手把手带你入门MyBatis

手把手带你入门MyBatis

一、MyBatis简介

1、MyBatis历史(参考百度百科-MyBatis)

MyBatis本是apache的一个开源项目iBatis，2010年这个项目由apache software foundation迁移到了google code，并且由IBatis3.x改名为MyBatis。2013年11月迁移到Github。

iBATIS一词来源于“internet”和“abatis”的组合，是一个基于Java的持久层框架。iBATIS提供的持久层框架包括SQL Maps和Data Access Objects（DAOs）。

2、MyBatis特性

• 是支持定制化SQL、存储过程以及高级映射的优秀持久层框架
• 避免了几乎所有的JDBC代码和手动设置参数以及获取结果集
• 可以使用简单的XML或注解用于配置和原始映射，将接口和Java的POJO(Plain Old Java Objects,普通的Java对象)映射成数据库中的记录
• 是一个半自动的ORM(Object Relation Mapping)框架

3、功能架构

分为三层：

• API接口层：提供给外部使用的接口API，开发人员通过这些本地API来操纵数据库。接口层一接收到调用请求就会调用数据处理层来完成具体的数据处理。

• 数据处理层：负责具体的SQL查找、SQL解析、SQL执行和执行结果映射处理等。它主要的目的是根据调用的请求完成一次数据库操作。

• 基础支撑层：负责最基础的功能支撑，包括连接管理、事务管理、配置加载和缓存处理，这些都是共用的东西，将他们抽取出来作为最基础的组件。为上层的数据处理层提供最基础的支撑。

4、MyBatis下载

MyBatis下载地址

5、和其他持久化层技术对比

• JDBC
  • SQL夹杂在Java代码中耦合度高，导致硬编码内伤
  • 维护不易且实际开发需求中SQL有变化，频繁修改的情况多见
  • 代码冗长，开发效率低
• Hibernate和JPA
  • 操作简单，开发效率高
  • 程序中的长难复杂SQL需要绕过框架
  • 内部自动生成SQL不容易做特殊优化
  • 基于全映射的自动框架，大量字段的POJO进行部分映射是比较困难
  • 反射操作太多，导致数据库性能下降
• MyBatis
  • 轻量级，性能出色
  • SQL和Java编码分开，功能边界清晰。Java代码专注业务、SQL语句专注数据
  • 开发效率稍逊于Hibernate，但是完全能够接收

二、搭建MyBatis

1、开发环境

IDE：idea 2021.3

构建工具：maven3.8.1

MySQL版本：8.0.28

MyBatis：3.5.10

2、创建maven工程

3、引入依赖

在pom.xml中导入需要的依赖

<dependencies>
    <dependency>
        <groupId>org.mybatis</groupId>
        <artifactId>mybatis</artifactId>
        <version>3.5.10</version>
    </dependency>
    <dependency>
        <groupId>junit</groupId>
        <artifactId>junit</artifactId>
        <version>4.12</version>
        <scope>test</scope>
    </dependency>
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <version>8.0.28</version>
    </dependency>
</dependencies>

4、创建MyBatis的核心配置文件

MyBatis的核心配置文件无默认名字，习惯上命名为mybatis-config.xml，并非强制要求，将来使用SSM整合框架时这个配置文件可以省略，都会被交给Spring管理。

• 核心配置文件主要用于配置连接数据库的环境以及Mybatis的全局配置信息
• 核心配置文件存放的目录是src/main/resources

在里面写上从官方文档中找到的如下内容

<?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="${driver}"/>
                <property name="url" value="${url}"/>
                <property name="username" value="${username}"/>
                <property name="password" value="${password}"/>
            </dataSource>
        </environment>
    </environments>
    <!--引入映射文件-->
    <mappers>
        <mapper resource="org/mybatis/example/BlogMapper.xml"/>
    </mappers>
</configuration>

**注意：**以下四个标签中是需要填入你自己的数据库信息的

<property name="driver" value="${driver}"/>
<property name="url" value="${url}"/>
<property name="username" value="${username}"/>
<property name="password" value="${password}"/>

这是我的数据库信息，密码我就不贴上去了

<property name="driver" value="com.mysql.cj.jdbc.Driver"/>
<property name="url" value="jdbc:mysql://localhost:3306/mybatis"/>
<property name="username" value="root"/>
<property name="password" value=""/>

另外，其实斜面还有一个引入映射文件的操作，由于我目前还没有创建，所以还是保留官方文档内容，后面会创建一个映射文件并引入。

5、创建mapper接口

MyBatis中的mapper接口相当于以前的dao，但区别在于，mapper仅仅是接口，并不需要我们手动提供实现类。

1>在数据库中建个t_user表，以下是t_user表的结构

2>根据表结构创建实体类，并写上有参构造、无参构造、Setter、Getter和toString

public class User {
    private Integer id;
    private String username;
    private String password;
    private Integer age;
    private String sex;
    private String email;

    @Override
    public String toString() {
        return "User{" +
                "id=" + id +
                ", username='" + username + '\'' +
                ", password='" + password + '\'' +
                ", age=" + age +
                ", sex='" + sex + '\'' +
                ", email='" + email + '\'' +
                '}';
    }

    public Integer getId() {
        return id;
    }

    public void setId(Integer 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;
    }

    public Integer getAge() {
        return age;
    }

    public void setAge(Integer age) {
        this.age = age;
    }

    public String getSex() {
        return sex;
    }

    public void setSex(String sex) {
        this.sex = sex;
    }

    public String getEmail() {
        return email;
    }

    public void setEmail(String email) {
        this.email = email;
    }

    public User() {
    }

    public User(Integer id, String username, String password, Integer age, String sex, String email) {
        this.id = id;
        this.username = username;
        this.password = password;
        this.age = age;
        this.sex = sex;
        this.email = email;
    }
}

3>创建一个UserMapper接口

public interface UserMapper {
    /**
     * 添加用户信息
     */
    int insertUser();
}

6、创建MyBatis的映射文件

• 相关概念：ORM（Object Relationship Mapping）对象关系映射。
  • 对象：Java的实体类对象
  • 关系：关系型数据库
  • 映射：二者之间的对应关系

Java概念	数据库概念
类	表
属性	字段/列
对象	记录/行

• 映射文件的命名规则
  • 表所对应的实体类的类名+Mapper.xml
  • 例如：表t_user，映射的实体类为User，所对应的映射文件为UserMapper.xml
  • 因此一个映射文件对应一个实体类，对应一张表的操作
  • MyBatis映射文件用于编写SQL，访问以及操作表中的数据
• MyBatis中可以面向接口操作数据，要保证两个一致
  • mapper接口的全类名和映射文件的命名空间（namespace）保持一致
  • mapper接口中方法的方法名和映射文件中编写SQL的标签的id属性保持一致

下面这一段是官方文档上的mapper映射文件的示例

<?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="org.mybatis.example.BlogMapper">
    <select id="selectBlog" resultType="Blog">
        select * from Blog where id = #{id}
    </select>
</mapper>

我们把select标签先删除然后敲个左尖括号看代码提示，可以看到标签对应的增删改查，由此可知这个标签就是用来定义SQL语句的

这里是上面提到的两个一致**(最重要)**

这里我写的是insertUser()方法所以我映射文件中就是这个方法对应的SQL语句

<mapper namespace="mybatis.mapper.UserMapper">
    <insert id="insertUser">
        insert into t_user values(null,'admin','123456',23,'男','123456@qq.com')
    </insert>
</mapper>

**需要注意的是：**表–实体类–mapper接口–映射文件之间的对应关系

7、回到核心配置文件中引入映射文件

这是我的映射文件位置

<mappers>
    <mapper resource="mappers/UserMapper.xml"/>
</mappers>

8、通过junit测试功能

到这里我的第一个MyBatisDemo就搭建好了，下面测试一下

• SqlSession：代表Java程序和数据库之间的会话。（HttpSession是Java程序和浏览器之间的会话）
• SqlSessionFactory：是“生产”SqlSession的“工厂”
• 工厂模式：如果创建某一个对象，使用的过程基本固定，那么我们就可以把创建这个对象的相关代码封装到一个“工厂类”中，以后都使用这个工厂类来“生产”我们需要的对象

public class MyBatisTest {
    @Test
    public void testMyBatis() throws IOException {
        //加载核心配置文件
        InputStream is =  Resources.getResourceAsStream("mybatis-config.xml");
        
        //获取SqlSessionFactoryBuilder
        SqlSessionFactoryBuilder sqlSessionFactoryBuilder = new SqlSessionFactoryBuilder();
        
        //获取SqlSessionFactory
        SqlSessionFactory sqlSessionFactory = sqlSessionFactoryBuilder.build(is);
        
        //获取MyBatis操作数据库的会话对象SqlSession
        SqlSession sqlSession = sqlSessionFactory.openSession();
        
        //获取SqlSession的同时设置事务自动提交
        //SqlSession sqlSession = sqlSessionFactory.openSession(true);
        
        //获取mapper接口对象,getMapper方法底层使用的是代理模式，返回接口对应实现类的对象
        UserMapper mapper = sqlSession.getMapper(UserMapper.class);
        
        //测试功能
        int result = mapper.insertUser();
        System.out.println("result:"+result);
        
        //最后提交事务，就可以成功写入数据库了
        sqlSession.commit();
    }
}

注意：

• MyBatis使用的是jdbc最原始的事务管理器，默认是手动提交事务，所以最后需要调用sqlSession.commit()来手动提交事务，才会将事务操作写入数据库。
• 只要你插入了一条记录，那么无论你最终有没有手动提交事务，该id都将被占用。
• 如果想要开启事务自动提交，需要在sqlSessionFactory.openSession()方法里传入一个参数true，那么该项事务就会自动提交。

9、加入log4j日志功能

1>添加依赖

<!-- log4j日志 -->
<dependency>
    <groupId>log4j</groupId>
    <artifactId>log4j</artifactId>
    <version>1.2.17</version>
</dependency>

2>加入log4j的配置文件

• log4j的配置文件名为log4j.xml，存放的位置是src/main/resources目录下
• 日志的级别：FATAL(致命)>ERROR(错误)>WARN(警告)>INFO(信息)>DEBUG(调试) 从左到右打印的内容越来越详细

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">
<log4j:configuration xmlns:log4j="http://jakarta.apache.org/log4j/">
    <appender name="STDOUT" class="org.apache.log4j.ConsoleAppender">
        <param name="Encoding" value="UTF-8" />
        <layout class="org.apache.log4j.PatternLayout">
            <param name="ConversionPattern" value="%-5p %d{MM-dd HH:mm:ss,SSS} %m (%F:%L) \n" />
        </layout>
    </appender>
    <logger name="java.sql">
        <level value="debug" />
    </logger>
    <logger name="org.apache.ibatis">
        <level value="info" />
    </logger>
    <root>
        <level value="debug" />
        <appender-ref ref="STDOUT" />
    </root>
</log4j:configuration>