【JavaWeb】带你全面了解Mybatis

蔚落 2024-03-31 16:06 96阅读 0赞

![在这里插入图片描述][6d2d3d1668374af294c0cbe93b8470c7.jpeg_pic_center]

*  `推荐学习专栏：`[JavaWeb学习专栏][JavaWeb]

--------------------

#### 文章目录 ####

*   *  1.1 Mybatis概述
     *   *  1.1.1 Mybatis概念
         *  1.1.2 JDBC 缺点
         *  1.1.3 Mybatis 优化
     *  1.2 Mybatis快速入门
     *  1.3 Mapper代理开发
     *   *  1.3.1 Mapper代理开发概述
         *  1.3.2 使用Mapper代理要求
         *  1.3.3 案例代码实现
     *  1.4 核心配置文件
     *   *  1.4.1 多环境配置
         *  1.4.2 类型别名

--------------------

### 1.1 Mybatis概述 ###

#### 1.1.1 Mybatis概念 ####

>  *  MyBatis 是一款优秀的持久层框架，用于简化 JDBC 开发
>  *  MyBatis 本是 Apache 的一个开源项目iBatis, 2010年这个项目由apache software foundation 迁移到了google code，并且改名为MyBatis 。2013年11月迁移到Github
>  *  官网：https://mybatis.org/mybatis-3/zh/index.html

**持久层：**

*  负责将数据到保存到数据库的那一层代码。
    
    以后开发我们会将操作数据库的Java代码作为持久层。而Mybatis就是对jdbc代码进行了封装。
 *  JavaEE三层架构：表现层、业务层、持久层
    
    三层架构在后期会给大家进行讲解，今天先简单的了解下即可。

**框架：**

*  框架就是一个半成品软件，是一套可重用的、通用的、软件基础代码模型
 *  在框架的基础之上构建软件编写更加高效、规范、通用、可扩展

举例给大家简单的解释一下什么是半成品软件。大家小时候应该在公园见过给石膏娃娃涂鸦

![1fa70fdc9e27472398a2327043e380d9.png][]

如下图所示有一个石膏娃娃，这个就是一个半成品。你可以在这个半成品的基础上进行不同颜色的涂鸦

![0f42217f901d471a96ca749a43604405.png][]

了解了什么是Mybatis后，接下来说说以前 `JDBC代码` 的缺点以及Mybatis又是如何解决的。

#### 1.1.2 JDBC 缺点 ####

下面是 JDBC 代码，我们通过该代码分析都存在什么缺点：

![f5223aeea35f49d2a132e1f53bd5b521.png][]

*  硬编码
    
     *  注册驱动、获取连接
        
        上图标1的代码有很多字符串，而这些是连接数据库的四个基本信息，以后如果要将Mysql数据库换成其他的关系型数据库的话，这四个地方都需要修改，如果放在此处就意味着要修改我们的源代码。
     *  SQL语句
        
        上图标2的代码。如果表结构发生变化，SQL语句就要进行更改。这也不方便后期的维护。
 *  操作繁琐
    
     *  手动设置参数
     *  手动封装结果集
        
        上图标4的代码是对查询到的数据进行封装，而这部分代码是没有什么技术含量，而且特别耗费时间的。

#### 1.1.3 Mybatis 优化 ####

*  硬编码可以配置到配置文件
 *  操作繁琐的地方mybatis都自动完成

如图所示

![07aea371eb344ebd88c08589a6e600ca.png][]

下图是持久层框架的使用占比。

![d6600e8c3fd348b48ba2626c9e08eda3.png][]

### 1.2 Mybatis快速入门 ###

**需求：查询user表中所有的数据**

*  创建user表，添加数据
    
        create database mybatis;
        use mybatis;
        
        drop table if exists tb_user;
        
        create table tb_user(
        	id int primary key auto_increment,
        	username varchar(20),
        	password varchar(20),
        	gender char(1),
        	addr varchar(30)
        );
        
        INSERT INTO tb_user VALUES (1, 'zhangsan', '123', '男', '北京');
        INSERT INTO tb_user VALUES (2, '李四', '234', '女', '天津');
        INSERT INTO tb_user VALUES (3, '王五', '11', '男', '西安');
 *  创建模块，导入坐标
    
    在创建好的模块中的 pom.xml 配置文件中添加依赖的坐标
    
        <dependencies>
            
            <dependency>
                <groupId>org.mybatis</groupId>
                <artifactId>mybatis</artifactId>
                <version>3.5.5</version>
            </dependency>
        
            
            <dependency>
                <groupId>mysql</groupId>
                <artifactId>mysql-connector-java</artifactId>
                <version>5.1.46</version>
            </dependency>
        
            
            <dependency>
                <groupId>junit</groupId>
                <artifactId>junit</artifactId>
                <version>4.13</version>
                <scope>test</scope>
            </dependency>
        
            
            <dependency>
                <groupId>org.slf4j</groupId>
                <artifactId>slf4j-api</artifactId>
                <version>1.7.20</version>
            </dependency>
            
            <dependency>
                <groupId>ch.qos.logback</groupId>
                <artifactId>logback-classic</artifactId>
                <version>1.2.3</version>
            </dependency>
            
            <dependency>
                <groupId>ch.qos.logback</groupId>
                <artifactId>logback-core</artifactId>
                <version>1.2.3</version>
            </dependency>
        </dependencies>
    
    注意：需要在项目的 resources 目录下创建logback的配置文件
 *  编写 MyBatis 核心配置文件 – > 替换连接信息 解决硬编码问题
    
    在模块下的 resources 目录下创建mybatis的配置文件 `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>
        
            <typeAliases>
                <package name="com.itheima.pojo"/>
            </typeAliases>
            
            
            <environments default="development">
                <environment id="development">
                    <transactionManager type="JDBC"/>
                    <dataSource type="POOLED">
                        
                        <property name="driver" value="com.mysql.jdbc.Driver"/>
                        <property name="url" value="jdbc:mysql:///mybatis?useSSL=false"/>
                        <property name="username" value="root"/>
                        <property name="password" value="1234"/>
                    </dataSource>
                </environment>
        
                <environment id="test">
                    <transactionManager type="JDBC"/>
                    <dataSource type="POOLED">
                        
                        <property name="driver" value="com.mysql.jdbc.Driver"/>
                        <property name="url" value="jdbc:mysql:///mybatis?useSSL=false"/>
                        <property name="username" value="root"/>
                        <property name="password" value="1234"/>
                    </dataSource>
                </environment>
            </environments>
            <mappers>
               
               <mapper resource="UserMapper.xml"/>
            </mappers>
        </configuration>
 *  编写 SQL 映射文件 --> 统一管理sql语句，解决硬编码问题
    
    在模块的 `resources` 目录下创建映射配置文件 `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="test">
            <select id="selectAll" resultType="com.itheima.pojo.User">
                select * from tb_user;
            </select>
        </mapper>
 *  编码
    
     *  在 `com.itheima.pojo` 包下创建 User类
        
            public class User {
                    
                private int id;
                private String username;
                private String password;
                private String gender;
                private String addr;
                
                //省略了 setter 和 getter
            }
     *  在 `com.itheima` 包下编写 MybatisDemo 测试类
        
            public class MyBatisDemo {
                    
            
                public static void main(String[] args) throws IOException {
                    
                    //1. 加载mybatis的核心配置文件，获取 SqlSessionFactory
                    String resource = "mybatis-config.xml";
                    InputStream inputStream = Resources.getResourceAsStream(resource);
                    SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
            
                    //2. 获取SqlSession对象，用它来执行sql
                    SqlSession sqlSession = sqlSessionFactory.openSession();
                    //3. 执行sql
                    List<User> users = sqlSession.selectList("test.selectAll"); //参数是一个字符串，该字符串必须是映射配置文件的namespace.id
                    System.out.println(users);
                    //4. 释放资源
                    sqlSession.close();
                }
            }

**解决SQL映射文件的警告提示：**

在入门案例映射配置文件中存在报红的情况。问题如下：

![1b8bcdd1bc934b758e72ec48b9d540ba.png][]

*  产生的原因：Idea和数据库没有建立连接，不识别表信息。但是大家一定要记住，它并不影响程序的执行。
 *  解决方式：在Idea中配置MySQL数据库连接。

**IDEA中配置MySQL数据库连接**

*  点击IDEA右边框的 `Database` ，在展开的界面点击 `+` 选择 `Data Source` ，再选择 `MySQL`
    
    ![00a9175215fe4c138564c4d41998a3f3.png][]
 *  在弹出的界面进行基本信息的填写
    
    ![8632083b15f646d6b605fb793ea9b708.png][]
 *  点击完成后就能看到如下界面
    
    ![7cd55c0ad1ff41439f3444a649963fc0.png][]
    
    而此界面就和 `navicat` 工具一样可以进行数据库的操作。也可以编写SQL语句

![1dc8431e973f462fa6c89f3c02e72ab0.png][]

### 1.3 Mapper代理开发 ###

#### 1.3.1 Mapper代理开发概述 ####

之前我们写的代码是基本使用方式，它也存在硬编码的问题，如下：

![9ecff7b2314c441eaaffd2f7a5fce18d.png][]

这里调用 `selectList()` 方法传递的参数是映射配置文件中的 namespace.id值。这样写也不便于后期的维护。如果使用 Mapper 代理方式（如下图）则不存在硬编码问题。

![9d2b3baa0a1243428de1daed095eddd3.png][]

通过上面的描述可以看出 Mapper 代理方式的目的：

*  解决原生方式中的硬编码
 *  简化后期执行SQL

Mybatis 官网也是推荐使用 Mapper 代理的方式。下图是截止官网的图片

![\[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-tvUKXRRk-1670395758457)(assets/image-20210726215339568.png)\]][img-tvUKXRRk-1670395758457_assets_image-20210726215339568.png]

#### 1.3.2 使用Mapper代理要求 ####

使用Mapper代理方式，必须满足以下要求：

*  定义与SQL映射文件同名的Mapper接口，并且将Mapper接口和SQL映射文件放置在同一目录下。如下图：
    
    ![38714f1337af4305840a49f75072a388.png][]
 *  设置SQL映射文件的namespace属性为Mapper接口全限定名
    
    ![ebbd31b6bbab413daf1bb555f98d9336.png][]
 *  在 Mapper 接口中定义方法，方法名就是SQL映射文件中sql语句的id，并保持参数类型和返回值类型一致
    
    ![e499d27dedb8410692971756dad84ce4.png][]

#### 1.3.3 案例代码实现 ####

*  在 `com.itheima.mapper` 包下创建 UserMapper接口，代码如下：
    
        public interface UserMapper {
              
            List<User> selectAll();
            User selectById(int id);
        }
 *  在 `resources` 下创建 `com/itheima/mapper` 目录，并在该目录下创建 UserMapper.xml 映射配置文件
    
        
        <mapper namespace="com.itheima.mapper.UserMapper">
            <select id="selectAll" resultType="com.itheima.pojo.User">
                select *
                from tb_user;
            </select>
        </mapper>
 *  在 `com.itheima` 包下创建 MybatisDemo2 测试类，代码如下：
    
        /**
         * Mybatis 代理开发
         */
        public class MyBatisDemo2 {
              
        
            public static void main(String[] args) throws IOException {
              
        
                //1. 加载mybatis的核心配置文件，获取 SqlSessionFactory
                String resource = "mybatis-config.xml";
                InputStream inputStream = Resources.getResourceAsStream(resource);
                SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
        
                //2. 获取SqlSession对象，用它来执行sql
                SqlSession sqlSession = sqlSessionFactory.openSession();
                //3. 执行sql
                //3.1 获取UserMapper接口的代理对象
                UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
                List<User> users = userMapper.selectAll();
        
                System.out.println(users);
                //4. 释放资源
                sqlSession.close();
            }
        }

注意：

如果Mapper接口名称和SQL映射文件名称相同，并在同一目录下，则可以使用包扫描的方式简化SQL映射文件的加载。也就是将核心配置文件的加载映射配置文件的配置修改为

### 1.4 核心配置文件 ###

核心配置文件中现有的配置之前已经给大家进行了解释，而核心配置文件中还可以配置很多内容。我们可以通过查询官网看可以配置的内容

![8deb9f08dabe4d79829e410a70527261.png][]

接下来我们先对里面的一些配置进行讲解。

#### 1.4.1 多环境配置 ####

在核心配置文件的 `environments` 标签中其实是可以配置多个 `environment` ，使用 `id` 给每段环境起名，在 `environments` 中使用 `default='环境id'` 来指定使用哪儿段配置。我们一般就配置一个 `environment` 即可。

<environments default="development">
        <environment id="development">
            <transactionManager type="JDBC"/>
            <dataSource type="POOLED">
                
                <property name="driver" value="com.mysql.jdbc.Driver"/>
                <property name="url" value="jdbc:mysql:///mybatis?useSSL=false"/>
                <property name="username" value="root"/>
                <property name="password" value="1234"/>
            </dataSource>
        </environment>
    
        <environment id="test">
            <transactionManager type="JDBC"/>
            <dataSource type="POOLED">
                
                <property name="driver" value="com.mysql.jdbc.Driver"/>
                <property name="url" value="jdbc:mysql:///mybatis?useSSL=false"/>
                <property name="username" value="root"/>
                <property name="password" value="1234"/>
            </dataSource>
        </environment>
    </environments>=

#### 1.4.2 类型别名 ####

在映射配置文件中的 `resultType` 属性需要配置数据封装的类型（类的全限定名）。而每次这样写是特别麻烦的，Mybatis 提供了 `类型别名`(typeAliases) 可以简化这部分的书写。

首先需要现在核心配置文件中配置类型别名，也就意味着给pojo包下所有的类起了别名（别名就是类名），不区分大小写。内容如下：

通过上述的配置，我们就可以简化映射配置文件中 `resultType` 属性值的编写

<mapper namespace="com.itheima.mapper.UserMapper">
        <select id="selectAll" resultType="user">
            select * from tb_user;
        </select>
    </mapper>

[6d2d3d1668374af294c0cbe93b8470c7.jpeg_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/31/fddc2afe085841e89843f9b4558fbe4e.jpeg
[JavaWeb]: https://blog.csdn.net/csdn_anhl/category_12037534.html?spm=1001.2014.3001.5482
[1fa70fdc9e27472398a2327043e380d9.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/31/2d5dd9c1c3ec4d03891f197398a1dadb.png
[0f42217f901d471a96ca749a43604405.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/31/013f23338a3f469c9361ca65e5507f33.png
[f5223aeea35f49d2a132e1f53bd5b521.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/31/6234d7ea3f664f5c8780d1a6fc2e4290.png
[07aea371eb344ebd88c08589a6e600ca.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/31/fdbb05ca2c0144a292e77557e1f9d0fd.png
[d6600e8c3fd348b48ba2626c9e08eda3.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/31/f3fe3e7b51b446bd924f6df93bc735c8.png
[1b8bcdd1bc934b758e72ec48b9d540ba.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/31/03499fc1b7984ecdbdf1fdfab0d0b267.png
[00a9175215fe4c138564c4d41998a3f3.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/31/da3a861c7b6f4d4b938f9af2c225fcee.png
[8632083b15f646d6b605fb793ea9b708.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/31/5405f0d59ae243bab1ee3591b0835f4b.png
[7cd55c0ad1ff41439f3444a649963fc0.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/31/d9b3a60c32954aa68eb641d5a49e585a.png
[1dc8431e973f462fa6c89f3c02e72ab0.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/31/42f2614c98c941099cc77970261692f6.png
[9ecff7b2314c441eaaffd2f7a5fce18d.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/31/3185ab81e3ce42bab66950feae01eec9.png
[9d2b3baa0a1243428de1daed095eddd3.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/31/781e73fb3487408aba34a66af57b68d3.png
[img-tvUKXRRk-1670395758457_assets_image-20210726215339568.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/31/064c6721185547be8fcbe8ec4693e71f.png
[38714f1337af4305840a49f75072a388.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/31/e3fae3415eb14d03a900cf9e0e217b7f.png
[ebbd31b6bbab413daf1bb555f98d9336.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/31/5993587706a14630b9341325d8e2c39f.png
[e499d27dedb8410692971756dad84ce4.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/31/cf8fa6322b49417abe0f041e8762236a.png
[8deb9f08dabe4d79829e410a70527261.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/31/b00e30d131bd4f568c14e1786fc9033c.png