如何部署并运行MyBatis3

MyBatis 是一个优秀的持久层框架，它支持定制化 SQL、存储过程以及高级映射。MyBatis 避免了几乎所有的 JDBC 代码和手动设置参数以及获取结果集。MyBatis 可以使用简单的 XML 或注解来配置和映射原生信息，将接口和 Java 的 POJOs(Plain Old Java Objects,普通的 Java对象)映射成数据库中的记录。

本文将介绍如何在 Java 项目中部署并运行 MyBatis3。

1. 环境准备

在开始之前，确保你已经安装了以下软件：

• JDK 1.8 或更高版本
• Maven 3.x 或更高版本
• 一个支持 SQL 的数据库（如 MySQL、PostgreSQL 等）

2. 创建 Maven 项目

首先，创建一个新的 Maven 项目。你可以使用以下命令来创建一个简单的 Maven 项目：

mvn archetype:generate -DgroupId=com.example -DartifactId=mybatis-demo -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false

这将创建一个名为 mybatis-demo 的项目。

3. 添加 MyBatis 依赖

在 pom.xml 文件中添加 MyBatis 的依赖：

<dependencies>
    <!-- MyBatis 核心依赖 -->
    <dependency>
        <groupId>org.mybatis</groupId>
        <artifactId>mybatis</artifactId>
        <version>3.5.7</version>
    </dependency>

    <!-- 数据库驱动 -->
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <version>8.0.26</version>
    </dependency>

    <!-- 日志框架 -->
    <dependency>
        <groupId>org.slf4j</groupId>
        <artifactId>slf4j-log4j12</artifactId>
        <version>1.7.32</version>
    </dependency>
</dependencies>

4. 配置 MyBatis

在 src/main/resources 目录下创建一个 mybatis-config.xml 文件，用于配置 MyBatis：

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configuration
  PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
  "http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration>
    <environments default="development">
        <environment id="development">
            <transactionManager type="JDBC"/>
            <dataSource type="POOLED">
                <property name="driver" value="com.mysql.cj.jdbc.Driver"/>
                <property name="url" value="jdbc:mysql://localhost:3306/mybatis_demo"/>
                <property name="username" value="root"/>
                <property name="password" value="password"/>
            </dataSource>
        </environment>
    </environments>
    <mappers>
        <mapper resource="com/example/mapper/UserMapper.xml"/>
    </mappers>
</configuration>

5. 创建实体类和 Mapper 接口

创建一个简单的实体类 User：

package com.example.model;

public class User {
    private int id;
    private String name;
    private String email;

    // Getters and Setters
}

创建一个 Mapper 接口 UserMapper：

package com.example.mapper;

import com.example.model.User;

public interface UserMapper {
    User selectUser(int id);
}

6. 创建 Mapper XML 文件

在 src/main/resources/com/example/mapper 目录下创建 UserMapper.xml 文件：

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper
  PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
  "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.example.mapper.UserMapper">
    <select id="selectUser" resultType="com.example.model.User">
        SELECT * FROM users WHERE id = #{id}
    </select>
</mapper>

7. 编写测试代码

在 src/test/java/com/example 目录下创建一个测试类 MyBatisTest：

package com.example;

import com.example.mapper.UserMapper;
import com.example.model.User;
import org.apache.ibatis.io.Resources;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;

import java.io.IOException;
import java.io.InputStream;

public class MyBatisTest {
    public static void main(String[] args) {
        String resource = "mybatis-config.xml";
        InputStream inputStream = null;
        try {
            inputStream = Resources.getResourceAsStream(resource);
        } catch (IOException e) {
            e.printStackTrace();
        }
        SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);

        try (SqlSession session = sqlSessionFactory.openSession()) {
            UserMapper mapper = session.getMapper(UserMapper.class);
            User user = mapper.selectUser(1);
            System.out.println(user);
        }
    }
}

8. 运行测试

确保你的数据库已经启动，并且 users 表中有数据。然后运行 MyBatisTest 类，你应该能够看到从数据库中查询到的用户信息。

9. 总结

通过以上步骤，你已经成功地在 Java 项目中部署并运行了 MyBatis3。MyBatis 提供了强大的 SQL 映射功能，使得数据库操作变得更加简单和高效。你可以根据项目需求进一步扩展和优化 MyBatis 的配置和使用。

希望这篇文章对你有所帮助！