MyBatis快速入门

一、简介

• MyBatis是一个优秀的基于ORM的半自动轻量级持久层框架，它对jdbc的操作数据库的过程进行封装，使开发者只需要关注 SQL 本身，而不需要花费精力去处理例如注册驱动、创建connection、创建statement、手动设置参数、结果集检索等jdbc繁杂的过程代码

• ORM（Object Relational Mapping）对象关系映射
  • O（对象模型）：
    • 实体对象，即我们在程序中根据数据库表结构建立的一个个实体javaBean
  • R（关系型数据库的数据结构）：
    • 关系数据库领域的Relational（建立的数据库表）
  • M（映射）：
    • 从R（数据库）到O（对象模型）的映射，可通过XML文件映射
• 实现：

1. 让实体类和数据库表进行一一对应关系
   1. 先让实体类和数据库表对应
   2. 再让实体类属性和表里面字段对应
2. 不需要直接操作数据库表，直接操作表对应的实体类对象

• ORM作为是一种思想
  • 帮助我们跟踪实体的变化,并将实体的变化翻译成sql脚本,执行到数据库中去,也就是将实体的变化映射到了表的变化。
  • mybatis采用ORM思想解决了实体和数据库映射的问题，对jdbc 进行了封装，屏蔽了jdbc api 底层访问细节，使我们不用与jdbc api 打交道，就可以完成对数据库的持久化操作

二、快速入门

新建一个quickstart模块，修改pom.xml文件，引入依赖包

<!--mysql-->
  <dependency>
    <groupId>com.mysql</groupId>
    <artifactId>mysql-connector-j</artifactId>
    <version>8.0.32</version>
  </dependency>
  <!--mybaties-->
  <dependency>
    <groupId>org.mybatis</groupId>
    <artifactId>mybatis</artifactId>
    <version>3.5.5</version>
  </dependency>
  <dependency>
    <groupId>junit</groupId>
    <artifactId>junit</artifactId>
    <version>4.13.1</version>
  </dependency>
  <dependency>
    <groupId>org.projectlombok</groupId>
    <artifactId>lombok</artifactId>
    <version>1.18.30</version>
  </dependency>

准备一个数据库表login，有两个字段username、password,均为字符串类型

构建项目结构

UserMapper

User

UserMapper.xml

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper
        PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
        "https://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.dbzhu.mapper.UserMapper">

        <select id="findAll" resultType="User">
            select * from login
        </select>

</mapper>

德鲁伊配置文件

jdbc.driverClassName=com.mysql.cj.jdbc.Driver
jdbc.url=jdbc:mysql://localhost:3306/db2?serverTimezone=UTC&characterEncoding=utf8&useUnicode=true&useSSL=false
jdbc.username=root
jdbc.password=123456

initialSize=5

maxActive=10

maxWait=3000

mybaties-config.xml配置文件

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configuration
        PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
        "https://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration>
    <properties resource="druid.properties"/>

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

    <environments default="development">
        <environment id="development">
            <transactionManager type="JDBC"/>
            <dataSource type="POOLED">
                <!--数据库的连接信息-->
                <property name="driver" value="${jdbc.driverClassName}"/>
                <property name="url" value="${jdbc.url}"/>
                <property name="username" value="${jdbc.username}"/>
                <property name="password" value="${jdbc.password}"/>
            </dataSource>
        </environment>
    </environments>

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

</configuration>

编写测试类Test

执行测试类

三、mapper映射文件

1.resultMap

resultMap 解决数据库表的列名与实体类的属性名不一致,不能自动封装的问题

id 唯一标识
type 映射的类型支持别名

id 主键的映射
   column 表的列名
   property 实体类的属性名
result 一般字段的映射
   column 表的列名
   property 实体类的属性名

2.多条件查询

使用 #{arg 0}--------#{arg n} 或者 #{param 1}------#{param n} 获取参数

Mapper接口

Mapper映射文件

测试类

使用注解，引入 @Param() 注解获取参数

使用pojo对象传递参数（推荐）

3.模糊查询

或

#{}与${}的区别

        #{} :表示一个占位符号

• 通过 #{} 可以实现preparedStatement向占位符中设置值，自动进行java类型和jdbc类型转换，#{}可以有效防止sql注入。
• #{} 可以接收简单类型值或pojo属性值。
• 如果parameterType传输单个简单类型值， #{} 括号中名称随便写。

       ${} :表示拼接sql串

• 通过 ${} 可以将parameterType 传入的内容拼接在sql中且不进行jdbc类型转换，会出现sql注入问题。
• ${} 可以接收简单类型值或pojo属性值。
• 如果parameterType传输单个简单类型值， ${} 括号中只能是value。
  • 补充：TextSqlNode.java 源码可以证明

4.立即返回主键

useGeneratedKeys

<!--
    useGeneratedKeys="true" 声明返回主键
        keyProperty="id" 把返回主键的值，封装到实体的id属性中
注意：只适用于主键自增的数据库，mysql和sqlserver支持，oracle不支持
-->
<insert id="save" parameterType="user" useGeneratedKeys="true" keyProperty="id">
    INSERT INTO `user`(username,birthday,sex,address)
    values(#{username},#{birthday},#{sex},#{address})
</insert>

selectKey

<!--
    selectKey 适用范围广，支持所有类型数据库
    keyColumn="id" 指定主键列名
    keyProperty="id" 指定主键封装到实体的id属性中
    resultType="int" 指定主键类型
    order="AFTER" 设置在sql语句执行前（后），执行此语句
-->
<insert id="save" parameterType="user">
    <selectKey keyColumn="id" keyProperty="id" resultType="int" order="AFTER">
        SELECT LAST_INSERT_ID();
    </selectKey>
    INSERT INTO `user`(username,birthday,sex,address)
      values(#{username},#{birthday},#{sex},#{address})
</insert>

5.动态sql

<where><if>

根据id和username查询，但是不确定两个都有值。

<set>

动态更新user表数据，如果该属性有值就更新，没有值不做处理

set标签在更新的时候，自动加上set关键字，然后去掉最后一个条件的逗号

 <foreach>

• foreach主要是用来做数据的循环遍历

•标签用于遍历集合，它的属性：

• collection：代表要遍历的集合元素

• open：代表语句的开始部分

• close：代表结束部分

• item：代表遍历集合的每个元素，生成的变量名

• sperator：代表分隔符

如果是查询数组,

collection的值为array,

parameter的值为数组中值的类型，

抽取sql片段

映射文件中可将重复的 sql 提取出来，使用时用 include 引用即可，最终达到 sql 重用的目的

四、mybaties核心文件

1.environments环境配置

1. 其中，事务管理器（transactionManager）类型有两种：

- JDBC： 这个配置就是直接使用了JDBC 的提交和回滚设置，

它依赖于从数据源得到的连接来管理事务作用域。

- MANAGED： 这个配置几乎没做什么。它从来不提交或回滚一个连接，

而是让容器来管理事务的整个生命周期。

例如：mybatis与spring整合后，事务交给spring容器管理。

2. 其中，数据源（dataSource）常用类型有三种：

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

- POOLED： 这种数据源的实现利用“池”的概念将 JDBC 连接对象组织起来。

- JNDI : 这个数据源实现是为了能在如 EJB 或应用服务器这类容器中使用，

容器可以集中或在外部配置数据 源，然后放置一个 JNDI 上下文的数据源引用

2.properties标签

抽取dataSource数据源使用文件关联降低耦合

3.typeAliases标签

类型别名是为 Java 类型设置一个短的名字。为了简化映射文件 Java 类型设置，mybatis框架为我们设置好的一些

<!--配置别名-->
<typeAliases>
            <!--自己定义的别名       要代替的全限定包名 -->
        <typeAlias alias="User" type="com.easthome.pojo.User"/>
</typeAliases>
<!--包扫描 将该包下的所有类变成别名-->
<typeAliases>  
    <package name="com.example"/>  
</typeAliases>

4.mapper标签

1. 使用相对于类路径的资源引用，例如：
<mapper resource="org/mybatis/builder/userMapper.xml"/>
2. 使用完全限定资源定位符（URL），例如：
<mapper url="file:///var/mappers/userMapper.xml"/>
《下面两种mapper代理开发中使用:暂时了解》
3. 使用映射器接口实现类的完全限定类名，例如：
<mapper class="org.mybatis.builder.userMapper"/>
4. 将包内的映射器接口实现全部注册为映射器，例如：
<package name="org.mybatis.builder"/>

五、mybatiesAPI

sql会话的方法

<T> T selectOne(String statement, Object parameter)
<E> List<E> selectList(String statement, Object parameter)
int insert(String statement, Object parameter)
int update(String statement, Object parameter)
int delete(String statement, Object parameter)

六、代理开发方式

遵守规范

1. Mapper.xml映射文件中的namespace与mapper接口的全限定名相同
2. Mapper接口方法名和Mapper.xml映射文件中定义的每个statement的id相同
3. Mapper接口方法的输入参数类型和mapper.xml映射文件中定义的每个sql的parameterType的类型相同
4. Mapper 接口开发方法只需要程序员编写Mapper 接口（相当于Dao 接口），由Mybatis 框架根据接口定义创建接口的动态代理对象，代理对象的方法体同上边Dao接口实现类方法

测试方法

七、分页设置

1.引入依赖

<!-- 分页助手 -->
<dependency>
  <groupId>com.github.pagehelper</groupId>
  <artifactId>pagehelper</artifactId>
  <version>3.7.5</version>
</dependency>
<dependency>
  <groupId>com.github.jsqlparser</groupId>
  <artifactId>jsqlparser</artifactId>
  <version>0.9.1</version>
</dependency>

2.配置核心文件

放在<typeAliases>标签后

<plugins>
    <!-- 分页助手的插件 -->
    <plugin interceptor="com.github.pagehelper.PageHelper">
        <!-- 指定方言 -->
        <property name="dialect" value="mysql"/>
    </plugin>
</plugins>

3.测试