正文

Java开源框架MyBatis快速入门指南：从搭建到实战应用详解

/0 浏览量
0828

引言

MyBatis是一个优秀的持久层框架，它消除了几乎所有的JDBC代码和手动设置参数以及获取结果集的过程。MyBatis可以通过简单的XML或注解用于配置和原始映射，将接口和Java的POJOs（Plain Old Java Objects，普通的Java对象）映射成数据库中的记录。本文将带你从搭建MyBatis环境开始，逐步深入到实战应用。

一、环境搭建

1. 准备开发工具

  • IDE：推荐使用IntelliJ IDEA或Eclipse。
  • Java：确保JDK版本至少为1.8。
  • Maven：用于管理项目依赖。

2. 创建Maven项目

  1. 打开Maven命令行工具。
  2. 创建一个新的Maven项目，选择合适的组ID和项目ID。
  3. 添加以下依赖到pom.xml文件：
<dependencies>
    <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>
</dependencies>

3. 配置数据库

  1. 在MySQL数据库中创建一个新的数据库，例如mybatis_db。
  2. 创建一个用户表user，包含id、username和password字段。

二、编写MyBatis配置

1. 创建mybatis-config.xml

在项目根目录下创建mybatis-config.xml文件，配置数据库连接信息、事务管理器和映射器：

<?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_db"/>
                <property name="username" value="root"/>
                <property name="password" value=""/>
            </dataSource>
        </environment>
    </environments>
    <mappers>
        <mapper resource="com/example/mapper/UserMapper.xml"/>
    </mappers>
</configuration>

2. 创建UserMapper.xml

在src/main/resources目录下创建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="selectUserById" resultType="com.example.entity.User">
        SELECT * FROM user WHERE id = #{id}
    </select>
</mapper>

三、编写Java接口

在src/main/java目录下创建UserMapper.java接口，定义对应的操作方法：

package com.example.mapper;

public interface UserMapper {
    User selectUserById(Integer id);
}

四、编写Java实体类

在src/main/java目录下创建User.java实体类，对应数据库中的用户表：

package com.example.entity;

public class User {
    private Integer id;
    private String username;
    private String password;

    // 省略getter和setter方法
}

五、编写测试代码

在src/test/java目录下创建UserMapperTest.java测试类，编写测试代码：

package com.example.mapper;

import com.example.entity.User;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;
import org.junit.BeforeClass;
import org.junit.Test;

import static org.junit.Assert.assertEquals;

public class UserMapperTest {
    private static SqlSessionFactory sqlSessionFactory;

    @BeforeClass
    public static void setUp() throws Exception {
        sqlSessionFactory = new SqlSessionFactoryBuilder().build(
                Resources.getResourceAsStream("mybatis-config.xml"));
    }

    @Test
    public void testSelectUserById() throws Exception {
        try (SqlSession session = sqlSessionFactory.openSession()) {
            UserMapper mapper = session.getMapper(UserMapper.class);
            User user = mapper.selectUserById(1);
            assertEquals("test", user.getUsername());
        }
    }
}

六、运行测试

运行UserMapperTest类中的testSelectUserById方法，如果测试通过，说明MyBatis环境搭建成功。

七、总结

通过本文的讲解，你已经掌握了MyBatis的基本使用方法。在实际开发中，你可以根据需求自定义XML映射文件或使用注解，实现更加复杂的操作。希望本文对你有所帮助，祝你学习愉快！

-- 展开阅读全文 --