Mybatis简介及快速入门

喜欢ヅ旅行 2022-10-08 13:26 237阅读 0赞

### 文章目录 ###

*   *  一、原始JDBC
     *   *  1.1 查询数据
         *  1.2 插入数据
         *  1.3 操作分析
     *  二、Mybatis简介
     *  三、Mybatis快速入门
     *   *  3.1 添加mybatis坐标
         *  3.2 创建User数据表
         *  3.3 编写User实体类
         *  3.4 编写映射文件UserMapper.xml
         *  3.5 编写核心文件SqlMapConfig.xml
         *  3.6 编写测试类
         *   *  3.6.1 查询
             *  3.6.2 添加
             *  3.6.3 修改
             *  3.6.4 删除
             *  3.6.5 查询单个
     *  四、 Mapper配置文件概述
     *  五、MyBatis核心配置文件概述
     *   *  5.1 MyBatis核心配置文件层级关系
         *  5.2 properties标签
         *  5.3 environments标签
         *  5.4 mapper标签
         *  5.5 typeAliases标签
     *  六、MyBatis相应API
     *   *  6.1 SqlSession工厂构建器SqlSessionFactoryBuilder
         *  6.2 SqlSession工厂对象SqlSessionFactory
         *  6.3 SqlSession会话对象

## 一、原始JDBC ##

### 1.1 查询数据 ###

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTAzNTgxNjg_size_16_color_FFFFFF_t_70]

### 1.2 插入数据 ###

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTAzNTgxNjg_size_16_color_FFFFFF_t_70 1]

### 1.3 操作分析 ###

原始`JDBC`开发存在的问题如下：

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

应对上述问题的解决方案：

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

## 二、Mybatis简介 ##

*  `mybatis`是一个优秀的基于`Java`的持久层框架，内部封装了`jdbc`，是开发者只需要关注`SQL`语句本身，而不需要花费精力去处理加载驱动、创建连接、创建`statement`等繁杂的过程
 *  `mybatis`通过`xml`或注解的方式将要执行的各种`statement`配置起来，并通过`Java`对象和`statement`中`SQL`的动态参数进行映射生成最终执行的`SQL`语句
 *  最后`mybatis`框架执行`SQL`并将结果映射为`Java`对象并返回。采用`ORM`思想解决了实体和数据库映射的问题，对`JDBC`进行了封装，屏蔽了`jdbc api`底层访问细节，使我们不用与`jdbc api`打交道，就可以完成对数据库的持久化操作

## 三、Mybatis快速入门 ##

### 3.1 添加mybatis坐标 ###

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTAzNTgxNjg_size_16_color_FFFFFF_t_70 2]

### 3.2 创建User数据表 ###

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTAzNTgxNjg_size_16_color_FFFFFF_t_70 3]

### 3.3 编写User实体类 ###

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTAzNTgxNjg_size_16_color_FFFFFF_t_70 4]

### 3.4 编写映射文件UserMapper.xml ###

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTAzNTgxNjg_size_16_color_FFFFFF_t_70 5]

### 3.5 编写核心文件SqlMapConfig.xml ###

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTAzNTgxNjg_size_16_color_FFFFFF_t_70 6]

### 3.6 编写测试类 ###

#### 3.6.1 查询 ####

`UserMapper.xml`

<select id="findAll" resultType="com.happy.domain.User"> 
           select * from User    
    </select>

`Java测试代码`

@Test
    //查询操作
     public void test1() throws IOException { 
         //获得核心配置文件
         InputStream resourceAsStream = Resources.getResourceAsStream("sqlMapConfig.xml");
         //获得session工厂对象
         SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(resourceAsStream);
         //获得session回话对象
         SqlSession sqlSession = sqlSessionFactory.openSession();
         //执行操作 参数：namespace+id
         List<User> userList = sqlSession.selectList("userMapper.findAll");
         //打印数据
         System.out.println(userList);
         //释放资源
         sqlSession.close();
     }

#### 3.6.2 添加 ####

`UserMapper.xml`

<mapper namespace="userMapper">    
    	<insert id="add" parameterType="com.happy.domain.User">        
    		insert into user values(#{id},#{username},#{password})    
    	</insert>
    </mapper>

`Java测试代码`

@Test
    //插入操作
    public void test2() throws IOException { 
    
        //模拟user对象
        User user = new User();
        user.setUsername("xxx");
        user.setPassword("abc");
    
        //获得核心配置文件
        InputStream resourceAsStream = Resources.getResourceAsStream("sqlMapConfig.xml");
        //获得session工厂对象
        SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(resourceAsStream);
        //获得session回话对象
        SqlSession sqlSession = sqlSessionFactory.openSession(true);
        //执行操作 参数：namespace+id
        sqlSession.insert("userMapper.save",user);
    
        //mybatis执行更新操作 提交事务
        //sqlSession.commit();
    
        //释放资源
        sqlSession.close();
    }

注意事项：

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

#### 3.6.3 修改 ####

`UserMapper.xml`

<mapper namespace="userMapper">
        <update id="update" parameterType="com.happy.domain.User">        		update user set username=#{username},password=#{password} where id=#{id}    		</update>
    </mapper>

`Java测试代码`

@Test
    //修改操作
    public void test3() throws IOException { 
    
        //模拟user对象
        User user = new User();
        user.setId(7);
        user.setUsername("lucy");
        user.setPassword("123");
    
        //获得核心配置文件
        InputStream resourceAsStream = Resources.getResourceAsStream("sqlMapConfig.xml");
        //获得session工厂对象
        SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(resourceAsStream);
        //获得session回话对象
        SqlSession sqlSession = sqlSessionFactory.openSession();
        //执行操作 参数：namespace+id
        sqlSession.update("userMapper.update",user);
    
        //mybatis执行更新操作 提交事务
        sqlSession.commit();
    
        //释放资源
        sqlSession.close();
    }

注意事项：

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

#### 3.6.4 删除 ####

`UserMapper.xml`

<mapper namespace="userMapper">
        <delete id="delete" parameterType="java.lang.Integer"> 
               delete from user where id=#{id}    
        </delete>
    </mapper>

`Java测试代码`

@Test
    //删除操作
    public void test4() throws IOException { 
    
        //获得核心配置文件
        InputStream resourceAsStream = Resources.getResourceAsStream("sqlMapConfig.xml");
        //获得session工厂对象
        SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(resourceAsStream);
        //获得session回话对象
        SqlSession sqlSession = sqlSessionFactory.openSession();
        //执行操作 参数：namespace+id
        sqlSession.delete("userMapper.delete",8);
    
        //mybatis执行更新操作 提交事务
        sqlSession.commit();
    
        //释放资源
        sqlSession.close();
    }

注意事项：

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

#### 3.6.5 查询单个 ####

`UserMapper.xml`

<mapper namespace="userMapper">
    
        <select id="findById" resultType="com.happy.domain.User" parameterType="int">
            select * from user where id=#{id}
        </select>
    </mapper>

`Java测试代码`

@Test
    //查询一个对象
    public void test5() throws IOException { 
        //获得核心配置文件
        InputStream resourceAsStream = Resources.getResourceAsStream("sqlMapConfig.xml");
        //获得session工厂对象
        SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(resourceAsStream);
        //获得session回话对象
        SqlSession sqlSession = sqlSessionFactory.openSession();
        //执行操作 参数：namespace+id
        User user = sqlSession.selectOne("userMapper.findById", 1);
        //打印数据
        System.out.println(user);
        //释放资源
        sqlSession.close();
    }

## 四、 Mapper配置文件概述 ##

`UserMapper.xml`  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTAzNTgxNjg_size_16_color_FFFFFF_t_70 7]

## 五、MyBatis核心配置文件概述 ##

### 5.1 MyBatis核心配置文件层级关系 ###

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTAzNTgxNjg_size_16_color_FFFFFF_t_70 8]

### 5.2 properties标签 ###

通过`<properties>`标签加载外部`properties`文件

`resources`下`jdbc.properties`文件：

jdbc.driver=com.mysql.jdbc.Driver
    jdbc.url=jdbc:mysql://localhost:3306/test
    jdbc.username=root
    jdbc.password=root

`sqlMapConfig.xml`中引用并使用：

### 5.3 environments标签 ###

数据库环境的配置，支持多环境配置  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTAzNTgxNjg_size_16_color_FFFFFF_t_70 9]  
其中，事务管理器`（transactionManager）`类型有两种：

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

其中，数据源`（dataSource）`类型有三种：

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

### 5.4 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"/>`

### 5.5 typeAliases标签 ###

类型别名是为`Java`类型设置一个短的名字。原来的类型名称配置如下

<select id="findAll" resultType="com.happy.domain.User">
        select * from User
    </select>

配置`typeAliases`，为`com.happy.domain.User`定义别名为`user`

此时，可以直接使用其别名：

<select id="findAll" resultType=“user">
        select * from User
    </select>

上面我们是自定义的别名，`mybatis`框架已经为我们设置好的一些常用的类型的别名  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTAzNTgxNjg_size_16_color_FFFFFF_t_70 10]

## 六、MyBatis相应API ##

### 6.1 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`中加载资源文件。

### 6.2 SqlSession工厂对象SqlSessionFactory ###

`SqlSessionFactory`有多个方法创建 `SqlSession` 实例。常用的有如下两个：  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTAzNTgxNjg_size_16_color_FFFFFF_t_70 11]

### 6.3 SqlSession会话对象 ###

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

执行语句的方法主要有：

<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()

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTAzNTgxNjg_size_16_color_FFFFFF_t_70]: /images/20221005/c2f522a9ef0e432f84b423fff82e924b.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTAzNTgxNjg_size_16_color_FFFFFF_t_70 1]: /images/20221005/2009162cbee34176b9c5c937c6ace313.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTAzNTgxNjg_size_16_color_FFFFFF_t_70 2]: /images/20221005/8fea8533f8e644aba000fc62e0e0a025.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTAzNTgxNjg_size_16_color_FFFFFF_t_70 3]: /images/20221005/f50a95f6febe474a9e6211f1a46799ff.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTAzNTgxNjg_size_16_color_FFFFFF_t_70 4]: /images/20221005/af6e52805c89447d9df3487536cd5877.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTAzNTgxNjg_size_16_color_FFFFFF_t_70 5]: /images/20221005/c4e81b50918d4be6990b3f397e521e5c.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTAzNTgxNjg_size_16_color_FFFFFF_t_70 6]: /images/20221005/68dfd2f9c13e432486a1053fd7cd1eaa.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTAzNTgxNjg_size_16_color_FFFFFF_t_70 7]: /images/20221005/8b9b132a89594a97a554f601e4292ce7.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTAzNTgxNjg_size_16_color_FFFFFF_t_70 8]: /images/20221005/e99a3b73595245b881e5eb4ac4e60762.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTAzNTgxNjg_size_16_color_FFFFFF_t_70 9]: /images/20221005/5707c6789a2f4751abb276d940d90044.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTAzNTgxNjg_size_16_color_FFFFFF_t_70 10]: /images/20221005/7fa7dce622c74efba41bb57c8e684ede.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTAzNTgxNjg_size_16_color_FFFFFF_t_70 11]: /images/20221005/a507f06b28da476291ea9cf0995dc409.png