MyBatis学习：入门指南与基础操作

MyBatis 是一个基于 Java 的开源持久层框架，它侧重于简化 SQL 语句的编写和数据库交互。与传统的 ORM（对象关系映射）框架相比，MyBatis 提供了更细粒度的控制，允许开发者直接编写 SQL 语句和动态 SQL，从而提高性能和灵活性。

实践示例：创建MyBatis项目

首先，我们需要创建一个新的 Java 项目，并引入 MyBatis 相关的依赖。这里以 Maven 作为构建工具为例：

<dependencies>
    <dependency>
        <groupId>org.mybatis</groupId>
        <artifactId>mybatis</artifactId>
        <version>3.5.7</version>
    </dependency>
    <dependency>
        <groupId>org.mybatis</groupId>
        <artifactId>mybatis-spring</artifactId>
        <version>2.0.2</version>
    </dependency>
</dependencies>

接下来，设置 MyBatis 的核心配置文件 mybatis-config.xml：

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

配置完成后，就可以开始使用 MyBatis 进行数据库操作了。

创建实体类

实体类是数据库表的映射，每个字段对应表中的一个列。以下是一个简单的实体类示例：

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

    // 构造函数、getter和setter省略...
}

创建SQL映射文件

SQL映射文件(UserMapper.xml)是 MyBatis 的核心，用于定义与数据库交互的 SQL 语句。以下是创建 UserMapper.xml 文件并定义基本的 CRUD 操作：

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

    <insert id="insertUser" parameterType="com.example.User">
        INSERT INTO user(name, email) VALUES(#{name}, #{email})
    </insert>

    <update id="updateUser" parameterType="com.example.User">
        UPDATE user SET name = #{name}, email = #{email} WHERE id = #{id}
    </update>

    <delete id="deleteUser" parameterType="int">
        DELETE FROM user WHERE id = #{id}
    </delete>
</mapper>

使用MyBatis进行操作

现在我们可以在 Java 类中使用这些映射的 SQL 语句：

@Autowired
private SqlSession sqlSession;

public void addUser(User user) {
    sqlSession.getMapper(UserMapper.class).insertUser(user);
}

public User getUserById(int id) {
    return sqlSession.getMapper(UserMapper.class).selectUser(id);
}

public void updateUser(User user) {
    sqlSession.getMapper(UserMapper.class).updateUser(user);
}

public void deleteUser(int id) {
    sqlSession.getMapper(UserMapper.class).deleteUser(id);
}

注意：SqlSession 是 MyBatis 的会话接口，负责与数据库进行交互。在实际应用中，要确保 SqlSession 的生命周期管理，通常通过 Spring 的事务管理或单例模式来实现。

元素与属性

在 SQL 映射文件中，使用 <sql>、<select>、<insert>、<update>、<delete> 等元素来定义不同的操作。这些元素可以包含 SQL 语句、变量和参数。

使用#{}表达参数绑定

在 SQL 语句中，#{} 用于绑定参数。这种方式能够防止 SQL 注入，并允许在运行时动态地插入参数值。

<select id="getUserById" parameterType="int" resultType="com.example.User">
    SELECT * FROM user WHERE id = #{id}
</select>

使用<foreach>元素处理循环

对于需要在 SQL 中动态添加多个参数的场景，可以使用 <foreach> 元素。下面是一个使用 <foreach> 的例子：

<delete id="deleteUsersByIds" parameterType="java.util.List">
    DELETE FROM user WHERE id IN
    <foreach item="id" collection="ids" open="(" separator="," close=")">
        #{id}
    </foreach>
</delete>

动态SQL

MyBatis 的动态 SQL 功能允许在查询中添加、删除或修改条件，这极大地提高了 SQL 语句的灵活性。MyBatis 支持的动态 SQL 元素包括 if、choose、when、otherwise 等。

if元素示例

<select id="selectUserByCondition" parameterType="com.example.Condition">
    SELECT * FROM user WHERE 1=1
    <if test="name != null">
        AND name = #{name}
    </if>
    <if test="age != null">
        AND age = #{age}
    </if>
</select>

choose、when、otherwise 示例

<select id="selectUserByCriteria" parameterType="com.example.Criteria">
    SELECT * FROM user WHERE
    <choose>
        <when test="id != null">
            id = #{id}
        </when>
        <when test="name != null">
            name = #{name}
        </when>
        <otherwise>
            1=1
        </otherwise>
    </choose>
</select>

结果映射

结果映射用于指定如何将查询结果映射到 Java 对象。以下是一个简单的结果映射配置示例：

<resultMap id="UserResultMap" type="com.example.User">
    <id column="id" property="id"/>
    <result column="name" property="name"/>
    <result column="email" property="email"/>
</resultMap>

关联映射

关联映射用于处理复杂对象之间的关系，如多对一、一对多等。下面是一个多对一关联映射的示例：

<association property="departments" javaType="java.util.List">
    <resultMap id="DepartmentResultMap" type="com.example.Department">
        <!-- 映射字段 -->
    </resultMap>
    <select id="getDepartments" resultType="com.example.Department">
        SELECT * FROM department WHERE user_id = #{userId}
    </select>
</association>

在使用 MyBatis 进行数据库操作时，需要管理事务的提交和回滚。MyBatis 支持自动提交事务和手动控制事务两种方式。

自动提交事务

当使用 <select>、<insert>、<update>、<delete> 等操作时，MyBatis 会自动处理事务的开始、提交和回滚。

public void updateUser(User user) {
    sqlSession.getMapper(UserMapper.class).updateUser(user);
}

手动控制事务

当需要更细粒度的事务控制时，可以使用 SqlSession 的 commit() 和 rollback() 方法：

public void updateUserWithTransaction(User user) {
    SqlSession session = null;
    try {
        session = sqlSessionFactory.openSession();
        UserMapper mapper = session.getMapper(UserMapper.class);
        mapper.updateUser(user);
        session.commit();
    } catch (Exception e) {
        session.rollback();
        throw new RuntimeException(e);
    } finally {
        session.close();
    }
}

通过上述指南，你已经对 MyBatis 的基础使用有了深入的了解。从环境配置到动态 SQL 的应用，再到事务管理的细节，MyBatis 提供了强大的工具集，让你在 Java 开发中高效地与数据库进行交互。