正文

揭秘MyBatis：从入门到实战，Java开源框架的强大应用解析

/0 浏览量
0925

MyBatis 是一个优秀的持久层框架，它对 JDBC 的操作数据库过程进行了封装，使开发者只需要关注 SQL 语句本身，而不需要花费精力去处理比如建立连接、创建 Statement、关闭 Statement 等JDBC 操作。MyBatis 可以使用简单的 XML 或注解用于配置和原始映射，将接口和 Java 的 POJOs（Plain Old Java Objects，普通的 Java对象）映射成数据库中的记录。

一、MyBatis 的入门

1.1 MyBatis 的特点

  • 简单易用：MyBatis 可以很容易地使用，并且不需要复杂的配置和依赖。
  • 半自动映射：MyBatis 只需要将 SQL 与 Java 对象进行映射，而不需要写复杂的 JDBC 代码。
  • 支持定制化：MyBatis 支持自定义 SQL、存储过程以及高级映射。
  • 插件机制：MyBatis 提供了插件机制，可以扩展其功能。

1.2 MyBatis 的安装

要使用 MyBatis，首先需要在项目中添加 MyBatis 的依赖。通常，你可以通过 Maven 或 Gradle 来添加依赖。

<!-- Maven 依赖 -->
<dependency>
    <groupId>org.mybatis</groupId>
    <artifactId>mybatis</artifactId>
    <version>3.5.7</version>
</dependency>

1.3 MyBatis 的基本配置

在使用 MyBatis 之前，你需要创建一个配置文件（通常命名为 mybatis-config.xml），其中包含数据源的配置、事务管理器以及 SQL 映射文件的位置。

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

二、MyBatis 的实战

2.1 创建 Mapper 接口

在 MyBatis 中，你需要为每个数据表创建一个对应的 Mapper 接口，接口中声明了操作数据库的方法。

package com.your.package.mapper;

import com.your.package.entity.User;
import org.apache.ibatis.annotations.*;

public interface UserMapper {
    @Select("SELECT * FROM users WHERE id = #{id}")
    User findUserById(@Param("id") int id);

    @Insert("INSERT INTO users (name, email) VALUES (#{name}, #{email})")
    @Options(useGeneratedKeys = true, keyProperty = "id")
    int addUser(@Param("name") String name, @Param("email") String email);

    @Update("UPDATE users SET name = #{name}, email = #{email} WHERE id = #{id}")
    int updateUser(@Param("id") int id, @Param("name") String name, @Param("email") String email);

    @Delete("DELETE FROM users WHERE id = #{id}")
    int deleteUser(@Param("id") int id);
}

2.2 XML 映射文件

接下来，你需要创建一个 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.your.package.mapper.UserMapper">
    <resultMap id="userResultMap" type="com.your.package.entity.User">
        <id property="id" column="id"/>
        <result property="name" column="name"/>
        <result property="email" column="email"/>
    </resultMap>

    <select id="findUserById" resultMap="userResultMap">
        SELECT * FROM users WHERE id = #{id}
    </select>

    <insert id="addUser" parameterType="User">
        INSERT INTO users (name, email) VALUES (#{name}, #{email})
    </insert>

    <update id="updateUser" parameterType="User">
        UPDATE users SET name = #{name}, email = #{email} WHERE id = #{id}
    </update>

    <delete id="deleteUser">
        DELETE FROM users WHERE id = #{id}
    </delete>
</mapper>

2.3 使用 MyBatis

现在，你可以使用 MyBatis 的 SqlSessionFactoryBuilder 来创建 SqlSessionFactory，然后通过 SqlSessionFactory 来创建 SqlSession，最后使用 SqlSession 来执行 SQL 语句。

package com.your.package;

import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;

public class MyBatisExample {
    public static void main(String[] args) {
        try {
            // 创建 SqlSessionFactory
            SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(new FileInputStream("src/main/resources/mybatis-config.xml"));
            // 创建 SqlSession
            SqlSession sqlSession = sqlSessionFactory.openSession();
            // 获取 Mapper 接口
            UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
            // 执行方法
            User user = userMapper.findUserById(1);
            System.out.println(user.getName());
            sqlSession.close();
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

三、MyBatis 的进阶应用

3.1 动态 SQL

MyBatis 提供了动态 SQL 功能，可以让你在 XML 映射文件中编写动态 SQL。

<update id="updateUser" parameterType="User">
    UPDATE users
    <set>
        <if test="name != null">name = #{name},</if>
        <if test="email != null">email = #{email},</if>
    </set>
    WHERE id = #{id}
</update>

3.2 类型处理器

MyBatis 提供了类型处理器，可以自动将 Java 类型转换为 JDBC 类型。

public class IntegerTypeHandler extends BaseTypeHandler<Integer> {
    @Override
    public void setNonNullParameter(PreparedStatement ps, int i, Integer parameter, JdbcType jdbcType) throws SQLException {
        ps.setInt(i, parameter);
    }

    @Override
    public Integer getNullableResult(ResultSet rs, String columnName) throws SQLException {
        return rs.getInt(columnName);
    }

    @Override
    public Integer getNullableResult(ResultSet rs, int columnIndex) throws SQLException {
        return rs.getInt(columnIndex);
    }

    @Override
    public Integer getNullableResult(CallableStatement cs, int columnIndex) throws SQLException {
        return cs.getInt(columnIndex);
    }
}

3.3 缓存机制

MyBatis 提供了两种类型的缓存：一级缓存和二级缓存。

  • 一级缓存：在同一个 SqlSession 中，同一个 SqlSession 的所有查询都会使用同一个缓存，查询过的数据都会放在缓存中。
  • 二级缓存：在同一个数据库的多个 SqlSession 中，所有 SqlSession 的查询都会使用同一个缓存。
<cache eviction="FIFO" flushInterval="60000" size="512" readOnly="true"/>

四、总结

MyBatis 是一个功能强大且灵活的持久层框架，它可以帮助你快速地完成数据库操作。通过本篇文章，你应该已经了解了 MyBatis 的入门、实战以及进阶应用。希望这些知识能帮助你更好地使用 MyBatis。

-- 展开阅读全文 --