MyBatis.md
第 1 章 框架概述

1.3 JDBC 编程

1.3.1 :JDBC 编程

  1. public void findStudent() {
  2. Connection conn = null;
  3. Statement stmt = null;
  4. ResultSet rs = null;
  5. try {
  6. //注册mysql驱动
  7. Class.forName("com.mysql.jdbc.Driver");
  8. //连接数据的基本信息 url ,username,password
  9. String url = "jdbc:mysql://localhost:3306/springdb";
  10. String username = "root";
  11. String password = "123456";
  12. //创建连接对象
  13. conn = DriverManager.getConnection(url, username, password);
  14. //保存查询结果
  15. List<Student> stuList = new ArrayList<>();
  16. //创建Statement, 用来执行sql语句
  17. stmt = conn.createStatement();
  18. //执行查询,创建记录集,
  19. rs = stmt.executeQuery("select * from student");
  20. while (rs.next()) {
  21. Student stu = new Student();
  22. stu.setId(rs.getInt("id"));
  23. stu.setName(rs.getString("name"));
  24. stu.setAge(rs.getInt("age"));
  25. //从数据库取出数据转为Student对象,封装到List集合
  26. stuList.add(stu);
  27. }
  28. } catch (Exception e) {
  29. e.printStackTrace();
  30. } finally {
  31. try {
  32. //关闭资源
  33. if (rs != null) ;
  34. {
  35. rs.close();
  36. }
  37. if (stmt != null) {
  38. stmt.close();
  39. }
  40. if (conn != null) {
  41. conn.close();
  42. }
  43. } catch (Exception e) {
  44. e.printStackTrace();
  45. }
  46. }
  47. }

1.3.2:缺陷

  1. 代码比较多,开发效率低
  2. 需要关注 Connection ,Statement, ResultSet 对象创建和销毁
  3. 对 ResultSet 查询的结果,需要自己封装为 List
  4. 重复的代码比较多些
  5. 业务代码和数据库的操作混在一起

    1.4 MyBatis 框架概述

    是一个基于 Java 的持久层框架。减轻使用 JDBC 的复杂性,不用编写重复的创建 Connetion , Statement ;不用编写关闭资源代码。直接使用 java 对象,表示结果数据。让开发者专注 SQL 的处理。 其他分心的工作由 MyBatis 代劳。
    MyBatis 可以完成:

  6. 注册数据库的驱动,例如 Class.forName(“com.mysql.jdbc.Driver”))

  7. 创建 JDBC 中必须使用的 Connection , Statement, ResultSet 对象
  8. 从 xml 中获取 sql,并执行 sql 语句,把 ResultSet 结果转换 java 对象
  9. 关闭资源:ResultSet.close() , Statement.close() , Conenection.close()

缺点:
1、SQL 语句的编写工作量较大,尤其当字段多、关联表多时,对开发人员编写 SQL 语句的功底有一定要求。
2、SQL 语句依赖于数据库,导致数据库移植性差,不能随意更换数据库

对 Hibernate 对比

Mybatis 是一个半自动的 ORM 框架,在查询关联对象或关联集合对象时,需要手动编写 sql 语句来完成;
Hibernate 是全自动 ORM 映射工具,查询关联对象或者关联集合对象时,可以根据对象关系模型直接获取,不需要编写 sql.
Mybatis 直接编写原生态 sql,可以严格控制 sql 执行性能,灵活度高, 非常适合对性能要求高,需求变化频繁的项目;但是如果涉及到较多的字段或者关联多表时,sql 语句编写量大且对开发人的 sql 语句编写功底要求高。
Hibernate 对象/关系映射能力强,数据库无关性好,适合需求变化不大的项目,使用 hibernate 开发可以节省很多代码,提高效率。

第 2 章 MyBatis 框架快速入门

2.1 入门案例

搭建 MyBatis 开发环境,实现第一个案例
下载 mybatis
https://github.com/mybatis/mybatis-3/releases
(1) 创建 mysql 数据库和表
MyBatis - 图1

2) 创建 maven 工程
创建 maven 工程,信息如下:模板:
3) 删除默认创建的 App 类文件
(4)添加 Maven 依赖

  1. <dependencies>
  2. <dependency>
  3. <groupId>junit</groupId>
  4. <artifactId>junit</artifactId>
  5. <version>4.11</version>
  6. <scope>test</scope>
  7. </dependency>
  8. <dependency>
  9. <groupId>org.mybatis</groupId>
  10. <artifactId>mybatis</artifactId>
  11. <version>3.5.1</version>
  12. </dependency>
  13. <dependency>
  14. <groupId>mysql</groupId>
  15. <artifactId>mysql-connector-java</artifactId>
  16. <version>5.1.9</version>
  17. </dependency>
  18. </dependencies>

5) 加入 maven 插件

  1. <build>
  2. <resources>
  3. <resource>
  4. <directory>src/main/java</directory><!--所在的目录-->
  5. <includes><!--包括目录下的.properties,.xml 文件都会扫描到-->
  6. <include>**/*.properties</include>
  7. <include>**/*.xml</include>
  8. </includes>
  9. <filtering>false</filtering>
  10. </resource>
  11. </resources>
  12. <plugins>
  13. <plugin>
  14. <artifactId>maven-compiler-plugin</artifactId>
  15. <version>3.1</version>
  16. <configuration>
  17. <source>1.8</source>
  18. <target>1.8</target>
  19. </configuration>
  20. </plugin>
  21. </plugins>
  22. </build>

6) 编写 Student 实体类
创建包 com.xqc.domain, 包中创建 Student 类

  1. package com.xqc.domain;
  2. /**
  3. * <p>Description: 实体类 </p>
  4. * <p>Company: http://www.xqc.com
  5. */
  6. public class Student {
  7. //属性名和列名一样
  8. private Integer id;
  9. private String name;
  10. private String email;
  11. private Integer age;
  12. // set ,get , toString
  13. }

7) 编写 Dao 接口 StudentDao

  1. package com.xqc.dao;
  2. import com.xqc.domain.Student;
  3. import java.util.List;
  4. /**
  5. * <p>Description: Dao接口 </p>
  6. * <p>Company: http://www.xqc.com
  7. */
  8. public interface StudentDao {
  9. /*查询所有数据*/
  10. List<Student> selectStudents();
  11. }

8) 编写 Dao 接口 Mapper 映射文件 StudentDao.xml
要求:

  1. 在 dao 包中创建文件 StudentDao.xml
  2. 要 StudentDao.xml 文件名称和接口 StudentDao 一样,区分大小写的一样。
  1. <?xml version="1.0" encoding="UTF-8" ?>
  2. <!DOCTYPE mapper
  3. PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
  4. "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
  5. <!--
  6. namespace:必须有值,自定义的唯一字符串
  7. 推荐使用:dao接口的全限定名称
  8. -->
  9. <mapper namespace="com.xqc.dao.StudentDao">
  10. <!--
  11. <select>: 查询数据, 标签中必须是select语句
  12. id: sql语句的自定义名称,推荐使用dao接口中方法名称,
  13. 使用名称表示要执行的sql语句
  14. resultType: 查询语句的返回结果数据类型,使用全限定类名
  15. -->
  16. <select id="selectStudents" resultType="com.xqc.domain.Student">
  17. <!--要执行的sql语句-->
  18. select id,name,email,age from student
  19. </select>
  20. </mapper>

9) 创建 MyBatis 主配置文件
项目 src/main 下创建 resources 目录,设置 resources 目录为 resources root 创建主配置文件:名称为 mybatis.xml
说明:主配置文件名称是自定义的,内容如下:

  1. <?xml version="1.0" encoding="UTF-8" ?>
  2. <!DOCTYPE configuration
  3. PUBLIC "-//mybatis.org//DTD Config 3.0//EN" "http://mybatis.org/dtd/mybatis-3-config.dtd">
  4. <!--配置mybatis环境-->
  5. <environments default="mysql">
  6. <!--id:数据源的名称-->
  7. <environment id="mysql">
  8. <!--配置事务类型:使用JDBC事务(使用Connection的提交和回滚)-->
  9. <transactionManager type="JDBC"/>
  10. <!--数据源dataSource:创建数据库Connection对象
  11. type: POOLED 使用数据库的连接池
  12. -->
  13. <dataSource type="POOLED">
  14. <!--连接数据库的四个要素-->
  15. <property name="driver" value="com.mysql.jdbc.Driver"/>
  16. <property name="url" value="jdbc:mysql://localhost:3306/ssm"/>
  17. <property name="username" value="root"/>
  18. <property name="password" value="123456"/>
  19. </dataSource>
  20. </environment>
  21. </environments>
  22. <mappers>
  23. <!--告诉mybatis要执行的sql语句的位置-->
  24. <mapper resource="com/xqc/dao/StudentDao.xml"/>
  25. </mappers>
  26. <configuration>

支持中文的 url:jdbc:mysql://localhost:3306/ssm?useUnicode=true&characterEncoding=utf-8
10) 创建测试类 MyBatisTest
src/test/java/com/xqc/ 创建 MyBatisTest.java 文件

  1. @Test
  2. public void testStart() throws IOException{
  3. //1.mybatis主配置文件
  4. String config = "mybatis-config.xml";
  5. //2:读取配置文件
  6. InputStream in = Resources.getResourceAsStream(config);
  7. //3.创建SqlSessionFactory对象,目的是获取SqlSession
  8. SqlSessionFactory factory = new SqlSessionFactoryBuilder().build(in);
  9. //4.获取SqlSession,SqlSession能执行sql语句
  10. SqlSession session = factory.openSession();
  11. //5.执行SqlSession的selectList()
  12. List<Student> studentList = session.selectList("com.xqc.dao.StudentDao.selectStudents");
  13. //6.循环输出查询结果
  14. studentList.forEach( student -> System.out.println(student));
  15. //7.关闭SqlSession,释放资源 session.close();
  16. }
  17. List<Student> studentList = session.selectList("com.xqc.dao.StudentDao.selectStudents"); 近似等价的 jdbc 代码
  18. Connection conn = 获取连接对象
  19. String sql=” select id,name,email,age from student
  20. PreparedStatement ps = conn.prepareStatement(sql);
  21. ResultSet rs = ps.executeQuery();

11) 配置日志功能
mybatis.xml 文件加入日志配置,可以在控制台输出执行的 sql 语句和参数


2.2 基本的 CURD

查询一个 selectOne
insert ,update ,delete

2.2.1 insert

(1) StudentDao 接口中增加方法
int insertStudent(Student student);
(2) StudentDao.xml 加入 sql 语句
insert into student(id,name,email,age)
values(#{id},#{name},#{email},#{age})

(3) 增加测试方法

  1. @Test
  2. public void testInsert() throws IOException {
  3. //1.mybatis主配置文件
  4. String config = "mybatis-config.xml";
  5. //2.读取配置文件
  6. InputStream in = Resources.getResourceAsStream(config);
  7. //3.创建SqlSessionFactory对象
  8. SqlSessionFactory factory = new SqlSessionFactoryBuilder().build(in);
  9. //4.获取SqlSession
  10. SqlSession session = factory.openSession();
  11. //5.创建保存数据的对象
  12. Student student = new Student();
  13. student.setId(1005);
  14. student.setName("张丽");
  15. student.setEmail("zhangli@163.com");
  16. student.setAge(20);
  17. //6.执行插入insert
  18. int rows = session.insert("com.xqc.dao.StudentDao.insertStudent",student);
  19. //7.提交事务
  20. System.out.println("增加记录的行数:"+rows);
  21. //8.关闭SqlSession
  22. session.close();
  23. }

2.2.2 update

(1) StudentDao 接口中增加方法
int updateStudent(Student student);
(2) StudentDao.xml 增加 sql 语句
update student set age = #{age} where id=#{id}

(3) 增加测试方法
(4)问:Mybatis 如果 Update 一个没有的数据项会怎么办??
实验证明:不会怎么样,也不会报错,也不会增加数据

2.2.3 delete

(1) StudentDao 接口中增加方法
int deleteStudent(int id);
(2) StudentDao.xml 增加 sql 语句
delete from student where id=#{studentId}

2.3 MyBatis 对象分析

2.3.1 对象使用

(1) Resources 类
Resources 类,顾名思义就是资源,用于读取资源文件。其有很多方法通过加载并解析资源文件,返回不同类型的 IO 流对象。
(2) SqlSessionFactoryBuilder 类
SqlSessionFactory 的创建,需要使用 SqlSessionFactoryBuilder 对象的 build()方法。由于 SqlSessionFactoryBuilder 对象在创建完工厂对象后,就完成了其历史使命,即可被销毁。所以,一般会将该 SqlSessionFactoryBuilder 对象创建为一个方法内的局部对象,方法结束,对象销毁。
(3) SqlSessionFactory 接口
SqlSessionFactory 接口对象是一个重量级对象(系统开销大的对象),是线程安全的,所以一个应用只需要一个该对象即可。创建 SqlSession 需要使用 SqlSessionFactory 接口的 openSession()方法。
SqlSessionFactory 是 MyBatis 的关键对象,它是个单个数据库映射关系经过编译后的内存镜像.SqlSessionFactory 对象的实例可以通过 SqlSessionFactoryBuilder 对象类获得,SqlSessionFactoryBuilder 则可以从 XML 配置文件或一个预先定制的 Configuration 的实例构建出 SqlSessionFactory 的实例.每一个 MyBatis 的应用程序都以一个 SqlSessionFactory 对象的实例为核心.同时 SqlSessionFactory 也是线程安全的,SqlSessionFactory 一旦被创建,应该在应用执行期间都存在.在应用运行期间不要重复创建多次,建议使用单例模式.SqlSessionFactory 是创建 SqlSession 的工厂.
openSession(true):创建一个有自动提交功能的 SqlSession
openSession(false):创建一个非自动提交功能的 SqlSession,需手动提交
openSession():同 openSession(false)
mybatis 框架主要是围绕着 SqlSessionFactory 进行的,创建过程大概如下:
(1)、定义一个Configuration对象,其中包含数据源、事务、mapper文件资源以及影响数据库行为属性设置settings

(2)、通过配置对象,则可以创建一个SqlSessionFactoryBuilder对象

(3)、通过 SqlSessionFactoryBuilder 获得SqlSessionFactory 的实例。

(4)、SqlSessionFactory 的实例可以获得操作数据的SqlSession实例,通过这个实例对数据库进行操
(4)SqlSession 接口
SqlSession 接口对象用于执行持久化操作。一个 SqlSession 对应着一次数据库会话,一次会话以 SqlSession 对象的创建开始,以 SqlSession 对象的关闭结束。
SqlSession 的实例不能被共享,SqlSession 接口对象是线程不安全的,所以每次数据库会话结束前,需要马上调用其 close()方法,将其关闭。再次需要会话,再次创建。 SqlSession 在方法内部创建,.使用完 SqlSeesion 之后关闭 Session 很重要,应该确保使用 finally 块来关闭它.

3.1 Dao 代理实现 CURD

3.1.1:步骤

1) 去掉 Dao 接口实现类
只需调用 SqlSession 的 getMapper()方法,即可获取指定接口的实现类对象。该方法的参数为指定 Dao 接口类的 class 值。
SqlSession session = factory.openSession();
StudentDao dao = session.getMapper(StudentDao.class);
使用工具类:
StudentDao studentDao = MyBatisUtil.getSqlSession().getMapper(StudentDao.class);
3) 使用 Dao 代理对象方法执行 sql 语句
select 方法:

  1. @Test
  2. public void testSelect() throws IOException{
  3. final List<Student> studentList = studentDao.selectStudents();
  4. studentList.foreach(stu->System.out.println(stu));
  5. }
  6. update 方法
  7. @Test
  8. public void testUpdate() throws IOException{
  9. Student student = new Student();
  10. student.setId(10086);
  11. student.setAge(28);
  12. int nums = studentDao.updateStudent(student);
  13. System.out.println(nums);
  14. }
  15. delete 方法
  16. StudentDao.delectStudent(1006);

3.1.2 原理

动态代理

  1. MapperProxy 类定义
  2. public class MapperProxy<T> implements InvocationHandlerSerializable {
  3. @Override
  4. public Object invoke(Object proxyMethod method0bject[] args)
  5. try {
  6. if (object.class.equals(method.getDeclaringClass())) {
  7. return method.invoke(this,args) ;
  8. }else if (isDefaultMethod ( method)) {
  9. return invokeDefaultMethod (proxy,methodargs);}
  10. }catch (Throwable t) {
  11. throw ExceptionUtil.unwrapThrowable(t);
  12. }final MapperMethod mapperMethod = cachedMapperMethod(method) ;
  13. return mapperMethod.execute(sqlsession,args);
  14. }
  15. public Object execute( SqlSession sqlSession0bject[] args){
  16. Object result;
  17. switch ( command . getType()) {
  18. case INSERT: {
  19. Object param = method.convertArgsTosqlCommandParam(args);
  20. result - rowCountResult(sqlsession.insert(command.getName(), param);
  21. break;
  22. }
  23. case UPDATE: {
  24. Object param = method.convertArgsToSqlCommandParam(args);
  25. result = rowCountResult(sqlsession.update(command.getName(), param);
  26. break;
  1. }

3.2 深入理解参数

3.2.1 parameterType

parameterType: 接口中方法参数的类型,类型的完全限定名或别名。这个属性是可选的,因为 MyBatis 可以推断出具体传入语句的参数,默认值为未设置(unset)。
接口中方法的参数从 java 代码传入到 mapper 文件的 sql 语句。

select * from student where id = #{studentId}

#{studentId} , studentId 是自定义的变量名称,和方法参数名无关。

多个参数-使用@Param

当 Dao 接口方法多个参数,需要通过名称使用参数。在方法形参前面加入@Param(“自定义参数名”),
mapper 文件使用#{自定义参数名}。
例如
List selectMultiParam(@Param(“Name”)String name,@Param(“Age”)int age);
mapper 文件:

测试方法:

多个参数-使用对象

使用 java 对象传递参数, java 的属性值就是 sql 需要的参数值。每一个属性就是一个参数。
语法格式: #{ property,javaType=java 中数据类型名,jdbcType=数据类型名称 }
javaType, jdbcType 的类型 MyBatis 可以检测出来,一般不需要设置。
常用格式 #{property }
MyBatis - 图2

创建保存参数值的对象 QueryParam
package com.xqc.vo;
public class QueryParam{
private String queryName;
private int queryAge;
//get和set
}
接口方法:
List selectMultiObject(QueryParam queryParam);
mapper 文件:

或者

多个参数-按位置

参数位置从 0 开始, 引用参数语法 #{ arg 位置 } , 第一个参数是#{arg0},第二个是#{arg1}
注意:mybatis-3.3 版本和之前的版本使用#{0},#{1}方式, 从 mybatis3.4 开始使用#{arg0}方式。
接口方法:
List selectByNameAndAge(String name,int age);
mapper 文件

多个参数-使用 Map

Map 集合可以存储多个值,使用 Map 向 mapper 文件一次传入多个参数。Map 集合使用 String 的 key, Object 类型的值存储参数。 mapper 文件使用 # { key } 引用参数值。
例如:
Map data = new HashMap();
data.put(“myname”,”李力”);
data.put(“myage”,20);
接口方法:
List selectMultiMap(Map map)
mapper 文件:

3.2.8 #和$

1:传入的值
#将传入的数据都当成一个字符串,会对自动传入的数据加一个双引号。
如:where username = #{username} 会解析成 where username = “111”
$将传入的数据直接显示生成在 sql 中。
如:where username=${username}会解析成 where username = 111
#方式可以很大程度防止 sql 注入
2:防止注入攻击
$这样的参数会直接参与 sql 编译,从而不能避免注入攻击
#占位符,告诉 mybatis 使用实际的参数值代替。并使用 PrepareStatement 对象执行 sql 语句,
#{…}代替 sql 语句的“?”。这样做更安全,更迅速,通常也是首选做法

3.3 封装 MyBatis 输出结果

3.3.1:resultType

resultType: 执行 sql 得到 ResultSet 转换的类型,使用类型的完全限定名或别名。注意如果返回的是集合,那应该设置为集合包含的类型,而不是集合本身。resultType 和 resultMap,不能同时使用。

3.3.2 resultMap

resultMap 可以自定义 sql 的结果和 java 对象属性的映射关系。更灵活的把列值赋值给指定属性。常用在列名和 java 对象属性名不一样的情况。

3.3.3 实体类属性名和列名不同

(1) 使用列别名和
(2) 使用

3.4 模糊 like

模糊查询的实现有两种方式,
一是 java 代码中给查询数据加上“%” ;
二是在 mapper 文件 sql 语句的条件位置加上“%”
需求:查询姓名有“力”的
例 1: java 代码中提供要查询的 “%力%” 接口方法:
List selectLikeFirst(String name);
mapper 文件:

此时传入的 studentName 为应该为% 力 %
例 2:mapper 文件中使用 like name “%” #{xxx} “%”
接口方法:
List selectLikeSecond(String name);
mapper 文件:

第 4 章 动态 SQL

动态 SQL,通过 MyBatis 提供的各种标签对条件作出判断以实现动态拼接 SQL 语句。这里的条件判断使用的表达式为 OGNL 表达式。常用的动态 SQL 标签有等。
MyBatis 的动态 SQL 语句,与 JSTL 中的语句非常相似。
动态 SQL,主要用于解决查询条件不确定的情况:在程序运行期间,根据用户提交的查询条件进行查询。提交的查询条件不同,执行的 SQL 语句不同。若将每种可能的情况均逐一列出,对所有条件进行排列组合,将会出现大量的 SQL 语句。此时,可使用动态 SQL 来解决这样的问题

4.1 环境准备

在 mapper 的动态 SQL 中若出现大于号(>)、小于号(<)、大于等于号(>=),小于等于号(<=)等符号,最好将其转换为实体符号。否则,XML 可能会出现解析出错问题。
特别是对于小于号(<),在 XML 中是绝不能出现的。否则解析 mapper 文件会出错。
实体符号表:

< 小于 <
> 大于 >
>= 大于等于 >=
<= 小于等于 <=

4.2

对于该标签的执行,当 test 的值为 true 时,会将其包含的 SQL 片断拼接到其所在的 SQL 语句中。
语法: sql 语句的部分
接口方法:
List selectStudentIf (Student student);
mapper 文件:

测试:
List studentList = studentDao.selectStudentIf(param);
studentList.forEach( stu -> System.out.println(stu));
Mybatis 映射几种:
1:没有传该数据项就不插入
2:如果没有传该对象就插入一个默认值
3:查询条件不为空就添加该查询条件

4.3

标签的中存在一个比较麻烦的地方:需要在 where 后手工添加 1=1 的子句。因为,若 where 后的所有条件均为 false,而 where 后若又没有 1=1 子句,则 SQL 中就会只剩下一个空的 where,SQL 出错。所以,在 where 后,需要添加永为真子句 1=1,以防止这种情况的发生。但当数据量很大时,会严重影响查询效率。
使用标签,在有查询条件时,可以自动添加上 where 子句;没有查询条件时,不会添加 where 子句。需要注意的是,第一个标签中的 SQL 片断,可以不包含 and。不过,写上 and 也不错,系统会将多出的 and 去掉。但其它中 SQL 片断的 and,必须要求写上。否则 SQL 语句将拼接出错 。
接口方法:
List selectStudentWhere (Student student);
mapper 文件:

4.4

标签用于实现对于数组与集合的遍历。对其使用,需要注意:
collection 表示要遍历的集合类型, list ,array 等。
open、close、separator 为对遍历内容的 SQL 拼接。
(1) 遍历 List<简单类型>
表达式中的 List 使用 list 表示,其大小使用 list.size 表示。
需求:查询学生 id 是 1002,1005,1006
接口方法:
List selectStudentForList(List idList);
mapper 文件:

  1. <select id="selectStudentForList" resultType="com.xqc.domain.Student">
  2. select id,name,email,age from student
  3. <if test="list !=null and list.size > 0 ">
  4. where id in
  5. <foreach collection="list" open="(" close=")" item="stuid" separator=",">
  6. #{stuid}
  7. </foreach>
  8. </if>
  9. </select>

2) 遍历 List<对象类型>
接口方法:
List selectStudentForList2(List stuList);
mapper 文件:

  1. <select id="selectStudentForList2" resultType="com.bjpowernode.domain.Student">
  2. select id,name,email,age from student
  3. <if test="list !=null and list.size > 0 ">
  4. where id in
  5. <foreach collection="list" open="(" close=")" item="stuobject" separator=",">
  6. #{stuobject.id}
  7. </foreach>
  8. </if>
  9. </select>

4.5

标签用于定义 SQL 片断,以便其它 SQL 标签复用。而其它标签使用该 SQL 片断,需要使用子标签。

4.6

choose 标签是按顺序判断其内部 when 标签中的 test 条件出否成立,如果有一个成立,则 choose 结束。当 choose 中所有 when 的条件都不满则时,则执行 otherwise 中的 sql

4.7

一般用于去除 sql 语句中多余的 and 关键字,逗号,或者给 sql 语句前拼接“where“、“set“以及“values(“等前缀,或者添加“)“等后缀,可用于选择性插入、更新、删除或者条件查询等操作

属性 描述
prefix 给 sql 语句拼接的前缀
suffix 给 sql 语句拼接的后缀
prefixOverrides 去除 sql 语句前面的关键字或者字符,该关键字或者字符由 prefixOverrides 属性指定,假设该属性指定为”AND”,当 sql 语句的开头为”AND”,trim 标签将会去除该”AND”
suffixOverrides 去除 sql 语句后面的关键字或者字符,该关键字或者字符由 suffixOverrides 属性指定

如果都没匹配上:SELECT FROM BLOG WHERE
如果仅有第二个匹配上:SELECT
FROM BLOG WHERE AND title like ‘someTitle’
你也可以使用 where 标签去完成该问题

4.8<![CDATA[ ]]>

在 CDATA 内部的所有内容都会被解析器忽略。

4.9:Begin And

第 5 章 配置文件

5.1 主配置文件

主配置文件特点:
1:xml 文件,需要在头部使用约束文件
2:根元素,<configuration>
3.主要包含内容:

  1. <!-- settings是 MyBatis 中全局的调整设置,它们会改变 MyBatis 的运行时行为,应谨慎设置 -->
  2. <settings>
  3. <!-- 该配置影响的所有映射器中配置的缓存的全局开关。默认值true -->
  4. <setting name="cacheEnabled" value="true"/>
  5. <!--延迟加载的全局开关。当开启时,所有关联对象都会延迟加载。 特定关联关系中可通过设置fetchType属性来覆盖该项的开关状态。默认值false -->
  6. <setting name="lazyLoadingEnabled" value="true"/>
  7. <!-- 是否允许单一语句返回多结果集(需要兼容驱动)。 默认值true -->
  8. <setting name="multipleResultSetsEnabled" value="true"/>
  9. <!-- 使用列标签代替列名。不同的驱动在这方面会有不同的表现, 具体可参考相关驱动文档或通过测试这两种不同的模式来观察所用驱动的结果。默认值true -->
  10. <setting name="useColumnLabel" value="true"/>
  11. <!-- 允许 JDBC 支持自动生成主键,需要驱动兼容。 如果设置为 true 则这个设置强制使用自动生成主键,尽管一些驱动不能兼容但仍可正常工作(比如 Derby)。 默认值false -->
  12. <setting name="useGeneratedKeys" value="false"/>
  13. <!-- 指定 MyBatis 应如何自动映射列到字段或属性。 NONE 表示取消自动映射;PARTIAL 只会自动映射没有定义嵌套结果集映射的结果集。 FULL 会自动映射任意复杂的结果集(无论是否嵌套)。 -->
  14. <!-- 默认值PARTIAL -->
  15. <setting name="autoMappingBehavior" value="PARTIAL"/>
  16. <setting name="autoMappingUnknownColumnBehavior" value="WARNING"/>
  17. <!-- 配置默认的执行器。SIMPLE 就是普通的执行器;REUSE 执行器会重用预处理语句(prepared statements); BATCH 执行器将重用语句并执行批量更新。默认SIMPLE -->
  18. <setting name="defaultExecutorType" value="SIMPLE"/>
  19. <!-- 设置超时时间,它决定驱动等待数据库响应的秒数。 -->
  20. <setting name="defaultStatementTimeout" value="25"/>
  21. <setting name="defaultFetchSize" value="100"/>
  22. <!-- 允许在嵌套语句中使用分页(RowBounds)默认值False -->
  23. <setting name="safeRowBoundsEnabled" value="false"/>
  24. <!-- 是否开启自动驼峰命名规则(camel case)映射,即从经典数据库列名 A_COLUMN 到经典 Java 属性名 aColumn 的类似映射。 默认false -->
  25. <setting name="mapUnderscoreToCamelCase" value="false"/>
  26. <!-- MyBatis 利用本地缓存机制(Local Cache)防止循环引用(circular references)和加速重复嵌套查询。
  27. 默认值为 SESSION,这种情况下会缓存一个会话中执行的所有查询。
  28. 若设置值为 STATEMENT,本地会话仅用在语句执行上,对相同 SqlSession 的不同调用将不会共享数据。 -->
  29. <setting name="localCacheScope" value="SESSION"/>
  30. <!-- 当没有为参数提供特定的 JDBC 类型时,为空值指定 JDBC 类型。 某些驱动需要指定列的 JDBC 类型,多数情况直接用一般类型即可,比如 NULL、VARCHAR 或 OTHER。 -->
  31. <setting name="jdbcTypeForNull" value="OTHER"/>
  32. <!-- 指定哪个对象的方法触发一次延迟加载。 -->
  33. <setting name="lazyLoadTriggerMethods" value="equals,clone,hashCode,toString"/>
  34. </settings>

5.2 dataSource 连接池

Mybatis 中访问数据库,可以连接池技术,但它采用的是自己的连接池技术。在 Mybatis 的 mybatis.xml 配置文件中,通过来实现 Mybatis 中连接池的配置。
dataSource 类型:Mybatis 将数据源分成三类
UNPOOLED 不使用连接池的数据源
POOLED 使用连接池的数据源
JNDI 使用 JNDI 实现的数据源
其中 UNPOOLED ,POOLED 数据源实现了 javax.sq.DataSource 接口, JNDI 和前面两个实现方式不同,
dataSource 配置






MyBatis 在初始化时,根据的 type 属性来创建相应类型的的数据源 DataSource,即: type=”POOLED”:MyBatis 会创建 PooledDataSource 实例 type=”UNPOOLED” : MyBatis 会创建 UnpooledDataSource 实例 type=”JNDI”:MyBatis 会从 JNDI 服务上查找 DataSource 实例,然后返回使用

5.3 事务

(1) 默认需要手动提交事务
Mybatis 框架是对 JDBC 的封装,所以 Mybatis 框架的事务控制方式,本身也是用 JDBC 的 Connection 对象的 commit(), rollback() .Connection 对象的 setAutoCommit()方法来设置事务提交方式的。自动提交和手工提交、该标签用于指定 MyBatis 所使用的事务管理器。MyBatis 支持两种事务管理器类型:JDBCMANAGED

  • JDBC:使用 JDBC 的事务管理机制。即,通过 Connection 的 commit()方法提交,通过 rollback()方法回滚。但默认情况下,MyBatis 将自动提交功能关闭了,改为了手动提交。即程序中需要显式的对事务进行提交或回滚。从日志的输出信息中可以看到。

MyBatis - 图3

  • MANAGED:由容器来管理事务的整个生命周期(如 Spring 容器)。

2) 自动提交事务
设置自动提交的方式,factory 的 openSession() 分为有参数和无参数的。
SqlSession openSession();
SqlSession openSession(boolean autoCommit);
有参数为 true,使用自动提交,可以修改 MyBatisUtil 的 getSqlSession()方法。session = factory.openSession(true);再执行 insert 操作,无需执行 session.commit(),事务是自动提交的

5.4 使用数据库属性配置文件

为 了方便对数据库连接的管理,DB 连接四要素数据一般都是存放在一个专门的属性文件中的。MyBatis 主配置文件需要从这个属性文件中读取这些数据。
步骤:
1) 在 classpath 路径下,创建 properties 文件
在 resources 目录创建 jdbc.properties 文件,文件名称自定义。
MyBatis - 图4

2) 使用 properties 标签

5.5 typeAliases(类型别名)
Mybatis 支持默认别名,我们也可以采用自定义别名方式来开发,主要使用在
select from account


select: 填写我们要调用的 select 映射的 id
column : 填写我们要传递给 select 映射的参数
用户的业务接口
开启*Mybatis
的延迟加载策略
进入 Mybaits 的官方文档,找到 settings 的说明信息:
我们需要在 Mybatis 的配置文件 SqlMapConfig.xml 文件中添加延迟加载的配置。

1.2 使用 Collection 实现延迟加载

同样我们也可以在一对多关系配置的结点中配置延迟加载策略。
结点中也有 select 属性,column 属性。
需求:
完成加载用户对象时,查询该用户所拥有的账户信息。

第 11 章 Mybatis 缓存

像大多数的持久化框架一样,Mybatis 也提供了缓存策略,通过缓存策略来减少数据库的查询次数,从而提高性能。
Mybatis 中缓存分为一级缓存,二级缓存。
MyBatis - 图5

一级缓存: 基于 PerpetualCache 的 HashMap 本地缓存,其存储作用域为 Session,当 Session flush 或 close 之后,该 Session 中的所有 Cache 就将清空。
二级缓存与一级缓存其机制相同,默认也是采用 PerpetualCache,HashMap 存储,不同在于 其存储作用域为 Mapper(Namespace),并且可自定义存储源,如 Ehcache。
对于缓存数据更新机制,当某一个作用域(一级缓存 Session/二级缓存 Namespaces)的进行了 C/U/D 操作后,默认该作用域下所有 select 中的缓存将被 clear。
但是二级缓存会带来问题:
因为二级缓存时保存在 Mapper 对象中的,如果一个 user 的操作对应了两个 mapper,Amapper.xml 修改后 Bmapper.xml 是无法感知到的。
例如:
对于 tableA 与 tableB 的操作定义在两个 Mapper 中,分别叫做 MapperA 与 MapperB,即它们属于两个命名空间,如果此时启用缓存:
MapperA 中执行上述 sql 语句查询这 6 个字段
tableB 更新了 col1 与 col2 两个字段
MapperA 再次执行上述 sql 语句查询这 6 个字段〈前提是没有执行过任何 insert、delete、update 操作) 此时问题就来了,即使第(2)步 tableB 更新了 col1 与 col2 两个字段,第(3)步 MapperA 走二级缓存查询到的这 6 个字段依然是原来的这 6 个字段的值

1:Mybatis 一级缓存

1.1 证明一级缓存的存在

一级缓存是 SqlSession 级别的缓存,只要 SqlSession 没有 flush 或 close,它就存在。
编写用户持久层Dao接口
public interface IUserDao {
/
根据id查询
@param userId
@return
/
User findById(Integer userId);
}
编写用户持久层映射文件
<?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">




编写测试方法
/


Title: MybastisCRUDTest


Description: 一对多的操作


Company: http://www.xqc.com/


*/
public class UserTest {
private InputStream in ;
private SqlSessionFactory factory;
private SqlSession session;
private IUserDao userDao;
@Test
public void testFindById() {
//6.执行操作
User user = userDao.findById(41);
System.out.println(“第一次查询的用户:”+user);
User user2 = userDao.findById(41);
System.out.println(“第二次查询用户:”+user2);
System.out.println(user == user2);
}

  1. @Before//在测试方法执行之前执行<br /> public void init()throws Exception {<br /> //1.读取配置文件<br /> in = Resources.getResourceAsStream("SqlMapConfig.xml");<br /> //2.创建构建者对象<br /> SqlSessionFactoryBuilder builder = new SqlSessionFactoryBuilder();<br /> //3.创建SqlSession工厂对象<br /> factory = builder.build(in);<br /> //4.创建SqlSession对象<br /> session = factory.openSession();<br /> //5.创建Dao的代理对象<br /> userDao = session.getMapper(IUserDao.class);<br /> }
  2. @After//在测试方法执行完成之后执行<br /> public void destroy() throws Exception{<br /> //7.释放资源<br /> session.close();<br /> in.close();<br /> }<br />}<br />测试结果如下:<br />我们可以发现,虽然在上面的代码中我们查询了两次,但最后只执行了一次数据库操作,这就是 Mybatis 提供给我们的一级缓存在起作用了。因为一级缓存的存在,导致第二次查询 id 为 41 的记录时,并没有发出 sql 语句从数据库中查询数据,而是从一级缓存中查询。

1.2 一级缓存的分析

一级缓存是 SqlSession 范围的缓存,当调用 SqlSession 的修改,添加,删除,commit(),close()方法时,就会清空一级缓存。
第一次发起查询用户 id 为 1 的用户信息,先去找缓存中是否有 id 为 1 的用户信息,如果没有,从数据库查询用户信息。
得到用户信息,将用户信息存储到一级缓存中。
如果 sqlSession 去执行 commit 操作(执行插入、更新、删除),清空 SqlSession 中的一级缓存,这样做的目的为了让缓存中存储的是最新的信息,避免脏读。
第二次发起查询用户 id 为 1 的用户信息,先去找缓存中是否有 id 为 1 的用户信息,缓存中有,直接从缓存中获取用户信息。
MyBatis 的一级缓存是默认开启的,不需要任何的配置。

1.3 测试一级缓存的清空

测试一级缓存
public class UserTest {
private InputStream in ;
private SqlSessionFactory factory;
private SqlSession session;
private IUserDao userDao;
@Test
public void testFindById() {
//6.执行操作

  1. User user = userDao.findById(41);<br /> System.out.println("第一次查询的用户:"+user);<br /> User user2 = userDao.findById(41);<br /> System.out.println("第二次查询用户:"+user2);<br /> System.out.println(user == user2);<br /> }
  2. @Before//在测试方法执行之前执行<br /> public void init()throws Exception {<br /> //1.读取配置文件<br /> in = Resources.getResourceAsStream("SqlMapConfig.xml");<br /> //2.创建构建者对象<br /> SqlSessionFactoryBuilder builder = new SqlSessionFactoryBuilder();<br /> //3.创建SqlSession工厂对象<br /> factory = builder.build(in);<br /> //4.创建SqlSession对象<br /> session = factory.openSession();<br /> //5.创建Dao的代理对象<br /> userDao = session.getMapper(IUserDao.class);<br /> }
  3. @After//在测试方法执行完成之后执行<br /> public void destroy() throws Exception{<br /> //7.释放资源<br /> session.close();<br /> in.close();<br /> }<br />}<br />测试缓存同步<br />@Test<br />public void testClearlCache(){<br /> //1.根据id查询用户<br /> User user1 = userDao.findById(41);<br /> System.out.println(user1);<br /> //2.更新用户信息<br /> user1.setUsername("update user clear cache");<br /> user1.setAddress("北京市海淀区");<br /> userDao.updateUser(user1);<br /> //3.再次查询id为41的用户<br /> User user2 = userDao.findById(41);<br /> System.out.println(user2);<br /> System.out.println(user1 == user2);<br />}<br />当执行 sqlSession.close()后,再次获取 sqlSession 并查询 id=41 的 User 对象时,又重新执行了 sql 语句,从数据库进行了查询操作。

1.4:总结

MyBatis 的一级缓存是默认开启的,不需要任何的配置。
一级缓存的生命周期有多长?

  1. MyBatis 在开启一个数据库会话时,会 创建一个新的 SqlSession 对象,SqlSession 对象中会有一个新的 Executor 对象,Executor 对象中持有一个新的 PerpetualCache 对象;当会话结束时,SqlSession 对象及其内部的 Executor 对象还有 PerpetualCache 对象也一并释放掉。
  2. 如果 SqlSession 调用了 close()方法,会释放掉一级缓存 PerpetualCache 对象,一级缓存将不可用;
  3. 如果 SqlSession 调用了 clearCache(),会清空 PerpetualCache 对象中的数据,但是该对象仍可使用;
  4. SqlSession 中执行了任何一个 update 操作(update()、delete()、insert()) ,都会清空 PerpetualCache 对象的数据,但是该对象可以继续使用;

一级缓存的不足:
使用一级缓存的时候,因为缓存不能跨会话共享,不同的会话之间对于相同的数据可能有不一样的缓存。在有多个会话或者分布式环境下,会存在脏数据的问题。如果要解决这个问题,就要用到二级缓存。MyBatis 一级缓存(MyBaits 称其为 Local Cache)无法关闭,但是有两种级别可选:

  • session 级别的缓存,在同一个 sqlSession 内,对同样的查询将不再查询数据库,直接从缓存中。
  • statement 级别的缓存,避坑: 为了避免这个问题,可以将一级缓存的级别设为 statement 级别的,这样每次查询结束都会清掉一级缓存。

    2 Mybatis 二级缓存

    二级缓存是 mapper 映射级别的缓存,多个 SqlSession 去操作同一个 Mapper 映射的 sql 语句,多个 SqlSession 可以共用二级缓存,二级缓存是跨 SqlSession 的。二级缓存是用来解决以及缓存不能跨会话共享问题的

    2.1 二级缓存结构图

    MyBatis - 图6

首先开启 mybatis 的二级缓存。
sqlSession1 去查询用户信息,查询到用户信息会将查询数据存储到二级缓存中。
如果 SqlSession3 去执行相同 mapper 映射下 sql,执行 commit 提交,将会清空该 mapper 映射下的二级缓存区域的数据。
sqlSession2 去查询与 sqlSession1 相同的用户信息,首先会去缓存中找是否存在数据,如果存在直接从缓存中取出数据。

2.2 二级缓存的开启与关闭

第一步:在SqlMapConfig.xml文件开启二级缓存




因 cacheEnabled 的取值默认就为 true,所以这一步可以省略不配置。为 true 代表开启二级缓存;为 false 代表不开启二级缓存。
第二步:配置相关的Mapper映射文件,在 Mapping 文件中打上标签
标签表示当前这个 mapper 映射将使用二级缓存,区分的标准就看 mapper 的 namespace 值。
<?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">


size=”1024”
eviction=”LRU”
flushInterval=”120000”
readOnly=”false”/>

这个简单语句的效果如下:

  • 映射语句文件中的所有 select 语句的结果将会被缓存。
  • 映射语句文件中的所有 insert、update 和 delete 语句会刷新缓存。
  • 缓存会使用最近最少使用算法(LRU, Least Recently Used)算法来清除不需要的缓存。
  • 缓存不会定时进行刷新(也就是说,没有刷新间隔)。
  • 缓存会保存列表或对象(无论查询方法返回哪种)的 1024 个引用。
  • 缓存会被视为读/写缓存,这意味着获取到的对象并不是共享的,可以安全地被调用者修改,而不干扰其他调用者或线程所做的潜在修改。

可用的清除策略有:

  • LRU – 最近最少使用:移除最长时间不被使用的对象。
  • FIFO – 先进先出:按对象进入缓存的顺序来移除它们。
  • SOFT – 软引用:基于垃圾回收器状态和软引用规则移除对象。
  • WEAK – 弱引用:更积极地基于垃圾收集器状态和弱引用规则移除对象。

默认的清除策略是 LRU。
flushInterval(刷新间隔)属性可以被设置为任意的正整数,设置的值应该是一个以毫秒为单位的合理时间量。 默认情况是不设置,也就是没有刷新间隔,缓存仅仅会在调用语句时刷新。
size(引用数目)属性可以被设置为任意正整数,要注意欲缓存对象的大小和运行环境中可用的内存资源。默认值是 1024。
readOnly(只读)属性可以被设置为 true 或 false。只读的缓存会给所有调用者返回缓存对象的相同实例。 因此这些对象不能被修改。这就提供了可观的性能提升。而可读写的缓存会(通过序列化)返回缓存对象的拷贝。 速度上会慢一些,但是更安全,因此默认值是 false。
第三步:配置statement上面的useCache属性


将 UserDao.xml 映射文件中的