JavaWeb02-MyBatis

一、MyBatis

1.概述

2.JavaEE三层架构简单介绍

（1）表现层

（2）业务层

（3）持久层

3.框架

4.优势

（1）JDBC的劣势

（2）MyBatis优化

5.使用

（1）快速上手

（2）框架使用部分

（3）编码部分

6.Mapper代理开发

（1）Mapper代理开发的好处

（2）Mapper代理使用步骤

7.Mybatis的配置文件说明

8.查询过程出现的问题

9.xml文件中编写SQL语句没有提示

10.查操作

（1）单条件查询

（2）多条件查询

11.动态查询

（1）多条件动态查询

（2）单条件动态查询（多选一）

12.增操作

（1）主键返回

13.删操作

14.改操作

（1）修改字段数据

（2）修改动态字段数据

15.删操作

（1）单个删除

（2）批量删除

16.Mybatis参数传递

（1）单个参数

（2）多个参数

17.注解方式完成增删改查

一、MyBatis

1.概述

MyBatis 是一款优秀的持久层框架，用于简化JDBC 开发
MyBatis 本是Apache 的一个开源项目iBatis,2010年这个项目由apache softwarefoundation 迁移到了google code，并且改名为MyBatis 。2013年11月迁移到Github
网址：mybatis – MyBatis 3 | 简介

辅助插件：MybatisX

2.JavaEE三层架构简单介绍

（1）表现层

页面展示

（2）业务层

逻辑处理

（3）持久层

负责将数据到保存到数据库的那一层代码

3.框架

框架就是一个半成品软件，是一套可重用的、通用的、软件基础代码模型
在框架的基础之上构建软件编写更加高效、规范、通用、可扩展

4.优势

（1）JDBC的劣势

硬编码
- 注册驱动，获取连接
- SQL语句
操作较繁琐
- 手动设置参数
- 手动封装结果集

（2）MyBatis优化

MyBatis 免除了几乎所有的JDBC代码以及设置参数和获取结果集的工作

5.使用

（1）快速上手

框架使用部分：

创建模块，导入坐标
编写核心配置文件
编写SQL映射文件

编码部分：

定义实体类（POJO类）
加载核心配置文件，获取SqlSessionFactory对象
获取SqlSession对象
释放资源

（2）框架使用部分

导入坐标

   <!-- https://mvnrepository.com/artifact/org.mybatis/mybatis -->
        <dependency>
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis</artifactId>
            <version>3.5.9</version>
        </dependency>
<!--        mysql驱动-->
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>5.1.46</version>
        </dependency>
        <!--单元测试-->
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.13</version>
            <scope>test</scope>
        </dependency>

        <!-- 添加slf4j日志api -->
        <dependency>
            <groupId>org.slf4j</groupId>
            <artifactId>slf4j-api</artifactId>
            <version>1.7.20</version>
        </dependency>
        <!-- 添加logback-classic依赖 -->
        <dependency>
            <groupId>ch.qos.logback</groupId>
            <artifactId>logback-classic</artifactId>
            <version>1.2.3</version>
        </dependency>
        <!-- 添加logback-core依赖 -->
        <dependency>
            <groupId>ch.qos.logback</groupId>
            <artifactId>logback-core</artifactId>
            <version>1.2.3</version>
        </dependency>

核心配置文件，文件名通常：mybatis-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>
    <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:///test?useSSL=false&amp;useServerPrepStmts=true"/>
                <property name="username" value="root"/>
                <property name="password" value="root"/>
            </dataSource>
        </environment>
    </environments>
    <mappers>
<!--        加载SQL的映射文件-->
        <mapper resource="ProductMapper.xml"/>
    </mappers>
</configuration>

编写SQL映射文件，名称：要操作的表名+Mapper（ProductMapper.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">
<!--
    namespace:名称空间

-->
<mapper namespace="product">
<!--
    id:sql语句的唯一标识
    resultType:返回结果类型
-->
    <select id="selectAll" resultType="pojo.Product">
        select * from Product;
    </select>
</mapper>

如果映射文件SQL语句中表名爆红，只是警告，并不影响实际操作

产生原因：ldea和数据库没有建立连接，不识别表信息

解决方法：用IDEA与数据库建立连接即可

（3）编码部分

定义实体类

要与数据库中的数据类型对应

使用

public class MybatisDemo {
    public static void main(String[] args) throws IOException {
//        1.加载核心配置文件，直接从官网粘过来就行了，获取SqlSessionFactory对象
        String resource = "mybatis-config.xml";
        InputStream inputStream = Resources.getResourceAsStream(resource);
        SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);

//        2.获取sqlSession对象
        final SqlSession sqlSession = sqlSessionFactory.openSession();

//        3.执行SQL
        final List<Product> list = sqlSession.selectList("product.selectAll");

        System.out.println(list);
//        4.释放资源
        sqlSession.close();

    }
}

6.Mapper代理开发

（1）Mapper代理开发的好处

解决原生方式中的硬编码（更安全）
简化后期执行SQL

（2）Mapper代理使用步骤

定义与SQL映射文件同名的Mapper接口，并且将Mapper接口和SQL映射文件放置在同一目录下

检查方式：编译项目

在文件夹中打开

如下图即为成功

设置SQL映射文件的namespace属性为Mapper接口全限定名
在Mapper 接口中定义方法，方法名就是SQL映射文件中sql语句的id，并保持参数类型和返回值类型一致

【如果Mapper接口名称和SQL映射文件名称相同，并且在同一目录下，则可以使用包扫描的方式简化SQL映射文件的加载，如下图】

编码
- 通过 SqlSession的 getMapper方法获取 Mapper接口的代理对象
- 调用对应方法完成sql的执行

//        3.执行SQL
//        3-1.获取接口的代理对象
        final ProductMapper mapper = sqlSession.getMapper(ProductMapper.class);
        final List<Product> products = mapper.selectAll();
        products.forEach(product -> System.out.println(product));

7.Mybatis的配置文件说明

可访问网址查看，后续再补

8.查询过程出现的问题

如以下情况

原因：实体类属性名称与数据库字段名称不一致，导致不能自动封装数据

解决方法一：

为数据库字段起别名，让其和实体类属性名称一致（麻烦，不推荐）

方法一的优化方案：

写一个SQL语句块，不灵活，还是不推荐~

解决方法二：

结果映射，resultMap【有两个子标签，一个result，一个id，其中id子标签用来完成主键字段的映射，result用来映射普通字段的映射，使用方法与result一致】
type支持别名

再次运行

9.xml文件中编写SQL语句没有提示

在xml文件中按alt+enter

往下拉，根据安装的数据库选择合适的即可

10.查操作

（1）单条件查询

<!--
    参数占位符：
    1.#{}:将其替换为？,为了防止SQL注入。      使用场景：参数传递
    2.${}:拼SQL，存在SQL注入问题。           使用场景：表名或列名不固定的情况，但要注意SQL注入问题

    参数类型：parameterType，可以省略

    特殊字符处理：
    1.转义字符：适合少量
    2.CDATA区：适合大量，CD回车即可
-->
    <select id="selectById"  resultMap="resultMap_Employee">
        select * from employees where emp_no = #{id}
    </select>

    <resultMap id="resultMap_Employee" type="employee">
<!--        将不一样的属性名写一下即可-->
        <result column="emp_no" property="empNo"/>
        <result column="birth_date" property="birthDate"/>
        <result column="first_name" property="firstName"/>
        <result column="last_name" property="lastName"/>
        <result column="hire_date" property="hireDate"/>

    </resultMap>

（2）多条件查询

Mybatis提供了三种方式：

mapper.xml：

<select id="selectByCondition01" resultMap="resultMap_Employee">
    select *
    from employees
    where emp_no > #{empNo}
    and gender = #{gender}
</select>

<select id="selectByCondition02" resultMap="resultMap_Employee">
    select *
    from employees
    where emp_no > #{empNo}
      and gender = #{gender}
</select>

<select id="selectByCondition03" resultMap="resultMap_Employee">
    select *
    from employees
    where emp_no > #{empNo}
      and gender = #{gender}
</select>

    <resultMap id="resultMap_Employee" type="employee">
<!--        将不一样的属性名写一下即可-->
        <result column="emp_no" property="empNo"/>
        <result column="birth_date" property="birthDate"/>
        <result column="first_name" property="firstName"/>
        <result column="last_name" property="lastName"/>
        <result column="hire_date" property="hireDate"/>

    </resultMap>

pojo实体类：

public class Employee {
    private Integer empNo;
    private Date birthDate;
    private String firstName;
    private String lastName;
    private Character gender;
    private Date hireDate;

    public Employee() {
    }

    public Employee(Integer empNo, Character gender) {
        this.empNo = empNo;
        this.gender = gender;
    }

    public Employee(Integer empNo, Date birthDate, String firstName, String lastName, Character gender, Date hireDate) {
        this.empNo = empNo;
        this.birthDate = birthDate;
        this.firstName = firstName;
        this.lastName = lastName;
        this.gender = gender;
        this.hireDate = hireDate;
    }

    public Integer getEmpNo() {
        return empNo;
    }

    public void setEmpNo(Integer empNo) {
        this.empNo = empNo;
    }

    public Date getBirthDate() {
        return birthDate;
    }

    public void setBirthDate(Date birthDate) {
        this.birthDate = birthDate;
    }

    public String getFirstName() {
        return firstName;
    }

    public void setFirstName(String firstName) {
        this.firstName = firstName;
    }

    public String getLastName() {
        return lastName;
    }

    public void setLastName(String lastName) {
        this.lastName = lastName;
    }

    public Character getGender() {
        return gender;
    }

    public void setGender(Character gender) {
        this.gender = gender;
    }

    public Date getHireDate() {
        return hireDate;
    }

    public void setHireDate(Date hireDate) {
        this.hireDate = hireDate;
    }

    @Override
    public String toString() {
        return "Employee{" +
                "empNo=" + empNo +
                ", birthDate=" + birthDate +
                ", firstName='" + firstName + '\'' +
                ", lastName='" + lastName + '\'' +
                ", gender=" + gender +
                ", hireDate=" + hireDate +
                '}';
    }
}

mapper.EmployeeMapper

/**
 * 条件查询01
 * 查询员工工号>?且性别为？的所有员工信息
 * *参数接收方式
 * 1.散装参数：如果方法中有多个参数，需要使用@Param("SQL参数占位符名称”)
 * @param empNo 员工工号
 * @param character 性别
 * @return Employee对象集合
 */
List<Employee> selectByCondition01(@Param("empNo")int empNo,@Param("gender")Character character);

/**
 * 条件查询02：实体类封装参数
 * @param employee 员工对象，注意对象的属性名称要和SQL参数占位符名称一致
 * @return 员工对象集合
 */
List<Employee> selectByCondition02(Employee employee);

/**
 * 条件查询03：map集合
 * @param map map集合，要保证SQL中的参数占位符名称和map集合的键名称一致
 * @return 员工对象集合
 */
List<Employee> selectByCondition03(Map map);

测试：

@Test
public void selectByCondition01() throws IOException {
    String resource = "mybatis-config.xml";
    InputStream inputStream = Resources.getResourceAsStream(resource);
    SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);

    final SqlSession sqlSession = sqlSessionFactory.openSession();

    final List<Employee> employees = sqlSession.getMapper(EmployeeMapper.class).selectByCondition01(10001, 'F');
    employees.forEach(employee -> System.out.println(employee));
    sqlSession.close();
}
    @Test
    public void selectByCondition022() throws IOException {
        String resource = "mybatis-config.xml";
        InputStream inputStream = Resources.getResourceAsStream(resource);
        SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);

        final SqlSession sqlSession = sqlSessionFactory.openSession();

//        final List<Employee> employees = sqlSession.getMapper(EmployeeMapper.class).selectByCondition02(new Employee(10001,'F'));
        Employee employee = new Employee();
        employee.setEmpNo(10001);
        employee.setGender('F');
        final List<Employee> employees = sqlSession.getMapper(EmployeeMapper.class).selectByCondition02(employee);
        employees.forEach(e -> System.out.println(e));
        sqlSession.close();
    }
@Test
public void selectByCondition03() throws IOException {
    String resource = "mybatis-config.xml";
    InputStream inputStream = Resources.getResourceAsStream(resource);
    SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);

    final SqlSession sqlSession = sqlSessionFactory.openSession();
    
    Map map = new HashMap();
    Integer empNo = 10001;
    Character gender = 'F';
    map.put("empNo",empNo);
    map.put("gender",gender);

    final List<Employee> employees = sqlSession.getMapper(EmployeeMapper.class).selectByCondition03(map);
    employees.forEach(e -> System.out.println(e));
    sqlSession.close();
}

11.动态查询

SQL语句会随着用户的输入或外部条件的变化而变化，我们称为动态SQL

mybatis对动态SQL用很大的支撑

if：条件判断
- test：逻辑判断
choose（when，otherwise）
trim（where，set）
foreach

更具体的可查阅官网，动态SQL

（1）多条件动态查询

修改一下：

<select id="selectByCondition03" resultMap="resultMap_Employee">
    select *
    from employees
    where
        <if test="empNo != null and empNo != ''">
            emp_no > #{empNo}
        </if>
        <if test="gender !=null ">
            and gender = #{gender}
        </if>

</select>

测试时会发现如果没有第一个参数后面会报错

解决方法：

第一种方法：统一格式，第一个条件为一个恒等式

            where
#             恒等式
            <if test="empNo != null and empNo != ''">
                and emp_no > #{empNo}
            </if>
            <if test="gender !=null ">
                and gender = #{gender}
            </if>

第二种方法：使用< where >标签替换where关键字

<where>
    <if test="empNo != null and empNo != ''">
        and emp_no > #{empNo}
    </if>
    <if test="gender !=null ">
        and gender = #{gender}
    </if>
</where>

测试：

（2）单条件动态查询（多选一）

<select id="selectByConditionSingle" resultMap="resultMap_Employee">
        select * from employees
    where
        <choose>
            <when test="empNo != null">
                emp_no > #{empNo}
            </when>
            <when test="gender !=null">
                gender = #{gender}
            </when>
            <when test="lastName != null">
                last_name like #{lastName}
            </when>
            <otherwise>
<!--                相当于java switch中的default，写个恒等式即可-->
                
                1 = 1
            </otherwise>
        </choose>
    </select>

或者

<where>
    <choose>
        <when test="empNo != null">
            emp_no > #{empNo}
        </when>
        <when test="gender !=null">
            gender = #{gender}
        </when>
        <when test="lastName != null">
            last_name like #{lastName}
        </when>
    </choose>
</where>

12.增操作

<insert id="add">
    insert into employees
        (first_name,last_name,gender,birth_date,hire_date)
    VALUES
        (#{firstName},#{lastName},#{gender},#{birthDate},#{hireDate})
</insert>

测试的时候会发现代码运行成功但并没有数据！

打开日志，会发现roll back了

观察日志就会发现 -Setting autocommit to false on JDBC Connection

所以在增操作后，需要使用commit（）手动提交一次事务！

再次运行，数据添加成功

如果不想手动提交，可在openSession()传递布尔值以开启是否自动提交

mybatis默认是开启事务的