Mybatis基础

一、什么是Mybatis

1⃣️-基础概述

---

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

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

• 中文文档：mybatis3-中文文档

• Github: GitHub - mybatis/mybatis-3: MyBatis SQL mapper framework for Java

• Maven: Maven Repository: mybatis

  <!-- https://mvnrepository.com/artifact/org.mybatis/mybatis -->
  <dependency>
      <groupId>org.mybatis</groupId>
      <artifactId>mybatis</artifactId>
      <version>3.5.5</version>
  </dependency>
  

持久化：

相关：数据持久化

• 持久化就是将数据持久状态和瞬时状态转化的过程

• 内存：断电即失

• 数据库（jdbc），io文件持久化

持久层：

相关：Dao层，Service层，Controller层

• 完成持久化工作的代码块

• 层界限十分明显

Mybatis的功能架构>:

我们把Mybatis的功能架构分为三层：

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

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

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

2⃣️-为什么需要Mybatis?

---

• 帮助程序员将数据存入到数据库中

• 方便

• 传统的JDBC代码太复杂，简化，框架，自动化

• 不用Mybatis也可以，更容易上手。

二、第一个Mybatis程序

思路:搭建环境➡️导入Mybatis➡️编写代码➡️测试

1⃣️-搭建数据库

---

create database `mybatis`;
use `mybatis`;
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,'李四','123456'),
(3,'小王','123456')

2⃣️-新建Mybatis项目

---

1. 新建Maven项目

2. 删除src目录

3. 导入Maven依赖

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <!--    父工程-->
    <groupId>com.samsaramax</groupId>
    <artifactId>Mybatis-Study</artifactId>
    <version>1.0-SNAPSHOT</version>

<!--    导入依赖-->
    <dependencies>
<!--        mysql驱动-->
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>5.1.47</version>
        </dependency>
<!--        mybatis-->
        <!-- https://mvnrepository.com/artifact/org.mybatis/mybatis -->
        <dependency>
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis</artifactId>
            <version>3.5.5</version>
        </dependency>
<!--        junit-->
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.12</version>
            <scope>test</scope>
        </dependency>

    </dependencies>
</project>

4. 创建子模块mybatis-01

• 编写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>
      <environments default="development">
          <environment id="development">
              <transactionManager type="JDBC"></transactionManager>
              <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"/>
                  <property name="username" value="root"/>
                  <property name="password" value="root"/>
              </dataSource>
          </environment>
      </environments>
  </configuration>
  

• 编写mybatis工具类

  package com.samsaramax.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;
  
  /**
   * @description: Mybatis工具类
   * @author: Vior
   * @time: 2020/8/13 1:51 下午
   */
  public class MybatisUtils {
      private static SqlSessionFactory sqlSessionFactory;
  
      static {
          try {
              //使用Mybatis获取SqlSessiononFactory
              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() {
          //此处需提升前面SqlSessionFactory的作用域
          //SqlSession sqlSession = sqlSessionFactory.openSession();
          //return sqlSession;
          //优化
          return sqlSessionFactory.openSession();
      }
  
  }
  

5. 编写代码

• 实体类

  package com.samsaramax.pojo;
  
  /**
   * @description: 用户实体类
   * @author: Vior
   * @time: 2020/8/17 2:28 下午
   */
  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.samsaramax.dao;
  
  import com.samsaramax.pojo.User;
  
  import java.util.List;
  
  public interface UserDao {
      List<User> getUserList();
  }
  

• 接口实现类由impl转换为mapper.xml配置文件

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

6. 测试

注意点:Exception in thread "main" org.apache.ibatis.binding.BindingException: Type interface com.samsaramax.dao.UserDao is not known to the MapperRegistry.

MapperRegistry是什么?

核心配置文件中注册mappers;

解决方案:

xxmapper.xml

<configuration>
<environments>
...
...
</environments>
    <!--每一个Mapper.XML都需要在Mybatis核心配置中心注册！-->
    <mappers>
        <mapper resource="com/samsaramax/dao/UserDaoMapper.xml"/>
    </mappers>
</configuration>

注意点Exception in thread "main" java.lang.ExceptionInInitializerError

at com.samsaramax.dao.UserDaoTest.main(UserDaoTest.java:19)

Caused by: org.apache.ibatis.exceptions.PersistenceExceptio n:

Error building SqlSession.

The error may exist in com/samsaramax/dao/UserDaoMapper.xml

解决方案:

pom.xml

<!--由于在Maven中，它的约定大于配置特性，我们这之后写的配置文件，可能会遇到无法导出或者无法生效问题，解决方案手动配置过滤，导出开启-->
    <!--默认配置文件是在resource文件夹下，所以java文件夹下的配置文件-->
    <build>
        <resources>
            <!--        resource文件夹-->
            <resource>
                <directory>src/main/resource</directory>
                <includes>
                    <include>**/*.properties</include>
                    <include>**/*.xml</include>
                </includes>
                <filtering>true</filtering>
            </resource>
            <!--        java文件夹-->
            <resource>
                <directory>src/main/java</directory>
                <includes>
                    <include>**/*.properties</include>
                    <include>**/*.xml</include>
                </includes>
                <filtering>true</filtering>
            </resource>
        </resources>
    </build>

• junit

  package com.samsaramax.dao;
  
  import com.samsaramax.pojo.User;
  import com.samsaramax.utils.MybatisUtils;
  import org.apache.ibatis.session.SqlSession;
  import org.junit.Test;
  
  import java.util.List;
  
  /**
   * @description: 测试实体类
   * @author: Vior
   * @time: 2020/8/17 3:05 下午
   */
  public class UserDaoTest {
      @Test
      public static void main(String[] args) {
  //        第一步：获得sqlSession对象
          SqlSession sqlSession = MybatisUtils.getSqlSession();
  //        第二步：执行SQL
  //        方式一：getMapper
          UserDao userDao = sqlSession.getMapper(UserDao.class);
          List<User> userList = userDao.getUserList();
          for (User user : userList) {
              System.out.println(user);
          }
          sqlSession.close();
      }
  }
  

可能遇到的问题：

• 配置文件没有注册

• 绑定接口错误

• 方法名不对

• 返回类型不对

• Maven资源导出问题

三、CRUD例子

1⃣️-标志名

---

把项目中Userdao改为UserMapper

2⃣️-语句

• select,insert,update,delete(增删改需要开启事务，commit)

  • id对应的就是namespace中的方法名

  • resultType：SQL语句的返回值

  • parameterType：参数类型

• Map

  • Map传递参数，直接在sql取出key即可 【parameterType="map"】

  • 对象传递参数，直接在sql取出对象属即可 【parameterType="User"】

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

  • 多个参数用Map，或者注解

• 模糊查询

  • 为了安全防止sql注入如（select * from user where id = ?;?处拼接1 or 1=1,查出全部）

  • 第一： 在java层面，使用通配符%%；

    • List<User> userList = mapper.getUserListlike("%李%");

  • 第二：在sql语句中，使用通配符%%；

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

4、配置解析

1⃣️-核心配置文件

---

1. mybatis-config.xml

2. 环境配置（environments）

• mybatis可以适应多种环境

• 不过，每个SqlsessionFactory实例只能选择一种环境

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

  br

3. 属性（properties）

• 属性都可以外部配置且可动态替换的

• 编写db.properties

  driver=com.mysql.jdbc.driver
  url=jdbc:mysql://localhost:3306/mybatis?usessl=true&useUnicode=true&charaEncoding=UTF-8
  username=root
  password=123456
  

• 在核心配置文件中引入

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

• 重点：

  • 可以直接引入外部文件

  • 可以在其中增加一些属性配置

  • 如果两个文件有同一个字段，最终使用外部文件，先读取内部，然后外部覆盖

    

    
    

4. 类型别名（typeAliases）

• 类型别名是为java类型设置一个短的名字，意在降低冗余的全限定类名书写

  <!--①——可以给实体类设置别名-->
  <typeAliases>
      <typeAlias type="com.samsaramax.pojo.User" alias="User"></typeAlias>
  </typeAliases>
  <!--②——也可以指定一个包命，mybatis会扫面该包下Bean，
  默认别名为类名，首字母小写，大写也可以--> 
  <typeAliases>
     <package name="com.samsaramax.pojo"/>
  </typeAliases>
  PS:在实体类比较少的时候使用第一种，实体类多的时候建议第二种
  第一种可以DIY别名，
  第二种要实现DIY，需要 类注解——@Alias（“xx”）注解，别名为注解值
  

• 内建类型别名

  

  
  

5. 设置

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

6. 其他配置

• typeHanDlers(类型处理器)

• objectFactory(对象工厂)

• plugins(插件)

  • mybatis-generator-core

  • mybatis-plus

  • 通用mapper