文章目录
MyBatis快速入门
一、简介
1、什么是MyBatis
- MyBatis 是一款优秀的持久层框架。
- 它支持自定义 SQL、存储过程以及高级映射。
- MyBatis 免除了几乎所有的 JDBC 代码以及设置参数和获取结果集的工作。
- MyBatis 可以通过简单的 XML 或注解来配置和映射原始类型、接口和 Java POJO(Plain Old Java Objects,普通老式 Java 对象)为数据库中的记录。
如何获取MyBatis?
- Maven仓库(https://mvnrepository.com/search?q=MyBatis)
- Github(https://github.com/mybatis/mybatis-3)
- 中文文档(https://mybatis.org/mybatis-3/zh/index.html)
2.什么是持久化
数据的持久化,将程序的数据在持久状态和瞬时状态的转化的过程就是持久化。
- 内存:断电即失
- 数据库(jdbc)IO文件持久化
3.什么是持久层
常见的层有:Dao层,Service层,Controller层
所谓持久层:
- 完成持久化工作的代码块
- 层界限十分明显
4 为什么需要MyBatis?
- 方便
- 传统的JDBC代码太复杂,简化、框架、自动化
- 帮助程序人员将数据存入数据库中
5.MyBatis的特点(优势)
- 简单易学:本身就很小且简单。没有任何第三方依赖,最简单安装只要两个jar文件+配置几个sql映射文件易于学习,易于使用,通过文档和源代码,可以比较完全的掌握它的设计思路和实现。
- 灵活:mybatis不会对应用程序或者数据库的现有设计强加任何影响。 sql写在xml里,便于统一管理和优化。通过sql语句可以满足操作数据库的所有需求。
- 解除sql与程序代码的耦合:通过提供DAO层,将业务逻辑和数据访问逻辑分离,使系统的设计更清晰,更易维护,更易单元测试。sql和代码的分离,提高了可维护性。
- 提供映射标签,支持对象与数据库的orm字段关系映射
- 提供对象关系映射标签,支持对象关系组建维护
- 提供xml标签,支持编写动态sql。
二、第一个MyBatis程序
思路:搭建环境——>导入MyBatis——>测试
1.搭建环境
a、搭建一个数据库
CREATE DATABASE MyBatis;
USE MyBatis;
CREATE TABLE user(
id int NOT NULL PRIMARY KEY,
name varchar(30) DEFAULT NULL,
pwd varchar(30) DEFAULT NULL
);
INSERT INTO user VALUES(3,'王五','789');
b、创建项目(创建所有项目的父项目MyBatisDemo1)
c、添加mybatis所需要的依赖
<!--mybatis依赖-->
<!-- https://mvnrepository.com/artifact/org.mybatis/mybatis -->
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.4.6</version>
</dependency>
<!--mysql依赖-->
<!-- https://mvnrepository.com/artifact/mysql/mysql-connector-java -->
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>8.0.16</version>
</dependency>
<!--junit依赖-->
<!-- https://mvnrepository.com/artifact/junit/junit -->
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.12</version>
<scope>test</scope>
</dependency>
2、创建一个模块(以MyBatisDemo1为父模块)
出现的问题
- 子模块没有自动导入父模块的包
- 子模块手动导入
<parent>xxxx</parent>
,父模块手动导入<modules>xxxx</modules>
- 子模块手动导入
- 父模块显示不合法的包类型(‘packaging’ with value ‘jar’ is invalid. Aggregator projects require ‘pom’ as packaging.)
- 需要将在父模块之下,加入
<packing>pom</packing>
即可
- 需要将在父模块之下,加入
3.编写MyBatis的核心配置文件
(1)创建配置文件
在子项目的resources创建配置文件mybatis-config.xml,并在MyBatis官网中复制该文件所需要的内容。并在此基础上作出适当的修改。
XML 配置文件中包含了对 MyBatis 系统的核心设置,包括获取数据库连接实例的数据源(DataSource)以及决定事务作用域和控制方式的事务管理器(TransactionManager)。
<?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">
<!--事务处理的类型是JDBC-->
<transactionManager type="JDBC"/>
<dataSource type="POOLED">
<!--设置url,driver,username和password-->
<property name="driver" value="com.mysql.jdbc.Driver"/>
<property name="url" value="jdbc:mysql://localhost:3306/MyBatis?useSSL=true&useUnicode=true&characterEncoding=UTF-8 "/>
<property name="username" value="root"/>
<property name="password" value="123456"/>
</dataSource>
</environment>
</environments>
<mappers>
<mapper resource="org/mybatis/example/BlogMapper.xml"/>
</mappers>
</configuration>
注意:
<property name="url" value="jdbc:mysql://localhost:3306/MyBatis?useSSL=true&useUnicode=true&characterEncoding=UTF-8 "/>
,在指定url之后需要添加一系列参数,
指定MyBatis数据库(步骤一新建的数据库),?之后的是所有需要设置的参数,分别是支持安全连接,使用字符集,设置字符编码为UTF-8,&
表示的是和的意思。
- idea中可以直接连接MySQL数据库,只需要在相应的位置输入账户和密码即可。
(2)编写MyBatis工具类
每个基于 MyBatis 的应用都是以一个 SqlSessionFactory 的实例为核心的。SqlSessionFactory 的实例可以通过 SqlSessionFactoryBuilder 获得。而 SqlSessionFactoryBuilder 则可以从 XML 配置文件或一个预先配置的 Configuration 实例来构建出 SqlSessionFactory 实例。
从 XML 文件中构建 SqlSessionFactory 的实例非常简单,建议使用类路径下的资源文件进行配置。 但也可以使用任意的输入流(InputStream)实例,比如用文件路径字符串或 file:// URL 构造的输入流。MyBatis 包含一个名叫 Resources 的工具类,它包含一些实用方法,使得从类路径或其它位置加载资源文件更加容易。
String resource = "org/mybatis/example/mybatis-config.xml";---读取xml资源
InputStream inputStream = Resources.getResourceAsStream(resource);--将资源转换为输入流
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);-- 利用输入流和建造工厂类创建一个sqlSessionFactory
- 首先获取SqlSessionFactory实例
String sources="xxxx.xml";
InputStream inputStream = Resources.getResourceAsStream(sources);
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
- 获取sqlSession,既然有了 SqlSessionFactory,顾名思义,我们可以从中获得 SqlSession 的实例。SqlSession 提供了在数据库执行 SQL 命令所需的所有方法。可以通过 SqlSession 实例来直接执行已映射的 SQL 语句。
package com.apache.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;
/**
* @author lambda
*/
public class MyBatisUtils {
private static SqlSessionFactory sqlSessionFactory;
static{
try {
//由于是在项目的资源文件中,所以可以直接选择文件名,在static中直接初始化
String sources="mybatis-config.xml";
InputStream inputStream = Resources.getResourceAsStream(sources);
sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
} catch (Exception e) {
throw new RuntimeException(e);
}
}
public static SqlSession getSqlSession(){
return sqlSessionFactory.openSession();
}
}
(3)编写代码
- 编写实体类
/**
* @author lambda
*/
public class User {
private int id;
private String name;
private String pwd;
public User() {
}
public User(int id, String name, String pwd) {
this.id = id;
this.name = name;
this.pwd = pwd;
}
public int getId() {
return id;
}
public void setId(int id) {
this.id = id;
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public String getPwd() {
return pwd;
}
public void setPwd(String pwd) {
this.pwd = pwd;
}
@Override
public String toString() {
return "User{" +
"id=" + id +
", name='" + name + '\'' +
", pwd='" + pwd + '\'' +
'}';
}
}
- Dao接口
编写完一个可以获取所有用户的接口之后,在添加一个UserMapper.xml文件,这里面定义了sqlsession的调用
package com.apache.dao;
import com.apache.pojo.User;
import java.util.List;
/**
* The interface User dao.
*
* @author lambda
*/
public interface UserDao {
/**
* Gets user.
*
* @return the user
*/
List<User> getUserList();
}
- 定义接口实现类(使用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">
<!--namesapce表示一个命名空间,指定一个对应的Dao/Mapper接口
select中的id表示的是接口中的定义方法
SELECT * FROM MyBatis.user表示查询user表
resultType表示sql语句返回的结果类型-->
<mapper namespace="com.apache.dao.UserDao">
<select id="getUserList" resultType="com.apache.pojo.User">
SELECT * FROM MyBatis.user
</select>
</mapper>
(4)测试代码
import com.apache.pojo.User;
import com.apache.utils.MyBatisUtils;
import org.apache.ibatis.session.SqlSession;
import org.junit.Test;
import java.util.List;
public class UserDaoTest {
@Test
public void test(){
//获取sqlsession
SqlSession sqlSession = MyBatisUtils.getSqlSession();
/*执行方式有很多种*/
//方式一:要执行sql语句,首先要获取UserDao对象(调用方法获取结果),dao层中的xml文件是UserDao的实现类。
UserDao userDao = sqlSession.getMapper(UserDao.class);
List<User> userList = userDao.getUserList();
for (User user : userList) {
System.out.println(user);
}
//关闭sqlSession
sqlSession.close();
}
}
出现的问题:
- 出现绑定异常,会显示没有注册
org.apache.ibatis.binding.BIndingException
此时需要在MyBatis的核心配置文件MyBatis-config.xml文件中添加Mapper选项进行绑定
<!--每一个mapper.xml文件都需要在myBatis的核心配置文件进行注册-->
<mappers>
<mapper resource="/home/lambda/MyBatis练习/MyBatisDemo1/son1/src/main/java/com/apache/dao/UserMapper.xml"/>
</mappers>
- 出现初始化异常
java.lang.ExceptionInInitializerError
(显示找不到资源类)
解决方案:在maven的pom文件中都加上资源导出选项
<resources>
<resource>
<directory>src/main/resources</directory>
<includes>
<include>**/*.properties</include>
<include>**/*.xml</include>
</includes>
<filtering>true</filtering>
</resource>
<resource>
<directory>src/main/java</directory>
<includes>
<include>**/*.properties</include>
<include>**/*.xml</include>
</includes>
<filtering>true</filtering>
</resource>
</resources>
运行结果如下:
总结步骤:
- 首先创建一个maven子项目,并在其pom.xml文件中添加资源导出设置选项。
- 在src/main/java/com/xxx下创建三个包,分别为dao,pojo和utils,并在resources目录下创建一个mybatis-config.xml的核心配置文件。
- 首先导入mybatis-config.xml所需要的核心配置(可以从官网上直接复制到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="${driver}"/>
<property name="url" value="${url}"/>
<property name="username" value="${username}"/>
<property name="password" value="${password}"/>
</dataSource>
</environment>
</environments>
<mappers>
<mapper resource="org/mybatis/example/BlogMapper.xml"/>
</mappers>
</configuration>
- 之后在pojo文件夹中创建实体类,并创建相应的setter和getter方法,完成对应实体类的创建
- 在dao目录下创建创建一个接口xxxdao,里面创建一个能够获取所有pojo目录下实体类对象的方法
- 在dao目录下创建一个xxxMapper.xml文件,此文件用来实现接口xxxdao,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">
<mapper namespace="org.mybatis.example.BlogMapper">
<select id="selectBlog" resultType="Blog">
select * from Blog where id = #{id}
</select>
</mapper>
在此需要修改命名空间namespace的内容,改为dao目下的接口xxxdao的路径,之后修改select标签中的id,此id表示xxxdao接口中的对应需要实现的方法,resultType表示该接口中定义的方法的返回值类型,select标签中的内容为需要执行的sql查询语句。
- 在utils目录下创建一个MyBatisUtils的工具类,类中需要创建方法来获取到执行sql语句的SqlSession对象
package com.apache.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;
/**
* @author lambda
*/
public class MyBatisUtils {
private static SqlSessionFactory sqlSessionFactory;
static{
try {
//由于是在项目的资源文件中,所以可以直接选择文件名,在static中直接初始化
String sources="mybatis-config.xml";
InputStream inputStream = Resources.getResourceAsStream(sources);
sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
} catch (Exception e) {
throw new RuntimeException(e);
}
}
public static SqlSession getSqlSession(){
return sqlSessionFactory.openSession();
}
}
需要注意的是SqlSessionFactorBuilder是为了获取SqlSessionFactory,而SqlSessionFactory可以通过其openSession方法获取SqlSession对象。
- 在mybatis-config.xml文件中修改Mappers标签中的mapper选项的内容,将mapper选项中resources的内容指定为上面已经建立的xxxMapper.xml文件的路径(可以使用相对路径)
三、进行增删改查的业务处理
1. namespace:
命名空间中的包名要和接口中的包名一致。
2.select:选择查询语句
- id:就是对应namespace中的方法名
- resultType:sql语句执行的返回值
- parameterType:参数类型
<!--由于接口中添加了新的方法,所以需要在xml文件中添加新的select标签-->
<select id="getUserById" resultType="com.apache.pojo.User" parameterType="int">
select * from MyBatis.user where id= #{id}
</select>
此时需要注意的是,参数类型为int,是因为所绑定的方法中的参数为int类型的参数,编写sql语句时,也需要注意的是where条件查询时,id列值,需要通过#{id}
的形式给出
//以下是测试类和接口中的方法
/**
* Gets user by id.
*
* @param id the id
* @return the user by id 通过给定的id查询对应的user对象
*/
User getUserById(int id);
@Test
public void testGetUser(){
SqlSession sqlSession = MyBatisUtils.getSqlSession();
UserDao mapper = sqlSession.getMapper(UserDao.class);
User user = mapper.getUserById(1);
System.out.println(user);
sqlSession.close();
}
3.INSERT语句
<!--User对象中的属性可以直接获取-->
<insert id="addUser" parameterType="com.apache.pojo.User" >
INSERT INTO MyBatis.user(id,name,pwd) VALUES (#{id},#{name},#{pwd})
</insert>
//以下是所有的测试方法和接口方法
/**
* Add user int.
*
* @param user the user
* @return the int
* 创建一个方法,插入新的对象
*/
int addUser(User user);
@Test
public void addUser(){
SqlSession sqlSession = MyBatisUtils.getSqlSession();
UserDao mapper = sqlSession.getMapper(UserDao.class);
int res = mapper.addUser(new User(4, "刘翔", "999"));
if (res>0) System.out.println("插入成功");
//所有的增删改都需要提交事务,这样数据才可以到数据库
sqlSession.commit();
sqlSession.close();
}
4.UPDATE语句
<!--更改一个用户的语句-->
<update id="updateUser" parameterType="com.apache.pojo.User" >
update MyBatis.user SET name=#{name}, pwd=#{pwd} where id=#{id}
</update>
//以下是所有的测试方法和接口方法
/**
* 使用此方法更改一个用户
* @param user
* @return
*/
int updateUser(User user);
@Test
public void updateUser(){
SqlSession sqlSession = MyBatisUtils.getSqlSession();
UserDao mapper = sqlSession.getMapper(UserDao.class);
int res = mapper.updateUser(new User(4, "Jack", "123123"));
if (res>0) System.out.println("修改成功!");
sqlSession.commit(); //提交事务
sqlSession.close();
}
5.DELETE语句
<!--创建删除语句-->
<delete id="deleteUser" parameterType="int" >
DELETE FROM MyBatis.user WHERE id=#{id}
</delete>
//以下是所有的测试方法和接口方法
/**
* 此方法用来删除一个用户,根据id来删除
* @param id
* @return
*/
int deleteUser(int id);
@Test
public void deleteUser(){
SqlSession sqlSession = MyBatisUtils.getSqlSession();
UserDao mapper = sqlSession.getMapper(UserDao.class);
int i = mapper.deleteUser(4);
if (i>0) System.out.println("删除成功!");
sqlSession.commit();
sqlSession.close();
}
步骤总结
- 编写接口中的方法(需要执行什么样的业务逻辑)
- 修改接口实现的xml文件中的内容,依据操作添加相应的不同标签
- 测试接口
增删改都需要提交事务!!!!!!
注意事项
- 标签不能匹配错误
- resources表示一个路径,需要斜杠表示分割
- 程序配置文件必须规范(即mybatis-config.xml文件中的所有格式都必须要规范)
- 在UserMapper.xml实现文件中,如果语句的参数是一个实体类,那么就需要将数据库中的字段与类的属性一一对应。
<!--User对象中的属性可以直接获取-->
<insert id="addUser" parameterType="com.apache.pojo.User" >
INSERT INTO MyBatis.user(id,name,pwd) VALUES (#{id},#{name},#{pwd})
</insert>
其中的id、name、pwd字段都需要与类的属性名一一对应。
扩展知识:万能Map
如果实体类或者数据库中的表、字段或者参数过多时,我们应当考虑使用Map
改进:
<!--使用map做参数,此时的值可以自定义,无需与类的属性保持一致
传入map的key值即可-->
<insert id="addUserByMap" parameterType="map">
INSERT INTO MyBatis.user(id,name,pwd) VALUES(#{userid},#{username},#{userpwd})
</insert>
/**
* Add user by map int.
*要求参数传入一个Map,通过map来添加用户
* @param map the map
* @return the int
*/
int addUserByMap(Map<String,Object> map);
@Test
public void addUserByMap(){
SqlSession sqlSession = MyBatisUtils.getSqlSession();
UserDao mapper = sqlSession.getMapper(UserDao.class);
//由于此处方法传入的是map集合,所以预先传入
Map<String, Object> hsm = new HashMap<>();
//此处的键需要与xml文件中的保持一致
hsm.put("userid",4);
hsm.put("username","刘翔");
hsm.put("userpwd","888");
int i = mapper.addUserByMap(hsm);
if (i>0) System.out.println("插入成功!");
sqlSession.commit();
sqlSession.close();
}
此处表示在map中添加相应的键值对,表示数据库的一条记录
上述的xml中传入的是map的key值,因此在创建map时需要将key与上述xml文件中的#{xxx}
中的值(userid等)相对应,程序可以通过key值得到对应的value值。
Map传递参数只需要在sql中取出key即可。对象传递参数,直接在sql中取对象的属性即可。只有一个基本类型参数的情况下,可以直接在sql中取到。
多个参数的情况下应该使用Map或者是注解。
模糊查询的实现
主要实现Like的查询
<!--进行模糊查询Like-->
<select id="getUserByLike" resultType="com.apache.pojo.User">
SELECT * FROM MyBatis.user WHERE name LIKE #{value}
</select>
/**
* Gets user by like.
* 使用like进行模糊查询
*
* @param value the value
* @return the user by like
*/
List<User> getUserByLike(String value);
@Test
public void likeUsers(){
SqlSession sqlSession = MyBatisUtils.getSqlSession();
UserDao mapper = sqlSession.getMapper(UserDao.class);
List<User> userList = mapper.getUserByLike("李%");
for (User user : userList) {
System.out.println(user);
}
sqlSession.close();
}
实现了对李姓用户的查询。
其中的select语句请求模糊查询,返回类型是User,Like后面的参数value是我们需要传入的参数,并通过测试方法获取所有的符合用户的信息。
- Java代码执行的时候,需要传递通配符% %
- 在sql拼接中使用通配符
四、配置解析
1. 核心配置文件
- mybatis-config.xml
- MyBatis 的配置文件包含了会深深影响 MyBatis 行为的设置和属性信息
configuration(配置)
properties(属性)
settings(设置)
typeAliases(类型别名)
typeHandlers(类型处理器)
objectFactory(对象工厂)
plugins(插件)
environments(环境配置)
environment(环境变量)
transactionManager(事务管理器)
dataSource(数据源)
databaseIdProvider(数据库厂商标识)
mappers(映射器)
2. 环境配置(environments)
MyBatis 可以配置成适应多种环境,这种机制有助于将 SQL 映射应用于多种数据库之中
不过要记住:尽管可以配置多个环境,但每个 SqlSessionFactory 实例只能选择一种环境。
<environments default="development">
<environment id="development">
<transactionManager type="JDBC"/>
<dataSource type="POOLED">
<property name="driver" value="com.mysql.cj.jdbc.Driver"/>
<property name="url" value="jdbc:mysql://localhost:3306/MyBatis?useSSL=true&useUnicode=true&characterEncoding=UTF-8 "/>
<property name="username" value="root"/>
<property name="password" value="xielibin20001011"/>
</dataSource>
</environment>
<environment id="test">
<transactionManager type="JDBC"/>
<dataSource type="POOLED">
<property name="driver" value="com.mysql.cj.jdbc.Driver"/>
<property name="url" value="jdbc:mysql://localhost:3306/MyBatis?useSSL=true&useUnicode=true&characterEncoding=UTF-8 "/>
<property name="username" value="root"/>
<property name="password" value="xielibin20001011"/>
</dataSource>
</environment>
</environments>
<!--改变环境只需要修改对应的default就行-->
MyBatis默认的事务管理器是JDBC,但不止有JDBC,连接池:POOLED(但不止有连接池)
3. 属性(properties)
我们可以使用属性(properties)来引用配置文件
这些属性可以在外部进行配置,并可以进行动态替换。你既可以在典型的 Java 属性文件中配置这些属性,也可以在 properties 元素的子元素中设置。[db.properties]
配置文件有一定的顺序
编写一个配置文件
driver=com.mysql.cj.jdbc.Driver
url=jdbc:mysql://localhost:3306/MyBatis?useSSL=true&useUnicode=true&characterEncoding=UTF-8
username=root
password=123456
在核心配置文件中引入配置
<!--引入外部配置文件,之后在配置下直接写引用的名字即可-->
<properties resource="db.properties">
<property name="username" value="root"/>
<property name="password" value="123456"/>
</properties>
在核心配置文件进行设置
<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>
- 可以引入外部配置文件db.properties
- 也可以在属性中进行配置文件的设置
- 如果有两个文件有同一字段,优先使用外部配置文件。
4. 类型别名(typeAliases)
类型别名可为 Java 类型设置一个缩写名字。 它仅用于 XML 配置,意在降低冗余的全限定类名书写
别名的设置有两种形式:
使用类型标签的方式
<!--为对应的pojo、对象起别名-->
<typeAliases>
<typeAlias type="com.apache.pojo.User" alias="User"></typeAlias>
</typeAliases>
使用包的方式:MyBatis会在对应包下搜索所需要的Java Bean。扫描实体类的包,它的默认别名就为这个类的类名,首字母小写。
<!--为对应的pojo、对象起别名-->
<typeAliases>
<package name="com.apache.pojo"/>
</typeAliases>
实体类比较少的情况下建议使用第一种,在实体类比较多的情况下建议使用第二种。但区别在于第一种可以DIY别名。第二种无法自定义别名
虽然第二种方式无法使用DIY别名,但是可以通过注解的方式来设置别名
import org.apache.ibatis.type.Alias;
/**
* @author lambda
*/
@Alias("hello")
public class User {
private int id;
private String name;
private String pwd;
}
<select id="getUserList" resultType="hello">
SELECT * FROM MyBatis.user
</select>
5.设置(settings)
这是 MyBatis 中极为重要的调整设置,它们会改变 MyBatis 的运行时行为。
例如:MyBatis的日志实现设置
开启缓存与懒加载
6. 映射器(mappers)
MapperRegister:注册绑定Mapper文件(去核心配置文件注册)
既然 MyBatis 的行为已经由上述元素配置完了,我们现在就要来定义 SQL 映射语句了。我们需要告诉 MyBatis 到哪里去找到这些语句。你可以使用相对于类路径的资源引用,或完全限定资源定位符(包括 file:///
形式的 URL),或类名和包名等
(1)相对类路径的引用
<!-- 使用相对于类路径的资源引用 -->
<mappers>
<mapper resource="org/mybatis/builder/AuthorMapper.xml"/>
<mapper resource="org/mybatis/builder/BlogMapper.xml"/>
<mapper resource="org/mybatis/builder/PostMapper.xml"/>
</mappers>
(2)使用完全限定资源定位符
<!-- 使用完全限定资源定位符(URL) -->
<mappers>
<mapper url="file:///var/mappers/AuthorMapper.xml"/>
<mapper url="file:///var/mappers/BlogMapper.xml"/>
<mapper url="file:///var/mappers/PostMapper.xml"/>
</mappers>
(3)使用映射器接口实现类的完全限定类名
<!-- 使用映射器接口实现类的完全限定类名 -->
<mappers>
<mapper class="org.mybatis.builder.AuthorMapper"/>
<mapper class="org.mybatis.builder.BlogMapper"/>
<mapper class="org.mybatis.builder.PostMapper"/>
</mappers>
使用class文件绑定注册会出现的问题
- 接口和Mapper配置文件必须同名(如UserMapper必须要与UserMapper.xml同名)
- 接口和配置文件必须在同一包下。
(4)包内映射器接口全部注册为映射器
<!-- 将包内的映射器接口实现全部注册为映射器 -->
<mappers>
<package name="org.mybatis.builder"/>
</mappers>
- 接口和Mapper配置文件必须同名(如UserMapper必须要与UserMapper.xml同名)
- 接口和配置文件必须在同一包下
五、生命周期和作用域
理解我们之前讨论过的不同作用域和生命周期类别是至关重要的,因为错误的使用会导致非常严重的并发问题。
SqlSessionFactoryBuilder:
- 这个类可以被实例化、使用和丢弃,一旦创建了 SqlSessionFactory,就不再需要它了
- 局部变量
SqlSessionFactory
- 可以将其理解为数据库连接池,可以创建很多的sqlsession对象
- SqlSessionFactory 一旦被创建就应该在应用的运行期间一直存在,没有任何理由丢弃它或重新创建另一个实例。
- SqlSessionFactory 的最佳作用域是应用作用域。(全局作用域,程序开启它就开启)
- 最简单的就是使用单例模式或者静态单例模式。
SqlSession
- 类似于一个连接到连接池的请求
- SqlSession 的实例不是线程安全的,因此是不能被共享的,所以它的最佳的作用域是请求或方法作用域
- 用完就要关闭,否则资源就要被占用。
这里的每一个Mapper就代表每一个具体的业务。
六、ResultMap结果集映射
1. 问题
主要解决属性名与字段名不一致的问题。
- 新建一个项目,修改项目中pojo对象的属性,使其与数据库中的字段不一致。
public class User {
private int id;
private String name;
private String password;
}
- 测试结果(根据id查找相应的用户)
select * from MyBatis.user where id= #{id}
-- 等同于
-- 类型处理器
select id, name, pwd from MyBatis.user where id= #{id}
- 问题解决措施
- 起别名
<select id="getUserById" resultType="com.apache.pojo.User" parameterType="int">
select id, name, pwd as password from MyBatis.user where id= #{id}
</select>
<!--给pwd起别名为password-->
最后可以根据id查找到对应的用户信息。
2.解决措施(推荐):ResultMap
结果集映射
resultMap
元素是 MyBatis 中最重要最强大的元素。它可以让你从 90% 的 JDBCResultSets
数据提取代码中解放出来,并在一些情形下允许你进行一些 JDBC 不支持的操作。- ResultMap 的设计思想是,对简单的语句做到零配置,对于复杂一点的语句,只需要描述语句之间的关系就行了。
<!--此处采用结果集映射的方式来设置-->
<select id="getUserById" resultMap="userMap" parameterType="int">
select * from MyBatis.user where id= #{id}
</select>
<!--此处设置结果集的映射形式-->
<resultMap id="userMap" type="user">
<!--此处表示具体数据库字段与pojo对象的一一对应关系映射-->
<result column="id" property="id"/>
<result column="name" property="name"/>
<result column="pwd" property="password"/>
</resultMap>
之后使用查询或者其他操作,就解决了字段名与属性名不同的问题。
七、日志
1. 日志工厂
如果一个数据库操作出现了异常,我们需要排错,日志就是最好的助手。
- SLF4J
- LOG4J (掌握)
- LOG4J2
- DK_LOGGING
- COMMONS_LOGGING
- STDOUT_LOGGING (掌握)
- NO_LOGGING
在MyBatis中具体使用哪一个日志实现,在设置中实现
2. STDOUT_LOGGING 标准输出日志
在MyBatis的核心配置文件中,配置了我们的日志。
<!--设置配置文件-->
<settings>
<!--此处表示标准日志输出-->
<setting name="logImpl" value="STDOUT_LOGGING"/>
</settings>
本质上执行的是JDBC的操作
3. LOG4J
什么是Log4J?
a、og4j是Apache的一个开源项目,通过使用Log4j,我们可以控制日志信息输送的目的地是控制台、文件、GUI组件,甚至是套接口服务器、NT的事件记录器、UNIX Syslog守护进程等
b、我们也可以控制每一条日志的输出格式;通过定义每一条日志信息的级别,我们能够更加细致地控制日志的生成过程
c、这些可以通过一个配置文件来灵活地进行配置,而不需要修改应用的代码。
- 首先在MyBatis.xml文件中设置日志实现为Log4J
<!--设置配置文件-->
<settings>
<!--此处表示标准日志输出-->
<!-- <setting name="logImpl" value="STDOUT_LOGGING"/>-->
<setting name="logImpl" value="LOG4J"/>
</settings>
执行,但是出现了问题:
出现类没有被建立,一般就是类名写错了或者没有导入jar包
- 因此,需要导入Log4J的jar包
<!-- https://mvnrepository.com/artifact/log4j/log4j -->
<dependency>
<groupId>log4j</groupId>
<artifactId>log4j</artifactId>
<version>1.2.17</version>
</dependency>
- 为Log4J添加配置文件(在resources目录下)
#将等级为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/apache.log
log4j.appender.file.MaxFileSize=10mb
log4j.appender.file.Threshold=DEBUG
log4j.appender.file.layout=org.apache.log4j.PatternLayout
1og4j.appender.file.layout.ConversionPattern=[%p][%d(yy-MM-dd)][%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
- 配置Log4J为日志的实现
<settings>
<setting name="logImpl" value="LOG4J"/>
</settings>
- Log4J的使用
Log4J的简单使用
- 在要使用Log4J的类中的包(apache的包)
- 日志对象加载参数为当前类的class(需要保证该对象都可以用,需要设置为类享有的。)
//此处表示获取Log4J的日志对象,传入的参数为当前类的class对象
static Logger logger=Logger.getLogger(UserDaoTest.class);
- 对日志对象进行测试
//此处表示获取Log4J的日志对象,传入的参数为当前类的class对象
static Logger logger=Logger.getLogger(UserDaoTest.class);
@Test
public void testLog4J(){
logger.info("info:进入了testLog4J方法");
logger.debug("debug:进入了testLog4J方法");
logger.error("error:进入了了testLog4J方法");
}
- 常见的日志级别
logger.info("info:进入了testLog4J方法");
logger.debug("debug:进入了testLog4J方法");
logger.error("error:进入了了testLog4J方法");
八、分页
为什么要分页?——减少数据的处理量
1. 使用Limit分页
select * from user limit startIndex,pagesize;
2. 使用MyBatis实现分页
核心是SQL
- 接口(使用Map作为参数传递,更加方便)
/**
* Gets user by limit.
*
* @param map the map
* @return the user by limit
*/
List<User> getUserByLimit(Map<String, Integer> map);
- Mapper.xml文件(需要注意结果集映射的实现,解决属性名与字段名不一致的情况下导致的问题,参数类型为map,并且要注意别名问题。基本类型在mybatis中需要在前面加下划线,Map为小写map)
<!--分页实现查询-->
<!--此处需要注意参数的类型,如果是基本类型,则需要在原有的类型前加_表示别名-->
<select id="getUserByLimit" resultType="user" parameterType="map" resultMap="userMap">
SELECT * FROM MyBatis.user LIMIT #{startIndex}, #{pageSize};
</select>
- 测试
@Test
public void getByLimit(){
SqlSession sqlSession = MyBatisUtils.getSqlSession();
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
HashMap<String, Integer> stringIntegerHashMap = new HashMap<>();
stringIntegerHashMap.put("startIndex",0);
stringIntegerHashMap.put("pageSize",2);
List<User> userList= mapper.getUserByLimit(stringIntegerHashMap);
for (User user : userList) {
System.out.println(user);
}
sqlSession.close();
}
3.使用RowBounds实现分页
不使用SQL实现分页
- 接口
/**
* Gets user by row bounds.
* @return the user by row bounds
*/
List<User> getUserByRowBounds();
- Mapper.xml
<!--使用RowBounds实现分页-->
<select id="getUserByRowBounds" resultMap="userMap">
SELECT * FROM MyBatis.user
</select>
- 测试代码
@Test
public void getUserByRowBounds(){
SqlSession sqlSession = MyBatisUtils.getSqlSession();
//RowBounds实现
RowBounds rowBounds = new RowBounds(1, 2);
//通过Java代码层面实现分页
List<User> userList = sqlSession.selectList("com.apache.dap.UserMapper.getUserByRowBounds",null,rowBounds);
for (User user : userList) {
System.out.println(user);
}
sqlSession.close();
}
4.分页插件
Mybatis分页插件PageHelper
九、使用注解开发
1. 注解开发
- 注解在接口上实现
public interface UserMapper {
/**
* Gets users.
*
* @return the users
*/
@Select("SELECT * FROM user")
List<User> getUsers();
}
- 需要在核心配置文件中绑定接口
<!--使用注解需要绑定接口-->
<mappers>
<!--需要绑定到一个具体的接口中-->
<mapper class="com.apache.dao.UserMapper"></mapper>
</mappers>
- 测试结果
本质上:反射机制实现
底层:动态代理
使用注解来映射简单语句会使代码显得更加简洁,但对于稍微复杂一点的语句,Java 注解不仅力不从心,还会让你本就复杂的 SQL 语句更加混乱不堪。 因此,如果你需要做一些很复杂的操作,最好用 XML 来映射语句。
2. MyBatis的详细执行流程
3 .注解实现增删改查
使用注解之后无需再使用xml文件来配置增删改查。但是复杂的业务逻辑还是需要xml文件,相比更加直观。
- 我们可以在工具类创建的时候实现自动提交事务。
public static SqlSession getSqlSession(){
//这里可以设置自动提交事务,默认不是自动提交事务的。
return sqlSessionFactory.openSession(true);
}
- 编写接口的各种处理方法,并增加注解
public interface UserMapper {
/**
* Gets users.
*
* @return the users
*/
@Select("SELECT * FROM user")
List<User> getUsers();
/**
* Gets user by id.
*
* @param id the id
* @return the user by id 参数有多个的时候一定要加@Param的注解(限于基本数据类型和String) User getUserByID(@Param("id") int id,@Param("name") String name);
*/
@Select("SELECT * FROM user WHERE id=#{id}")
User getUserById(@Param("id") int id);
/**
* Add user int.
*
* @param user the user
* @return the int VALUES中需要的pwd的值需要填写实体类中的属性名password
*/
@Insert("INSERT INTO user (id,name,pwd) VALUES(#{id},#{name},#{password})")
int addUser(User user);
/**
* Update user int.
*
* @param user the user
* @return the int
*/
@Update("UPDATE user SET name=#{name},pwd=#{password} WHERE id=#{id}")
int updateUser(User user);
/**
* Delete user int.
*
* @param id the id
* @return the int
*/
@Delete("DELETE FROM user WHERE id=#{id2}")
int deleteUser(@Param("id2") int id);
}
此处需要注意的是对应的增删改查都有相应的语句,@Select,@Delete,@Update,@Insert。同时需要注意@Param的运用,该注解只应用于基本类型和String类型,注解内的值就是上述增删改查语句中需要填入的值,即#{xxx}中的xxx值。
- 测试接口
public class UserMapperTest {
@Test
public void getUsersByAnnotation(){
SqlSession sqlSession = MyBatisUtils.getSqlSession();
//底层主要运用反射
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
List<User> userList=mapper.getUsers();
for (User user : userList) {
System.out.println(user);
}
sqlSession.close();
}
@Test
public void getUserById(){
SqlSession sqlSession = MyBatisUtils.getSqlSession();
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
User user = mapper.getUserById(1);
System.out.println(user);
sqlSession.close();
}
@Test
public void addUser(){
SqlSession sqlSession = MyBatisUtils.getSqlSession();
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
int i = mapper.addUser(new User(5,"李白","9567"));
// sqlSession.commit();由于在工具类中设置了自动提交事务,所以此处不需要提交commit
sqlSession.close();
}
@Test
public void updateUser(){
SqlSession sqlSession = MyBatisUtils.getSqlSession();
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
int affectRows = mapper.updateUser(new User(5, "杜甫", "123321"));
sqlSession.close();
}
@Test
public void deleteUser(){
SqlSession sqlSession = MyBatisUtils.getSqlSession();
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
int affectRows = mapper.deleteUser(5);
sqlSession.close();
}
}
接口创建之后必须要记得在mybatis-config.xml配置文件中注册该接口,否则会报错。
4.关于@Param注解
- 基本类型的参数或者String类型参数,需要加上
- 引用类型不需要加上
- 如果只有一个基本类型的化,可以忽略,但是建议加上
- 我们在SQL中的引用就是我们的@Param中设置的值
5. 关于#{}和${}的区别
1)#{}是预编译处理,$ {}是字符串替换。
2)MyBatis在处理#{}时,会将SQL中的#{}替换为?号,使用PreparedStatement的set方法来赋值;MyBatis在处理 $ { } 时,就是把 ${ } 替换成变量的值。
3)使用 #{} 可以有效的防止SQL注入,提高系统安全性。
十、Lombok
1. 什么是Lombok
Lombok是一个可以通过简单的注解形式来帮助我们简化消除一些必须有但显得很臃肿的Java代码的工具,通过使用对应的注解,可以在编译源码的时候生成对应的方法。
2. 使用步骤
- 在IDEA中安装Lombok的插件
- 在项目中导入Lombok的jar包
<!-- https://mvnrepository.com/artifact/org.projectlombok/lombok -->
<dependency>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
<version>1.18.12</version>
<scope>provided</scope>
</dependency>
- 获取lombok常用的注解
@Getter and @Setter
@FieldNameConstants
@ToString
@EqualsAndHashCode
@AllArgsConstructor, @RequiredArgsConstructor and @NoArgsConstructor
@Log, @Log4j, @Log4j2, @Slf4j, @XSlf4j, @CommonsLog, @JBossLog, @Flogger, @CustomLog
@Data
@Builder
@SuperBuilder
@Singular
@Delegate
@Value
@Accessors
@Wither
@With
@SneakyThrows
@val
@var
experimental @var
@UtilityClass
@Data:生成无参构造,get se,toString,hashcode,equals
@AllArgsConstructor:生成有参构造
@NoArgsConstructor:生成无参构造器
- 在实体类上添加注解即可
十一、多对一关系的处理
对于ABCDE这边而言,他们关联了一个共有的对象(多对一)
对于对象而言,一个对象下面对应了一个集合对象(一对多)
案例:SQL
- 首先编写sql语句,创建表
USE MyBatis;
CREATE TABLE teacher(
id INT(10) NOT NULL,
name VARCHAR(32) DEFAULT NULL,
PRIMARY KEY (id)
);
INSERT INTO teacher(id, name) VALUES (1,'李老师');
CREATE TABLE student(
id INT(10) NOT NULL ,
name VARCHAR(32) DEFAULT NULL,
tid INT(10) DEFAULT NULL,
PRIMARY KEY (id),
KEY fktid (tid),
CONSTRAINT fktid FOREIGN KEY (tid) REFERENCES teacher(id)
);
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);
1.测试环境搭建
- 导入Lombok
<dependency>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
<version>1.18.22</version>
</dependency>
- 编写实体类Teacher和Student
@Data
@AllArgsConstructor
@NoArgsConstructor
public class Student {
private int id;
private String name;
/**学生需要关联一个老师*/
private Teacher teacher;
}
@Data
@NoArgsConstructor
@AllArgsConstructor
public class Teacher {
private int id;
private String name;
}
- 编写相应的接口
public interface TeacherMapper {
/**
* Gets teacher by id.
*
* @param id the id
* @return the teacher by id
*/
@Select("SELECT * FROM teacher WHERE id=#{tid}")
Teacher getTeacherById(@Param("tid") int id);
}
- 编写相应的xml文件
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper
PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<!--绑定了对应的Mapper-->
<mapper namespace="com.apache.dao.TeacherMapper">
</mapper>
- 在核心配置文件中绑定注册接口或者文件
<mappers>
<mapper class="com.apache.dao.TeacherMapper"/>
<mapper class="com.apache.dao.StudentMapper"/>
</mappers>
- 测试实体类
public class MyTest {
public static void main(String[] args) {
SqlSession sqlSession = MyBatisUtils.getSqlSession();
TeacherMapper mapper = sqlSession.getMapper(TeacherMapper.class);
Teacher teacherById = mapper.getTeacherById(1);
System.out.println(teacherById);
sqlSession.close();
}
}
2. 按照查询嵌套处理
<!--查询所有学生的信息
1. 首先查出所有的学生
2. 根据学生的tid查找对应的老师-->
<select id="getStudents" resultMap="StudentTeacher" >
SELECT * FROM MyBatis.student
</select>
<resultMap id="StudentTeacher" type="com.apache.pojo.Student">
<!--此处的property与类的属性对应。column与数据库字段对应-->
<result property="id" column="id"/>
<result property="name" column="name"/>
<!--复杂属性需要单独处理
1.如果是查找是多个关联一个,那么用association关联,
property是需要查找的类型,也就是student的属性,column表示的是数据库中的
对应的字段,javaType表示查找的内容的实体类,select表示执行某项查询(内容是查询的id)
2.如果是查找的一个对多个,则需要使用集合。-->
<association property="teacher" column="tid"
javaType="com.apache.pojo.Teacher" select="getTeacher"/>
</resultMap>
<select id="getTeacher" resultType="com.apache.pojo.Teacher">
SELECT * FROM MyBatis.teacher WHERE id=#{id}
</select>
3.按照结果嵌套处理
<!--按照结果嵌套处理-->
<select id="getStudents2" resultMap="StudentTeacher2">
SELECT s.id sid,s.name sname,t.name tname FROM student s,teacher t WHERE s.tid=t.id
</select>
<resultMap id="StudentTeacher2" type="com.apache.pojo.Student">
<!--此处的column是填入别名-->
<result property="id" column="sid"/>
<result property="name" column="sname"/>
<!--此处student的属性是一个teacher,是一个典型的多对一的关系-->
<association property="teacher" javaType="com.apache.pojo.Teacher">
<result property="name" column="tname"/>
</association>
</resultMap>
常见的MySQL中多对一的查询方式有:子查询和联表查询。
十二、一对多的关系处理
1.环境搭建
- 实体类的创建
@Data
@NoArgsConstructor
@AllArgsConstructor
public class Teacher {
private int id;
private String name;
/**一个老师下有多个学生*/
private List<Student> students;
}
@Data
@AllArgsConstructor
@NoArgsConstructor
public class Student {
private int id;
private String name;
/**学生需要关联一个老师*/
private int teacher;
}
2. 按照查询嵌套处理
<!--使用子查询的方式来查询结果-->
<select id="getTeacher2" resultMap="TeacherStudent2">
SELECT * FROM MyBatis.teacher WHERE id=#{tid};
</select>
<resultMap id="TeacherStudent2" type="com.apache.pojo.Teacher">
<result property="id" column="id"/>
<result property="name" column="name"/>
<collection property="students"
ofType="com.apache.pojo.Student" select="getStudentByTeacherId"
column="tid"/>
</resultMap>
<select id="getStudentByTeacherId" resultType="com.apache.pojo.Student">
SELECT * FROM MyBatis.student WHERE tid=#{tid}
</select>
3.按照结果嵌套处理
<!--按照结果嵌套查询-->
<select id="getTeachers" resultType="com.apache.pojo.Teacher">
SELECT * FROM MyBatis.teacher;
</select>
<select id="getTeacher" resultMap="TeacherStudent">
SELECT s.id sid,s.name sname,t.name tname ,t.id tid
FROM student s,teacher t
WHERE t.id=s.tid AND t.id=#{tid};
</select>
<resultMap id="TeacherStudent" type="com.apache.pojo.Teacher">
<result property="id" column="tid"/>
<result property="name" column="tname"/>
<!--由于Teacher类的第三个属性是集合,那么我们需要用collection
其中JavaType为属性的类型
集合中的泛型信息,我们使用ofType
此处的teacher类中的属性名是students
-->
<collection property="students" ofType="com.apache.pojo.Student">
<result property="id" column="sid"/>
<result property="name" column="sname"/>
<result property="teacher" column="tid"/>
</collection>
</resultMap>
小结:
- 关联:assocation多对一
- 集合:collection 一对多
- javaType & ofType
- javaType:用来指定实体类中的属性的类型
- ofType:用来指定映射到集合中的POJO类型(泛型中的类型)
注意:
- 保证SQL的可读性,尽量保证通俗易懂
- 注意一对多与多对一中,属性名与字段的问题
- 如果不好排查错误,可以使用日志,建议使用Log4J
十三、动态SQL
什么是动态SQL?
就是根据不同的条件生成不同的SQL语句,动态 SQL 是 MyBatis 的强大特性之一。如果你使用过 JDBC 或其它类似的框架,你应该能理解根据不同条件拼接 SQL 语句有多痛苦,例如拼接时要确保不能忘记添加必要的空格,还要注意去掉列表最后一个列名的逗号。利用动态 SQL,可以彻底摆脱这种痛苦。
常见的动态SQL处理有四种:
- if
- choose(when,otherwise)
- trim(where ,set)
- foreach
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(30) NOT NULL COMMENT '浏览量'
)ENGINE=InnoDB DEFAULT CHARSET=utf8
创建一个基础工程:
- 导包
- 编写配置文件
<?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>
<!--引入外部配置文件,之后在配置下直接写引用的名字即可-->
<properties resource="db.properties">
<property name="username." value="root"/>
<property name="password" value="123456"/>
</properties>
<!--设置配置文件-->
<settings>
<!--此处表示标准日志输出-->
<!-- <setting name="logImpl" value="STDOUT_LOGGING"/>-->
<setting name="logImpl" value="STDOUT_LOGGING"/>
<!--开启驼峰式命名转换-->
<setting name="mapUnderscoreToCamelCase" value="true"/>
</settings>
<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>
<environment id="test">
<transactionManager type="JDBC"/>
<dataSource type="POOLED">
<property name="driver" value="com.mysql.cj.jdbc.Driver"/>
<property name="url" value="jdbc:mysql://localhost:3306/MyBatis?useSSL=true&useUnicode=true&characterEncoding=UTF-8 "/>
<property name="username" value="root"/>
<property name="password" value="xielibin20001011"/>
</dataSource>
</environment>
</environments>
<mappers>
<mapper class="com.apache.dao.BlogMapper"/>
</mappers>
</configuration>
- 编写实体类
@Data
public class Blog {
private String id;
private String title;
private String author;
private Date createTime;
private int views;
}
- 编写实体类对应的Mapper接口以及MapperXML文件
public interface BlogMapper {
/**
* 插入数据 @param blog the blog
*
* @return the int
*/
int addBlog(Blog blog);
}
<?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.apache.dao.BlogMapper">
<insert id="addBlog" parameterType="com.apache.pojo.Blog">
INSERT INTO MyBatis.blog (id, title, author, create_time, views)
VALUES (#{id},#{title},#{author},#{createTime},#{views})
</insert>
</mapper>
2.IF
- 编写dao层接口的规则
/**
* Query blog if list.
* 查询所有的博客
*
* @param map the map
* @return the list
*/
List<Blog> queryBlogIf(Map map);
这里由于是查询给定条件下的所有的Blog,因此以map作为条件,可以将更加方便地实现动态增删。
- 编写dao层接口的xml文件
<select id="queryBlogIf" resultType="com.apache.pojo.Blog" parameterType="map">
SELECT * FROM MyBatis.blog
<where>
<if test=" title!=null">
title=#{title}
</if>
<if test="author!=null">
AND author=#{author}
</if>
</where>
</select>
采用if语句来判断是否需要继续增加条件,如果是则增加,如果没有则查询出所有的内容。
此处的where标签表示条件,如果是if的第二个条件成立了,它会自动将第二条件中的AND去掉。
- 测试查询
public void queryBlogIf(){
SqlSession sqlSession = MyBatisUtils.getSqlSession();
BlogMapper mapper = sqlSession.getMapper(BlogMapper.class);
Map map = new HashMap();
map.put("title","Java编程思想");
map.put("author","Bruce");
List<Blog> blogs = mapper.queryBlogIf(map);
for (Blog blog : blogs) {
System.out.println(blog);
}
sqlSession.close();
}
3. choose(when,otherwise)
<select id="queryBlogChoose" resultType="com.apache.pojo.Blog" parameterType="map">
SELECT * FROM MyBatis.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>
MyBatis 提供了 choose 元素,它有点像 Java 中的 switch 语句。
4.trim(where set)
SELECT * FROM MyBatis.blog
<where>
<if test=" title!=null">
title=#{title}
</if>
<if test="author!=null">
AND author=#{author}
</if>
</where>
此处的where标签表示条件,如果是if的第二个条件成立了,它会自动将第二条件中的AND去掉。
set元素会动态地在行首插入 SET 关键字,并会删掉额外的逗号(这些逗号是在使用条件语句给列赋值时引入的)。
<update id="updateBlog" parameterType="map" >
UPDATE MyBatis.blog
<set>
<if test="title!=null">
title=#{title},
</if>
<if test="author!=null">
author=#{author},
</if>
</set>
WHERE id=#{id}
</update>
所谓的动态SQL本质上还是SQL语句,只是我们可以在SQL层面去执行相应的逻辑代码。
<trim prefix="SET" suffixOverrides=",">
...
</trim>
prefix表示前缀,suffixOverrides表示后缀
5.Foreach
<select id="selectPostIn" resultType="domain.blog.Post">
SELECT *
FROM POST P
<where>
<foreach item="item" index="index" collection="list"
open="ID in (" separator="," close=")" nullable="true">
#{item}
</foreach>
</where>
</select>
foreach 元素的功能非常强大,它允许你指定一个集合,声明可以在元素体内使用的集合项(item)和索引(index)变量。它也允许你指定开头与结尾的字符串以及集合项迭代之间的分隔符。这个元素也不会错误地添加多余的分隔符
6.SQL片段
有的时候可能会将公共部分抽取出来,方便复用
- 公共的sql片段
<!--SQL片段-->
<sql id="if">
<if test=" title!=null">
title=#{title}
</if>
<if test="author!=null">
AND author=#{author}
</if>
</sql>
- 引用sql片段
<select id="queryBlogIf" resultType="com.apache.pojo.Blog" parameterType="map">
SELECT * FROM MyBatis.blog
<where>
<include refid="if"></include>
</where>
</select>
其中sql片段中的id可以随意,但是在引用时需要选择正确的引用对象。
注意:
- 最好基于单表来定义SQL片段
- 不要存在where标签
动态SQL就是在拼接SQL语句,我们只要保证SQL的正确性,按照SQL的格式,去排列组合就可以了。
十四、缓存
1.简介
所有的查询都必须连接数据库,耗费资源
- 什么是缓存?
- 存在内存中的临时数据
- 将用户经常查询的数据放在缓存(内存)中,用户去查询数据就不用从磁盘上(关系型数据库数据文件)查询,从缓存中查询,从而提高查询效率,解决了高并发系统的性能问题。
- 为什么使用缓存?
- 减少和数据库的交互次数,减少系统开销,提高系统效率
- 什么样的数据能使用缓存?
- 经常查询并且不经常改变的数据。(使用缓存)
2.MyBatis缓存
- MyBatis包含一个非常强大的查询缓存特性,它可以非常方便地定制和配置缓存,缓存可以极大的提升查询效率
- MyBatis系统中默认定义了两级查询:一级缓存和二级缓存
- 默认情况下只有一级缓存开启(sqlSession级别的缓存,也称为本地缓存)
- 二级缓存需要手动开启和配置,它是基于namespace级别的缓存
- 为了提高扩展性,MyBatis定义了缓存接口Cache,我们可以通过Cache接口来定义二级缓存。
3.一级缓存
- 一级缓存也叫做本地缓存:sqlSession
- 与数据库同一次会话期间查询到的数据会放在本地缓存中
- 以后如果需要获取相同的数据,直接从缓存中拿,没必要再去查询数据库
测试步骤:
- 开启日志
<!--开启系统标准日志输出-->
<setting name="logImpl" value="STDOUT_LOGGING"/>
- 测试在一次查询中查询两次相同的记录
@Test
public void getUserById(){
SqlSession sqlSession = MyBatisUtils.getSqlSession();
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
User user1 = mapper.queryUserById(1);
System.out.println(user1);
System.out.println("======================");
User user2 = mapper.queryUserById(1);
System.out.println(user2);
System.out.println("====================");
System.out.println(user1==user2);
sqlSession.close();
}
图中执行了两次查询操作,但是却执行了一次SQL语句,这是因为MyBatis的一级缓存的作用。
缓存失效的情况
-
查询不同的东西
-
增删改操作可能会改变原来的数据,所以必定会刷新缓存
@Test
public void getUserById(){
SqlSession sqlSession = MyBatisUtils.getSqlSession();
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
User user1 = mapper.queryUserById(1);
System.out.println(user1);
System.out.println("======================");
System.out.println("修改用户开始........");
int i = mapper.updateUser(new User(2, "小张", "998"));
User user2 = mapper.queryUserById(1);
System.out.println(user2);
System.out.println("====================");
System.out.println(user1==user2);
sqlSession.close();
}
上图在两次查询相同对象之间插入了新的增删改操作,造成的结果是缓存刷新了。
- 查询不同的Mapper.xml
- 手动清理缓存
@Test
public void getUserById(){
SqlSession sqlSession = MyBatisUtils.getSqlSession();
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
User user1 = mapper.queryUserById(1);
System.out.println(user1);
System.out.println("======================");
//使用清理缓存方法手动清理缓存
sqlSession.clearCache();
User user2 = mapper.queryUserById(1);
System.out.println(user2);
System.out.println("====================");
System.out.println(user1==user2);
sqlSession.close();
}
上图中手动清理一级缓存,之后查询两次相同的记录得到了不一样的结果,并执行了两次SQL语句。
小结:一级缓存默认是开启的,只在一次sqlsession中有效,也就是拿到连接到关闭连接这个区间段有效。(相当于一个map)
4.二级缓存
- 二级缓存也叫做全局缓存,一级缓存作用域太低了,所以诞生了二级缓存
- 基于namespace级别的缓存,一个名称空间,对应一个二级缓存
- 工作机制:
- 一个会话查询一条数据,这个数据就会被放在当前会话的一级缓存中。
- 如果当前会话关闭了,这个会话对应的一级缓存就没有了,但是我们想要的是会话关闭了,一级缓存中的数据被保存到二级缓存中。
- 新的会话查询信息,就可以从二级缓存中获取内容
- 不同的mapper查出的数据就会放在自己对应的缓存(map)中。
步骤:
- 开启全局缓存
<!--要想使用二级缓存,需要显式开启它-->
<setting name="cacheEnabled" value="true"/>
- 在要使用二级缓存的Mapper中的开启
<!--开启二级缓存(在当前的UserMapper.xml中使用)-->
<cache/>
也可以自定义一些参数
<!--开启二级缓存(在当前的UserMapper.xml中使用)-->
<cache
eviction="FIFO"
flushInterval="60000"
size="512"
readOnly="true"/>
可用的清除策略有:
LRU
– 最近最少使用:移除最长时间不被使用的对象。FIFO
– 先进先出:按对象进入缓存的顺序来移除它们。SOFT
– 软引用:基于垃圾回收器状态和软引用规则移除对象。WEAK
– 弱引用:更积极地基于垃圾收集器状态和弱引用规则移除对象。
需要注意的是默认的清除策略是LRU
- 测试
- 问题:我们需要将实体类序列化,否则就会报错。
Caused by: java.io.NotSerializableException: com.alibaba.pojo.User
小结:
- 只要开启了二级缓存,在同一个Mapper下就有效
- 所有的数据会先放在一级缓存中
- 只有当会话提交,或者关闭的时候,才会提交到二级缓存中。
5.缓存的原理
6.自定义缓存——Ehcache
(1)什么是Ehcache?
Ehcache
Ehcache是一种广泛使用的开源Java分布式缓存。主要面向通用缓存,Java EE和轻量级容器。它具有内存和磁盘存储,缓存加载器,缓存扩展,缓存异常处理程序,一个gzip缓存servlet过滤器,支持REST和SOAP api等特点。
(2)Ehcache的优点
-
快速
-
简单
-
多种缓存策略
-
缓存数据有两级:内存和磁盘,因此无需担心容量问题
-
缓存数据会在虚拟机重启的过程中写入磁盘
-
可以通过RMI、可插入API等方式进行分布式缓存
-
具有缓存和缓存管理器的侦听接口
-
支持多缓存管理器实例,以及一个实例的多个缓存区域
-
提供Hibernate的缓存实现
(3)使用
要在程序中使用ehcache,需要导包
- 导入相应的依赖
<!-- https://mvnrepository.com/artifact/org.mybatis.caches/mybatis-ehcache -->
<dependency>
<groupId>org.mybatis.caches</groupId>
<artifactId>mybatis-ehcache</artifactId>
<version>1.1.0</version>
</dependency>
- 在对应的Mapper.xml文件中设置缓存策略(指定使用Ehcache)
<cache type="org.mybatis.caches.ehcache.EhcacheCache"/>
type 属性指定的类必须实现 org.mybatis.caches.ehcache.EhcacheCache
- 建立相应的xml配置文件(为ehcache)
<?xml version="1.0" encoding="UTF-8"?>
<ehcache xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="http://ehcache.org/ehcache.xsd"
updateCheck="false">
<diskStore path="./tmpdir/Tmp_EhCache"/>
<defaultCache
eternal="false"
maxElementsInMemory="10000"
overflowToDisk="false"
diskPersistent="false"
timeToIdleSeconds="1800"
timeToLiveSeconds="259200"
memoryStoreEvictionPolicy="LRU"/>
<cache
name="cloud_user"
eternal="false"
maxElementsInMemory="5000"
overflowToDisk="false"
diskPersistent="false"
timeToIdleSeconds="1800"
timeToLiveSeconds="1800"
memoryStoreEvictionPolicy="LRU"/>
</ehcache>
不过目前一般使用Redis数据库来做缓存