Mybatis总结

数据持久化

• 持久化就是将程序的数据在持久状态和瞬时状态转化的过程
• 内存：断电即失
• 数据库(jdbc)：id文件持久化
  为什么要持久化？ 有一些对象，不能让他丢失

持久层

Dao层、Service层、Controller层…

• 完成持久化工作的代码块
• 层界限十分明显
  为什么需要MyBatis？
  帮助程序员将数据存入到数据库中
  方便
  传统的JDBC代码太复杂了。简化，框架，自动化。
  优点
• 简单易学
• 灵活
• sql和代码的分离，提高了可维护性
• 提供映射标签，支持对象与数据库的orm字段关系映射
• 提供对象关系映射标签，支持对象关系组建维护
• 提供xml标签，支持编写动态sql。

第一个Mybatis程序

思路：搭建环境–>导入Mybatis–>编写代码–>测试

1. 搭建环境

搭建数据库
新建项目
1. 新建一个普通的maven项目
2. 删除src目录
3. 导入maven依赖

<!--导入依赖-->
    <dependencies>
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connection-java</artifactId>
            <version>8</version>
        </dependency>

        <dependency>
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis</artifactId>
            <version>3.5.2</version>
        </dependency>

        <!--mybatis-->
        <dependency>
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis</artifactId>
            <version>3.5.2</version>
        </dependency>

        <!--junit-->
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.12</version>
        </dependency>
    </dependencies>

创建一个模块
- 编写mybatis的核心配置文件

<?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 核心配置文件-->
<configuration>
    <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://localhost:3306/mybatis?useSSL=false&amp;useUnicode=true&amp;characterEncoding=utf-8&amp;serverTimezone=UTC"/>
                <property name="username" value="root"/>
                <property name="password" value="root"/>
            </dataSource>
        </environment>
    </environments>
</configuration>

• 编写mybatis工具类

//sqlSessionFactory --> sqlSession
public class MybatisUtils {

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

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

}

• 编写代码

1. 实体类

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 + '\'' +
                '}';
    }
}

2. Dao接口

public interface UserDao {
    List<User> getUserList();
}

3. 接口实现类

<?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">
<!--namespace=绑定一个对应的Dao/Mapper接口-->
<mapper namespace="cn.com.dao.UserDao">
    <!--select查询语句-->
    <select id="getUserList" resultType="cn.com.pojo.User">
        select * from mybatis.user;
    </select>
</mapper>

测试

注意点：org.apache.ibatis.binding.BindingException: Type interface
cn.com.dao.UserDao is not known to the MapperRegistry.

MapperRegistry是什么？
核心配置文件中注册mappers

Junit测试

	@Test
    public void test() {

        //获取sqlSession对象
        SqlSession sqlSession = MybatisUtils.getSqlSession();
        //执行sql
        //方式1：getMapper
        UserDao userDao = sqlSession.getMapper(UserDao.class);
        List<User> userList = userDao.getUserList();

        for (User user : userList) {
            System.out.println(user);
        }
        //关闭SqlSession
        sqlSession.close();
    }

CRUD

1. namespace
namespace中的包名要和Dao/mapper接口中的包名一致！
2.select
选择、查询语句；
id：对应的namespace中的方法名；
resultType：Sql语句执行的返回值！
parameterType：参数类型！

1. 编写接口

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

2. 编写对应的mapper中的sql语句

<select id="getUserById" parameterType="int" resultType="cn.com.pojo.User">
        select * from mybatis.user where id = #{id};
    </select>

3. 测试

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

        UserMapper mapper = sqlSession.getMapper(UserMapper.class);
        User userById = mapper.getUserById(1);
        System.out.println(userById);


        sqlSession.close();
    }

Insert、Update和Delete同上。
增删改需要提交事务。

万能Map

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

配置解析

1. 核心配置文件

• mybatis-config.xml
• mybatis的配置文件包含了会深深影响Mybatis行为的设置和属性信息

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

环境配置（environments）

MyBatis可以配置成适应多种环境。
不过要记住，尽管可以配置多个环境，但每个SqlSessionFactory实例只能选择一种环境。
每个数据库对应一个SqlSessionFactory实例。
Mybatis默认的事务管理器就是JDBC，连接池：POOLED

属性（properties）

我们可以通过properties属性来实现引用配置文件。
这些属性都是可以外部配置且可动态替换的，既可以在典型的Java属性文件中配置，亦可以通过properties元素的子元素来传递。【db.properties】

编写一个配置文件db.properties

driver=com.mysql.cj.jdbc.Driver
url=jdbc:mysql://localhost:3306/mybatis?useSSL=false&useUnicode=true&characterEncoding=UTF-8&serverTimezone=UTC
username=root
password=root

在核心文件中引入

<!--引入外部配置文件-->
<properties resource="db.properties">
	<property name="username" value="root"/>
	<property name="pwd" value="root"/>
</properties> 

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

类型别名（typeAliases）

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

<!--可以给实体类起别名-->
<typeAliases>
	<typeAlias type="xn.xom.pojo.User" alias="User"/>
</typeAliases>

也可以指定一个包名，MyBatis会在包名下面搜索需要的Java Bean，比如：扫描实体类的包，它的默认别名就为这个类的类名。

<!--可以给实体类起别名-->
<typeAliases>
	<package name="cn.com.pojo"/>
</typeAliases>

设置

MyBatis中极为重要的调整设置，他们会改变MyBatis的运行时行为。

logImpl	指定 MyBatis 所用日志的具体实现，未指定时将自动查找。
cacheEnabled	全局性地开启或关闭所有映射器配置文件中已配置的任何缓存。
lazyLoadingEnabled	延迟加载的全局开关。当开启时，所有关联对象都会延迟加载。 特定关联关系中可通过设置 fetchType 属性来覆盖该项的开关状态。

其他配置

typeHandlers(类型处理器)
objectFactory(对象工厂)
plugins(插件)

映射器（mappers）

MapperRegistry：注册绑定我们的Mapper文件。
方式一：[推荐使用]

 <!--每一个Mapper.xml都需要在Mybatis核心配置-->
    <mappers>
        <mapper resource="cn/com/dao/UserMapper.xml"/>
    </mappers>

方式二：使用class文件绑定注册

  <!--每一个Mapper.xml都需要在Mybatis核心配置-->
    <mappers>
        <mapper class="cn.com.dao.UserMapper"/>
    </mappers>

方式三：使用扫描包进行注入绑定

    <!--每一个Mapper.xml都需要在Mybatis核心配置-->
    <mappers>
        <package name="cn.com.dao"/>
    </mappers>

生命周期和作用域

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

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

SqlSessionFactory:

一旦被创建就应该在应用的运行期间一直存在。
因此SqlSessionFactory的最佳作用域是应用作用域。
最简单的就是使用单例模式或者静态单例模式。

SqlSession

连接到连接池的一个请求！
SqlSession的实例不是线程安全的，因此是不能被共享的。所以它的最佳的作用域是请求或方法作用域。
用完之后需要赶紧关闭，否则资源被占用。

resultMap

• resultMap元素是MyBatis中最重要最强大的元素。
• ResultMap的设计思想，对于简单的语句根本不需要配置显式的结果映射，而对于复杂一点的语句只需要描述它们的关系就行了。

日志

日志工厂

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

• SLF4J
• LOG4J 【掌握】
• LOG4J2
• JDK_LOGGING
• COMMONS_LOGGING
• STDOUT_LOGGING 【掌握】
• NO_LOGGING
  在Mybatis中具体使用哪个日志实现，在设置中设定。
  STDOUT_LOGGING 标准日志输出

在mybatis核心配置文件中，配置我们的日志

 <settings>
        <setting name="logImpl" value="STDOUT_LOGGING"/>
    </settings>

Log4j

什么是Log4j？

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

步骤：

1. 先导入log4j的包

<dependency>
            <groupId>log4j</groupId>
            <artifactId>log4j</artifactId>
            <version>1.2.17</version>
        </dependency>

2. 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/com.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

3. 配置log4j为日志的实现

 <settings>
        <!--标准的日志工厂实现-->
<!--        <setting name="logImpl" value="STDOUT_LOGGING"/>-->
        <setting name="logImpl" value="LOG4J"/>
    </settings>

4. Log4j的使用，直接测试运行test

简单使用

1. 在要使用Log4j的类中，导入包 import org.apache.log4j.Logger;
2. 日志对象，参数为当前类的class static Logger logger = Logger.getLogger(UserDaoTest.class);
3. 日志级别

logger.info("info:进入了testLig4j");
logger.debug("debug:进入了testLig4j");
logger.error("error:进入了testLig4j");

分页

为什么要分页：减少数据的处理量。
使用Limit分页

select * from user limit startIndex, pageSize;

使用MyBatis实现分页，核心SQL

1. 接口

// 分页
List<User> getUserByLimit(Map<String, Integer> map);

2. Mapper.xml

<!--分页查询-->
 <select id="getUserByLimit" parameterType="map" resultMap="UserMap">
       select * from mybatis.user limit #{startIndex}, #{pageSize};
</select>

3. 测试

@Test
  public void getUserByLimit() {
    SqlSession sqlSession = MybatisUtils.getSqlSession();
       UserMapper mapper = sqlSession.getMapper(UserMapper.class);
   HashMap<String, Integer> map = new HashMap<String, Integer>();
 map.put("startIndex", 0);
map.put("pageSize", 2);
       List<User> userList = mapper.getUserByLimit(map);
     for (User user : userList) {
       System.out.println(user);
 }
       sqlSession.close();
 }

面向接口编程

根本原因：解耦，可拓展，提高复用，分层开发中，上层不用管具体的实现，大家在遵循共同的标准，使得开发变得容易，规范性更好。

关于接口的理解

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

三个面向区别

• 面向对象是指，我们考虑问题时，以对象为单位，考虑它的属性及方法。
• 面向过程是指，我们考虑问题时，以一个具体的流程（事务过程）为单位，考虑它的实现。
• 接口设计与非接口设计是针对复用技术而言的，与面向对象（过程） 不是一个问题，更多的体现就是对系统整体的架构。

使用注解开发

1. 注解在接口上实现

@Select("select * from user")
List<User> getUsers();

2. 需要再核心配置文件中绑定接口！

<!--绑定接口-->
<mappers>
	<mapper class="cn.com.dao.UserMapper"/>
</mappers>

3. 测试

本质：反射机制实现
底层：动态代理！

Mybatis详细的执行流程

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

public static SqlSession getSqlSession() {
        // 参数为true，不用手动commit
        return ssf.openSession(true);
    }

编写接口，增加注解

public interface UserMapper {

    @Select("select * from user")
    List<User> getUsers();


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


    @Insert("insert into user(id, name, pwd) values (#{id}, #{name}, #{password})")
    int addUser(User user);



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


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

}

测试
【注意：我们必须要将接口注册绑定到我们的配置文件！】
关于@Param()注解

• 基本类型的参数或者String类型，需要加上
• 引用类型不需要加
• 如果只有一个基本类型的话，可以忽略，但是建议大家加上

Lombok

1. IDEA中加载Lombok
2. 在项目中导入lombok的jar包
3. 在实体类上加注解

@Getter and @Setter
@FieldNameConstants
@ToString
@EqualsAndHashCode
@AllArgsConstructor, @RequiredArgsConstructor and @NoArgsConstructor
@Log, @Log4j, @Log4j2, @Slf4j, @XSlf4j, @CommonsLog, @JBossLog, @Flogger, @CustomLog
@Data
@Builder
@SuperBuilder
@Singular
@Delegate
@Value
@Accessors
@Wither
@With
@SneakyThrows
@val
@var
experimental @var
@UtilityClass
Lombok config system
Code inspections
Refactoring actions (lombok and delombok)

多对一处理

按照查询嵌套处理

<!--思路
        1. 查询所有的学生信息
        2. 根据查询出的学生的tid，寻找对应的老师
    -->

    <select id="getStudent" resultMap="StudentTeacher">
        select * from student
    </select>

    <resultMap id="StudentTeacher" type="cn.com.pojo.Student">
        <result property="id" column="id"/>
        <result property="name" column="name"/>
        <!--复杂的属性，我们需要单独处理
            对象：association
            集合：collection
        -->
        <association property="tid" column="tid" javaType="cn.com.pojo.Teacher" select="getTeacher"/>
    </resultMap>
    
    
    <select id="getTeacher" resultType="cn.com.pojo.Teacher">
        select * from teacher where id = #{id}
    </select>

按照结果嵌套处理

 <!--按照结果嵌套处理-->
    <select id="getStudent2" resultMap="StudentTeacher2">
        select s.id sid, s.name sname, t.name tname
        from student s,teacher t
        where s.tid = t.id
    </select>

    <resultMap id="StudentTeacher2" type="cn.com.pojo.Student">
        <result property="id" column="sid"/>
        <result property="name" column="sname"/>
        <association property="tid" javaType="cn.com.pojo.Teacher">
            <result property="name" column="tname"/>
        </association>
    </resultMap>

一对多处理

同上多对一处理。

小结

1. 关联 - association 【多对一】
2. 集合 - collection 【一对多】
3. javaType & ofType
   1. JavaType 用来指定实体类中属性的类型
   2. ofType 用来指定映射到List或者集合中的pojo类型，泛型中的约束类型！

注意点：

• 保证SQL的可读性，尽量保证通俗易懂。
• 注意一对多和多对一中，属性名和字段的问题。
• 如果问题不好排查，可以使用入职

动态SQL

什么是动态SQL：动态SQL就是指根据不同的条件生成不同的SQL语句

动态SQL元素和JSTL或基于类似XML的文本处理器相似。在Mybatis之前的版本中，有很多元素需要花时间了解。Mybatis3大大精简了元素种类，现在只需学习原来一半的元素即可。Mybatis采用功能强大的基于OGNL的表达式来淘汰其他大部分元素。
if
choose(when, otherwise)
trim(where, set)
foreach

搭建环境

CREATE TABLE blog(
	id VARCHAR(50) NOT NULL COMMENT '博客id',
	title VARCHAR(100) NOT NULL COMMENT '博客标题',
	author VARCHAR(30) NOT NULL COMMENT '博客作者',
	create_time DATETIME NOT NULL COMMENT '创建时间',
	views INT(30) NOT NULL COMMENT '浏览量'
)ENGINE=INNODB DEFAULT CHARSET=utf8

创建一个基础工程

1. 导包
2. 编写配置文件
3. 编写实体类

@Data
public class Blog {

    private String id;
    private String title;
    private String author;
    private Date create_time;
    private int views;
}

4. 编写实体类对应的Mapper接口和Mapper.XML文件

IF

<select id="queryBlogIF" parameterType="map" resultType="cn.com.pojo.Blog">
        select * from mybatis.blog
        where 1=1
        <if test="title != null">
            and title = #{title}
        </if>
        <if test="author != null">
            and author = #{author}
        </if>
    </select>

choose, when, otherwise

有时我们不想应用到所有的条件语句，而只想从中择其一项。针对这种情况，Mybatis提供了choose元素，他有点像Java中的switch语句。

<select id="queryBlogChoose" parameterType="map" resultType="cn.com.pojo.Blog">
        select * from mybatis.blog
        <where>
            <choose>
                <when test="title != null">
                    title = #{title}
                </when>

                <when test="author != null">
                   and author != #{author}
                </when>

                <otherwise>
                    and views = #{views}
                </otherwise>

            </choose>
        </where>
    </select>

trim（where, set）

where元素只会在至少有一个子元素的条件返回SQL子句的情况下采取插入“WHERE”子句。而且，若语句的开头为“AND”或“OR”，where元素也会将他们去掉

<select id="queryBlogIF" parameterType="map" resultType="cn.com.pojo.Blog">
        select * from mybatis.blog
        <where>
            <if test="title != null">
                and title = #{title}
            </if>
            <if test="author != null">
                and author = #{author}
            </if>
        </where>
        
    </select>

用于动态更新语句的解决方案叫set,set元素可以用于动态包含需要更新的列，而舍去其他的。
SET元素会动态前置SET关键字，同时也会删掉无关的逗号

<update id="updateBlog" parameterType="map">
        update mybatis.blog
        <set>
            <if test="title != null">
                title = #[title],
            </if>
            <if test="author != null">
                author = #{author}
            </if>
        </set>
        where views = #{views}
    </update>

所谓的动态SQL，本质还是SQL语句。只是我们可以在SQL层面，去执行一个逻辑代码。

Foreach

SQL片段

有的时候，我们可能会将一些功能的部分抽取出来，方便复用！

1. 使用SQL标签抽取公共的部分

<sql id="if-title-author">
        <if test="title != null">
            and title = #{title}
        </if>
        <if test="author != null">
            and author = #{author}
        </if>
    </sql>

2. 需要使用的地方，使用include标签引用即可。

<select id="queryBlogIF" parameterType="map" resultType="cn.com.pojo.Blog">
        select * from mybatis.blog
        <where>
            <include refid="if-title-author"></include>
        </where>

    </select>

注意事项：
最好基于单表来定义SQL片段！
不要存在where标签

foreach

foreach元素的功能非常强大，它允许你指定一个集合，声明可以在元素体内使用的集合项（item）和索引（index）变量。它也允许你指定开头与结尾的字符串以及在迭代结果之间放置分隔符。

动态SQL就是在拼接SQL语句，我们只要保证SQL的正确性，按照SQL的格式，去排列组合就可以了。