正文

从零开始学MyBatis：开源框架入门与实战指南

/0 浏览量
0415

MyBatis 是一个流行的持久层框架，它简化了数据库操作，使开发者能够更加专注于业务逻辑的实现。本文将从零开始，带你一步步了解 MyBatis 的入门知识，并通过实战案例来加深理解。

什么是MyBatis？

MyBatis 是一个半ORM（对象关系映射）框架，它将 SQL 映射成 Java 对象，从而简化了数据库操作。与全 ORM 框架（如 Hibernate）相比，MyBatis 允许开发者更加精细地控制 SQL 语句的执行，同时也更容易与现有的代码集成。

MyBatis 的特点

  1. 半ORM 框架：MyBatis 允许开发者自定义 SQL 语句，同时将 SQL 映射成 Java 对象。
  2. 易于集成：MyBatis 可以与各种数据库连接池（如 C3P0、HikariCP）和数据库驱动程序（如 MySQL、Oracle）集成。
  3. 灵活的映射规则：MyBatis 支持多种映射规则，如一对一、一对多、多对多等。
  4. 丰富的插件机制：MyBatis 提供了丰富的插件机制，可以扩展框架的功能。

MyBatis 的入门

1. 环境搭建

首先，你需要安装 Java 开发环境（JDK 1.6 以上）、IDE（如 IntelliJ IDEA、Eclipse）和数据库（如 MySQL）。

2. 添加依赖

在你的项目中添加 MyBatis 和数据库驱动的依赖。以下是 Maven 依赖示例：

<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.22</version>
    </dependency>
    <!-- 数据库连接池 -->
    <dependency>
        <groupId>com.zaxxer</groupId>
        <artifactId>HikariCP</artifactId>
        <version>4.0.3</version>
    </dependency>
</dependencies>

3. 配置 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="driver" value="com.mysql.cj.jdbc.Driver"/>
                <property name="url" value="jdbc:mysql://localhost:3306/test?useSSL=false"/>
                <property name="username" value="root"/>
                <property name="password" value="root"/>
            </dataSource>
        </environment>
    </environments>
    <mappers>
        <mapper resource="com/example/mapper/UserMapper.xml"/>
    </mappers>
</configuration>

4. 定义 Mapper 接口

创建一个 UserMapper.java 接口，定义数据库操作方法：

public interface UserMapper {
    List<User> findAll();
    User findById(int id);
    int insert(User user);
    int update(User user);
    int delete(int id);
}

5. 编写 Mapper XML

创建一个 UserMapper.xml 文件，定义 SQL 映射：

<?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="findAll" resultType="com.example.entity.User">
        SELECT * FROM user
    </select>
    <select id="findById" parameterType="int" resultType="com.example.entity.User">
        SELECT * FROM user WHERE id = #{id}
    </select>
    <insert id="insert" parameterType="com.example.entity.User">
        INSERT INTO user (name, age) VALUES (#{name}, #{age})
    </insert>
    <update id="update" parameterType="com.example.entity.User">
        UPDATE user SET name = #{name}, age = #{age} WHERE id = #{id}
    </update>
    <delete id="delete" parameterType="int">
        DELETE FROM user WHERE id = #{id}
    </delete>
</mapper>

6. 使用 MyBatis

创建一个 MyBatisUtil 工具类，用于获取 MyBatis 会话：

public class MyBatisUtil {
    private static SqlSessionFactory sqlSessionFactory;

    static {
        try {
            String resource = "mybatis-config.xml";
            InputStream inputStream = Resources.getResourceAsStream(resource);
            sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
        } catch (IOException e) {
            e.printStackTrace();
        }
    }

    public static SqlSession getSqlSession() {
        return sqlSessionFactory.openSession();
    }
}

在你的业务代码中，你可以使用 MyBatisUtil.getSqlSession() 获取 MyBatis 会话，然后调用 UserMapper 接口的方法：

public class UserService {
    public List<User> findAll() {
        try (SqlSession sqlSession = MyBatisUtil.getSqlSession()) {
            UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
            return userMapper.findAll();
        }
    }
}

MyBatis 实战案例

以下是一个简单的 MyBatis 实战案例，演示了如何使用 MyBatis 查询用户信息：

  1. 创建实体类：创建一个 User 类，用于表示用户信息。
public class User {
    private int id;
    private String name;
    private int age;
    // ... 省略构造方法、getters 和 setters
}
  1. 定义 Mapper 接口：在 UserMapper.java 接口中定义 findById 方法。
public interface UserMapper {
    User findById(int id);
}
  1. 编写 Mapper XML：在 UserMapper.xml 文件中定义 findById 方法的 SQL 映射。
<select id="findById" parameterType="int" resultType="com.example.entity.User">
    SELECT * FROM user WHERE id = #{id}
</select>
  1. 使用 MyBatis：在你的业务代码中，使用 MyBatisUtil.getSqlSession() 获取 MyBatis 会话，然后调用 UserMapper 接口的 findById 方法。
public class UserService {
    public User findUserById(int id) {
        try (SqlSession sqlSession = MyBatisUtil.getSqlSession()) {
            UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
            return userMapper.findById(id);
        }
    }
}

通过以上步骤，你就可以使用 MyBatis 实现简单的数据库操作了。

总结

本文介绍了 MyBatis 的入门知识，并通过一个简单的实战案例展示了如何使用 MyBatis 进行数据库操作。希望这篇文章能帮助你更好地理解 MyBatis，并能够在实际项目中应用它。

-- 展开阅读全文 --