学习笔记_SSM_Mybatis

MyBatis

学习视频，B站狂神说Java

环境：

JDK1.8
MySQL8.0.22
maven3.6.3
IDEA2019.03

框架：配置文件、最好的学习方法就是看官网

Mybatis官网

1、简介

1.1、什么是MyBatis

MyBatis 是一款优秀的持久层框架
它支持自定义 SQL、存储过程以及高级映射。
MyBatis 免除了几乎所有的 JDBC 代码以及设置参数和获取结果集的工作。
MyBatis 可以通过简单的 XML 或注解来配置和映射原始类型、接口和 Java POJO(Plain Old Java Objects，普通老式 Java 对象)为数据库中的记录。
MyBatis 本是apache的一个开源项目iBatis, 2010年这个项目由apache software foundation 迁移到了[google code](https://baike.baidu.com/item/google code/2346604)，并且改名为MyBatis 。
2013年11月迁移到Github。
iBATIS一词来源于“internet”和“abatis”的组合，是一个基于Java的持久层框架。iBATIS提供的持久层框架包括SQL Maps和Data Access Objects(DAOs)
当前，最新版本是MyBatis 3.5.6 ，其发布时间是2020年10月6日

如何获取Mybatis?

maven仓库



    org.mybatis
    mybatis
    3.5.6

GitHub：https://github.com/mybatis/mybatis-3/tree/master/src/site
中文文档：

1.2、持久化

数据持久化

持久化就是将程序的数据在持久状态和瞬时状态转化的过程
内存：断电即失
数据库(jdbc)、io文件持久化

为什么需要持久化？

有一些对象，不能让它丢掉
内存太贵

1.3、持久层

Dao层、Service层、Controller层···

完成持久化工作的代码块
层界限十分明显

1.4、为什么需要Mybatis

帮助程序员将数据读到数据库中
方便
传统JDBC代码太复杂了。简化，框架，半自动化
不用Mybatis也可以。但使用后更容易上手

1.5 Mybatis优点

简单易学
灵活
sql和代码的分离，提高了可维护性。
提供映射标签，支持对象与数据库的orm字段关系映射
提供对象关系映射标签，支持对象关系组建维护
提供xml标签，支持编写动态sq

最重要的一点：使用的人多

2、第一个Mybatis程序

2.1、思路

思路：搭建环境->导入Mybatis->

创建数据库mybatis，创建一个表格user

新建项目

新建一个普通的maven项目
删除src目录

导入maven依赖


    

        
            org.mybatis
            mybatis
            3.5.2
        

        
            mysql
            mysql-connector-java
            8.0.22
        

        
            junit
            junit
            4.12

2.2、创建一个模块

编写myabtis配置文件mybatis-config.xml

创建工具类

package com.liuxingwu.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
 * @author 扫地生_LiuXingWu
 * @create 2021-02-22 15:56
 */
public class MybatisUtils {
    private static SqlSessionFactory sqlSessionFactory;
    static {
        try {
            // 获取Mybatis第一步：获取sqlsessionFactory对象
            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();		// 没有设置事物自动提交
    }
}

2.3、编写代码

实体类

package com.liuxingwu.pojo;

/**
 * 实体类
 * @author 扫地生_LiuXingWu
 * @create 2021-02-22 16:06
 */
public class User {
    private int 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 + "' }";
    }
}

Dao接口

package com.liuxingwu.dao;

import com.liuxingwu.pojo.User;

import java.util.List;
import java.util.Map;

/**
 * 实体类
 * @author 扫地生_LiuXingWu
 */
public interface UserMapper {
    // 查询全部用户
    List getUserList();
}

接口实现类(由原来的impl类变为XML配置文件)

2.4、测试

测试代码

package com.liuxingwu.dao;

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

import java.util.HashMap;
import java.util.List;

/**
 * @author 扫地生_LiuXingWu
 */
public class UserMapperTest {
    @Test
    public void getUserLikeTest() {
        // 1. 获取连接对象
        SqlSession sqlSession = MybatisUtils.getSqlSession();
        // 2. 获取实例
        UserMapper mapper = sqlSession.getMapper(UserMapper.class);
        // 3. 执行方法
        List userLike = mapper.getUserLike("%李%");

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

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

可能遇到的问题：

配置文件没有注册，解决方法：对于每一个实现接口的xml文件都需要核心配置文件mybati-config.xml中注册
```
        
    
```

maven导出资源问题

可能是配置文件不在resource目录下，需要在pom.xml下声明位置


    
        
            
                src/main/resources
                
                    **/*.properties
                    **/*.xml
                
                false
            
            
                src/main/java
                
                    **/*.properties
                    **/*.xml
                
                false

方法名不对
返回类型不对
绑定接口错误

3、CRUD

1、namespace

namespace中的包名要和Dao/mapper接口的包名一致

2、select

选择、查询语句

id：就是对应的namespace中的方法名
resultType：SQL语句执行的返回值
parameterType：参数类型

编写接口

// 根据id查询用户
    User getUserById(int id);

接口对应的mapper中的sql语句

测试

@Test
    public void getUserByIdTest() {
        // 1. 获取连接对象
        SqlSession sqlSession = MybatisUtils.getSqlSession();
        // 2. 获取实例
        UserMapper mapper = sqlSession.getMapper(UserMapper.class);
        // 3. 执行方法
        User user = mapper.getUserById(1);

        System.out.println(user);
        // 关闭连接
        sqlSession.close();
    }

3、Insert


    
        insert into mybatis.user value(#{id}, #{name}, #{pwd})

4、update


    
        update mybatis.user set name = #{name}, pwd = #{pwd} where id = #{id}

5、Delete


    
        delete from mybatis.user where id = #{id}

注意点：

增删改需要提交事务

6、分析错误

标签不要匹配错
Resource绑定mapper，使用路径
程序配置文件必须符合规范
NullPointerException，没有注册到资源
输出的XML文件存在乱码问题
maven资源没有导出

7、万能的map

假设，我们的实体类，或者数据库中的表，字段或者参数过多，我们应该考虑使用map

// map传参
    int insertUser2(Map map);


    
-- 参数名没有限制
        insert into mybatis.user value(#{userid}, #{username}, #{pwd})

@Test
    public void insertUser2Test() {
        SqlSession sqlSession = MybatisUtils.getSqlSession();
        UserMapper mapper = sqlSession.getMapper(UserMapper.class);
        HashMap map = new HashMap();
        map.put("userid", 5);
        map.put("username", "laoliu");
        map.put("pwd", "123456789");
        int res = mapper.insertUser2(map);
        if (res > 0) {
            System.out.println("用户添加成功");
        } else {
            System.out.println("添加用户失败");
        }
        sqlSession.commit();
        sqlSession.close();
    }

Map传递参数，直接在Sql中去除即可！【parameterType="map"】

对象传递参数，直接在sql中取出对象的属性即可！【parameterType="Object"】

只有一个基本类型参数的情况下，可以直接在sql中取到！

多个参数用map，或者注解

8、思考题

模糊查询怎么写？

Java代码执行的时候，传递通配符% %
```
ListuserList = mapper.getUserLike("%刘%");
```

在sql拼接时候用通配符(可以使用concat()拼接函数，实际开发中会这样使用)


select * from mybatis.user where name like "%"#{value}"%"

select * from mybatis.user where name like concat(concat("%", #{value}), "%")

4、配置解析

1、核心配置文件

mybatis-config.xml

Mybatis的配置文件包含了会影响Mybatis行为的设置和属性信息

configuration(配置)
properties(属性)
settings(设置)
typeAliases(类型别名)
typeHandlers(类型处理器)
objectFactory(对象工厂)
plugins(插件)
environments(环境配置)
environment(环境变量)
transactionManager(事务管理器)
dataSource(数据源)
databaseIdProvider(数据库厂商标识)
mappers(映射器)

2、环境配置(environments)

Mybatis可以配置成适应多种环境

不过要记住：尽管可以配置多个环境，但每个SqlSessionFactory实例只能选择一种环境

Mybatis默认的事务管理器就是JDBC，连接池：POOLED

3、属性(properties)

我们可以通过properties属性来实现引用配置文件

这些属性都是可外部配置且可动态替换的，既可以在典型的java属性文件中配置，也可以通过properties元素的子元素来传递。

编写一个db.properties

#jdbc配置文件
driver=com.mysql.cj.jdbc.Driver
url=jdbc:mysql://localhost:3306/mybatis?useSSL=true&useUniCode=ture&characterEncoding=UTF-8
username=root
password=root

在核心配置文件中映入

也可以直接引入外部文件
可以在其中添加一些属性配置
如果两个文件中有同一个字段，优先使用外部配置的

4、类型别名(typeAliases)

扫地生观点：不过在实际开发中，一般是不会使用类型别名的，因为使用全类名可以更加直接知道实体的所在的位置。这点在单个程序中可能体现不是很明显，但在RPC、分布式中就会有很深的体会。

类型别名是为Java类型设置一个短的名字
存在的意义仅在于用来减少类完全限定名的冗余

也指定一个包别名，MyBatis会在报名下扫描需要的Java Bean，扫描实体类的包，它的默认别名就是为这个类的类名，首字母小写，比如包里有个一JavaBean User，引用时可以可以直接只用user

在实体类比较少的时候，使用第一种方式。

如果实体类比较多，建议使用第二种

第一种可以DIY别名，第二种不行

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

5、设置

这是mybatis中即为重要的调整设置，它会改变mybatis的运行时行为

官网关于设置的部分

6、其他配置

typeHandlers(类型处理器)
objectFactory(对象工厂)
plugins(插件)
- mybatis-generator-core
- mybatis-plus
- 通用mapper

7、映射器(mappers)

MapperRegistry：注册绑定我们的Mapper文件

8、生命周期和作用域

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

SqlSessionFactoryBuilder:

一旦SqlSessionFactory创建了，就不再需要它了
局部变量

SqlSessionFactory：

相当于就是数据库连接池
SqlSessionFactory一旦被创建就应该在应用的运行期间一直存在，没有任何理由丢弃它或者重建另一个案例。
因此SqlSessionFactory的最佳作用域是应用作用域
最简单的就是使用单例模式或者静态单例模式

SqlSession

连接到连接池的一个请求
用完之后需要赶紧关闭，否则资源被占用。

这里的每一个Mapper就代表一个具体的业务！

5、解决属性名和字段名不一致的问题

1、问题

public class User {
    private int id;
    private String name;
    private String password;        // 与数据库对应的字段名称不一致
}

解决方法

起别名

2、resultMap

《阿里巴巴java开发手册》中提到，如果实体类和数据库中的字段名是否一致，都需要写resultMap

结果集映射

resultMap元素是mybatis中最重要最强大的元素(在实际开发中是常用的)
resultMap的设计思想，对于简单的语句根本不需要配置显式的结果映射，而对于复杂一点的语句只需要描述它们的关系就行。
resultMap最优秀的地方在于，虽然你已经对它相当了解了，但是根本就不需要显式地用到它们。

6、日志

6.1、日志工厂

可以参考扫地生之前关于常用日志框架的一篇学习笔记

如果一个数据库操作，出现了异常，我们需要排错，日志是最好的助手。

曾经：sout, debug

现在：日志工厂

SLF4J 【扫地生在实际开发项目中有遇到过】
LOG4J 【掌握】
LOG4J2
JDK_LOGGING
COMMONS_LOGGING
STDOUT_LOGGING 【掌握】
NO_LOGGING

在Mybatis中具体使用哪一个日志实现，可在设置中设定

STDOUT_LOGGING标准日志输出

在mybatis核心文件中配置日志

6.2、Log4j

什么是log4j?

Log4j是Apache的一个开源项目，通过使用Log4j，我们可以控制日志信息输送的目的地是控制台、文件、GUI组件
我们可以控制每一条日志的输出格式
通过定义每一条日志信息的级别，我们能够更加细致地控制日志的生成过程
通过一个配置文件来灵活地进行配置，而不需要修改应用的代码

先导入log4j的包
```
     log4j
     log4j
     1.2.17
```

log4j.properties

#将等级为DEGUG的日志信息输出到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 = saodisheng/logs/saodisheng.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{yyyy-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

配置log4j为日志的是实现

简单使用

在要使用的Log4j的类中，导入包import org.apache.log4j.Logger

日志对象，参数为当前类的class

static Logger logger = Logger.getLogger(UserDaoTest.class);

日志级别

7、分页

思考：为什么要分页？

减少数据的处理量

7.1、使用Limit分页

使用mybatis实现分页，核心SQL

接口
```
// 分页
List getUserByLimit(Map map);
```

Mapper.xml

测试

@Test
public void getUserByLimitTest() {
    SqlSession sqlSession = MybatisUtils.getSqlSession();

	UserMapper mapper = sqlSession.getMapper(UserMapper.class);
  	HashMap map = new HashMap();
    map.put("startIndex", 1);
    map.put("pageSize", 3);
    List userList = mapper.getUserByLimit(map);
    for (User user : userList) {
        System.out.println(user);
    }
    sqlSession.close();
}

7.2、RowBounds分页

不再使用SQL实现分页

接口

// 分页2, 不使用SQL实现分页
List getUserByRowBounds();

mapper.xml

测试

@Test
public void getUserByRowBoundsTest() {
    SqlSession sqlSession = MybatisUtils.getSqlSession();        
    RowBounds rowBounds = new RowBounds(1, 3);
        
    // 通过Java代码层面实现分页，不推荐使用        
    List userList = sqlSession.selectList("com.liuxingwu.dao.UserMapper.getUserByRowBounds", null, rowBounds);
    for (User user : userList) {
        System.out.println(user);
    }
    sqlSession.close();
}

7.3、分页插件：PageHelper

8、使用注解开发

8.1、面向接口编程

选择面向接口编程的根本原因：解耦，可拓展，提高复用，分层开发中，上层不用管具体的实现，大家都遵守共同的标准，使得开发变得容易，规范性更好。

在一个面向对象的系统中，系统的各种功能是由许许多多的不同对象协作完成的。在这种情况下，各个对象内部是如何实现自己的,对系统设计人员来讲就不那么重要了；
而各个对象之间的协作关系则成为系统设计的关键。小到不同类之间的通信，大到各模块之间的交互，在系统设计之初都是要着重考虑的，这也是系统设计的主要工作内容。面向接口编程就是指按照这种思想来编程。

关于接口的理解

接口从更深层次的理解，应是定义(规范，约束)与实现(名实分离的原则)的分离。
接口的本身反映了系统设计人员对系统的抽象理解。
接口应有两类：
- 第一类是对一个个体的抽象，它可对应为一个抽象体(abstract class)；
- 第二类是对一个个体某一方面的抽象，即形成一个抽象面(interface)；
一个体有可能有多个抽象面。
抽象体与抽象面是有区别的。

三个面向的区别

面向对象是指，我们考虑问题时，以对象为单位，考虑它的属性及方法
面向过程是指，我们考虑问题时，以一个具体的流程(事务过程)为单位，考虑它的实现
接口设计与非接口设计是针对复用技术而言的，与面向对象(过程)不是一个问题

8.2、使用注解开发

注解在接口上是实现

@Select("select * from user")List getUser();

需要在核心配置文件中绑定接口
```
    
```
测试
1. 本质：反射机制
2. 底层：动态代理

mybatis机制详细执行流程

8.3 CRUD

我们在工具类创建的时候可以实现自动提交

public static SqlSession getSqlSession() {
    return sqlSessionFactory.openSession(true);     // 自动提交
}

编写接口，增加注解

package com.liuxingwu.dao;

import com.liuxingwu.pojo.User;
import org.apache.ibatis.annotations.*;

import java.util.List;

/**
 * 实体类
 * @author 扫地生_LiuXingWu
 */
public interface UserMapper {
    @Select("select * from user")
   List getUser();

    // 方法存在多个参数，必须在参数前加上注解@Param("参数名")
    @Select("select * from user where id = #{id}")
    User getUserById(@Param("id") int id);

    @Insert("insert into user value (#{id}, #{name}, #{password})")
    int insertUser(User user);

    @Update("update user set name = #{name}, pwd = #{password} where id = #{id}")
    int updateUser(User user);

    @Delete("delete from user where id = #{id}")
    int deleteUser(int id);
}

测试类

【注意】必须将接口注册到核心配置文件中

关于@Param()注解

基本类型的参数或者String类型，需要加上
引用类型不用加
如果只有一个基本类型的话，可以不加，但建议加上
我们在SQL引用的就是我们这里的@Param("自定义属性名")中设定的属性名

传参方式：

{}：预编译，可以防止sql注入，prepareStatement
${}：没有预编译，无法防止sql注入，Statement

9、Lombok

在IDEA中安装Lombok插件

在项目中导入Lombok的jar包



    org.projectlombok
    lombok
    1.18.10

在实体类上夹注解即可

package com.liuxingwu.pojo;

import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;

/**
 * 多对一关系，多个学生同时关联一个老师
 * @author 扫地生_LiuXingWu
 */
@Data
@AllArgsConstructor
@NoArgsConstructor
public class Student {
    private int id;
    private String name;
    // 学生关联一个老师
    private Teacher teacher;
}

10、多对一处理

多个学生对应一个老师
从学生角度看，多个学生关联一个老师【多对一】
从老师角度看，一个老师对应多个学生【一对多】

10.1、准备工作

在数据库中创建teacher、student表并添加数据

10.2、测试环境搭建

导入lombok
新建实体类Teacher、Student
建立mapper接口
建立mapper.xml文件
在核心配置文件中绑定注册mapper接口或文件
测试查询是否能够成功

实体类

package com.liuxingwu.pojo;

import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;

/**
 * 多对一关系，多个学生同时关联一个老师
 * @author 扫地生_LiuXingWu
 */
@Data
@AllArgsConstructor
@NoArgsConstructor
public class Teacher {
    private int id;
    private String name;
}

package com.liuxingwu.pojo;

import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;

/**
 * 多对一关系，多个学生同时关联一个老师
 * @author 扫地生_LiuXingWu
 */
@Data
@AllArgsConstructor
@NoArgsConstructor
public class Student {
    private int id;
    private String name;
    // 学生关联一个老师
    private Teacher teacher;
}

10.3、按照查询嵌套处理

10.4、按照结果嵌套处理

回顾MySQL多对一查询方式：

子查询
联表查询

11、一对多处理

比如：一个老师拥有多个学生

对于老师而言，就是一对多的关系

环境搭建，和多对一一样(无需重复)