正文

Java开源框架MyBatis实战攻略：轻松上手，高效开发，案例详解

/0 浏览量
0609

MyBatis 是一个优秀的持久层框架，它消除了几乎所有的 JDBC 代码和手动设置参数以及获取结果集。MyBatis 可以使用简单的 XML 或注解用于配置和原始映射，将接口和 Java 的 POJOs（Plain Old Java Objects，普通的 Java对象）映射成数据库中的记录。

下面，我们将通过详细的步骤和案例来介绍如何轻松上手 MyBatis，并高效地进行开发。

MyBatis 快速入门

1. 环境搭建

首先，你需要搭建 MyBatis 的开发环境。以下是步骤：

  1. 添加依赖：在你的 Maven 项目中，添加以下依赖到 pom.xml 文件中。

    <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.22</version>
</dependency>

  2. 配置数据库：在 src/main/resources 目录下创建一个 application.properties 文件，配置数据库信息。

    # 数据库配置
url=jdbc:mysql://localhost:3306/mybatis_db?useSSL=false&serverTimezone=UTC
username=root
password=root
driver-class-name=com.mysql.cj.jdbc.Driver

  3. 编写实体类：创建一个与数据库表对应的 Java 类，例如 User.java。

    public class User {
    private Integer id;
    private String username;
    private String password;
    // getter 和 setter
}

  4. 编写 MyBatis 配置文件：创建 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="url" value="jdbc:mysql://localhost:3306/mybatis_db?useSSL=false&serverTimezone=UTC"/>
                <property name="username" value="root"/>
                <property name="password" value="root"/>
                <property name="driver" value="com.mysql.cj.jdbc.Driver"/>
            </dataSource>
        </environment>
    </environments>
    <mappers>
        <mapper resource="com/example/mybatis/UserMapper.xml"/>
    </mappers>
</configuration>

  5. 编写 Mapper 接口和 XML 映射文件：创建 UserMapper.java 接口和 UserMapper.xml 映射文件。

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

    <?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.mybatis.UserMapper">
    <select id="getUserById" resultType="com.example.mybatis.User">
        SELECT * FROM user WHERE id = #{id}
    </select>
</mapper>

  6. 运行程序：运行 UserMapperTest 测试类。

    public class UserMapperTest {
    public static void main(String[] args) {
        SqlSession sqlSession = MyBatisUtil.getSession();
        UserMapper mapper = sqlSession.getMapper(UserMapper.class);
        User user = mapper.getUserById(1);
        System.out.println(user);
        sqlSession.close();
    }
}

2. MyBatis 核心概念

  • SqlSession：MyBatis 的核心接口，用于执行 SQL 语句、管理事务、操作数据库。
  • Executor：执行器，负责执行 SQL 语句并返回结果。
  • Mapper：映射器，将 SQL 语句与 Java 接口的方法映射起来。
  • StatementHandler：处理 SQL 语句，生成对应的 PreparedStatement 对象。
  • ParameterHandler：处理 SQL 语句中的参数。
  • ResultHandler：处理查询结果。

3. MyBatis 高级功能

  • 动态 SQL：MyBatis 提供了动态 SQL 功能，可以根据不同的条件动态构建 SQL 语句。
  • 缓存：MyBatis 支持一级缓存和二级缓存，可以提高查询效率。
  • 注解开发：MyBatis 支持使用注解来编写 Mapper 接口和 XML 映射文件，简化开发过程。

案例详解

以下是一个简单的示例，演示如何使用 MyBatis 进行分页查询。

1. 定义分页实体类

public class PageInfo<T> {
    private int pageNum; // 当前页码
    private int pageSize; // 每页显示的记录数
    private List<T> list; // 当前页的记录列表
    private int totalCount; // 总记录数
    // getter 和 setter
}

2. 创建分页查询的 Mapper 接口

public interface UserMapper {
    PageInfo<User> getUserPageInfo(int pageNum, int pageSize);
}

3. 编写分页查询的 XML 映射文件

<select id="getUserPageInfo" parameterType="map" resultType="com.example.mybatis.PageInfo">
    SELECT
        id,
        username,
        password
    FROM
        user
    LIMIT #{offset}, #{pageSize}
</select>

4. 使用分页查询

public class UserMapperTest {
    public static void main(String[] args) {
        SqlSession sqlSession = MyBatisUtil.getSession();
        UserMapper mapper = sqlSession.getMapper(UserMapper.class);
        Map<String, Object> params = new HashMap<>();
        params.put("offset", (1 - 1) * 2);
        params.put("pageSize", 2);
        PageInfo<User> pageInfo = mapper.getUserPageInfo(params);
        System.out.println(pageInfo);
        sqlSession.close();
    }
}

通过以上案例，我们可以看到 MyBatis 在实现分页查询方面的便利性。

总结

MyBatis 是一个功能强大的持久层框架，可以帮助开发者轻松上手并高效地进行数据库开发。通过本文的介绍，相信你已经对 MyBatis 有了一定的了解。在实际开发中，你需要不断学习和实践，才能更好地掌握 MyBatis 的核心功能和高级特性。

-- 展开阅读全文 --