：MyBatis 详解

Posted 2022-05-09 求不脱发

🙊🙊作者主页：🔗求不脱发的博客

📔📔 精选专栏：🔗SSM直击大厂

📋📋 精彩摘要：MyBatis 是一款优秀的持久层框架，它支持定制化 SQL、存储过程以及高级映射。MyBatis 避免了几乎所有的 JDBC 代码和手动设置参数以及获取结果集。MyBatis 可以使用简单的 XML 或注解来配置和映射原生信息，将接口和 Java 的 POJOs(Plain Ordinary Java Object,普通的 Java对象)映射成数据库中的记录。

💞💞觉得文章还不错的话欢迎大家点赞👍➕收藏⭐️➕评论💬支持博主🤞

---

📚目录

📖MyBatis 快速入门

📝1️⃣揭秘 MyBatis

        ✨什么是MyBatis？

        ✨为什么使用MyBatis？

📝2️⃣MyBatis的快速入门

        ✨MyBatis开发步骤：

        ✨MyBatis开发步骤小结：

📖MyBatis 深入

📝3️⃣MyBatis映射文件各标签详解

📝4️⃣MyBatis的增删改查操作

        ✨MyBatis插入操作：

        ✨MyBatis修改操作：

        ✨MyBatis删除操作：

        ✨MyBatis增删改查小结：

📝5️⃣MyBatis核心配置文件 SqlMapConfig.xml 详解

        ✨层级关系 注意上下顺序：

        ✨常用配置：

📝6️⃣MyBatis的相应API

        ✨SqlSession工厂构建器SqlSessionFactoryBuilder

        ✨SqlSession工厂对象SqlSessionFactory

        ✨SqlSession会话对象

---

📖MyBatis 快速入门

---

📝1️⃣揭秘 MyBatis

✨什么是MyBatis？

百度介绍

MyBatis 是一款优秀的持久层框架，它支持定制化 SQL、存储过程以及高级映射。MyBatis 避免了几乎所有的 JDBC 代码和手动设置参数以及获取结果集。MyBatis 可以使用简单的 XML 或注解来配置和映射原生信息，将接口和 Java 的 POJOs(Plain Ordinary Java Object,普通的 Java对象)映射成数据库中的记录。

特点

• 简单易学：本身就很小且简单。没有任何第三方依赖，最简单安装只要两个jar文件+配置几个sql映射文件。易于学习，易于使用。通过文档和源代码，可以比较完全的掌握它的设计思路和实现。
• 灵活：mybatis不会对应用程序或者数据库的现有设计强加任何影响。 sql写在xml里，便于统一管理和优化。通过sql语句可以满足操作数据库的所有需求。
• 解除sql与程序代码的耦合：通过提供DAO层，将业务逻辑和数据访问逻辑分离，使系统的设计更清晰，更易维护，更易单元测试。sql和代码的分离，提高了可维护性。
• 提供映射标签，支持对象与数据库的orm字段关系映射。
• 提供对象关系映射标签，支持对象关系组建维护。
• 提供xml标签，支持编写动态sql。

---

✨为什么使用MyBatis？

问题引入：首先对原始JDBC操作分析

原始jdbc开发存在的问题：

1.  数据库连接创建、释放频繁造成系统资源浪费从而影响系统性能。
2.  Sql 语句在代码中硬编码，造成代码不易维护，实际应用 sql 变化的可能较大，sql 变动需要改变java代码。
3.  查询操作时，需要手动将结果集中的数据手动封装到实体中。插入操作时，需要手动将实体的数据设置到sql语句的占位符位置。

解决方案：持久层框架：

1. 使用数据库连接池初始化连接资源。
2. 将sql语句抽取到xml配置文件中。
3. 使用反射、内省等底层技术，自动将实体与表进行属性与字段的自动映射。

---

📝2️⃣MyBatis的快速入门

✨MyBatis开发步骤：

1. 在 pom.xml 文件中导入MyBatis的坐标和其他相关坐标

<dependencies>
        <!--单元测试-->
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.11</version>
            <scope>test</scope>
        </dependency>

        <!--mysql驱动-->
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>8.0.25</version>
        </dependency>

        <!--mybatis-->
        <dependency>
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis</artifactId>
            <version>3.4.6</version>
        </dependency>
</dependencies>

2. 创建测试需要的user数据表

​

3. 创建User实体类

package com.mybatis.domain;

public class User 
    private int id;
    private String username;
    private String password;

    //get and set

4. 创建 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="userMapper">
    <!--查询操作-->
    <select id="findAll" resultType="com.mybatis.domain.User">
        select * from user
    </select>
</mapper>

5. 创建MyBatis核心文件 SqlMapConfig.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>

    <!--1、加载jdbc.properties  resource路径下的db.properties-->
    <properties resource="db.properties"/>

    <!--2、配置数据源环境-->
    <environments default="mybatis">
        <environment id="mybatis">
            <transactionManager type="JDBC"></transactionManager>
            <dataSource type="POOLED">
                <property name="driver" value="$jdbc.driver"/>
                <property name="url" value="$jdbc.url"/>
                <property name="username" value="$jdbc.username"/>
                <property name="password" value="$jdbc.password"/>
            </dataSource>
        </environment>
    </environments>

    <!--3、加载映射文件-->
    <mappers>
        <mapper resource="com.mybatis.mapper\\UserMapper.xml"></mapper>
    </mappers>

</configuration>

6. 测试代码

public class test 
    @Test
    //查询操作测试
    public void test1() throws IOException 
        //加载核心配置文件
        InputStream resource = Resources.getResourceAsStream("SqlMapConfig.xml");
        //获得Session工厂
        SqlSessionFactory sessionFactory = new SqlSessionFactoryBuilder().build(resource);
        //获取sqlSession
        SqlSession sqlSession = sessionFactory.openSession();
        //执行sql语句     nameSpace + id  = userMapper.findAll
        List<User> userList = sqlSession.selectList("userMapper.findAll");
        //打印数据测试结果
        System.out.println(userList);
        //释放资源
        sqlSession.close();
    

执行结果

​

---

✨MyBatis开发步骤小结：

1. 在 pom.xml 文件中导入MyBatis的坐标和其他相关坐标

2. 创建测试需要的user数据表

3. 创建User实体类

4. 创建 UserMapper.xml 映射文件

5. 创建MyBatis核心文件 SqlMapConfig.xml

6. 编写测试代码  

---

📖MyBatis 深入

---

📝3️⃣MyBatis映射文件各标签详解

源码：

<?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="userMapper">
    <!--查询操作-->
    <select id="findAll" resultType="com.mybatis.domain.User">
        select * from user
    </select>
</mapper>

各标签详解

<!DOCTYPE mapper .......mapper.dtd>	映射文件DTD约束头
<mapper>.......</mapper>	根标签
<mapper  namespace="userMapper">	命名空间，+id 组成 查询标识
<select></select>	查询标签，insert、update、delete
resultType="com.mybatis.domain.User"	查询返回的结果集元素对应的数据类型
<select>select * from user</select>	对应SQL语句
<select id="findAll">	id唯一标识，与namespace组合成查询标识

---

📝4️⃣MyBatis的增删改查操作

✨MyBatis插入操作：

1. 编写UserMapper.xml 映射文件

<mapper namespace="userMapper">

    <!--插入操作-->
    <insert id="addUser" parameterType="com.mybatis.domain.User">
        insert into user values (#id,#username,#password)
    </insert>

</mapper>

2. 创建实体User对象

User user = new User();
user.setUsername("lisi");
user.setPassword("123456");

3. 测试代码：

@Test
    public void test2() throws IOException 
        //加载核心配置文件
        InputStream resource = Resources.getResourceAsStream("SqlMapConfig.xml");
        //获得Session工厂
        SqlSessionFactory sessionFactory = new SqlSessionFactoryBuilder().build(resource);
        //获取sqlSession
        SqlSession sqlSession = sessionFactory.openSession();
        //执行sql语句     nameSpace + id  = userMapper.addUser
        User user = new User();
        user.setUsername("lisi");
        user.setPassword("123456");
        sqlSession.insert("userMapper.addUser",user);
        //提交事务
        sqlSession.commit();
        //释放资源
        sqlSession.close();
    

4.插入操作注意事项：

• 插入语句使用insert标签。
• 在映射文件中使用parameterType属性指定要插入的数据类型。
• Sql语句中使用#实体属性名方式引用实体中的属性值。
• 插入操作使用的API是sqlSession.insert(“命名空间.id”,实体对象)。
• 插入操作涉及数据库数据变化，所以要使用sqlSession对象显示的提交事务，即sqlSession.commit()。

---

✨MyBatis修改操作：

1. 编写UserMapper.xml 映射文间

<mapper namespace="userMapper">

    <!--修改操作-->
    <update id="updateUser" parameterType="com.mybatis.domain.User">
        update user set username = #username,password = #password where id = #id
    </update>
</mapper>

2. 编写修改实体User的代码

@Test
    public void tes3() throws IOException 
        //加载核心配置文件
        InputStream resource = Resources.getResourceAsStream("SqlMapConfig.xml");
        //获得Session工厂
        SqlSessionFactory sessionFactory = new SqlSessionFactoryBuilder().build(resource);
        //获取sqlSession
        SqlSession sqlSession = sessionFactory.openSession();
        //执行sql语句     nameSpace + id  = userMapper.update
        User user = new User();
        user.setId(3);
        user.setUsername("lisi");
        user.setPassword("654321");
        sqlSession.update("userMapper.updateUser",user);
        //提交事务
        sqlSession.commit();
        //释放资源
        sqlSession.close();
    

3.修改操作注意事项

• 修改语句使用update标签
• 修改操作使用的API是sqlSession.update(“命名空间.id”,实体对象);

---

✨MyBatis删除操作：

1. 编写UserMapper映射文件

<mapper namespace="userMapper">

    <!--删除操作-->
    <delete id="deleteUser" parameterType="java.lang.Integer">
        delete from user where id = #id
    </delete>
</mapper>

2. 编写删除数据的代码

  @Test
    public void test4() throws IOException 
        //加载核心配置文件
        InputStream resource = Resources.getResourceAsStream("SqlMapConfig.xml");
        //获得Session工厂
        SqlSessionFactory sessionFactory = new SqlSessionFactoryBuilder().build(resource);
        //获取sqlSession
        SqlSession sqlSession = sessionFactory.openSession();
        //执行sql语句     nameSpace + id  = userMapper.delete
        sqlSession.delete("userMapper.deleteUser",3);
        //提交事务
        sqlSession.commit();
        //释放资源
        sqlSession.close();
    

3.删除操作注意事项

• 删除语句使用delete标签
• Sql语句中使用#任意字符串方式引用传递的单个参数
• 删除操作使用的API是sqlSession.delete(“命名空间.id”,Object);

---

✨MyBatis增删改查小结：

操作	API语句	映射文件配置
查询数据	List<User> userList = sqlSession.selectList("userMapper.findAll");	< select id ="findAll" resultType ="com.itheima.domain.User" > select * from User </ select >
添加数据	sqlSession.insert("userMapper.add", user);	< insert id ="add" parameterType ="com.itheima.domain.User" > insert into user values(#id,#username,#password) </ insert >
修改数据	sqlSession.update("userMapper.update", user);	< update id ="update" parameterType ="com.itheima.domain.User" > update user set username=#username,password=#password where id=#id </ update >
删除数据	sqlSession.delete("userMapper.delete",3);	< delete id ="delete" parameterType ="java.lang.Integer" > delete from user where id=#id </ delete >

---

📝5️⃣MyBatis核心配置文件 SqlMapConfig.xml 详解

✨层级关系 注意上下顺序：

• configguration 配置
  • properties 属性
  • settings 设置
  • typeAliases 类型别名
  • typeHandlers 类型处理器
  • objectFactory 对象工厂
  • plugins 插件
  • environments 环境 
    • environment 环境变量
      • transactionManager 事务管理器
      • dataSource数据源
  • databaseIdProvider 数据库厂商标识
  • mappers 映射器

---

✨常用配置：

1. environments 环境标签

事务管理器（transactionManager）类型有两种： 

事务管理器（transactionManager）
JDBC：	直接使用了JDBC 的提交和回滚设置，它依赖于从数据源得到的连接来管理事务作用域。
MANAGED：	它从来不提交或回滚一个连接，而是让容器来管理事务的整个生命周期（比如JEE 应用服务器的上下文）。 默认情况下它会关闭连接，然而一些容器并不希望这样，因此需要将 closeConnection 属性设置 为 false 来阻止它默认的关闭行为。

数据源（dataSource）类型有三种：

数据源（dataSource）
UNPOOLED：	这个数据源的实现只是每次被请求时打开和关闭连接。
POOLED：	这种数据源的实现利用“池”的概念将 JDBC 连接对象组织起来。
JNDI：	这个数据源的实现是为了能在如 EJB 或应用服务器这类容器中使用，容器可以集中或在外部配置数据源，然后放置 一个 JNDI 上下文的引用

2. mapper 映射标签

该标签用于加载映射，加载方式有如下几种：

加载方式	例：
使用相对于类路径资源引用（常用）	<mapper resource="org/mybatis/builder/AuthorMapper.xml"/>
使用完全限定资源定位符（URL）	<mapper url="file:///var/mappers/AuthorMapper.xml"/>
使用映射器接口实现类完全限定类名	<mapper class="org.mybatis.builder.AuthorMapper"/>
包内映射器接口实现全部注册映射器	<package name="org.mybatis.builder"/>

3. Properties 配置文件标签

实际开发中，习惯将数据源的配置信息单独抽取成一个properties文件，该标签可以加载额外配置的properties文件。

 <!--1、加载数据库相关配置文件db.properties-->
    <properties resource="db.properties"/>
 <!--2、配置数据源环境-->
    <environments default="mybatis">
        <environment id="mybatis">
            <transactionManager type="JDBC"></transactionManager>
            <dataSource type="POOLED">
                <property name="driver" value="$jdbc.driver"/>
                <property name="url" value="$jdbc.url"/>
                <property name="username" value="$jdbc.username"/>
                <property name="password" value="$jdbc.password"/>
            </dataSource>
        </environment>
    </environments>

4. typeAliases 定义别名标签

User全限定名：com.mybatis.domain.User

使用标签定义别名

<!--定义别名-->
    <typeAliases>
        <typeAlias type="com.mybatis.domain.User" alias="user"/>
    </typeAliases>

上面我们是自定义的别名，mybatis框架已经为我们设置好的一些常用的类型的别名

别名	数据类型
string	String
long	Long
int	Integer
double	Double
boolean	Boolean
...	...

---

✨核心文件常用配置小结：

1. environments 环境标签

2. mapper 映射标签

3. Properties 配置文件标签

4. typeAliases 定义别名标签

---

📝6️⃣MyBatis的相应API

✨SqlSession工厂构建器SqlSessionFactoryBuilder

常用API：SqlSessionFactory build(InputStream inputStream)

通过加载mybatis的核心文件的输入流的形式构建一个SqlSessionFactory对象

String resource = "org/mybatis/builder/mybatis-config.xml";
InputStream inputStream = Resources.getResourceAsStream(resource);
SqlSessionFactoryBuilder builder = new SqlSessionFactoryBuilder();
SqlSessionFactory factory = builder.build(inputStream);

其中， Resources 工具类，这个类在 org.apache.ibatis.io 包中。Resources 类帮助你从类路径下、文件系统或 一个 web URL 中加载资源文件。

---

✨SqlSession工厂对象SqlSessionFactory

SqlSessionFactory 常用方法创建 SqlSession 实例：

openSession()	会默认开启一个事务，但事务不会自动提交，也就意味着需要手动提 交该事务，更新操作数据才会持久化到数据库中
openSession(boolean autoCommit)	参数为是否自动提交，如果设置为true，那么不需要手动提交事务

---

✨SqlSession会话对象

SqlSession 实例在 MyBatis 中是非常强大的一个类。在这里你会看到所有执行语句、提交或回滚事务和获取映射器实例的方法。

执行语句的方法主要有：

//返回一个T泛型对象
<T> T selectOne(String statement, Object parameter) 

//查询操作返回一个结果集集合
<E> List<E> selectList(String statement, Object parameter) 

//增删改操作
int insert(String statement, Object parameter) 
int update(String statement, Object parameter) 
int delete(String statement, Object parameter)

操作事务的方法主要有：

void commit() //提交事务
void rollback() //回滚事务