MyBatis框架基础教程

一、MyBatis 简介

MyBatis 是一款优秀的持久层框架，它支持自定义 SQL、存储过程以及高级映射。MyBatis 免除了几乎所有的 JDBC 代码以及设置参数和获取结果集的工作。

主要特点：

简单易学：代码量少，学习曲线平缓

灵活：SQL写在XML里，便于统一管理和优化

解除SQL与程序代码的耦合

提供映射标签，支持对象与数据库的ORM字段关系映射

二、MyBatis 环境搭建

1. 添加依赖

Maven项目添加以下依赖：

<dependency>    <groupId>org.mybatis</groupId>    <artifactId>mybatis</artifactId>    <version>3.5.6</version></dependency><dependency>    <groupId>mysql</groupId>    <artifactId>mysql-connector-java</artifactId>    <version>8.0.23</version></dependency>

2. 创建核心配置文件

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="password"/>            </dataSource>        </environment>    </environments>    <mappers>        <mapper resource="mapper/UserMapper.xml"/>    </mappers></configuration>

三、基本使用

1. 创建实体类​​​​​​​

public class User {    private int id;    private String name;    private String email;    // 构造方法、getter和setter省略}

2. 创建Mapper接口​​​​​​​

public interface UserMapper {    User selectUser(int id);    List<User> selectAllUsers();    int insertUser(User user);    int updateUser(User user);    int deleteUser(int id);}

3. 创建Mapper XML文件

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="selectUser" resultType="com.example.entity.User">        SELECT * FROM user WHERE id = #{id}    </select>    <select id="selectAllUsers" resultType="com.example.entity.User">        SELECT * FROM user    </select>    <insert id="insertUser" parameterType="com.example.entity.User">        INSERT INTO user(name, email) VALUES(#{name}, #{email})    </insert>    <update id="updateUser" parameterType="com.example.entity.User">        UPDATE user SET name=#{name}, email=#{email} WHERE id=#{id}    </update>    <delete id="deleteUser">        DELETE FROM user WHERE id=#{id}    </delete></mapper>

4. 使用MyBatis​​​​​​​

public class MyBatisDemo {    public static void main(String[] args) throws IOException {        // 1. 读取配置文件        String resource = "mybatis-config.xml";        InputStream inputStream = Resources.getResourceAsStream(resource);        // 2. 构建SqlSessionFactory        SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);        // 3. 获取SqlSession        try (SqlSession session = sqlSessionFactory.openSession()) {            // 4. 获取Mapper接口的代理对象            UserMapper mapper = session.getMapper(UserMapper.class);            // 5. 执行SQL操作            User user = mapper.selectUser(1);            System.out.println(user);            // 6. 提交事务            session.commit();        }    }}

四、高级特性

1. 动态SQL​​​​​​​

<select id="findUsers" parameterType="map" resultType="User">    SELECT * FROM user    <where>        <if test="name != null">            AND name like #{name}        </if>        <if test="email != null">            AND email = #{email}        </if>    </where></select>

2. 结果映射​​​​​​​

<resultMap id="userResultMap" type="User">    <id property="id" column="user_id"/>    <result property="name" column="user_name"/>    <result property="email" column="user_email"/></resultMap><select id="selectUser" resultMap="userResultMap">    SELECT user_id, user_name, user_email FROM user WHERE user_id = #{id}</select>

3. 关联查询​​​​​​​

<resultMap id="userWithOrdersMap" type="User">    <id property="id" column="id"/>    <result property="name" column="name"/>    <collection property="orders" ofType="Order">        <id property="orderId" column="order_id"/>        <result property="orderNo" column="order_no"/>    </collection></resultMap><select id="selectUserWithOrders" resultMap="userWithOrdersMap">    SELECT u.*, o.order_id, o.order_no     FROM user u LEFT JOIN orders o ON u.id = o.user_id    WHERE u.id = #{id}</select>

五、注解开发

MyBatis也支持使用注解代替XML配置：​​​​​​

public interface UserMapper {    @Select("SELECT * FROM user WHERE id = #{id}")    User selectUser(int id);    @Insert("INSERT INTO user(name, email) VALUES(#{name}, #{email})")    @Options(useGeneratedKeys = true, keyProperty = "id")    int insertUser(User user);    @Update("UPDATE user SET name=#{name}, email=#{email} WHERE id=#{id}")    int updateUser(User user);    @Delete("DELETE FROM user WHERE id=#{id}")    int deleteUser(int id);}

六、常见问题

SQL注入问题：MyBatis使用#{}可以有效防止SQL注入，${}有注入风险

延迟加载：需要时再加载关联数据，可通过配置开启

一级缓存：SqlSession级别的缓存，默认开启

二级缓存：Mapper级别的缓存，需要手动配置开启