狂神说MyBatis学习笔记，一篇文章学会mybatis

MyBatis

学习视频：狂神说Java

笔记跟随视频学习总结而成。

---

---

1、Mybatis简介

1.1、什么是MyBatis

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

1.2、持久化

• 持久化是将程序数据在持久状态和瞬时状态间转换的机制。
  • 即把数据（如内存中的对象）保存到可永久保存的存储设备中（如磁盘）。持久化的主要应用是将内存中的对象存储在数据库中，或者存储在磁盘文件中、XML数据文件中等等。
  • JDBC就是一种持久化机制。文件IO也是一种持久化机制。
  • 在生活中 : 将鲜肉冷藏，吃的时候再解冻的方法也是。将水果做成罐头的方法也是。
• 为什么需要持久化服务呢？那是由于内存本身的缺陷引起的
  • 内存断电后数据会丢失，但有一些对象是无论如何都不能丢失的，比如银行账号等，遗憾的是，人们还无法保证内存永不掉电。 【 如果数据存在内存中,断电即失 】
  • 内存过于昂贵，与硬盘、光盘等外存相比，内存的价格要高2~3个数量级，而且维持成本也高，至少需要一直供电吧。所以即使对象不需要永久保存，也会因为内存的容量限制不能一直呆在内存中，需要持久化来缓存到外存。

1.3、持久层

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

1.4、为什么需要Mybatis

• Mybatis就是帮助程序猿将数据存入数据库中 , 和从数据库中取数据 .
• 传统的jdbc操作 , 有很多重复代码块 .比如 : 数据取出时的封装 , 数据库的建立连接等等… , 通过框架可以减少重复代码,提高开发效率 .
• MyBatis 是一个半自动化的ORM框架 (Object Relationship Mapping) —>对象关系映射
• 所有的事情，不用Mybatis依旧可以做到，只是用了它，所有实现会更加简单！技术没有高低之分，只有使用这个技术的人有高低之别
• MyBatis的优点
  • 简单易学：本身就很小且简单。没有任何第三方依赖，最简单安装只要两个jar文件+配置几个sql映射文件就可以了，易于学习，易于使用，通过文档和源代码，可以比较完全的掌握它的设计思路和实现。
  • 灵活：mybatis不会对应用程序或者数据库的现有设计强加任何影响。 sql写在xml里，便于统一管理和优化。通过sql语句可以满足操作数据库的所有需求。
  • 解除sql与程序代码的耦合：通过提供DAO层，将业务逻辑和数据访问逻辑分离，使系统的设计更清晰，更易维护，更易单元测试。sql和代码的分离，提高了可维护性。
  • 提供xml标签，支持编写动态sql。
  • …….
• 最重要的一点，使用的人多！公司需要！

2、编写第一个MyBatis程序

2.1 搭建环境

2.1.1 创建数据库

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,'halo','123456'),(2,'whot','abcdef'),(3,'学习MyBatis','987654');

2.1.2 创建maven项目

1. 父工程导包

   
       <dependencies>
           
           <dependency>
               <groupId>mysqlgroupId>
               <artifactId>mysql-connector-javaartifactId>
               <version>8.0.25version>
           dependency>
           
           <dependency>
               <groupId>org.mybatisgroupId>
               <artifactId>mybatisartifactId>
               <version>3.5.7version>
           dependency>
           <dependency>
               <groupId>junitgroupId>
               <artifactId>junitartifactId>
               <version>4.12version>
               <scope>testscope>
           dependency>
           <dependency>
               <groupId>log4jgroupId>
               <artifactId>log4jartifactId>
               <version>1.2.17version>
           dependency>
       dependencies>
   

2. 子工程中，在resources文件夹下创建 mybatis-config.xml 文件：

   这是MyBatis核心配置文件

   
   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="com.mysql.jdbc.Driver"/>
                   <property name="url" value="jdbc:mysql://localhost:3306/mybatis?useSSL=true&useUnicode=true&characterEncoding=UTF-8&serverTimeZone=UTC"/>
                   <property name="username" value="halo"/>
                   <property name="password" value="hutonghao"/>
               dataSource>
           environment>
       environments>
       
       <mappers>
       	<mapper resource="com/whot/dao/UserMapper.xml"/>
       mappers>
   configuration>
   

2.2 编写代码

1. 编写MyBatis工具类

   package com.whot.util;
   
   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;
   
       static {
           try {
               //使用MyBatis第一步：  获取sqlSessionFactory对象
               String resource = "mybatis-config.xml";
               InputStream inputStream =Resources.getResourceAsStream(resource);
               sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
           } catch (IOException e) {
               e.printStackTrace();
           }
       }
   
       //获取SqlSession连接
       //有了sqlSessionFactory，就从中获取SQLSession的实例
       //SQLSession 中完全包含了面向数据库执行的SQL命令所需的所有方法
       public static SqlSession getSession(){
           return sqlSessionFactory.openSession();
       }
   }
   

2. 编写实体类

   package com.whot.pojo;
   
   import lombok.Data;
   
   @Data
   public class User {
       private int id;  
       private String name;
       private String pwd;
   }
   

3. 编写Mapper接口类

   package com.whot.dao;
   
   import com.whot.pojo.User;
   
   import java.util.List;
   public interface UserMapper {
       List<User> selectUser();
   }
   

4. 编写Mapper.xml配置文件

   特别注意：namespace的路径唯一绑定对应接口，id对应接口中的方法名

   
   DOCTYPE mapper
           PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
           "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
   
   
   <mapper namespace="com.whot.dao.UserMapper">
       
       <select id="selectUser" resultType="com.whot.pojo.User">
           select * from user
       select>
   mapper>
   

2.3 测试

junit测试：

package com.whot.dao;

import com.whot.pojo.User;
import com.whot.util.MybatisUtils;
import org.apache.ibatis.session.SqlSession;
import org.junit.Test;
import java.util.List;

public class MyTest {
    @Test
    public void selectUser() {

        SqlSession session = MybatisUtils.getSession();
        //方法一:
        List<User> users = session.selectList("com.whot.dao.UserMapper.selectUser");
        //方法二:  不推荐
//        UserMapper mapper = session.getMapper(UserMapper.class);
//        List users = mapper.selectUser();
        for (User user: users){
            System.out.println(user);
        }
        session.close();
    }
}

2.4 遇到的问题

2.4.1 mapper.xml未注册

报错信息：

org.apache.ibatis.binding.BindingException: Type interface com.kuang.dao.UserDao is not known to the MapperRegistry.

解决方法：

在mybatis-config.xml 文件，加入：

    <mappers>    	<mapper resource="com/whot/dao/UserMapper.xml"/>    mappers>

2.4.2 could not find resources .xml

报错信息：could not find resources ~~~.xml

原因：

• Maven静态资源过滤问题
• 当前的xml文件没有放在resources文件夹下，所以没有maven扫描到

maven 由于他的约定大于配置 ， 之后可以能遇到我们写的配置文件 ， 无法被导出或者生效的问题

解决方法：

在父工程中，或者子工程中，后者两者的pom文件中加入：

    <build>        <resources>            <resource>                <directory>src/main/javadirectory>                <includes>                    <include>**/*.propertiesinclude>                    <include>**/*.xmlinclude>                includes>                <filtering>falsefiltering>            resource>            <resource>                <directory>src/main/resourcesdirectory>                <includes>                    <include>**/*.propertiesinclude>                    <include>**/*.xmlinclude>                includes>                <filtering>falsefiltering>            resource>        resources>    build>

3、CRUD

增删改查操作，原理大同小异，大致总结流程：

1. 在Mapper中添加对应方法
2. 在Mapper.xml中添加对应的sql语句

小结：

• 所有的==增删改==操作都需要**提交事务**！ session.commit();
• 接口所有的普通参数，尽量都写上@Param参数，尤其是多个参数时，必须写上！
• 有时候根据业务的需求，可以考虑使用map传递参数！
• 为了规范操作，在SQL的配置文件中，我们尽量将Parameter参数和resultType都写上！
• 养成习惯，关闭session session.close();

---

关于模糊查询

第1种：在Java代码中添加sql通配符。

String wildcardname = “%smi%”;List<name> names = mapper.selectlike(wildcardname);<select id=”selectlike”>     select * from foo where bar like #{value}</select>

第2种：在sql语句中拼接通配符，会引起sql注入

string wildcardname = “smi”;list names = mapper.selectlike(wildcardname);     	select * from foo where bar like "%"#{value}"%"

4、Mybatis配置解析

4.1 核心配置文件

• mybatis-config.xml 系统核心配置文件
• MyBatis 的配置文件包含了会深深影响 MyBatis 行为的设置和属性信息。
• 能配置的内容如下：

configuration（配置）        properties（属性）       settings（设置）       typeAliases（类型别名）      typeHandlers（类型处理器）       objectFactory（对象工厂）       plugins（插件）    environments（环境配置）           environment（环境变量）                transactionManager（事务管理器）              dataSource（数据源）       databaseIdProvider（数据库厂商标识）        mappers（映射器）<!-- 注意元素节点的顺序！顺序不对会报错 -->

4.2 environments元素

<environments default="development">    <environment id="development">       <transactionManager type="JDBC">            <property name="..." value="..."/>        transactionManager>      <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>

• MyBatis可配置多套运行环境，将SQL映射到多个不同的数据库上，但必须指定其中一个为默认运行环境

  （通过default指定）

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

• 子元素节点：environment

  • 子元素节点：transactionManager - [ 事务管理器 ] (两种 JDBC / MANAGED 后者几乎没做什么)

  <transactionManager type="[ JDBC | MANAGED ]"/>
  

  • 子元素节点：dataSource（数据源）

    • dataSource 元素使用标准的 JDBC 数据源接口来配置 JDBC 连接对象的资源。

    • 数据源是必须配置的。

    • 有三种内建的数据源类型

      type="[UNPOOLED|POOLED|JNDI]"）
      

    • unpooled： 这个数据源的实现只是每次被请求时打开和关闭连接。

    • pooled： 这种数据源的实现利用“池”的概念将 JDBC 连接对象组织起来 , 这是一种使得并发 Web 应用快速响应请求的流行处理方式。

    • jndi：这个数据源的实现是为了能在如 Spring 或应用服务器这类容器中使用，容器可以集中或在外部配置数据源，然后放置一个 JNDI 上下文的引用。

    • 数据源也有很多第三方的实现，比如dbcp，c3p0，druid等等….

4.3 Properties优化

数据库这些属性都是可外部配置且可动态替换的，既可以在典型的 Java 属性文件中配置，亦可通过 properties 元素的子元素来传递。具体的官方文档

优化配置文件:

第一步 : 在资源目录下新建一个db.properties文件

driver=com.mysql.jdbc.Driverurl=jdbc:mysql://localhost:3306/mybatis?useSSL=true&useUnicode=true&characterEncoding=utf8username=rootpassword=123456

第二步 : 将文件导入properties 配置文件

• 配置文件优先级问题： 外部引用优于内部

  如果内部定义 与 外部引用中有同一个字段，优先使用外部的配置文件！

4.4 类型别名(typeAliases)

为java类型设置一个短的名字，减少类完全限定名的冗余 在写sql语句的resultType时可简写

<typeAliases>    <typeAlias type="com.whot.pojo.User"  alias="halo"/>typeAliases>

也可以指定包名，对包下搜索需要的java Bean，扫到的类 取别名 为 首字母小写（com.pojo.User 别名 为user）

<typeAliases>    <package name="com.whot.pojo"/>typeAliases>

当实体类较少时，用第一种； 当实体类非常多时，建议使用第二种

4.5 生命周期与作用域（Scope）

理解我们目前已经讨论过的不同作用域和生命周期类是至关重要的

因为错误的使用会导致非常严重的并发问题

作用域理解

• SqlSessionFactoryBuilder 的作用在于创建 SqlSessionFactory，创建成功后，SqlSessionFactoryBuilder 就失去了作用，所以它只能存在于创建 SqlSessionFactory 的方法中，而不要让其长期存在。因此 SqlSessionFactoryBuilder 实例的最佳作用域是方法作用域（也就是局部方法变量）。

• SqlSessionFactory 可以被认为是一个数据库连接池，它的作用是创建 SqlSession 接口对象。因为 MyBatis 的本质就是 Java 对数据库的操作，所以 SqlSessionFactory 的生命周期存在于整个 MyBatis 的应用之中，所以一旦创建了 SqlSessionFactory，就要长期保存它，直至不再使用 MyBatis 应用，所以可以认为 SqlSessionFactory 的生命周期就等同于 MyBatis 的应用周期。

  SqlSessionFactory一旦被创建就应该在应用的运行期间一直存在 ， 没有任何理由丢弃它或重新创建
  另一个实例

• 由于 SqlSessionFactory 是一个对数据库的连接池，所以它占据着数据库的连接资源。如果创建多个 SqlSessionFactory，那么就存在多个数据库连接池，这样不利于对数据库资源的控制，也会导致数据库连接资源被消耗光，出现系统宕机等情况，所以尽量避免发生这样的情况。

• 因此在一般的应用中我们往往希望 SqlSessionFactory 作为一个单例，让它在应用中被共享。所以说 SqlSessionFactory 的最佳作用域是应用作用域。

• 如果说 SqlSessionFactory 相当于数据库连接池，那么 SqlSession 就相当于一个数据库连接（Connection 对象），你可以在一个事务里面执行多条 SQL，然后通过它的 commit、rollback 等方法，提交或者回滚事务。所以它应该存活在一个业务请求中，处理完整个请求后，应该关闭这条连接，让它归还给 SqlSessionFactory，否则数据库资源就很快被耗费精光，系统就会瘫痪，所以用 try…catch…finally… 语句来保证其正确关闭。

• 所以 SqlSession 的最佳的作用域是请求或方法作用域。

5、ResultMap

5.1 自动映射

• resultMap 元素是 MyBatis 中最重要最强大的元素。它可以让你从 90% 的 JDBC ResultSets 数据提取代码中解放出来。
• 实际上，在为一些比如连接的复杂语句编写映射代码的时候，一份 resultMap 能够代替实现同等功能的长达数千行的代码。
• ResultMap 的设计思想是，对于简单的语句根本不需要配置显式的结果映射，而对于复杂一点的语句只需要描述它们的关系就行了。

你已经见过简单映射语句的示例了，但并没有显式指定 resultMap。比如：

<select id="selectUserById" resultType="map">    select id , name , pwd     from user     where id = #{id}select>

上述语句只是简单地将所有的列映射到 HashMap 的键上，这由 resultType 属性指定。虽然在大部分情况下都够用，但是 HashMap 不是一个很好的模型。你的程序更可能会使用 JavaBean 或 POJO（Plain Old Java Objects，普通老式 Java 对象）作为模型。

ResultMap 最优秀的地方在于，虽然你已经对它相当了解了，但是根本就不需要显式地用到他们。

5.2 手动映射

1. 返回值类型为resultMap

   <select id="selectUserById" resultMap="UserMap">        select id , name , pwd     from user     where id = #{id}select>
   

2. 编写resultMap，实现手动映射！

   <resultMap id="UserMap" type="User">        <id column="id" property="id"/>        <result column="name" property="name"/>    <result column="pwd" property="password"/>resultMap>
   

如果世界总是这么简单就好了。但是肯定不是的，数据库中，存在一对多，多对一的情况，我们之后会使用到一些高级的结果集映射，association，collection这些概念需要进一步学习！

6、日志

6.1 标准日志

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

6.2 Log4j

简介：

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

使用步骤：

1. 导入log4j的包

   <dependency>    <groupId>log4jgroupId>    <artifactId>log4jartifactId>    <version>1.2.17version>dependency>
   

2. 编写配置文件 log4j.properties

   #将等级为DEBUG的日志信息输出到console和file这两个目的地，console和file的定义在下面的代码log4j.rootLogger=DEBUG,console,file#控制台输出的相关设置log4j.appender.console = org.apache.log4j.ConsoleAppenderlog4j.appender.console.Target = System.outlog4j.appender.console.Threshold=DEBUGlog4j.appender.console.layout = org.apache.log4j.PatternLayoutlog4j.appender.console.layout.ConversionPattern=[%c]-%m%n#文件输出的相关设置log4j.appender.file = org.apache.log4j.RollingFileAppenderlog4j.appender.file.File=./log/kuang.loglog4j.appender.file.MaxFileSize=10mblog4j.appender.file.Threshold=DEBUGlog4j.appender.file.layout=org.apache.log4j.PatternLayoutlog4j.appender.file.layout.ConversionPattern=[%p][%d{yy-MM-dd}][%c]%m%n#日志输出级别log4j.logger.org.mybatis=DEBUGlog4j.logger.java.sql=DEBUGlog4j.logger.java.sql.Statement=DEBUGlog4j.logger.java.sql.ResultSet=DEBUGlog4j.logger.java.sql.PreparedStatement=DEBUG
   

3. setting设置日志实现

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

4. 在程序中使用Log4j进行输出！

   //注意导包：org.apache.log4j.Loggerstatic Logger logger = Logger.getLogger(MyTest.class);@Testpublic void selectUser() {    logger.info("info：进入selectUser方法");    logger.debug("debug：进入selectUser方法");    logger.error("error: 进入selectUser方法");    SqlSession session = MybatisUtils.getSession();    UserMapper mapper = session.getMapper(UserMapper.class);    List users = mapper.selectUser();    for (User user: users){        System.out.println(user);    }    session.close();}
   

7、分页

感觉使用MyBatis-Plus更为简单，暂时跳过。

8、动态SQL

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

8.1 if 标签

<select id="queryBlogIf" parameterType="map" resultType="blog">    select * from blog where 1 = 1    <if test="title != null">        and title = #{title}    if>    <if test="author != null">        and author = #{author}    if>select>

8.2 where标签

<select id="queryBlogIf" parameterType="map" resultType="blog">    select * from blog     <where>        <if test="title != null">            title = #{title}        if>        <if test="author != null">            and author = #{author}        if>    where>select>

这个“where”标签会知道如果它包含的标签中有返回值的话，它就插入一个‘where’。此外，如果标签返回的内容是以AND 或OR 开头的，则它会剔除掉。 【自动添加where，自动去除或添加 and、or】

<where>    <choose>        <when test="title ！ = null">        	title = #{title}        when>        <when test=" author ！ = null">            and author = # { author}        when >        <otherwise>            and views = #{views}        otherwise>    choose>where>

解读一下上面的代码：

choose标签，作用：从中选择一个条件成立的 拼接sql 从前往后，成立就退出

otherwise标签，放于choose中，作用：当choose中没有成立的，就选otherwise中的进行拼接

8.3 set标签

<update id="updateBlog" parameterType="map">    update blog      <set>          <if test="title != null">              title = #{title},          if>          <if test="author != null">              author = #{author}          if>      set>    where id = #{id};update>

功能和用法都与 where 类似

set元素会动态前置 SET 关键字， 同时也会删除无关的逗号

8.4 foreach标签

<select id="queryBlogForeach" parameterType="map" resultType="blog">    select * from blog    <where>                <foreach collection="ids"  item="id" open="and (" close=")" separator="or">            id=#{id}        foreach>    where>select>

9、缓存

9.1 简介

1. 什么是缓存 [ Cache ]？
   • 存在内存中的临时数据。
   • 将用户经常查询的数据放在缓存（内存）中，用户去查询数据就不用从磁盘上(关系型数据库数据文件)查询，从缓存中查询，从而提高查询效率，解决了高并发系统的性能问题。
2. 为什么使用缓存？
   • 减少和数据库的交互次数，减少系统开销，提高系统效率。
3. 什么样的数据能使用缓存？
   • 经常查询并且不经常改变的数据。

9.2 MyBatis缓存

• MyBatis包含一个非常强大的查询缓存特性，它可以非常方便地定制和配置缓存。缓存可以极大的提升查询效率。
• MyBatis系统中默认定义了两级缓存：一级缓存 和 二级缓存
  • 默认情况下，只有一级缓存开启。（SqlSession级别的缓存，也称为本地缓存）
  • 二级缓存需要手动开启和配置，他是基于namespace级别的缓存。
  • 为了提高扩展性，MyBatis定义了缓存接口Cache。我们可以通过实现Cache接口来自定义二级缓存

9.3 一级缓存

• 一级缓存也叫本地缓存：
  • 与数据库同一次会话期间查询到的数据会放在本地缓存中。
  • 以后如果需要获取相同的数据，直接从缓存中拿，没必须再去查询数据库；

9.4 二级缓存

• 二级缓存也叫全局缓存，一级缓存作用域太低了，所以诞生了二级缓存
• 基于namespace级别的缓存，一个名称空间，对应一个二级缓存；
• 工作机制
  • 一个会话查询一条数据，这个数据就会被放在当前会话的一级缓存中；
  • 如果当前会话关闭了，这个会话对应的一级缓存就没了；但是我们想要的是，会话关闭了，一级缓存中的数据被保存到二级缓存中；
  • 新的会话查询信息，就可以从二级缓存中获取内容；
  • 不同的mapper查出的数据会放在自己对应的缓存（map）中；

9.5 原理图