文章目录
前言
这篇笔记是我根据狂神的Mybatis教程整理的,读者们也可以去B站看到秦疆老师的多个精品视频,而且都是免费的。
- 视频链接:【狂神说Java】Mybatis最新完整教程IDEA版通俗易懂
- 官方学习网站:KuangStudy
源码已经托管到Gitee上:https://gitee.com/blossoming819/Mybatis-study.git
环境说明
- jdk 1.8
- maven-3.8.4
- MySQL 8.0.28
- IDEA
需要具备的知识
- JDBC
- MySQL
- Java 基础
- Maven
- Junit(单元测试)
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第一个程序
思路流程:搭建环境—>导入Mybatis—->编写代码—->测试
2.1、源码演示
创建数据库
CREATE DATABASE mybatisdatabase
CREATE TABLE `user` (
`id` INT ( 20 ) NOT NULL,
`name` VARCHAR ( 30 ) DEFAULT NULL,
`pwd` VARCHAR ( 30 ) DEFAULT NULL,
PRIMARY KEY ( `id` )
) ;
INSERT INTO `user` ( `id`, `name`, `pwd` )
VALUES
( 1, '张三', '123456' ),
( 2, '李四', '123456' ),
( 3, '王五', '123456' )
接着建立一个普通的Maven项目Mybatis-study
,删除src,建立一个普通的Maven module
导入Mybatis及数据库的依赖
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.5.7</version>
</dependency>
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>8.0.28</version>
</dependency>
<!--junit单元测试-->
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>3.8.2</version>
<scope>test</scope>
</dependency>
编写MyBatis核心配置文件
- 查看MyBatis官方文档
resources
目录下建立一个名为mybatis-config.xml
的配置文件,名字可以自定义
<?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"/>
<dataSource type="POOLED">
<!--加载驱动-->
<property name="driver" value="com.mysql.cj.jdbc.Driver"/>
<!--数据库url-->
<property name="url"
value="jdbc:mysql://localhost:3306/mybatisdatabase?useSSL=true&useUnicode=true&characterEncoding=utf-8"/>
<!--数据库用户名-->
<property name="username" value="root"/>
<!--用户密码-->
<property name="password" value="0925"/>
</dataSource>
</environment>
</environments>
<!--每一个mapper.xml都需要注册一个-->
<mappers>
<mapper resource="com/princehan/dao/UserMapper.xml"/>
</mappers>
</configuration>
编写MyBatis工具类
package com.princehan.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.InputStream;
/**
* @Description
* @Author:PrinceHan
* @CreateTime:2022/3/29 19:01
*/
//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 (Exception e) {
e.printStackTrace();
}
}
public static SqlSession getSqlSession() {
return sqlSessionFactory.openSession();
}
}
创建实体类
package com.princehan.pojo;
/**
* @Description
* @Author:PrinceHan
* @CreateTime:2022/3/29 19:10
*/
public class User {
private int id;
private String name;
private String pwd;
public User() {
}
@Override
public String toString() {
return "User{" +
"id=" + id +
", name='" + name + '\'' +
", pwd='" + pwd + '\'' +
'}';
}
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;
}
}
编写Mapper接口类
package com.princehan.dao;
import com.princehan.pojo.User;
import java.util.List;
/**
* @Description
* @Author:PrinceHan
* @CreateTime:2022/3/29 19:11
*/
public interface UserMapper {
List<User> getUserList();
}
编写UserMapper.xml配置文件 (我写在了dao下)
- 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">
<!--namespace 绑定一个mapper dao接口-->
<mapper namespace="com.princehan.dao.UserMapper">
<!--id对应方法名 resultType结果类型 -->
<select id="getUserList" resultType="com.princehan.pojo.User">
select * from user
</select>
</mapper>
使用junit注解编写测试类
package com.princehan.dao;
import com.princehan.pojo.User;
import com.princehan.utils.MybatisUtils;
import org.apache.ibatis.session.SqlSession;
import org.junit.Test;
import java.util.List;
/**
* @Description
* @Author:PrinceHan
* @CreateTime:2022/3/29 19:23
*/
public class UserMapperTest {
@Test
public void test() {
//获得SqlSession对象
SqlSession sqlSession = MybatisUtils.getSqlSession();
//方式一 getMapper
UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
List<User> userList = userMapper.getUserList();
//方式二
// List<User> userList = sqlSession.selectList("com.princehan.dao.UserDao.getUserList");
for (User user : userList) {
System.out.println(user);
}
sqlSession.close();
}
}
运行测试
2.2、可能遇到的问题
- MyBatis核心配置文件名错误
- 无法获得Mapper.xml
原因是将UserMapper.xml
放在了dao层下,没有放在resources
目录下,无法加载配置文件,解决方法是在pom.xml
中添加如下配置:
<build>
<resources>
<resource>
<directory>src/main/java</directory>
<includes>
<include>**/*.properties</include>
<include>**/*.xml</include>
</includes>
<filtering>false</filtering>
</resource>
<resource>
<directory>src/main/resources</directory>
<includes>
<include>**/*.properties</include>
<include>**/*.xml</include>
</includes>
<filtering>false</filtering>
</resource>
</resources>
</build>
3、CRUD操作
3.1、namespace
- 将上面案例中的UserMapper接口改名为 UserDao;
- 将UserMapper.xml中的namespace改为为UserDao的路径 .
- 再次测试
结论:
配置文件中namespace中的名称为对应Mapper接口或者Dao接口的完整包名,必须一致!
3.2、select
- select标签是mybatis中最常用的标签之一
- select语句有很多属性可以详细配置每一条SQL语句
- id
- 命名空间中唯一的标识符
- 接口中的方法名与映射文件中的SQL语句ID 一一对应
- parameterType
- 传入SQL语句的参数类型 。【万能的Map,可以多尝试使用】
- resultType
- SQL语句返回值类型。【完整的类名或者别名】
- id
需求:根据id查询用户
- 在
UserMapper.xml
添加select
<select id="getUserById" resultType="com.princehan.pojo.User" parameterType="int">
select * from user where id = #{id}
</select>
- 在
UserMapper
中添加对应方法
User getUserById(int id);
- 在
UserMapperTest
中添加测试方法
@Test
public void getUserById() {
SqlSession sqlSession = MybatisUtils.getSqlSession();
UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
User user = userMapper.getUserById(1);
System.out.println(user);
sqlSession.close();
}
3.3、insert
我们一般使用insert标签进行插入操作,它的配置和select标签差不多!
需求:给数据库增加一个用户
- 在
UserMapper.xml
添加insert
<insert id="addUser" parameterType="com.princehan.pojo.User" >
insert into user (id, name, pwd) values(#{id}, #{name}, #{pwd})
</insert>
- 在
UserMapper
中添加对应方法
int addUser(User user);
- 在
UserMapperTest
中添加测试方法
@Test
public void addUser() {
SqlSession sqlSession = MybatisUtils.getSqlSession();
UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
int res = userMapper.addUser(new User(4, "赵六", "123456"));
if (res > 0) System.out.println("插入成功");
sqlSession.commit();
sqlSession.close();
}
注意点:增、删、改操作需要提交事务!
3.4、update
我们一般使用update标签进行更新操作,它的配置和select标签差不多!
需求:修改用户的信息
- 在
UserMapper.xml
添加update
<update id="updateUser" parameterType="com.princehan.pojo.User">
update user set name = #{name}, pwd = #{name} where id = #{id}
</update>
- 在
UserMapper
中添加对应方法
int updateUser(User user);
- 在
UserMapperTest
中添加测试方法
@Test
public void updateUser() {
SqlSession sqlSession = MybatisUtils.getSqlSession();
UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
int res = userMapper.updateUser(new User(4, "赵五", "123456"));
if (res > 0) System.out.println("更新成功");
sqlSession.commit();
sqlSession.close();
}
3.5、delete
我们一般使用delete标签进行删除操作,它的配置和select标签差不多!
需求:根据id删除一个用户
- 在
UserMapper.xml
添加update
<delete id="deleteUser" parameterType="int">
delete from user where id = #{id}
</delete>
- 在
UserMapper
中添加对应方法
int deleteUser(int id);
- 在
UserMapperTest
中添加测试方法
@Test
public void deleteUser() {
SqlSession sqlSession = MybatisUtils.getSqlSession();
UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
int res = userMapper.deleteUser(4);
if (res > 0) System.out.println("删除成功");
sqlSession.commit();
sqlSession.close();
}
小结:
-
所有的增删改操作都需要提交事务!
-
接口所有的普通参数,尽量都写上@Param参数,尤其是多个参数时,必须写上!
-
有时候根据业务的需求,可以考虑使用map传递参数!
-
为了规范操作,在SQL的配置文件中,我们尽量将Parameter参数和resultType都写上!
3.6、使用Map
<insert id="addUser2" parameterType="map" >
insert into user (id, name, pwd) values(#{userid}, #{userName}, #{password})
</insert>
int addUser2(Map<String, Object> map);
@Test
public void addUser2() {
SqlSession sqlSession = MybatisUtils.getSqlSession();
UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
Map<String, Object> map = new HashMap<>();
map.put("userid",4);
map.put("userName", "赵六");
map.put("password", "123456");
int res = userMapper.addUser2(map);
if (res > 0) System.out.println("插入成功");
sqlSession.commit();
sqlSession.close();
}
3.7、模糊查询
模糊查询like语句该怎么写?
第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<name> names = mapper.selectlike(wildcardname);
<select id=”selectlike”>
select * from foo where bar like "%"#{value}"%"
</select>
4、配置解析
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指定)
-
子元素节点:environment
-
具体的一套环境,通过设置id进行区别,id保证唯一!
-
子元素节点:transactionManager - [ 事务管理器 ]
<!-- 语法 -->
<transactionManager type="[ JDBC | MANAGED ]"/>
-
详情:点击查看官方文档
-
这两种事务管理器类型都不需要设置任何属性。
-
子元素节点:数据源(dataSource)
-
dataSource 元素使用标准的 JDBC 数据源接口来配置 JDBC 连接对象的资源。
-
数据源是必须配置的。
-
有三种内建的数据源类型
type="[UNPOOLED|POOLED|JNDI]")
-
unpooled: 这个数据源的实现只是每次被请求时打开和关闭连接。
-
pooled: 这种数据源的实现利用“池”的概念将 JDBC 连接对象组织起来 , 这是一种使得并发 Web 应用快速响应请求的流行处理方式。
-
jndi:这个数据源的实现是为了能在如 Spring 或应用服务器这类容器中使用,容器可以集中或在外部配置数据源,然后放置一个 JNDI 上下文的引用。
-
数据源也有很多第三方的实现,比如dbcp,c3p0,druid等等….
4.3、mappers元素
4.3.1、mappers
- 映射器 : 定义映射SQL语句文件
- 既然 MyBatis 的行为其他元素已经配置完了,我们现在就要定义 SQL 映射语句了。但是首先我们需要告诉 MyBatis 到哪里去找到这些语句。 Java 在自动查找这方面没有提供一个很好的方法,所以最佳的方式是告诉 MyBatis 到哪里去找映射文件。你可以使用相对于类路径的资源引用, 或完全限定资源定位符(包括 file:/// 的 URL),或类名和包名等。映射器是MyBatis中最核心的组件之一,在MyBatis 3之前,只支持xml映射器,即:所有的SQL语句都必须在xml文件中配置。而从MyBatis 3开始,还支持接口映射器,这种映射器方式允许以Java代码的方式注解定义SQL语句,非常简洁。
4.3.2、引入资源方式
方式一: 使用相对于类路径的资源引用
<mappers>
<mapper resource="com/princehan/dao/UserMapper.xml"/>
</mappers>
方式二:使用完全限定资源定位符(URL)(不常用)
<mappers>
<mapper url="file:///var/mappers/AuthorMapper.xml"/>
</mappers>
方式三:使用映射器接口实现类的完全限定类名
<mappers>
<mapper class="org.mybatis.builder.AuthorMapper"/>
</mappers>
注意点:
- 接口和它的Mapper配置文件必须同名
- 接口和它的Mapper配置文件,并且位于同一目录下
方式四: 使用包名
<mappers>
<package name="org.mybatis.builder"/>
</mappers>
4.3.3、Mapper文件
<?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">
<mapper namespace="com.princehan.dao.UserMapper">
</mapper>
- namespace中文意思:命名空间,作用如下:
- namespace和子元素的id联合保证唯一 , 区别不同的mapper
- 绑定DAO接口
- namespace的命名必须跟某个接口同名
- 接口中的方法与映射文件中sql语句id应该一一对应
- namespace命名规则 : 包名+类名
4.4、Properties优化
数据库这些属性都是可外部配置且可动态替换的,既可以在典型的 Java 属性文件中配置,亦可通过 properties 元素的子元素来传递。具体的官方文档
<!--外层优先级最大-->
<properties resource="db.properties">
<property name="username" value="dev_user"/>
<property name="password" value="F2Fa3!33TYyg"/>
</properties>
- 可以直接引入外部文件
- 可以在其中增加一些属性配置
- 如果两个文件有同一个字段,优先使用外部配置文件的。
我们来优化我们的配置文件
第一步 :在资源目录下新建一个db.properties
driver=com.mysql.cj.jdbc.Driver
url=jdbc:mysql://localhost:3306/mybatisdatabase?useSSL=true&useUnicode=true&characterEncoding=utf8
username=root
password=0925
第二步 : 将文件导入properties 配置文件
<configuration>
<!--导入properties文件-->
<properties resource="db.properties"/>
<environments default="development">
<environment id="development">
<transactionManager type="JDBC"/>
<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>
<mappers>
<mapper resource="com/princehan/dao/UserMapper.xml"/>
</mappers>
</configuration>
4.5、typeAliases优化
类型别名是为 Java 类型设置一个短的名字。它只和 XML 配置有关,存在的意义仅在于用来减少类完全限定名的冗余。
<!--配置别名,注意顺序-->
<typeAliases>
<typeAlias type="com.princehan.pojo.User" alias="User"/>
</typeAliases>
当这样配置时,User
可以用在任何使用com.princehan.pojo.User
的地方。
也可以指定一个包名,MyBatis 会在包名下面搜索需要的 Java Bean,比如:
<typeAliases>
<package name="com.princehan.pojo"/>
</typeAliases>
在实体类比较少的时候,使用第一种方式
如果实体类十分多,建议使用第二种
在没有注解的情况下,会使用 Bean 的首字母小写的非限定类名来作为它的别名。
第一种自定义别名,第二种不行,如果需要改,需要在实体上增加注解。见下面的例子:
@Alias("user")
public class User {
...
}
【演示】去官网查看一下Mybatis默认的一些类型别名!
4.6、其他配置浏览
4.6.1、设置
设置 (settings)相关 => 查看帮助文档
- 懒加载
- 日志实现
- 缓存开启关闭
一个配置完整的 settings 元素的示例如下:
<settings>
<setting name="cacheEnabled" value="true"/>
<setting name="lazyLoadingEnabled" value="true"/>
<setting name="multipleResultSetsEnabled" value="true"/>
<setting name="useColumnLabel" value="true"/>
<setting name="useGeneratedKeys" value="false"/>
<setting name="autoMappingBehavior" value="PARTIAL"/>
<setting name="autoMappingUnknownColumnBehavior" value="WARNING"/>
<setting name="defaultExecutorType" value="SIMPLE"/>
<setting name="defaultStatementTimeout" value="25"/>
<setting name="defaultFetchSize" value="100"/>
<setting name="safeRowBoundsEnabled" value="false"/>
<setting name="mapUnderscoreToCamelCase" value="false"/>
<setting name="localCacheScope" value="SESSION"/>
<setting name="jdbcTypeForNull" value="OTHER"/>
<setting name="lazyLoadTriggerMethods" value="equals,clone,hashCode,toString"/>
</settings>
4.7 生命周期和作用域
作用域(Scope)和生命周期
理解我们目前已经讨论过的不同作用域和生命周期类是至关重要的,因为错误的使用会导致非常严重的并发问题。
我们可以先画一个流程图,分析一下Mybatis的执行过程!
作用域理解
-
SqlSessionFactoryBuilder
的作用在于创建SqlSessionFactory
,创建成功后,SqlSessionFactoryBuilder
就失去了作用,所以它只能存在于创建SqlSessionFactory
的方法中,而不要让其长期存在。因此SqlSessionFactoryBuilder
实例的最佳作用域是方法作用域(也就是局部方法变量)。 -
SqlSessionFactory
可以被认为是一个数据库连接池,它的作用是创建SqlSession
接口对象。因为 MyBatis 的本质就是 Java 对数据库的操作,所以SqlSessionFactory
的生命周期存在于整个 MyBatis 的应用之中,所以一旦创建了SqlSessionFactory
,就要长期保存它,直至不再使用 MyBatis 应用,所以可以认为SqlSessionFactory
的生命周期就等同于 MyBatis 的应用周期。 -
由于
SqlSessionFactory
是一个对数据库的连接池,所以它占据着数据库的连接资源。如果创建多个SqlSessionFactory
,那么就存在多个数据库连接池,这样不利于对数据库资源的控制,也会导致数据库连接资源被消耗光,出现系统宕机等情况,所以尽量避免发生这样的情况。 -
因此在一般的应用中我们往往希望
SqlSessionFactory
作为一个单例,让它在应用中被共享。所以说SqlSessionFactory
的最佳作用域是应用作用域。 -
如果说
SqlSessionFactory
相当于数据库连接池,那么SqlSession
就相当于一个数据库连接(Connection
对象),你可以在一个事务里面执行多条 SQL,然后通过它的commit
、rollback
等方法,提交或者回滚事务。所以它应该存活在一个业务请求中,处理完整个请求后,应该关闭这条连接,让它归还给SqlSessionFactory
,否则数据库资源就很快被耗费精光,系统就会瘫痪,所以用try…catch…finally…
语句来保证其正确关闭。 -
所以
SqlSession
的最佳的作用域是请求或方法作用域。
5、ResultMap
思考:假如实体类属性名和数据库中字段名不一致会出现什么情况?
- 新建一个Maven Module,拷贝之前的项目
- 改写
User
实体类中的属性
package com.princehan.pojo;
/**
* @Description
* @Author:PrinceHan
* @CreateTime:2022/3/29 19:10
*/
public class User {
private int id;
private String name;
private String password;
}
User
表字段名
测试会出现何种情况?
<select id="getUserById" resultType="User" parameterType="int">
select * from user where id = #{id}
</select>
可以看到属性与字段名不一致会导致无法取出值。
分析
-
select * from user where id = #{id} 可以看做
-
select id,name,pwd from user where id = #{id}
-
MyBatis会根据这些查询的列名(会将列名转化为小写,数据库不区分大小写) , 去对应的实体类中查找相应列名的set方法设值 , 由于找不到setPwd() , 所以password返回null ; 【自动映射】
解决方法:
- 给字段名起别名
<select id="getUserById" resultType="User" parameterType="int">
select id, name, pwd password from user where id = #{id}
</select>
pwd
字段的值取出来了。
- 使用ResultMap结果映射
<resultMap id="UserMap" type="User">
<id column="id" property="id"/>
<result column="name" property="name"/>
<result column="pwd" property="password"/>
</resultMap>
<select id="getUserById" resultMap="UserMap">
select * from user where id = #{id}
</select>
5.1、ResultMap
5.1.1、自动映射
resultMap
元素是 MyBatis 中最重要最强大的元素。它可以让你从 90% 的 JDBCResultSets
数据提取代码中解放出来。- 实际上,在为一些比如连接的复杂语句编写映射代码的时候,一份
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.1.2、手动映射
返回值类型为resultMap
<select id="selectUserById" resultMap="UserMap">
select id , name , pwd from user where id = #{id}
</select>
编写resultMap
,实现手动映射!
<resultMap id="UserMap" type="User">
<!-- id为主键 -->
<id column="id" property="id"/>
<!-- column是数据库表的列名 , property是对应实体类的属性名 -->
<result column="name" property="name"/>
<result column="pwd" property="password"/>
</resultMap>
如需学习更多相关知识查看官方文档ResultMap的知识。
6、日志
6.1、日志工厂
思考:我们在测试SQL的时候,要是能够在控制台输出 SQL 的话,是不是就能够有更快的排错效率?
如果一个 数据库相关的操作出现了问题,我们可以根据输出的SQL语句快速排查问题。
对于以往的开发过程,我们会经常使用到debug模式来调节,跟踪我们的代码执行过程。但是现在使用Mybatis是基于接口,配置文件的源代码执行过程。因此,我们必须选择日志工具来作为我们开发,调节程序的工具。
Mybatis内置的日志工厂提供日志功能,具体的日志实现有以下几种工具:
- SLF4J
- Apache Commons Logging
- Log4j 2
- Log4j
- JDK logging
具体选择哪个日志实现工具由MyBatis的内置日志工厂确定。它会使用最先找到的(按上文列举的顺序查找)。 如果一个都未找到,日志功能就会被禁用。
标准日志实现
指定 MyBatis 应该使用哪个日志记录实现。如果此设置不存在,则会自动发现日志记录实现。
<settings>
<setting name="logImpl" value="STDOUT_LOGGING"/>
</settings>
测试,可以看到控制台有大量的输出!可以通过这些输出来判断程序到底哪里出了Bug
6.2 、Log4j
简介:
- Log4j是Apache的一个开源项目
- 通过使用Log4j,我们可以控制日志信息输送的目的地:控制台,文本,GUI组件….
- 我们也可以控制每一条日志的输出格式;
- 通过定义每一条日志信息的级别,我们能够更加细致地控制日志的生成过程。最令人感兴趣的就是,这些可以通过一个配置文件来灵活地进行配置,而不需要修改应用的代码。
使用步骤
- 导入Log4j的依赖
<dependency>
<groupId>log4j</groupId>
<artifactId>log4j</artifactId>
<version>1.2.17</version>
</dependency>
- 编写配置文件
#将等级为DEBUG的日志信息输出到console和file这两个目的地,console和file的定义在下面的代码
log4j.rootLogger=DEBUG,console,file
#控制台输出的相关设置
log4j.appender.console = org.apache.log4j.ConsoleAppender
log4j.appender.console.Target = System.out
log4j.appender.console.Threshold=DEBUG
log4j.appender.console.layout = org.apache.log4j.PatternLayout
log4j.appender.console.layout.ConversionPattern=[%c]-%m%n
#文件输出的相关设置
log4j.appender.file = org.apache.log4j.RollingFileAppender
log4j.appender.file.File=./log/princehan.log
log4j.appender.file.MaxFileSize=10mb
log4j.appender.file.Threshold=DEBUG
log4j.appender.file.layout=org.apache.log4j.PatternLayout
log4j.appender.file.layout.ConversionPattern=[%p][%d{yyyy-MM-dd HH:mm:ss}][%c]%m%n
#日志输出级别
log4j.logger.org.mybatis=DEBUG
log4j.logger.java.sql=DEBUG
log4j.logger.java.sql.Statement=DEBUG
log4j.logger.java.sql.ResultSet=DEBUG
log4j.logger.java.sql.PreparedStatement=DEBUG
setting设置日志实现
<settings>
<setting name="logImpl" value="LOG4J"/>
</settings>
在程序中使用Log4j进行输出!
package com.princehan.dao;
import com.princehan.pojo.User;
import com.princehan.utils.MybatisUtils;
import org.apache.ibatis.session.SqlSession;
import org.apache.log4j.Logger;
import org.junit.Test;
/**
* @Description
* @Author:PrinceHan
* @CreateTime:2022/3/31 20:46
*/
public class UserMapperTest {
static Logger logger = Logger.getLogger(UserMapperTest.class);
@Test
public void testLog4j() {
logger.info("info:进入了testLog4j");
logger.debug("debug:进入了testLog4j");
logger.error("error:进入了testLog4j");
}
}
控制台输出
项目目录下生成一个日志目录
- 使用Log4j 输出日志
- 可以看到还生成了一个日志的文件 【需要修改file的日志级别】
7、分页
思考:为什么需要分页?
在学习mybatis等持久层框架的时候,会经常对数据进行增删改查操作,使用最多的是对数据库进行查询操作,如果查询大量数据的时候,我们往往使用分页进行查询,也就是每次处理小部分数据,这样对数据库压力就在可控范围内。
7.1、使用limit
分页
<select id="getUserByLimit" parameterType="map" resultMap="UserMap">
select * from user limit #{startIndex},#{pageSize}
</select>
UserMapper
List<User> getUserByLimit(Map<String, Integer> map);
测试类
package com.princehan.dao;
import com.princehan.pojo.User;
import com.princehan.utils.MybatisUtils;
import org.apache.ibatis.session.SqlSession;
import org.apache.log4j.Logger;
import org.junit.Test;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
/**
* @Description
* @Author:PrinceHan
* @CreateTime:2022/3/31 20:46
*/
public class UserMapperTest {
static Logger logger = Logger.getLogger(UserMapperTest.class);
@Test
public void getUserByLimit() {
SqlSession sqlSession = MybatisUtils.getSqlSession();
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
Map<String, Integer> map = new HashMap<>();
map.put("startIndex", 0);
map.put("pageSize", 2);
List<User> userList = mapper.getUserByLimit(map);
for (User user : userList) {
System.out.println(user);
}
sqlSession.close();
}
}
8、使用注解开发
8.1、设置自动提交事务
public static SqlSession getSqlSession() {
return sqlSessionFactory.openSession(true);
}
8.2、使用注解实现CRUD
- 使用注解可以不用
mapper.xml
,相应的也不需在mybatis-config.xml
配置mapper.xml
的映射,但仍需配置dao层接口。
<!--绑定接口-->
<mappers>
<mapper class="com.princehan.dao.UserMapper"/>
</mappers>
- 编写接口
package com.princehan.dao;
import com.princehan.pojo.User;
import org.apache.ibatis.annotations.*;
import java.util.List;
import java.util.Map;
/**
* @Description
* @Author:PrinceHan
* @CreateTime:2022/3/31 20:42
*/
public interface UserMapper {
@Select("select id, name, pwd password from user")
List<User> getUsers();
//多个参数要用 @Param()
@Select("select * from user where id = #{id}")
User getUserByID(@Param("id") int id);
@Insert("insert into user(id, name, pwd) values(#{id}, #{name}, #{password})")
int addUser(User user);
@Update("update user set name = #{name}, pwd = #{password} where id = #{id}")
int updateUser(User user);
@Delete("delete from user where id = #{uid}")//如果加@Param()要与里面的key相同
int deleteUser(@Param("uid") int id);
}
- 编写测试类
@Test
public void getUsers() {
SqlSession sqlSession = MybatisUtils.getSqlSession();
UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
List<User> users = userMapper.getUsers();
for (User user : users) {
System.out.println(user);
}
sqlSession.close();
}
@Test
public void getUserByID() {
SqlSession sqlSession = MybatisUtils.getSqlSession();
UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
User user = userMapper.getUserByID(1);
System.out.println(user);
sqlSession.close();
}
@Test
public void addUser() {
SqlSession sqlSession = MybatisUtils.getSqlSession();
UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
userMapper.addUser(new User(6, "孙八", "123456"));
sqlSession.close();
}
@Test
public void updateUser() {
SqlSession sqlSession = MybatisUtils.getSqlSession();
UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
userMapper.updateUser(new User(6, "孙八", "123456"));
sqlSession.close();
}
@Test
public void deleteUser() {
SqlSession sqlSession = MybatisUtils.getSqlSession();
UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
userMapper.deleteUser(6);
sqlSession.close();
}
8.3、关于@Param()
注解
@Param
注解用于给方法参数起一个名字。以下是总结的使用原则:
- 基本类型的参数或者
String
类型,需要加上 - 引用类型不用加
- 在方法只接受一个参数的情况下,可以不使用
@Param
。 - 在方法接受多个参数的情况下,建议一定要使用
@Param
注解给参数命名。 SQL
中引用的就是@Param
中设置的属性名
8.4、#{}
与${}
的区别
${}
进行的是字符串的替换,在配置MyBatis连接数据库的时候用到,有SQL注入的风险。order by
用这个- 例如:order by #{parameterName} //或取Map中的value#{Key}也是一样操作。
假设传入参数是“Smith”
会解析成:order by Smith
- 例如:order by #{parameterName} //或取Map中的value#{Key}也是一样操作。
#{}
将传入的数据都当成一个字符串,会对自动传入的数据加一个双引号。keyi防止SQL注入- 例如:order by #{parameterName} //或取Map中的value#{Key}也是一样操作。
假设传入参数是“Smith”
会解析成:order by “Smith”
- 例如:order by #{parameterName} //或取Map中的value#{Key}也是一样操作。
9、多对一处理
多对一的理解:
- 多个学生对应一个老师
- 如果对于学生这边,就是一个多对一的现象,即从学生这边关联一个老师!
9.1、环境搭建
数据库设计
CREATE TABLE `teacher` (
`id` INT(10) NOT NULL,
`name` VARCHAR(30) DEFAULT NULL,
PRIMARY KEY (`id`)
) ENGINE=INNODB DEFAULT CHARSET=utf8;
INSERT INTO teacher(`id`, `name`) VALUES (1, '秦老师');
CREATE TABLE `student` (
`id` INT(10) NOT NULL,
`name` VARCHAR(30) DEFAULT NULL,
`tid` INT(10) DEFAULT NULL,
PRIMARY KEY (`id`),
KEY `fktid` (`tid`),
FOREIGN KEY (`tid`) REFERENCES `teacher` (`id`)
) ENGINE=INNODB DEFAULT CHARSET=utf8;
INSERT INTO `student` (`id`, `name`, `tid`) VALUES ('1', '小明', '1');
INSERT INTO `student` (`id`, `name`, `tid`) VALUES ('2', '小红', '1');
INSERT INTO `student` (`id`, `name`, `tid`) VALUES ('3', '小张', '1');
INSERT INTO `student` (`id`, `name`, `tid`) VALUES ('4', '小李', '1');
INSERT INTO `student` (`id`, `name`, `tid`) VALUES ('5', '小王', '1');
导入
LomBok
依赖
<!-- https://mvnrepository.com/artifact/org.projectlombok/lombok -->
<dependency>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
<version>1.18.22</version>
</dependency>
新建实体类(用LomBok创建)
Student
package com.princehan.pojo;
import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;
/**
* @Description
* @Author:PrinceHan
* @CreateTime:2022/4/10 10:21
*/
@Data
@NoArgsConstructor
@AllArgsConstructor
public class Student {
private int id;
private String name;
private Teacher teacher;
}
Teacher
package com.princehan.pojo;
import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;
import org.apache.ibatis.annotations.ConstructorArgs;
/**
* @Description
* @Author:PrinceHan
* @CreateTime:2022/4/10 10:22
*/
@Data
@NoArgsConstructor
@AllArgsConstructor
public class Teacher {
private int id;
private String name;
}
在
mybatis-config.xml
核心配置文件中绑定接口
<!--绑定接口-->
<mappers>
<mapper class="com.princehan.dao.StudentMapper"/>
<mapper class="com.princehan.dao.TeacherMapper"/>
</mappers>
编写测试类
package com.princehan.dao;
import com.princehan.pojo.Teacher;
import com.princehan.utils.MybatisUtils;
import org.apache.ibatis.session.SqlSession;
import org.junit.Test;
/**
* @Description
* @Author:PrinceHan
* @CreateTime:2022/4/10 10:49
*/
public class MyTest {
@Test
public void getTeacher() {
SqlSession sqlSession = MybatisUtils.getSqlSession();
TeacherMapper mapper = sqlSession.getMapper(TeacherMapper.class);
Teacher teacher = mapper.getTeacher(1);
System.out.println(teacher);
sqlSession.close();
}
@Test
public void getStudents() {
SqlSession sqlSession = MybatisUtils.getSqlSession();
StudentMapper mapper = sqlSession.getMapper(StudentMapper.class);
List<Student> students = mapper.getStudents1();
for (Student student : students) {
System.out.println(student);
}
sqlSession.close();
}
}
9.2、按照查询嵌套子查询 (子查询)
<resultMap id="StudentTeacher" type="Student">
<result property="id" column="id"/>
<result property="name" column="name"/>
<!--复杂的属性 单独处理 对象 association 集合 collection-->
<!--javatype 类型 select 子类型-->
<association
property="teacher"
column="tid"
javaType="Teacher"
select="getTeacher"/>
</resultMap>
<select id="getStudents" resultMap="StudentTeacher">
select * from student
</select>
<select id="getTeacher" resultType="Teacher">
select * from teacher where id = #{id}
</select>
9.3、按照结果嵌套查询 (联表查询)
<!--按照结果嵌套子查询-->
<select id="getStudents2" resultMap="StudentTeacher2">
select s.id sid, s.name sname, t.name tname, t.id tid
from student s,
teacher t
where s.tid = t.id
</select>
<resultMap id="StudentTeacher2" type="Student">
<result property="id" column="sid"/>
<result property="name" column="sname"/>
<association property="teacher" javaType="Teacher">
<result property="name" column="tname"/>
<result property="id" column="tid"/>
</association>
</resultMap>
<!---->
@Test
public void getStudents2() {
SqlSession sqlSession = MybatisUtils.getSqlSession();
StudentMapper mapper = sqlSession.getMapper(StudentMapper.class);
List<Student> students = mapper.getStudents2();
for (Student student : students) {
System.out.println(student);
}
sqlSession.close();
}
10、一对多处理
一对多的理解:
- 一个老师拥有多个学生
- 如果对于老师这边,就是一个一对多的现象,即从一个老师下面拥有一群学生(集合)!
10.1、环境搭建
编写实体类
package com.princehan.pojo;
import lombok.Data;
import java.util.List;
/**
* @Description
* @Author:PrinceHan
* @CreateTime:2022/4/10 18:31
*/
@Data
public class Teacher {
private int id;
private String name;
private List<Student> students;
}
package com.princehan.pojo;
import lombok.Data;
/**
* @Description
* @Author:PrinceHan
* @CreateTime:2022/4/10 18:28
*/
@Data
public class Student {
private int id;
private String name;
private int tid;
}
TeacherMapper
package com.princehan.dao;
import com.princehan.pojo.Teacher;
import org.apache.ibatis.annotations.Param;
/**
* @Description
* @Author:PrinceHan
* @CreateTime:2022/4/10 18:38
*/
public interface TeacherMapper {
//查询指定老师下的学生及老师信息
Teacher getTeacher(@Param("tid") int id);
Teacher getTeacher2(@Param("tid") int id);
}
10.1、按照查询嵌套子查询
<!--按查询嵌套查询-->
<select id="getTeacher2" resultMap="TeacherStudent2">
select *
from teacher
where id = #{tid}
</select>
<resultMap id="TeacherStudent2" type="Teacher">
<!--javaType="List" ArrayList List也可以-->
<!--ofType="Student"也可省略-->
<collection property="students"
javaType="ArrayList"
ofType="Student"
select="getStudentByTeacherId"
column="id"
/>
</resultMap>
<select id="getStudentByTeacherId" resultType="Student">
select *
from student
where tid = #{tid}
</select>
<!---->
@Test
public void getTeacher2() {
SqlSession sqlSession = MybatisUtils.getSqlSession();
TeacherMapper mapper = sqlSession.getMapper(TeacherMapper.class);
Teacher teacher = mapper.getTeacher2(1);
System.out.println(teacher);
sqlSession.close();
}
10.3、按照结果嵌套查询
<!--按结果嵌套查询-->
<select id="getTeacher" resultMap="TeacherStudent">
select s.id sid, s.name sname, t.name tname, t.id tid
from student s,
teacher t
where s.tid = tid
and tid = #{tid}
</select>
<resultMap id="TeacherStudent" type="Teacher">
<result property="id" column="tid"/>
<result property="name" column="tname"/>
<!--复杂属性用collection
javaType=""指定属性的类型
集合中的泛型信息,要用ofType获取-->
<collection property="students" ofType="Student">
<result property="id" column="sid"/>
<result property="name" column="sname"/>
<result property="tid" column="tid"/>
</collection>
</resultMap>
<!---->
@Test
public void getTeacher() {
SqlSession sqlSession = MybatisUtils.getSqlSession();
TeacherMapper mapper = sqlSession.getMapper(TeacherMapper.class);
Teacher teacher = mapper.getTeacher(1);
System.out.println(teacher);
sqlSession.close();
}
10.4、小结
关联 - association
集合 - collection
所以association
是用于一对一和多对一,而collection
是用于一对多的关系
JavaType
和ofType
都是用来指定对象类型的
JavaType
是用来指定pojo
中属性的类型
ofType
指定的是映射到list
集合属性中pojo
的类型。
注意说明:
-
保证SQL的可读性,尽量通俗易懂
-
根据实际要求,尽量编写性能更高的SQL语句
-
注意属性名和字段不一致的问题
-
注意一对多和多对一 中:字段和属性对应的问题
-
尽量使用Log4j,通过日志来查看自己的错误
11、动态SQL
什么是动态SQL:动态SQL指的是根据不同的查询条件 , 生成不同的Sql语句。
动态 SQL 是 MyBatis 的强大特性之一。如果你使用过 JDBC 或其它类似的框架,你应该能理解根据不同条件拼接 SQL 语句有多痛苦,例如拼接时要确保不能忘记添加必要的空格,还要注意去掉列表最后一个列名的逗号。利用动态 SQL,可以彻底摆脱这种痛苦。
使用动态 SQL 并非一件易事,但借助可用于任何 SQL 映射语句中的强大的动态 SQL 语言,MyBatis 显著地提升了这一特性的易用性。
如果你之前用过 JSTL 或任何基于类 XML 语言的文本处理器,你对动态 SQL 元素可能会感觉似曾相识。在 MyBatis 之前的版本中,需要花时间了解大量的元素。借助功能强大的基于 OGNL 的表达式,MyBatis 3 替换了之前的大部分元素,大大精简了元素种类,现在要学习的元素种类比原来的一半还要少。
- if
- choose (when, otherwise)
- trim (where, set)
- foreach
11.1、环境搭建
创建数据库
CREATE TABLE `blog` (
`id` varchar(50) NOT NULL COMMENT '博客id',
`title` varchar(100) NOT NULL COMMENT '博客标题',
`author` varchar(30) NOT NULL COMMENT '博客作者',
`create_time` datetime NOT NULL COMMENT '创建时间',
`views` int NOT NULL COMMENT '浏览量'
) ENGINE=InnoDB DEFAULT CHARSET=utf8;
新建实体类
package com.princehan.pojo;
import lombok.Data;
import java.util.Date;
/**
* @Description
* @Author:PrinceHan
* @CreateTime:2022/4/10 22:43
*/
@Data
public class Blog {
private String id;
private String title;
private String author;
private Date createTime;//属性名与字段名不一致
private int views;
}
编写
BlogMapper
接口
package com.princehan.dao;
import com.princehan.pojo.Blog;
import java.util.List;
import java.util.Map;
/**
* @Description
* @Author:PrinceHan
* @CreateTime:2022/4/10 22:45
*/
@SuppressWarnings("all")
public interface BlogMapper {
//插入数据
int addBlog(Blog blog);
}
编写
BlogMapper.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 dao接口-->
<mapper namespace="com.princehan.dao.BlogMapper">
<insert id="addBlog" parameterType="Blog">
insert into blog(id, title, author, create_time, views)
values (#{id}, #{title}, #{author}, #{createTime}, #{views})
</insert>
</mapper>
在
mybatis-config.xml
里配置
<settings>
<!--日志-->
<setting name="logImpl" value="STDOUT_LOGGING"/>
<!--开启驼峰形式字段匹配-->
<setting name="mapUnderscoreToCamelCase" value="true"/>
</settings>
<!--绑定接口-->
<mappers>
<!--MapperyuMapper.xml在同一个目录下 可以用类名 可用注解-->
<mapper class="com.princehan.dao.BlogMapper"/>
</mappers>
编写测试类
import com.princehan.dao.BlogMapper;
import com.princehan.pojo.Blog;
import com.princehan.utils.IDUtils;
import com.princehan.utils.MybatisUtils;
import org.apache.ibatis.session.SqlSession;
import org.junit.Test;
import java.util.Date;
import java.util.HashMap;
import java.util.List;
/**
* @Description
* @Author:PrinceHan
* @CreateTime:2022/4/10 23:02
*/
@SuppressWarnings("all")
public class MyTest {
@Test
public void addInitBlog() {
SqlSession sqlSession = MybatisUtils.getSqlSession();
BlogMapper mapper = sqlSession.getMapper(BlogMapper.class);
Blog blog = new Blog();
blog.setId(IDUtils.getID());
blog.setTitle("Mybatis如此简单");
blog.setAuthor("狂神说");
blog.setCreateTime(new Date());
blog.setViews(9999);
mapper.addBlog(blog);
blog.setId(IDUtils.getID());
blog.setTitle("Java如此简单");
mapper.addBlog(blog);
blog.setId(IDUtils.getID());
blog.setTitle("Spring如此简单");
mapper.addBlog(blog);
blog.setId(IDUtils.getID());
blog.setTitle("微服务如此简单");
mapper.addBlog(blog);
sqlSession.close();
}
}
测试环境是否搭建成功
11.2、if语句
需求:根据作者名字和博客名字来查询博客!如果作者名字为空,那么只根据博客名字查询,反之,则根据作者名来查询
新建接口
//查询博客
List<Blog> queryBlogIF(Map map);
编写映射
<insert id="addBlog" parameterType="Blog">
insert into blog(id, title, author, create_time, views)
values (#{id}, #{title}, #{author}, #{createTime}, #{views})
</insert>
<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>
</select>
编写测试类
@Test
public void queryBlogIF() {
SqlSession sqlSession = MybatisUtils.getSqlSession();
BlogMapper mapper = sqlSession.getMapper(BlogMapper.class);
HashMap map = new HashMap();
map.put("title", "Java如此简单");
map.put("author", "狂神说");
mapper.queryBlogIF(map);
sqlSession.close();
}
if
语句会根据条件真假来添加语句, 如果 author 等于 null,那么查询语句为 select from blog where title=#{title}
,但是如果title为空呢?那么查询语句为 select from blog where and author=#{author}
,这是错误的 SQL 语句,如何解决呢?请看下面的 where 语句!
11.3、trim、where、set
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 元素也会将它们去除。
trim
如果 where 元素与你期望的不太一样,你也可以通过自定义 trim 元素来定制 where 元素的功能。比如,和 where 元素等价的自定义 trim 元素为:
<trim prefix="WHERE" prefixOverrides="AND |OR ">
...
</trim>
prefixOverrides 属性会忽略通过管道符分隔的文本序列(注意此例中的空格是必要的)。
set
新建接口
//更新博客
int updateBlog(Map map);
<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>
这个例子中,set 元素会动态地在行首插入 SET 关键字,并会删掉额外的逗号(这些逗号是在使用条件语句给列赋值时引入的)。
来看看与 set 元素等价的自定义 trim 元素吧:
<trim prefix="SET" suffixOverrides=",">
...
</trim>
注意,我们覆盖了后缀值设置,并且自定义了前缀值。
@Test
public void updateBlog() {
SqlSession sqlSession = MybatisUtils.getSqlSession();
BlogMapper mapper = sqlSession.getMapper(BlogMapper.class);
HashMap map = new HashMap();
map.put("title", "Java如此简单2");
map.put("author", "狂神说2");
map.put("id", "8f9b7bd6cee84c49bc08a82e9b07f9df");
mapper.updateBlog(map);
sqlSession.close();
}
11.4、choose、when、otherwise
有时候,我们不想使用所有的条件,而只是想从多个条件中选择一个使用。针对这种情况,MyBatis 提供了 choose
元素,它有点像 Java 中的 switch
语句。
还是上面的例子,但是策略变为:传入了 “title” 就按 “title” 查找,传入了 “author” 就按 “author” 查找的情形。若两者都没有传入,就返回浏览量为 views 的 BLOG。
<select id="queryBlogChoose" parameterType="map" resultType="Blog">
select * from blog
<where>
<choose>
<when test="title != null">title = #{title}</when>
<when test="author != null">and author = #{author}</when>
<otherwise>and views = #{views}</otherwise>
</choose>
</where>
</select>
//查询博客
List<Blog> queryBlogChoose(Map map);
@Test
public void queryBlogChoose() {
SqlSession sqlSession = MybatisUtils.getSqlSession();
BlogMapper mapper = sqlSession.getMapper(BlogMapper.class);
HashMap map = new HashMap();
map.put("title", "Java如此简单");
map.put("author", "狂神说");
map.put("views",9999);
List<Blog> blogs = mapper.queryBlogChoose(map);
for (Blog blog : blogs) {
System.out.println(blog);
}
sqlSession.close();
}
11.5、sql片段
有时候可能某个 sql 语句我们用的特别多,为了增加代码的重用性,简化代码,我们需要将这些代码抽取出来,然后使用时直接调用。
- 使用sql标签抽取公共的部分
<sql id="if-title-author">
<if test="title != null">title = #{title}</if>
<if test="author != null">and author = #{author}</if>
</sql>
- 引用sql片段
<select id="queryBlogIF" parameterType="map" resultType="Blog">
select * from blog
<where>
<include refid="if-title-author"/>
</where>
</select>
注意:
①、最好基于 单表来定义 sql 片段,提高片段的可重用性
②、在 sql 片段中不要包括 where
11.6、foreach
将数据库中前三个数据的id修改为1,2,3;
需求:我们需要查询 blog 表中 id 分别为1,2,3的博客信息
新建接口
//查询1-2-3号记录的博客
List<Blog> queryBlogForeach(Map map);
配置映射
<!--传递map 存一个集合-->
<select id="queryBlogForeach" parameterType="map" resultType="Blog">
select * from blog
<where>
<foreach collection="ids" item="id" open="and (" separator="or" close=")">
id = #{id}
</foreach>
</where>
</select>
编写测试类
@Test
public void queryBlogForeach() {
SqlSession sqlSession = MybatisUtils.getSqlSession();
BlogMapper mapper = sqlSession.getMapper(BlogMapper.class);
HashMap map = new HashMap();
ArrayList<Integer> ids = new ArrayList<>();
for (int i = 1; i <= 3; i++) {
ids.add(i);
}
map.put("ids", ids);
List<Blog> blogs = mapper.queryBlogForeach(map);
sqlSession.close();
}
小结:其实动态 sql 语句的编写往往就是一个拼接的问题,为了保证拼接准确,我们最好首先要写原生的 sql 语句出来,然后在通过 mybatis 动态sql 对照着改,防止出错。多在实践中使用才是熟练掌握它的技巧
12、MyBatis缓存
12.1、简介
什么是缓存 [ Cache ]?
- 存在内存中的临时数据。
- 将用户经常查询的数据放在缓存(内存)中,用户去查询数据就不用从磁盘上(关系型数据库数据文件)查询,从缓存中查询,从而提高查询效率,解决了高并发系统的性能问题。
为什么使用缓存?
- 减少和数据库的交互次数,减少系统开销,提高系统效率。
什么样的数据能使用缓存?
- 经常查询并且不经常改变的数据。
12.2、 Mybatis缓存
- MyBatis包含一个非常强大的查询缓存特性,它可以非常方便地定制和配置缓存。缓存可以极大的提升查询效率。
- MyBatis系统中默认定义了两级缓存:一级缓存和二级缓存
- 默认情况下,只有一级缓存开启。(SqlSession级别的缓存,也称为本地缓存)
- 二级缓存需要手动开启和配置,他是基于namespace级别的缓存。
- 为了提高扩展性,MyBatis定义了缓存接口Cache。我们可以通过实现Cache接口来自定义二级缓存
12.3、一级缓存
一级缓存也叫本地缓存:
- 与数据库同一次会话期间查询到的数据会放在本地缓存中。
- 以后如果需要获取相同的数据,直接从缓存中拿,没必须再去查询数据库;
测试
新建实体类
package com.princehan.pojo;
import lombok.AllArgsConstructor;
import lombok.Data;
/**
* @Description
* @Author:PrinceHan
* @CreateTime:2022/4/11 21:15
*/
@Data
@AllArgsConstructor
public class User {
private int id;
private String name;
private String pwd;
}
编写
UserMapper
接口
//根据id查询用户
User queryUserById(@Param("id") int id);
编写映射
<?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">
<mapper namespace="com.princehan.dao.UserMapper">
<select id="queryUserById" resultType="User">
select * from user where id = #{id}
</select>
</mapper>
编写核心配置文件
<!--绑定接口-->
<mappers>
<!--Mapper与Mapper.xml在同一个目录下 可以用类名 可用注解-->
<mapper class="com.princehan.dao.UserMapper"/>
</mappers>
编写测试类
import com.princehan.dao.UserMapper;
import com.princehan.pojo.User;
import com.princehan.utils.MybatisUtils;
import org.apache.ibatis.session.SqlSession;
import org.junit.Test;
/**
* @Description
* @Author:PrinceHan
* @CreateTime:2022/4/11 21:29
*/
public class MyTest {
@Test
public void queryUserById() {
SqlSession sqlSession = MybatisUtils.getSqlSession();
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
User user = mapper.queryUserById(1);
System.out.println(user);
System.out.println("========");
User user1 = mapper.queryUserById(1);
System.out.println(user1);
System.out.println(user == user1);
sqlSession.close();
}
}
发现两次取出的User为同一对象,说明有缓存。映射语句文件中的所有 select 语句的结果将会被缓存。
缓存失效的情况:
-
一级缓存是SqlSession级别的缓存,是一直开启的,我们关闭不了它;
-
查询不同的数据
-
映射语句文件中的所有 insert、update 和 delete 语句会刷新缓存。
-
查询不同的Mapper.xml
-
手动清理缓存
@Test
public void queryUserById() {
SqlSession sqlSession = MybatisUtils.getSqlSession();
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
User user = mapper.queryUserById(1);
System.out.println(user);
//手动清理缓存
sqlSession.clearCache();
System.out.println("========");
User user1 = mapper.queryUserById(1);
System.out.println(user1);
System.out.println(user == user1);
sqlSession.close();
}
12.4、二级缓存
不开启二级缓存
@Test
public void queryUserById() {
SqlSession sqlSession = MybatisUtils.getSqlSession();
SqlSession sqlSession2 = MybatisUtils.getSqlSession();
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
UserMapper mapper2 = sqlSession2.getMapper(UserMapper.class);
User user = mapper.queryUserById(1);
System.out.println(user);
System.out.println("========");
User user1 = mapper2.queryUserById(1);
System.out.println(user1);
System.out.println(user == user1);
sqlSession.close();
sqlSession2.close();
}
开启二级缓存
<!--显示开启全局缓存 默认开启-->
<setting name="cacheEnabled" value="true"/>
<cache/>
<!--在当前Mapper使用二级缓存-->
<cache
eviction="FIFO"
flushInterval="60000"
size="512"
readOnly="true"/>
需要序列化
@Test
public void queryUserById() {
SqlSession sqlSession = MybatisUtils.getSqlSession();
SqlSession sqlSession2 = MybatisUtils.getSqlSession();
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
UserMapper mapper2 = sqlSession2.getMapper(UserMapper.class);
User user = mapper.queryUserById(1);
System.out.println(user);
System.out.println("========");
User user1 = mapper2.queryUserById(1);
System.out.println(user1);
System.out.println(user == user1);
sqlSession.close();
sqlSession2.close();
}
小结
- 只要开启了二级缓存,我们在同一个Mapper中的查询,可以在二级缓存中拿到数据
- 查出的数据都会被默认先放在一级缓存中
- 只有会话提交或者关闭以后,一级缓存中的数据才会转到二级缓存中
12.5、缓存原理
缓存提高查询效率
跟着狂神学完了, 感谢狂神!!!