MyBatis教程（持续更新）

一.全面了解Mybatis 环境变量

• jdk 8 +
• MySQL 8.0.27
• maven-3.6.1
• IDEA 2021.2.2

学习前需要掌握：

• JDBC
• MySQL
• Java基础
• Maven
• Junit（单元测试）

什么是MyBatis

• Myba是一款优秀的持久层框架
• MyBatis 避免了几乎所有的 JDBC 代码和手动设置参数以及获取结果集的过程，减少了代码的冗余，减少程序员的操作。
• MyBatis 可以使用简单的 XML 或注解来配置和映射原生信息，将接口和 Java 的 实体类 【Plain Old Java Objects,普通的 Java对象】映射成数据库中的记录。
• MyBatis原来是apache的一个开源项目，叫做ibatis，2010年这个项目由apache迁移到了google code，并且改名为MyBatis
• 2013年11月官方代码迁移到GitHub
• MyBatis中文文档：https://mybatis.net.cn/
• GitHub：https://github.com/mybatis/mybatis-3

持久化

持久化是将程序数据在持久状态和瞬时状态间转换的机制。（理解一下这个持久状态转化为瞬时状态，持久化是mybatis最重要的特性）

• 即把数据（如内存中的对象）保存到可永久保存的存储设备中（如磁盘）。持久化的主要应用是将内存中的对象存储在数据库中，或者存储在磁盘文件中、XML数据文件中等等。
• JDBC就是一种持久化机制。文件IO也是一种持久化机制。

为什么需要持久化服务？

• 内存断点后数据会丢失，但是有些业务不允许这种情况的存在
• 比起硬盘，内存过于昂贵，如果有够量的内存，则不需要持久化服务，但是正是因为内存太贵，储存有限，因此需要持久化来缓存

持久层

• 持久层，顾名思义是完成持久化工作的代码块，也就是Date Access Object（Dao层）
• 大多数情况下特别是企业级应用，数据持久化往往也就意味着将内存中的数据保存到磁盘上加以固化，而持久化的实现过程则大多通过各种关系数据库来完成。
• 不过这里有一个字需要特别强调，也就是所谓的“层”。对于应用系统而言，数据持久功能大多是必不可少的组成部分。也就是说，我们的系统中，已经天然的具备了“持久层”概念？也许是，但也许实际情况并非如此。之所以要独立出一个“持久层”的概念,而不是“持久模块”，“持久单元”，也就意味着，我们的系统架构中，应该有一个相对独立的逻辑层面，专注于数据持久化逻辑的实现.
• 与系统其他部分相对而言，这个层面应该具有一个较为清晰和严格的逻辑边界。（也就是改层就是为了操作数据库而设计的）

Mybatis的作用

• Mybatis就是帮助程序员将数据存取到数据库里面。
• 传统的jdbc操作 , 有很多重复代码块 .比如 : 数据取出时的封装 , 数据库的建立连接等等… , 通过框架可以减少重复代码,提高开发效率 .
• MyBatis 是一个半自动化的ORM框架 (Object Relationship Mapping) -->对象关系映射
• 所有的事情，不用Mybatis依旧可以做到，只是用了它，会更加方便更加简单，开发更快速。

MyBatis的优点

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

二.第一个程序MyBatis 思路：搭建环境–>导入Mybatis–>编写代码–>测试

• 1.创建Maven项目,File–>New–>Project 然后按照下图步骤，再输入项目名称，一路next即可
  
• 2.搭建数据库，sql脚本，直接在数据库中运行即可

CREATE DATABASE `mybatis`;

USE `mybatis`;

DROp TABLE IF EXISTS `user`;

CREATE TABLE `user` (
`id` int(20) NOT NULL,
`name` varchar(30) DEFAULT NULL,
`pwd` varchar(30) DEFAULT NULL,
PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8;

insert  into `user`(`id`,`name`,`pwd`) values (1,'阿渌','123456'),(2,'张三','abcdef'),(3,'李四','987654');

• 3.导入MyBatis相关jar包，导入到pom.xml文件里面

    

        
            mysql
            mysql-connector-java
            8.0.26
        
        
        
            org.mybatis
            mybatis
            3.5.2
        
        
        
            junit
            junit
            4.12
        
    
    
        
            
                src/main/java
                
                    ***.xml
                
                false
            
            
                src/main/resources
                
                    ***.xml
                
                false
            
        
    

• 4.编写Mybatis核心配置文件，在resources下创建mybatis-config.xml文件，配置自己的数据库地址、名字、密码以及mysql驱动

• 5.将工程目录按照层划分
  
• 6.编写MyBatis工具类 在文件夹utils下新建–>MybatisUtils.class文件,编写代码如下

package com.daimalu.utils;

import org.apache.ibatis.io.Resources;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;
import java.io.IOException;
import java.io.InputStream;

//sqlSessionFactory -->sqlSession
public class MybatisUtils {

    private static SqlSessionFactory sqlSessionFactory;
    //使用mybatis第一步，获取sqlSessionFactory对象
    static {
        try {
            String resource = "mybatis-config.xml";
            InputStream inputStream = Resources.getResourceAsStream(resource);
            sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
        } catch (IOException e) {
            e.printStackTrace();
        }
    }

    //既然有了sqlSessionFactory,顾名思义，我们就可以从中获得sqlSession的实例了
    //sqlSession 完全包含了面向数据库执行SQL命令所需的所有方法
    public static SqlSession getSqlSession(){
        return sqlSessionFactory.openSession();
    }

}

• 7 创建实体类，在文件夹User下创建 User.class文件,编写代码如下

package com.daimalu.pojo;

public class User {

    private int id;  //id
    private String name;   //姓名
    private String pwd;   //密码

    public User(){

    }
    public User(int id, String name, String pwd) {
        this.id = id;
        this.name = name;
        this.pwd = pwd;
    }

    public int getId() {
        return id;
    }

    public void setId(int id) {
        this.id = id;
    }

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public String getPwd() {
        return pwd;
    }

    public void setPwd(String pwd) {
        this.pwd = pwd;
    }

    @Override
    public String toString() {
        return "User{" +
                "id=" + id +
                ", name='" + name + ''' +
                ", pwd='" + pwd + ''' +
                '}';
    }
}

• 8 编写Mapper接口类，在文件夹dao下创建 UserDao.interface文件,编写代码如下

package com.daimalu.dao;

import com.daimalu.pojo.User;

import java.util.List;

public interface UserDao {
    List getUserList();
}

• 9 编写Mapper.xml配置文件，在文件夹dao下创建 UserMapper.xml文件,编写代码如下

    
    
        select * from mybatis.user
    

 
10 此时记得要将刚才的UserMapper.xml注册到mybatis-config.xml文件中，非常重要，此后每编写一个Mapper.xm文件都要注册一次！！！，在mybatis-config.xml文件更新为如下代码
 




    
        
            
            
                
                
                
                
            
        
    

    
        
    

 
11.编写测试类，测试代码。在test–>java–>com–>daimalu–>dao下创建UserDaoTest.class文件，编写代码如下
 
package com.daimalu.dao;

import com.daimalu.pojo.User;
import com.daimalu.utils.MybatisUtils;
import org.apache.ibatis.session.SqlSession;
import org.junit.Test;

import java.util.List;

public class UserDaoTest {
    //第一步：获得sqlSession对象
    SqlSession sqlSession;
    @Test
    public void test(){
        try {

            sqlSession = MybatisUtils.getSqlSession();
            //方式一：getMapper
            UserDao mapper = sqlSession.getMapper(UserDao.class);
            List userList = mapper.getUserList();
            for (User user : userList) {
                System.out.println(user);
            }
        }catch (Exception e){
            e.printStackTrace();
        }finally {

            //关闭sqlSession
            sqlSession.close();
        }

    }
}

 
运行结果，测试成功！！！
 
 
三.配置解析 
1.核心配置文件 
mybatis-config.xml
 
 
2.环境配置（environments） 
Mybatis可以配置成多种环境，但是每个sqlSessionFactory实例只能选择一种环境如图，有环境development和test，默认是development环境
 
 mybatis默认的事务管理器就是JDBC（事务管理器有多种），连接池：POOLED
 
3.属性（properties） 
可以通过properties属性来实现引用配置文件
 这些属性可以在外部进行配置，并可以进行动态替换。你既可以在典型的 Java 属性文件中配置这些属性，也可以在 properties 元素的子元素中设置（即db.properties）
 db.properties
 
driver=com.mysql.cj.jdbc.Driver
url=jdbc:mysql://localhost:3306/mybatis?useSSl=trur&sueUnicode=true&characterEncoding=UTF-8&serverTimezone=Asia/Shanghai
username=root
password=root
 
在核心配置文件中引入
 
 注意：如果一个属性在不只一个地方进行了配置，那么，MyBatis 将按照下面的顺序来加载：
 
1.首先读取在 properties 元素体内指定的属性。
 2.然后根据 properties 元素中的 resource 属性读取类路径下属性文件，或根据 url 属性指定的路径读取属性文件，并覆盖之前读取过的同名属性。
 3.最后读取作为方法参数传递的属性，并覆盖之前读取过的同名属性。
 因此，通过方法参数传递的属性具有最高优先级，resource/url 属性中指定的配置文件次之，最低优先级的则是 properties 元素中指定的属性。
 
四.类型别名 
类型别名可为 Java 类型设置一个缩写名字。 它仅用于 XML 配置
意在降低冗余的全限定类名书写
 
1.可以给实体类起别名
 
    
    
        
    
 
    
        select * from mybatis.user
    

2.也可以指定一个包名，MyBatis 会在包名下面搜索需要的 Java Bean,每一个在包 com.daimalu.pojo 中的 Java Bean，在没有注解的情况下，会使用 Bean 的首字母小写的非限定类名来作为它的别名

总结：在实体类比较少的时候，使用第一种方式，如果实体类很多，建议使用第二种，第一种可以diy（自定义）别名；第二种则不行，第二种如果非要改，则需要在尸体上增加注解

@Alias("othername")
public class User{}

五.设置

这是 MyBatis 中极为重要的调整设置，它们会改变 MyBatis 的运行时行为

六.其他设置（基本不用了解）

plugins插件
1.mybatis-generator-core
2.mybatis-plus
3.通用mapper

七.映射器（Mapper）

方式一：

方式二：使用class文件注册

注意：
1.接口和他的Mapper配置文件必须同名
2.接口和他的Mapper配置文件必须在同一个包下
方式三：使用包扫描注册

注意：
1.接口和他的Mapper配置文件必须同名
2.接口和他的Mapper配置文件必须在同一个包下

八.生命周期和作用域

生命周期、作用域是至关重要的，因为错误的使用会导致非常严重的并发问题

• SqlSessionFactoryBuilder
  1.这个类可以被实例化、使用和丢弃，一旦创建了 SqlSessionFactory，就不再需要它了
  2.局部变量
  SqlSessionFactory
  1.可以想象成连接池
  2.SqlSessionFactory 一旦被创建就应该在应用的运行期间一直存在，没有任何理由丢弃它或重新创建另一个实例
  3.SqlSessionFactory的最佳作用域是应用作用域
  4.最简单的就是使用单例模式或者静态单例模式

SqlSession
1.连接到的一个请求，可以想象成数据库连接池中的一个请求。
2.SqlSession 的实例不是线程安全的，因此是不能被共享的，所以它的最佳的作用域是请求或方法作用域
3.用完之后需要赶紧关闭，否则资源被占用！（类似于数据库连接池的回收）

九.解决属性名和数据库字段名不一致问题

ResultMap 元素是 MyBatis 中最重要最强大的元素。它可以让你从 90% 的 JDBC ResultSets 数据提取代码中解放出来，并在一些情形下允许你进行一些 JDBC 不支持的操作。实际上，在为一些比如连接的复杂语句编写映射代码的时候，一份 resultMap 能够代替实现同等功能的数千行代码。ResultMap 的设计思想是，对简单的语句做到零配置，对于复杂一点的语句，只需要描述语句之间的关系就行了。

然后在引用它的语句中设置 resultMap 属性就行了（注意我们去掉了 resultType 属性）。比如:

  select user_id, user_name, hashed_password
  from some_table
  where id = #{id}

 
十.日志 
1.日志工厂
 曾经：sout、debug
 现在：日志工厂
 
 SLF4J
 Log4j （掌握）
 Log4j 2
 Log4j 2
 JDK logging
 COMMONS_LOGGING（掌握）
 STDOUT_LOGGING
 NO_LOGGING
 
STDOUT_LOGGING 官方标准配置日志
 

    
    

 
2.Log4j
 
2.1log4g:
 
	Log4j是Apache的一个开源项目，通过使用Log4j，我们可以控制日志信息输送的目的地是控制台、文件、GUI组件
	我们也可以控制每一条日志的输出格式；
	通过定义每一条日志信息的级别，我们能够更加细致地控制日志的生成过程。
	通过一个配置文件来灵活地进行配置，而不需要修改应用的代码。
	用法
 
2.2导入依赖
 
        
        
            log4j
            log4j
            1.2.17
        
 
2.3在resoures下新建log4j.properties
 
#将等级为DEBUG的日志信息输出到console和file这两个目的地，console和file的定义在下面的代码
log4j.rootLogger=DEBUG,console,file

#控制台输出的相关设置
log4j.appender.console = org.apache.log4j.ConsoleAppender
log4j.appender.console.Target = System.out
log4j.appender.console.Threshold=DEBUG
log4j.appender.console.layout = org.apache.log4j.PatternLayout
log4j.appender.console.layout.ConversionPattern=[%c]-%m%n

#文件输出的相关设置
log4j.appender.file = org.apache.log4j.RollingFileAppender
log4j.appender.file.File=./log/logFile.log
log4j.appender.file.MaxFileSize=10mb
log4j.appender.file.Threshold=DEBUG
log4j.appender.file.layout=org.apache.log4j.PatternLayout
log4j.appender.file.layout.ConversionPattern=[%p][%d{yy-MM-dd}][%c]%m%n

#日志输出级别
log4j.logger.org.mybatis=DEBUG
log4j.logger.java.sql=DEBUG
log4j.logger.java.sql.Statement=DEBUG
log4j.logger.java.sql.ResultSet=DEBUG
log4j.logger.java.sql.PreparedStatement=DEBUG

 
2.4配置log4j为日志的实现
 

    

    
    

 
2.5结果
 
 
十一.分页 
使用Limit实现分页
 
Mapper接口，参数为map
 
//全部用户实现分页
List selectUser(Map map)
 
1、修改Mapper文件
 

  select * from user limit #{startIndex},#{pageSize}

;
3、在测试类中传入参数测试

推断：起始位置 = （当前页面 - 1 ） * 页面大小

//分页查询 , 两个参数startIndex , pageSize
@Test
public void testSelectUser() {
   SqlSession session = MybatisUtils.getSession();
   UserMapper mapper = session.getMapper(UserMapper.class);

   int currentPage = 1;  //第几页
   int pageSize = 2;  //每页显示几个
   Map map = new HashMap();
   map.put("startIndex",(currentPage-1)*pageSize);
   map.put("pageSize",pageSize);

   List users = mapper.selectUser(map);

   for (User user: users){
       System.out.println(user);
  }

   session.close();
}