什么是MyBatis

古城微笑少年丶 2023-09-23 22:30 60阅读 0赞

## 一、MyBatis概述 ##

### 1.1 原始的JDBC操作 ###

谈及mybatis，必然需要先了解Java和数据库的连接技术——JDBC(Java DataBase Connectivity)。但是原始JDBC操作中，却存在如下**缺点**：

1.  *数据库连接创建、释放频繁造成****系统资源浪费****从而影响系统性能。*

1.  *sql语句在代码中硬编译，造成代码****不易维护****，实际应用sql变化的可能较大，sql变动需要改变Java代码。*

1.  *查询操作时，需要****手动****将结果集中的数据手动封装到实体中；插入操作时，需要****手动****将实体的数据设置到sql语句的占位符位置。*

如下为原始JDBC操作：

public class JDBCDemo {
        public static void main(String[] args) throws Exception{
            //获取数据库连接对象
            Connection conn = DriverManager.getConnection("jdbc:mysql://localhost:3306/db1","root","root");
            //定义sql语句
            String sql = "select * from db1.emp";
            //获取执行sql的对象Statement
            Statement stmt = conn.createStatement();
            //执行sql
            ResultSet resultSet = stmt.executeQuery(sql);
            //处理结果
            while(resultSet.next()) {             
                int id = resultSet.getInt(1);                    //获取id
                String name = resultSet.getString("ename");             //获取姓名
                System.out.println("id:" + id + " name:" + name);
            }
            //释放资源
            stmt.close();
            conn.close();
        }
    }

### 1.2 如何克服JDBC固有缺陷 ###

而面对上述缺点，我们的**解决方案**是：

1.  *使用数据库****连接池****技术（C3P0或者Druid）初始化连接资源；*

1.  *将sql语句抽取到****xml配置文件****中（解耦合）；*

1.  *使用反射、内省等底层技术，自动将实体与表进行属性与字段的****自动映射****（比较困难）。*

因此，mybatis应运而生！

### 1.3 什么是MyBatis ###

**mybatis** 是一个优秀的基于java的持久层框架，它内部封装了 jdbc，使开发者只需要关注sql语句本身，而不需要花费精力 去处理加载驱动、创建连接、创建statement等繁杂的过程。

**mybatis**通过xml或注解的方式将要执行的各种 statement配 置起来，并通过java对象和statement中sql的动态参数进行 映射生成最终执行的sql语句。

最后**mybatis**框架执行sql并将结果映射为java对象并返回。采 用ORM思想解决了实体和数据库映射的问题，对jdbc 进行了 封装，屏蔽了jdbc api 底层访问细节，使我们不用与jdbc api 打交道，就可以完成对数据库的持久化操作 。

## 二、MyBatis传统开发步骤 ##

首先，我们可以先访问一下MyBatis官网地址：[http://www.mybatis.org/mybatis-3/][http_www.mybatis.org_mybatis-3]，这里有完整的mybatis的介绍。

![bdb11abd8946401290a40cac202c7314.png][]

### 2.1 添加MyBatis的坐标 ###

把mysql和mybatis的坐标引入pom.xml中。

<dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <version>5.1.32</version>
    </dependency>
    <dependency>
        <groupId>org.mybatis</groupId>
        <artifactId>mybatis</artifactId>
        <version>3.5.7</version>
    </dependency>

### 2.2 创建一个实体 ###

在项目下创建一个**User.java**的实体。

public class User {
        private int id;
        private String username;
        private String password;
    
        public int getId() {
            return id;
        }
    
        public void setId(int id) {
            this.id = id;
        }
    
        public String getUsername() {
            return username;
        }
    
        public void setUsername(String username) {
            this.username = username;
        }
    
        public String getPassword() {
            return password;
        }
    
        public void setPassword(String password) {
            this.password = password;
        }
    
        @Override
        public String toString() {
            return "User{" +
                    "id=" + id +
                    ", username='" + username + '\'' +
                    ", password='" + password + '\'' +
                    '}';
        }
    }

### 2.3 编写映射文件 ###

在文件夹resources下再创建一个mapper文件夹，再创建映射文件**UserMapper.xml。**后续我们的sql语句可以全部写到这里。

#### 2.3.1先写一个通用的dtd约束头 ####

<?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">

#### 2.3.2 再配置mapper ####

这里是select子句，当然也可以时insert、update等等。

<mapper namespace="userMapper">
        <select id="findAll" resultType="user">
            select * from db1.user
        </select>
    </mapper>

*  **namespace：**命名空间。起名可以随意。例如使用时我们可以用**userMapper.findAll**来使用对应的select语句。

*  **resultType**：结果类型。从数据库查询到的数据封装到哪个位置。例如我们这里的select子句查询到的结果要封装到User实体集中，但是这里用user而不适用domain.User是因为在接下来的核心配置文件**SqlMapConfig.xml**中我们通过typeAliases标签将domain.User更名为user。

注意：这里必须先要有一个user数据库表。

### 2.4 编写核心文件 ###

#### 2.4.1 核心配置文件**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>
        
        <properties resource="jdbc.properties"/>
        
        <typeAliases>
            <typeAlias type="domain.User" alias="user"/>
        </typeAliases>
        
        <environments default="developement">
            <environment id="developement">
                <transactionManager type="JDBC"/>
                <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>
        
        <mappers>
            <mapper resource="mapper/UserMapper.xml"/>
        </mappers>
    </configuration>

![2bb447f9fdbd49f687b1738014154efa.png][]

*  **typeAliases：**设置类型别名。比如这里我们使用自己定义的user更换本来的domain.User。所以在**UserMapper.xml**中我们就可以把sql语句中的resultType字段写成“user”。但是mybatis本身也为我们提供了一些别名来方便简写，如下：

<table style="table-layout:fixed;width:28px;"> 
 <tbody> 
  <tr> 
   <td style="width:184px;vertical-align:top;height:52px;"><p style="">别名</p></td> 
   <td style="width:230px;vertical-align:top;height:52px;"><p style="">数据类型</p></td> 
  </tr> 
  <tr> 
   <td style="width:184px;vertical-align:top;height:52px;"><p style="">string</p></td> 
   <td style="width:230px;vertical-align:top;height:52px;"><p style="">java.lang.String</p></td> 
  </tr> 
  <tr> 
   <td style="width:184px;vertical-align:top;height:52px;"><p style="">long</p></td> 
   <td style="width:230px;vertical-align:top;height:52px;"><p style="">java.lang.Long</p></td> 
  </tr> 
  <tr> 
   <td style="width:184px;vertical-align:top;height:52px;"><p style="">java</p></td> 
   <td style="width:230px;vertical-align:top;height:52px;"><p style="">java.lang.Integer</p></td> 
  </tr> 
  <tr> 
   <td style="width:184px;vertical-align:top;height:52px;"><p style="">double</p></td> 
   <td style="width:230px;vertical-align:top;height:52px;"><p style="">java.lang.Double</p></td> 
  </tr> 
  <tr> 
   <td style="width:184px;vertical-align:top;height:52px;"><p style="">boolean</p></td> 
   <td style="width:230px;vertical-align:top;height:52px;"><p style="">java.lang.Boolean</p></td> 
  </tr> 
 </tbody> 
</table>

而后期我们在执行更新操作时，就可以直接使用parameterType="int" 而不是 parameterType="java.lang.Integer"，比如：

<update id="update" parameterType="int">
    update user set username=#{username},password=#{password} where id=#{id}
    </update>

*  **transactionManager**：事务管理器。取值有两种，JDBC和MANAGED，这里我们使用JDBC。

*  **dataSource**：数据源。取值有三种，UNPOOLED、POOLED和JNDI，这里我们使用POOLED，利用“池”的概念将 JDBC 连接对象组织起来。

*  **property**：配置数据库连接池的属性。这里使用了jdbc.properties来简化书写，当然也可以直接写。

*  **mappers：**用来加载映射，加载方式有如下几种：

• 使用相对于类路径的资源引用，例如：

• 使用完全限定资源定位符（URL），例如：

• 使用映射器接口实现类的完全限定类名，例如：

• 将包内的映射器接口实现全部注册为映射器，例如：

#### 2.4.2 配置文件jdbc.properties ####

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

### 2.5 测试 ###

#### 2.5.1 编写测试代码 ####

/**
     * 查询
     * @throws IOException
     */
    @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();
    }

*  **SqlSessionFactoryBuilder ：**工厂构建器。通过加载mybatis的核心文件的输入流的形式构建一个SqlSessionFactory对象 。

*  **SqlSessionFactory：**工厂对象 ，用来创建sql会话。openSession( )会默认开启一个事务，但事务不会自动提交，也就意味着需要手动提 交该事务，更新操作数据才会持久化到数据库中 。如果里面传一个参数为true，那么不需要手动提交事务（更新操作中sqlSession.commit()方法就不需要写了）。

*  **SqlSession ：**会话对象。执行接下来的增删改查操作。

#### 2.5.2 代码要点 ####

这里我们可以看到，查询数据的一段java代码为：

List<User> userList = sqlSession.selectList("userMapper.findAll");

而这句代码中sqlSession.selectList的参数即我们刚才在**UserMapper.xml** 中写的代码：

<mapper namespace="userMapper">
        <select id="findAll" resultType="user">
            select * from db1.user
        </select>
    </mapper>

同理，我们也可以同样得到添加数据、修改数据和删除数据类似的代码：

*  添加数据：

sqlSession.insert("userMapper.add", user);

<insert id="add" parameterType="快速入门.User">
    insert into user values(#{id},#{username},#{password})
    </insert>

*  修改数据

sqlSession.update("userMapper.update", user);

<update id="update" parameterType="快速入门.User">
    update user set username=#{username},password=#{password} where id=#{id}
    </update>

*  删除数据

sqlSession.delete("userMapper.delete",3);

<delete id="delete" parameterType="快速入门.User">
    delete from user where id=#{id}
    </delete>

#### 2.5.3 输出结果 ####

执行编写好的代码，可以看到输出结果：

![8cb7146b60d4420a94fd924fb7cddbaa.png][]

上面被选中的输出语句为：

[User{id=1, username='zhangsan', password='123'}, User{id=2, username='lisi', password='234'}, User{id=5, username='wangwu', password='abc'}, User{id=6, username='ray', password='111'}]

而我们再看一下数据库当中的数据，判断是否输出正常：

![90958a0462d441dbbbbb4e3bd8dcfd94.png][]

这里我们可以看到，一共4条数据，数据库中的数据已经被我们成功查找到。

## 三、总结 ##

原来直接使用JDBC的sql代码被我们写入到了映射文件**UserMapper.xml**中，后续一些动态sql的加入更加简化了xml中代码量的书写。

而在Java代码中，我们只需要新建一些SqlSession对象便可以将xml中的sql语句直接使用。耦合度大大降低

但是我们也不难发现，这样的配置还是相对复杂的，因此就有了后来的**MyBatisPlus**来更加简化我们的代码书写。

[http_www.mybatis.org_mybatis-3]: http://www.mybatis.org/mybatis-3/
[bdb11abd8946401290a40cac202c7314.png]: https://img-blog.csdnimg.cn/img_convert/bdb11abd8946401290a40cac202c7314.png
[2bb447f9fdbd49f687b1738014154efa.png]: https://img-blog.csdnimg.cn/img_convert/2bb447f9fdbd49f687b1738014154efa.png
[8cb7146b60d4420a94fd924fb7cddbaa.png]: https://img-blog.csdnimg.cn/img_convert/8cb7146b60d4420a94fd924fb7cddbaa.png
[90958a0462d441dbbbbb4e3bd8dcfd94.png]: https://img-blog.csdnimg.cn/img_convert/90958a0462d441dbbbbb4e3bd8dcfd94.png