一、Mybatis入门
1.1 Mybatis历史
iBatis一词来源于“Internet”和“Abatis”的组合,是一个基于Java的持久层框架。iBatis提供的持久层框架包括SQL Maps和Data Access Objects(Dao)。
1.2 Mybatis特性
1)Mybatis是支持定制化SQL、存储过程以及高级映射的持久层框架
2)Mybatis避免了几乎所有的JDBC代码和手动设置参数以及获取结果集
3)Mybatis可以使用简单的XML或注解用于配置和原始映射,将接口和Java的POJO(Plain Old Java Objects,普通的Java对象)映射成数据库中的记录
4)Mybatis是一个半自动的ORM(Object Relation Mapping)框架
1.3 创建MyBatis的核心配置文件
- 习惯上命名为MyBatis-config.xml,这个文件名仅仅是建议,并非强制要求,将来整合Spirng之后,这个配置文件可以省略。
- 核心配置文件主要用于配置连接数据库的环境、Mybatis的全局配置信息
- 核心配置文件存放的位置是src/main/resource目录下
<?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"> <!--核心配置文件,这里是mybatis-3-config.dtd-->
<configuration>
<!--MyBatis核心配置文件中,标签的顺序:
properties,settings,typeAliases,typeHandlers,objectFactory,objectWrapperFactory,
reflectorFactory,plugins,environment,databaseIdPorvider,mappers-->
<!--引入jdbc.properties,让核心配置文件与jdbc.properties产生关联,让其能访问jdbc.properties-->
<properties resource="jdbc.properties"/>
<settings>
<!--将表中字段的下划线自动转换为驼峰-->
<setting name="mapUnderscoreToCamelCase" value="true"/>
<!--开启延迟加载-->
<setting name="lazyLoadingEnabled" value="true"/>
</settings>
<!--设置类型别名(resultType),alias标签可以省略,省略时自动默认为类名且不区分大小写。-->
<typeAliases>
<!-- <typeAlias type="com.atguigu.mybatis.pojo.User" alias="User"></typeAlias> -->
<!--以包为单位,将包下所有的类型设置默认的类型别名,即类名且不区分大小写-->
<package name="com.atguigu.mybatis.pojo"/>
</typeAliases>
<!--设置连接数据库的环境
environments:配置多个连接数据库的环境
属性:
default:设置默认使用的环境id
-->
<environments default="development">
<!--environment:配置某个具体的环境
属性:
id:表示连接数据库环境的唯一标识,不能重复
-->
<environment id="development">
<!--
transactionManager:设置事务管理方式
属性:
type="JDBC/MANAGED"
JDBC:标识当前环境中,执行SQL时,使用的是JDBC中原生的事务管理方式,即事务的提交和回滚需要手动设置。
MANAGED:被管理,例如Srping
-->
<transactionManager type="JDBC"/>
<!--
dataSource:配置数据源
属性:
type:设置数据源的类型
type="POOLED/UNPOOLED/JNDI"
POOLED:表示使用数据库连接池缓存数据库连接
UNPOOLED:表示不使用数据库连接池
JNDI:表示使用上下文中的数据源
注:Spirng整合MyBatis时,Spirng本身就有数据源,Spirng可以管理数据源(Spirng中就是一个对象),MyBatis使用Spring的数据源即可-->
<dataSource type="POOLED">
<!--设置连接数据源的驱动-->
<property name="driver" value=${jdbc.driver}/>
<!--设置连接数据库的连接地址-->
<property name="url" value=${jdbc.url}/>
<property name="username" value=${jdbc.username}/>
<property name="password" value=${jdbc.password}/>
</dataSource>
</environment>
</environments>
<!--引入映射文件-->
<mappers>
<!--resource目录下,不能用 . 因为不是包,是文件路径-->
<mapper resource="mappers/UserMapper.xml"/>
<!--
以包为单位引入映射文件
要求:
1、mapper接口所在的包要和映射文件所在的包一致
2、mapper接口要和映射文件的名字一致
注:resource下一次创建多个包,不能用 . 要用 / 创建-->
<package name="com.atguigu.mybatis.mapper"/>
</mappers>
</configuration>
1.3.1 引入properties文件
jdbc.driver=com.mysql.cj.jdbc.Driver
jdbc.url=jdbc:mysql://localhost:3306/MyBatis
jdbc.username=root
jdbc.password=123456
1.4 创建mapper接口
MyBatis中的接口相当于以前的Dao,但区别再与,MyBatis中我们只需要提供接口,无需提供实现类,MyBatis就可以自动为我们去调用对应的SQL语句操作数据,返回结果。
public interface UserMapper {
/**
* Mybatis面向接口编程的两个一致:
* - 映射文件的namespace和mapper接口的全类名保持一致。
* - 映射文件中的SQL语句的id和mapper接口中的方法名保持一致。
*/
int insertUser();
}
1.5 创建Mybatis的映射文件
相关概念:ORM(Object Relationship Mapping)对象映射关系。
-
对象:Java的实体类对象
-
关系:关系型数据库
-
映射:二者之间的对应关系
Java概念 数据库概念 类 表 对象 记录/行 属性 列 1、映射文件的命名规则:
表名+Mapper.xml,例:表为User表,映射的实体类为User.java,所对应的映射文件为UserMapper.xml
因此,一张表对应一个Mapper映射文件(对这个表的操作都写在这个映射文件中),对应一个实体类
2、映射文件的作用及存放位置
- 作用:用于编写SQL,访问以及操作表中的数据。
- 位置:src/main/resources/mapper目录下
注:MaBatis可以面向接口操作数据,要保证两个一致。
- 映射文件的namespace和mapper接口的全类名保持一致。
- 映射文件中的SQL语句的id和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文件,这里是mybatis-3-mapper.dtd-->
<!--映射文件的namespace和mapper接口的全类名保持一致。-->
<mapper namespace="com.atguigu.mybatis.mapper.UserMapper">
<!--映射文件中的SQL语句的id和mapper接口中的方法名保持一致。-->
<insert id="insertUser">
insert into t_user values(null,'张三','123',23,'女')
</insert>
<!--查询语句必须设置resultType或resultMap
resultType:设置默认的映射关系,MyBatis根据字段名与属性名自动映射,适用于字段名与属性名一致的情况。
resultMap:设置自定义的映射关系,适用于字段名与属性名不一致的情况,或一对多,多对一-->
<select id="selectUserById" resultType="com.lmj.mybatis.pojo.User">
select * from t_user where id = 1
</select>
</mapper>
总结:通过核心配置文件,配置好与数据库的连接关系,以及映射文件的位置,MyBatis是面向接口编程,接口相当于之前的Dao,只是没有了实现类,我们配置好MyBatis的信息后,调用接口。
- MyBatis先是从核心配置文件中找到连接数据库信息,以及找到映射文件的位置。
- 然后再通过mapper接口的全类名,在映射文件里找到的对应的namespace。
- 再通过调用的方法名,找到映射文件里的SQL唯一id,MaBatis执行SQL操作数据库。
- 返回结果,吧查到的表记录通过resultType或resultMap来确定映射关系,再通过反射自动映射表字段和实体类的属性名实现赋值,复杂的映射关系可以通过restultMap来自定义数据库字段与属性的关系。
打印日志,输出SQL执行情况
1、加入依赖
<!-- log4j日志 -->
<dependency>
<groupId>log4j</groupId>
<artifactId>log4j</artifactId>
<version>1.2.17</version>
</dependency>
2、添加log4j.xml文件
- log4j的配置文件名为log4j.xml,存放位置是src/main/resources目录下
- 日志的级别:FATAL(致命)>ERROR(错误)>WARN(警告)>INFO(信息)>DEBUG(调试)
- 从左到右打印的内容越来越详细
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">
<log4j:configuration xmlns:log4j="http://jakarta.apache.org/log4j/">
<appender name="STDOUT" class="org.apache.log4j.ConsoleAppender">
<param name="Encoding" value="UTF-8" />
<layout class="org.apache.log4j.PatternLayout">
<param name="ConversionPattern" value="%-5p %d{MM-dd HH:mm:ss,SSS} %m (%F:%L) \n" />
</layout>
</appender>
<logger name="java.sql">
<level value="debug" />
</logger>
<logger name="org.apache.ibatis">
<level value="info" />
</logger>
<root>
<level value="debug" />
<appender-ref ref="STDOUT" />
</root>
</log4j:configuration>
二、MyBatis获取参数值的两种方式
-
MyBatis获取参数值的两种方式:#{} 和 #{}
-
#{}的本质是:占位符赋值,${}的本质是:字符串拼接
-
#{}使用占位符赋值的方式拼接SQL,此时字符串类型或日期类型的字段进行赋值时,可以自动添加单引号;
${}使用字符串拼接的方式拼接SQL,此时字符串类型或日期类型的字段进行赋值时,需要手动加单引号。
2.1 单个字面量类型的参数
可以通过KaTeX parse error: Expected 'EOF', got '#' at position 4: {}和#̲{}以任意名称获取参数值,但使…{}时需要手动添加单引号
<!--User getUserByUsername(String username);-->
<select id="getUserByUsername" resultType="User">
select * from t_user where username = #{username}
</select>
<!--User getUserByUsername(String username);-->
<select id="getUserByUsername" resultType="User">
select * from t_user where username = '${username}'
</select>
以任意名称获取也可获取,但最好见名知意
<select id="getUserByUsername" resultType="User">
select * from t_user where username = #{aaa}
</select>
2.2 多个字面量类型的参数(不常用)
- 若mapper接口中的方法参数为多个时,此时MyBatis会自动将这些参数放在一个map集合中
- 以arg0,arg1…为键,以参数为值;
- 以param1,param2…为键,以参数为值。
<!--User checkLogin(String username,String password);-->
<select id="checkLogin" resultType="User">
select * from t_user where username = #{arg0} and password = #{arg1}
</select>
<!--User checkLogin(String username,String password);-->
<select id="checkLogin" resultType="User">
select * from t_user where username = '${param1}' and password = '${param2}'
</select>
混合用也可
<!--User checkLogin(String username,String password);-->
<select id="checkLogin" resultType="User">
select * from t_user where username = #{arg0} and password = #{param2}
</select>
- 所以只需要通过#{}和#{}访问map集合的键就可以获取相对应的值,${}需要加上单引号
- 使用arg或param都行,要注意的是,arg是从arg0开始的,param是从param1开始的
2.3 map集合类型的参数
- 若mapper接口中的参数为多个时,此时可以手动创建map集合,把参数封装到map中,也可以通过#{}和 来访问 m a p 的 k e y 来获取参数值,但 {}来访问map的key来获取参数值,但 来访问map的key来获取参数值,但{}需要手动添加单引号
Map<String,Object> params = new HashMap<>();
params.put("username","admin");
params.put("password",123456);
User user = mapper.checkLogin(params);
<!--User checkLoginByMap(Map<String,Object> map);-->
<select id="checkLoginByMap" resultType="User">
select * from t_user where username = #{username} and password = #{password}
</select>
2.4 实体类型的参数
- 若mapper接口中的方法参数为实体类对象时,此时可以使用#{}和 ,通过访问实体类对象中的属性名(通过 g e t , s e t 方法)获取属性值, {},通过访问实体类对象中的属性名(通过get,set方法)获取属性值, ,通过访问实体类对象中的属性名(通过get,set方法)获取属性值,{}需要手动添加单引号。
User user = new User(null,"Tom","123456",12,"男","123@321.com");
mapper.insertUser(user);
<!--int insertUser(User user);-->
<insert id="insertUser">
insert into t_user values(null,#{username},#{password},#{age},#{sex},#{email})
</insert>
2.5 使用@Param标识参数
-
可以通过@Param注解标识mapper接口中的方法参数,此时会将这些参数放入map集合中
- 以@Param注解的value属性值为键,以参数为值;
- 以param1,param2 . . .为键,以参数为值。
-
通过KaTeX parse error: Expected 'EOF', got '#' at position 4: {}和#̲{}访问map集合中的键就可以…{}需要手动添加单引号
User checkLoginByParam(@Param(value = "username")String username, @Param("password")String password);
User user = mapper.checkLoginByParam("admin","123456");
<!--User CheckLoginByParam(@Param("username") String username, @Param("password") String password);-->
<select id="checkLoginByParam" resultType="User">
select * from t_user where username = #{username} and password = #{password}
</select>
2.6 总结
- 建议分词两种情况进行处理
- 实体类类型的参数,及6.4所示
- 使用@Param标识参数,及6.5所示
三、MyBatis的各种查询功能
- 如果查询出的数据只有一条,可以通过
- 实体类对象接收
- List集合接收
- Map集合接收,结果
{password=123456, sex=男, id=1, age=23, username=admin}
- 如果查询出的数据有多条,一定不能用实体类对象接收,会抛出TooManyRestultsException,可以通过
- 实体类泛型的List集合接收
- Map类型的List集合接收
- 在mapper接口方法上添加@MapKey注解
- MaBatis中设置了默认的类型别名
- java.lang.Integer---->int,integer
- int---->_int,_integer
- Map---->map
- Stirng---->string
3.1 查询一个实体类对象
/**
* 根据用户id查询用户信息
* @param id
* @return
*/
User getUserById(@Param("id") int id);
<!--User getUserById(@Param("id") int id);-->
<select id="getUserById" resultType="User">
select * from t_user where id = #{id}
</select>
3.2 查询一个List集合
/**
* 查询所有用户信息
* @return
*/
List<User> getUserList();
<!--List<User> getUserList();-->
<select id="getUserList" resultType="User">
select * from t_user
</select>
3.3 查询单个数据
/**
* 查询用户的总记录数
* @return
* 在MyBatis中,对于Java中常用的类型都设置了类型别名
* 例如:java.lang.Integer-->int|integer
* 例如:int-->_int|_integer
* 例如:Map-->map,List-->list
*/
int getCount();
<!--int getCount();-->
<select id="getCount" resultType="_integer">
select count(id) from t_user
</select>
3.4 一条数据为map集合
/**
* 根据用户id查询用户信息为map集合
* @param id
* @return
*/
Map<String, Object> getUserToMap(@Param("id") int id);
<!--Map<String, Object> getUserToMap(@Param("id") int id);-->
<select id="getUserToMap" resultType="map">
select * from t_user where id = #{id}
</select>
<!--结果:{password=123456, sex=男, id=1, age=23, username=admin}-->
3.5 查询多条数据为map集合
- 方法一
/**
* 查询所有用户信息为map集合
* @return
* 将表中的数据以map集合的方式查询,一条数据对应一个map;若有多条数据,就会产生多个map集合,此时可以将这些map放在一个list集合中获取
*/
List<Map<String, Object>> getAllUserToMap();
<!--Map<String, Object> getAllUserToMap();-->
<select id="getAllUserToMap" resultType="map">
select * from t_user
</select>
<!--
结果:
[{password=123456, sex=男, id=1, age=23, username=admin},
{password=123456, sex=男, id=2, age=23, username=张三},
{password=123456, sex=男, id=3, age=23, username=张三}]
-->
- 方法二:在mapper接口的方法上添加@MapKey注解,此时就可以将每条数据转换的map结合作为值,以某个字段的值作为键,放在同一个map集合中。
/**
* 查询所有用户信息为map集合
* @return
* 将表中的数据以map集合的方式查询,一条数据对应一个map;若有多条数据,就会产生多个map集合,并且最终要以一个map的方式返回数据,此时需要通过@MapKey注解设置map集合的键,值是每条数据所对应的map集合
*/
@MapKey("id")
Map<String, Object> getAllUserToMap();
<!--Map<String, Object> getAllUserToMap();-->
<select id="getAllUserToMap" resultType="map">
select * from t_user
</select>
<!--
结果:
{
1={password=123456, sex=男, id=1, age=23, username=admin},
2={password=123456, sex=男, id=2, age=23, username=张三},
3={password=123456, sex=男, id=3, age=23, username=张三}
}
-->
四、特殊SQL的执行
4.1 模糊查询(用#{})
/**
* 根据用户名进行模糊查询
* @param username
* @return java.util.List<com.atguigu.mybatis.pojo.User>
* @date 2022/2/26 21:56
*/
List<User> getUserByLike(@Param("username") String username);
<!--List<User> getUserByLike(@Param("username") String username);-->
<select id="getUserByLike" resultType="User">
<!--select * from t_user where username like '%${mohu}%'-->
<!--select * from t_user where username like concat('%',#{mohu},'%')-->
select * from t_user where username like "%"#{mohu}"%"
</select>
-
其中 select * from t_user where username like “%”#{mohu}“%” 是最常用的。
下面的SQL是错误的,当在单引号里用#{}时,?存在于单引号里面,?属于字符串一部分,不会被解析为占位符,会被当做字符串中的一部分解析,所以此时sql语句中并没有占位符,而却要为占位符赋值,所以就会报错。
<select id="getUserByLike" resultType="User">
select * from t_user where username like '%#{}%'
</select>
4.2 批量删除(必须用${})
- 只能使用${},如果使用#{},则解析后的SQL语句为
delete from t_user where id in ('1,2,3')
,#{}会自动加单引号,相当于(‘1,2,3’)这样是将1,2,3
看做是一个整体,只有id为1,2,3
的数据才会被删除。 - 正确的语句应该是
delete from t_user where in (1,2,3)
或者delete from t_user where id in ('1','2','3')
/**
* 根据id批量删除
* @param ids
* @return int
* @date 2022/2/26 22:06
*/
int deleteMore(@Param("ids") String ids);
<delete id="deleteMore">
delete from t_user where id in (${ids})
</delete>
//测试类
@Test
public void deleteMore() {
SqlSession sqlSession = SqlSessionUtils.getSqlSession();
SQLMapper mapper = sqlSession.getMapper(SQLMapper.class);
int result = mapper.deleteMore("1,2,3,8");
System.out.println(result);
}
4.3 动态设置表名(必须用${})
- 只能使用${},因为表名不能用单引号,用#{},会自动加上单引号,所以会报错。SQL中字符串类型数据,日期类型数据,字段名可以加单引号,表名不能加单引号。
/**
* 查询指定表中的数据
*/
List<User> getUserByTable(@Param("tableName") String tableName);
<!--List<User> getUserByTable(@Param("tableName") String tableName);-->
<select id="getUserByTable" resultType="User">
select * from ${tableName}
</select>
4.4 添加功能获取自增的主键
使用场景
-
t_clazz(clazz_id,clazz_name)
- t_student(student_id,student_name,clazz_id)
- 添加班级信息
- 获取新添加的班级的id
- 为班级分配学生,即将某学的班级id修改为新添加的班级的id
-
在mapper.xml中设置两个属性
-
useGeneratedKeys:设置使用自增的主键
- keyProperty:因为增删改有统一的返回值是受影响的行数,因此只能将获取的自增的主键放在传输的参数user对象的某个属性中
注:一对多还是多对一,都要把表关系设置在多的一方,增删改的返回值固定,就是受影响的条数。
/**
* 添加用户信息
* @param user
* @date 2022/2/27 15:04
*/
void insertUser(User user);
<!--void insertUser(User user);-->
<insert id="insertUser" useGeneratedKeys="true" keyProperty="id">
insert into t_user values (null,#{username},#{password},#{age},#{sex},#{email})
</insert>
//测试类
@Test
public void insertUser() {
SqlSession sqlSession = SqlSessionUtils.getSqlSession();
SQLMapper mapper = sqlSession.getMapper(SQLMapper.class);
User user = new User(null, "ton", "123", 23, "男", "123@321.com");
mapper.insertUser(user);
System.out.println(user);
//输出:user{id=10, username='ton', password='123', age=23, sex='男', email='123@321.com'},自增主键存放到了user的id属性中
}
五、自定义映射
5.1 字段名与属性名不一致
-
字段名与属性名一致,就可以自动创建映射关系,把查出来的值对相对应的属性赋值。
-
字段名与属性名不一致时,如字段名为
emp_name
,属性名为empName
,下划线并不能对应驼峰命名,此时mybatis默认不能自动映射,但不会报错,只是不一致的不会赋值,empName
会被赋值'null'
。
解决方式
-
为字段起别名,保持和属性名的一致:对与属性名不一致的字段名起别名,来保证和实体类中的属性名保持一致 。
<!--List<Emp> getAllEmp();--> <select id="getAllEmp" resultType="Emp"> select eid,emp_name as empName,age,sex,email from t_emp </select>
-
设置全局配置,将
_
自动映射为驼峰可以在MyBatis的核心配置文件中的setting
标签中,设置一个全局配置信息mapUnderscoreToCamelCase,可以在查询表中数据时,自动将_类型的字段名转换为驼峰。此时,emp_name
会自动转换为empName
。mapUnderscoreToCamelCase默认为false,不开启该功能。<settings> <setting name="mapUnderscoreToCamelCase" value="true"/> </settings>
-
通过resultMap来设置自定义映射关系。一旦设置了resultMap,即使属性名与字段名一致也应写上对应关系,不可以省略,要全部写上,要保证property是resultmap type中的属性,column是查询出来字段名。
属性:
-
id:表示自定义映射的唯一标识,不能重复
type:设置映射关系中的实体类类型
-
子标签:
- id:设置主键的映射关系
- result:设置普通字段的映射关系
- 子标签属性:
- property:设置映射关系中实体类中的属性名 ,必须是type属性所设置的实体类类型中的属性名
- column:设置映射关系中表中的字段名,必须是SQL语句查询出的字段名,设置了别名,得写别名
<resultMap id="empResultMap" type="Emp">
<id property="eid" column="eid"></id>
<result property="empName" column="emp_name"></result>
<result property="age" column="age"></result>
<result property="sex" column="sex"></result>
<result property="email" column="email"></result>
</resultMap>
<!--List<Emp> getAllEmp();-->
<select id="getAllEmp" resultMap="empResultMap">
select * from t_emp
</select>
5.2 多对一映射
//对一对应对象
解决方式
5.2.1 级联属性赋值
<resultMap id="empAndDeptResultMapOne" type="Emp">
<id property="eid" column="eid"></id>
<result property="empName" column="emp_name"></result>
<result property="age" column="age"></result>
<result property="sex" column="sex"></result>
<result property="email" column="email"></result>
<result property="dept.did" column="did"></result>
<result property="dept.deptName" column="dept_name"></result>
</resultMap>
<!--Emp getEmpAndDept(@Param("eid")Integer eid);-->
<select id="getEmpAndDept" resultMap="empAndDeptResultMapOne">
select * from t_emp left join t_dept on t_emp.eid = t_dept.did where t_emp.eid = #{eid}
</select>
5.2.2 association处理多对一映射
- association:处理多对一的映射关系
- property:需要处理多对一映射关系的属性名
- javaType:该属性的类型
<!--把did和deptname,和dept实体类进行映射,再把dept对象赋给dept属性-->
<resultMap id="empAndDeptResultMapTwo" type="Emp">
<id property="eid" column="eid"></id>
<result property="empName" column="emp_name"></result>
<result property="age" column="age"></result>
<result property="sex" column="sex"></result>
<result property="email" column="email"></result>
<association property="dept" javaType="Dept">
<id property="did" column="did"></id>
<result property="deptName" column="dept_name"></result>
</association>
</resultMap>
<!--Emp getEmpAndDept(@Param("eid")Integer eid);-->
<select id="getEmpAndDept" resultMap="empAndDeptResultMapTwo">
select * from t_emp left join t_dept on t_emp.eid = t_dept.did where t_emp.eid = #{eid}
</select>
5.2.3 分布查询处理多对一映射
- select:设置分布查询的SQL的唯一标识(namespace.SQLId或mappper接口的全类名.方法名)
- column:设置分布查询的条件
5.2.3.1 查询员工信息
//EmpMapper里的方法
/**
* 通过分步查询,员工及所对应的部门信息
* 分步查询第一步:查询员工信息
* @param
* @return com.atguigu.mybatis.pojo.Emp
*/
Emp getEmpAndDeptByStepOne(@Param("eid") Integer eid);
<resultMap id="empAndDeptByStepResultMap" type="Emp">
<id property="eid" column="eid"></id>
<result property="empName" column="emp_name"></result>
<result property="age" column="age"></result>
<result property="sex" column="sex"></result>
<result property="email" column="email"></result>
<association property="dept"
select="com.atguigu.mybatis.mapper.DeptMapper.getEmpAndDeptByStepTwo"
column="did"></association>
</resultMap>
<!--Emp getEmpAndDeptByStepOne(@Param("eid") Integer eid);-->
<select id="getEmpAndDeptByStepOne" resultMap="empAndDeptByStepResultMap">
select * from t_emp where eid = #{eid}
</select>
5.2.3.2 查询每个员工对应的部门信息
//DeptMapper里的方法
/**
* 通过分步查询,员工及所对应的部门信息
* 分步查询第二步:通过did查询员工对应的部门信息
* @param
* @return com.atguigu.mybatis.pojo.Emp
*/
Dept getEmpAndDeptByStepTwo(@Param("did") Integer did);
<!--此处需将mapUnderscoreToCamelCase在核心配置文件中设为true,将_自动转换为驼峰-->
<!--Dept getEmpAndDeptByStepTwo(@Param("did") Integer did);-->
<select id="getEmpAndDeptByStepTwo" resultType="Dept">
select * from t_dept where did = #{did}
</select>
延迟加载
<settings>
<!--开启延迟加载-->
<setting name="lazyLoadingEnabled" value="true"/>
</settings>
分布查询的好处:
- 可以实现功能的独立,把一条SQL拆分成两条形成两个功能,当你想调用哪个就可以单独调用它。
- 可以实现延迟加载,只有当访问需要执行的数据,对应需要执行的SQL才会去执行。
fetchType
:当开启了全局的延迟加载之后,该属性默认为lazy
,此时所有的分布查询都是延迟加载。- 当你想要单独设置某个分布查询为立即加载时,可通过设置
fetchType="eager"
来开启立即加载
<!--该分步查询为立即查询-->
<resultMap id="empAndDeptByStepResultMap" type="Emp">
<id property="eid" column="eid"></id>
<result property="empName" column="emp_name"></result>
<result property="age" column="age"></result>
<result property="sex" column="sex"></result>
<result property="email" column="email"></result>
<association property="dept"
select="com.atguigu.mybatis.mapper.DeptMapper.getEmpAndDeptByStepTwo"
column="did" fetchType="eager"></association>
</resultMap>
<!--Emp getEmpAndDeptByStepOne(@Param("eid") Integer eid);-->
<select id="getEmpAndDeptByStepOne" resultMap="empAndDeptByStepResultMap">
select * from t_emp where eid = #{eid}
</select>
5.3 一对多映射
// 对多对应集合
public class Dept {
private Integer did;
private String deptName;
private List<Emp> emps;
//...构造器、get、set方法等
}
5.3.1 collection
通过SQL把所有字段都查询出来,然后通过自定义映射关系resultMap来对属性进行赋值
- collection:处理一对多的映射关系
- ofType:表示该属性对应的集合中存储的数据的类型
<resultMap id="DeptAndEmpResultMap" type="Dept">
<id property="did" column="did"></id>
<result property="deptName" column="dept_name"></result>
<collection property="emps" ofType="Emp">
<id property="eid" column="eid"></id>
<result property="empName" column="emp_name"></result>
<result property="age" column="age"></result>
<result property="sex" column="sex"></result>
<result property="email" column="email"></result>
</collection>
</resultMap>
<!--Dept getDeptAndEmp(@Param("did") Integer did);-->
<select id="getDeptAndEmp" resultMap="DeptAndEmpResultMap">
select * from t_dept left join t_emp on t_dept.did = t_emp.did where t_dept.did = #{did}
</select>
5.3.2 分布查询
5.3.2.1 查出部门信息
/**
* 通过分步查询,查询部门及对应的所有员工信息
* 分步查询第一步:查询部门信息
* @param did
* @return com.atguigu.mybatis.pojo.Dept
* @date 2022/2/27 22:04
*/
Dept getDeptAndEmpByStepOne(@Param("did") Integer did);
<resultMap id="DeptAndEmpByStepOneResultMap" type="Dept">
<id property="did" column="did"></id>
<result property="deptName" column="dept_name"></result>
<collection property="emps"
select="com.atguigu.mybatis.mapper.EmpMapper.getDeptAndEmpByStepTwo"
column="did"></collection>
</resultMap>
<!--Dept getDeptAndEmpByStepOne(@Param("did") Integer did);-->
<select id="getDeptAndEmpByStepOne" resultMap="DeptAndEmpByStepOneResultMap">
select * from t_dept where did = #{did}
</select>
5.3.2.2 查出每个部门的员工
/**
* 通过分步查询,查询部门及对应的所有员工信息
* 分步查询第二步:根据部门id查询部门中的所有员工
* @param did
* @return java.util.List<com.atguigu.mybatis.pojo.Emp>
* @date 2022/2/27 22:10
*/
List<Emp> getDeptAndEmpByStepTwo(@Param("did") Integer did);
<!--List<Emp> getDeptAndEmpByStepTwo(@Param("did") Integer did);-->
<select id="getDeptAndEmpByStepTwo" resultType="Emp">
select * from t_emp where did = #{did}
</select>
六、动态SQL
MyBatis框架的动态SQL技术是一种根据特定条件动态拼接SQL语句的功能,它存在的意思是为了解决拼接SQL语句字符串时的痛点问题。
6.1 if
- if标签可通过test属性(即传递过来的数据)的表达式进行判断,若表达式的结果为true,则标签中的内容会执行;反之标签中的内容不会执行
- 在where后面添加一个恒成立条件
1=1
- 这个恒成立条件并不会影响查询的结果
- 这个
1=1
可以用来拼接and
语句,例如:当empName为null时 - 如果不加上恒成立条件,则SQL语句为
select * from t_emp where and age = ? and sex = ? and email = ?
,此时where
会与and
连用,SQL语句会报错- 如果加上一个恒成立条件,则SQL语句为
select * from t_emp where 1= 1 and age = ? and sex = ? and email = ?
,此时不报错
- 如果加上一个恒成立条件,则SQL语句为
- 这个
<!--List<Emp> getEmpByCondition(Emp emp);-->
<!--没有传输该数据为null,没有在文本框中输入值此时为''-->
<select id="getEmpByCondition" resultType="Emp">
select * from t_emp where 1=1
<if test="empName != null and empName !=''">
and emp_name = #{empName}
</if>
<if test="age != null and age !=''">
and age = #{age}
</if>
<if test="sex != null and sex !=''">
and sex = #{sex}
</if>
<if test="email != null and email !=''">
and email = #{email}
</if>
</select>
6.2 where(常用,与if语句结合使用)
- 当where标签中有内容时,会自动生成where关键字,并且将内容前多余的and或or去掉
- 当where标签中没有内容时,此时where标签没有任何效果,即不会在SQL中拼接where
- 注意:where标签不能将内容后面多余的and或or去掉,所以if条件拼接应该把and或or放在前面拼接
<!--List<Emp> getEmpByCondition(Emp emp);-->
<select id="getEmpByCondition" resultType="Emp">
select * from t_emp
<where>
<if test="empName != null and empName !=''">
emp_name = #{empName}
</if>
<if test="age != null and age !=''">
and age = #{age}
</if>
<if test="sex != null and sex !=''">
and sex = #{sex}
</if>
<if test="email != null and email !=''">
and email = #{email}
</if>
</where>
</select>
6.3 trim
-
若trim标签中有内容时:
- prefix|suffix:将trim标签中前面或后面添加指定内容
- suffixOverrides|prefixOverrides:将trim标签中内容前面或后面去掉指定内容
-
若trim标签中没有内容时,trim标签也没有任何效果,即不会加上where关键字
<!--List<Emp> getEmpByCondition(Emp emp);-->
<select id="getEmpByCondition" resultType="Emp">
select * from t_emp
<trim prefix="where" suffixOverrides="and|or">
<if test="empName != null and empName !=''">
emp_name = #{empName} and
</if>
<if test="age != null and age !=''">
age = #{age} and
</if>
<if test="sex != null and sex !=''">
sex = #{sex} or
</if>
<if test="email != null and email !=''">
email = #{email}
</if>
</trim>
</select>
6.4 choose、when、otherwise
choose、when、otherwise
相当于if...else if..else
- when至少要有一个,otherwise至多只有一个(when只有一个条件会执行,有一个执行下面就不执行了,otherwise实在when都不满足的时候执行)
<select id="getEmpByChoose" resultType="Emp">
select * from t_emp
<where>
<choose>
<when test="empName != null and empName != ''">
emp_name = #{empName}
</when>
<when test="age != null and age != ''">
age = #{age}
</when>
<when test="sex != null and sex != ''">
sex = #{sex}
</when>
<when test="email != null and email != ''">
email = #{email}
</when>
<otherwise>
did = 1
</otherwise>
</choose>
</where>
</select>
6.5 foreach
- collection:设置需要循环的数组或集合
- item:表示数组或集合中的每一个数据
- separator:循环体之间的分隔符
- open:foreach标签所循环的所有内容的开始符
- close:foreach标签所循环的所有内容的结束符
6.5.1 批量删除
public void deleteMoreByArray() {
SqlSession sqlSession = SqlSessionUtils.getSqlSession();
DynamicSQLMapper mapper = sqlSession.getMapper(DynamicSQLMapper.class);
int result = mapper.deleteMoreByArray(new Integer[]{6, 7, 8, 9});
System.out.println(result);
}
delete from t_emp where eid in ( ? , ? , ? )
<!--int deleteMoreByArray(@Param("eids") Integer[] eids);-->
<delete id="deleteMoreByArray">
delete from t_emp where eid in
<foreach collection="eids" item="eid" separator="," open="(" close=")">
#{eid}
</foreach>
</delete>
delete from t_emp where eid = ? or eid = ? or eid = ?
<!--int deleteMoreByArray(@Param("eids") Integer[] eids);-->
<delete id="deleteMoreByArray">
delete from t_emp where eid in
<foreach collection="eids" item="eid" separator="or">
eid = #{eid}
</foreach>
</delete>
6.5.2 批量添加
@Test
public void insertMoreByList() {
SqlSession sqlSession = SqlSessionUtils.getSqlSession();
DynamicSQLMapper mapper = sqlSession.getMapper(DynamicSQLMapper.class);
Emp emp1 = new Emp(null,"a",1,"男","123@321.com",null);
Emp emp2 = new Emp(null,"b",1,"男","123@321.com",null);
Emp emp3 = new Emp(null,"c",1,"男","123@321.com",null);
List<Emp> emps = Arrays.asList(emp1, emp2, emp3);
int result = mapper.insertMoreByList(emps);
System.out.println(result);
}
<!--int insertMoreByList(@Param("emps") List<Emp> emps);-->
<insert id="insertMoreByList">
insert into t_emp values
<foreach collection="emps" item="emp" separator=",">
(null,#{emp.empName},#{emp.age},#{emp.sex},#{emp.email},null)
</foreach>
</insert>
6.6 SQL标签
通过SQL标签,把常用的SQL片段记录下来,当我们需要引用的时候
<sql id="empColumns">eid,emp_name,age,sex,email</sql>
<select id="getEmpByCondition" resultType="Emp">
select <include refid="empColumns"></include> from t_emp
</select>
七、MyBatis的缓存
7.1 MyBatis的一级缓存
一级缓存是SqlSession级别的,通过同一个SqlSession查询的数据会被缓存,下次查询相同的数据,就会从缓存中直接获取,不会从数据库重新访问。缓存只针对查询。
使一级缓存失效的四种方式:
- 不同的SqlSession对应不同的一级缓存
- 同一个SqlSession但是查询条件不同
- 同一个SqlSession两次查询期间执行了任何一次增删改操作
- 同一个SqlSession两次查询期间手动清空了缓存
7.2 MyBatis的二级缓存
二级缓存是SqlSessionFactory级别的,通过同一个SqlSessionFactory创建的SqlSession查询的结果会被缓存,此后若再次执行相同的查询语句,结果就会从缓存中获取;
使二级缓存失效的情况:两次查询直接执行了任意的增删改操作,会使一级和二级缓存同时失效。
二级缓存开启的条件:
- 在核心配置文件中,设置全局配置属性cacheEnabled=“true”,默认为true,不需要设置
- 在映射文件中设置标签
- 二级缓存必须在SqlSession关闭或提交之后有效
- 查询的数据所转换的实体类类型必须实现序列化的接口
7.2.1 二级缓存的相关设置
- 在mapper配置文件中添加的cache标签可以设置一些属性
- eviction属性:缓存回收策略
- LRU(Least Recently Used) – 最近最少使用的:移除最长时间不被使用的对象。
- FIFO(First in First out) – 先进先出:按对象进入缓存的顺序来移除它们。
- SOFT – 软引用:移除基于垃圾回收器状态和软引用规则的对象。
- WEAK – 弱引用:更积极地移除基于垃圾收集器状态和弱引用规则的对象。
- 默认的是 LRU
- flushInterval属性:刷新间隔,单位毫秒
- 默认情况是不设置,也就是没有刷新间隔,缓存仅仅调用语句(增删改)时刷新
- size属性:引用数目,正整数
- 代表缓存最多可以存储多少个对象,太大容易导致内存溢出
- readOnly属性:只读,true/false
- true:只读缓存;会给所有调用者返回缓存对象的相同实例。因此这些对象不能被修改。这提供了很重要的性能优势。
- false:读写缓存;会返回缓存对象的拷贝(通过序列化)。这会慢一些,但是安全,因此默认是false
7.3 MyBatis的查询顺序
- 先查询二级缓存,因为二级缓存中可能会有其他程序已经查出来的数据,可以拿来直接使用
- 如果二级缓存没有命中,再查询一级缓存
- 如果一级缓存也没有命中,则查询数据库
- SqlSession关闭之后,一级缓存中的数据会写入二级缓存
7.4 整合第三方缓存EHCache(了解)
7.4.1 添加依赖
<!-- Mybatis EHCache整合包 -->
<dependency>
<groupId>org.mybatis.caches</groupId>
<artifactId>mybatis-ehcache</artifactId>
<version>1.2.1</version>
</dependency>
<!-- slf4j日志门面的一个具体实现 -->
<dependency>
<groupId>ch.qos.logback</groupId>
<artifactId>logback-classic</artifactId>
<version>1.2.3</version>
</dependency>
7.4.1.1 各个jar包的功能
jar包名称 | 作用 |
---|---|
mybatis-ehcache | Mybatis和EHCache的整合包 |
ehcache | EHCache核心包 |
slf4j-api | SLF4J日志门面包 |
logback-classic | 支持SLF4J门面接口的一个具体实现 |
7.4.2 创建EHCache的配置文件ehcache.xml
名字必须叫
ehcache.xml
<?xml version="1.0" encoding="utf-8" ?>
<ehcache xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="../config/ehcache.xsd">
<!-- 磁盘保存路径 -->
<diskStore path="D:\atguigu\ehcache"/>
<defaultCache
maxElementsInMemory="1000"
maxElementsOnDisk="10000000"
eternal="false"
overflowToDisk="true"
timeToIdleSeconds="120"
timeToLiveSeconds="120"
diskExpiryThreadIntervalSeconds="120"
memoryStoreEvictionPolicy="LRU">
</defaultCache>
</ehcache>
7.4.2.1 EHCache配置文件说明
属性名 | 是否必须 | 作用 |
---|---|---|
maxElementsInMemory | 是 | 在内存中缓存的element的最大数目 |
maxElementsOnDisk | 是 | 在磁盘上缓存的element的最大数目,若是0表示无穷大 |
eternal | 是 | 设定缓存的elements是否永远不过期。 如果为true,则缓存的数据始终有效, 如果为false那么还要根据timeToIdleSeconds、timeToLiveSeconds判断 |
overflowToDisk | 是 | 设定当内存缓存溢出的时候是否将过期的element缓存到磁盘上 |
timeToIdleSeconds | 否 | 当缓存在EhCache中的数据前后两次访问的时间超过timeToIdleSeconds的属性取值时, 这些数据便会删除,默认值是0,也就是可闲置时间无穷大 |
timeToLiveSeconds | 否 | 缓存element的有效生命期,默认是0.,也就是element存活时间无穷大 |
diskSpoolBufferSizeMB | 否 | DiskStore(磁盘缓存)的缓存区大小。默认是30MB。每个Cache都应该有自己的一个缓冲区 |
diskPersistent | 否 | 在VM重启的时候是否启用磁盘保存EhCache中的数据,默认是false |
diskExpiryThreadIntervalSeconds | 否 | 磁盘缓存的清理线程运行间隔,默认是120秒。每个120s, 相应的线程会进行一次EhCache中数据的清理工作 |
memoryStoreEvictionPolicy | 否 | 当内存缓存达到最大,有新的element加入的时候, 移除缓存中element的策略。 默认是LRU(最近最少使用),可选的有LFU(最不常使用)和FIFO(先进先出 |
7.4.3 设置二级缓存的类型
- 在xxxMapper.xml文件中设置二级缓存类型
<cache type="org.mybatis.caches.ehcache.EhcacheCache"/>
7.4.4 加入logback日志
存在SLF4J时,作为简易日志的log4j将失效,此时我们需要借助SLF4J的具体实现logback来打印日志。创建logback的配置文件
logback.xml
,名字固定,不可改变
<?xml version="1.0" encoding="UTF-8"?>
<configuration debug="true">
<!-- 指定日志输出的位置 -->
<appender name="STDOUT"
class="ch.qos.logback.core.ConsoleAppender">
<encoder>
<!-- 日志输出的格式 -->
<!-- 按照顺序分别是:时间、日志级别、线程名称、打印日志的类、日志主体内容、换行 -->
<pattern>[%d{HH:mm:ss.SSS}] [%-5level] [%thread] [%logger] [%msg]%n</pattern>
</encoder>
</appender>
<!-- 设置全局日志级别。日志级别按顺序分别是:DEBUG、INFO、WARN、ERROR -->
<!-- 指定任何一个日志级别都只打印当前级别和后面级别的日志。 -->
<root level="DEBUG">
<!-- 指定打印日志的appender,这里通过“STDOUT”引用了前面配置的appender -->
<appender-ref ref="STDOUT" />
</root>
<!-- 根据特殊需求指定局部日志级别 -->
<logger name="com.atguigu.crowd.mapper" level="DEBUG"/>
</configuration>
八、分页插件
8.1 添加依赖
<!-- https://mvnrepository.com/artifact/com.github.pagehelper/pagehelper -->
<dependency>
<groupId>com.github.pagehelper</groupId>
<artifactId>pagehelper</artifactId>
<version>5.2.0</version>
</dependency>
8.2 配置分页插件
在MyBatis的核心配置文件(mybatis-config.xml)中配置插件
<plugins>
<!--设置分页插件-->
<plugin interceptor="com.github.pagehelper.PageInterceptor"></plugin>
</plugins>
8.3 开启分页功能
- 在查询功能之前使用
PageHelper.startPage(int pageNum, int pageSize)开启分页功能
- pageNum:当前页的页码
- pageSize:每页显示的条数
@Test
public void testPageHelper() throws IOException {
InputStream is = Resources.getResourceAsStream("mybatis-config.xml");
SqlSessionFactoryBuilder sqlSessionFactoryBuilder = new SqlSessionFactoryBuilder();
SqlSessionFactory sqlSessionFactory = sqlSessionFactoryBuilder.build(is);
SqlSession sqlSession = sqlSessionFactory.openSession(true);
EmpMapper mapper = sqlSession.getMapper(EmpMapper.class);
//访问第一页,每页四条数据
PageHelper.startPage(1,4);
List<Emp> emps = mapper.selectByExample(null);
emps.forEach(System.out::println);
}
8.4 获取分页相关的数据(重点)
分页插件的意义就是可以方便的获取关于分页的所有数据。
8.4.1 直接获取简易信息Page
@Test
public void testPageHelper() throws IOException {
InputStream is = Resources.getResourceAsStream("mybatis-config.xml");
SqlSessionFactoryBuilder sqlSessionFactoryBuilder = new SqlSessionFactoryBuilder();
SqlSessionFactory sqlSessionFactory = sqlSessionFactoryBuilder.build(is);
SqlSession sqlSession = sqlSessionFactory.openSession(true);
EmpMapper mapper = sqlSession.getMapper(EmpMapper.class);
//访问第一页,每页四条数据
Page<Object> page = PageHelper.startPage(1, 4);
List<Emp> emps = mapper.selectByExample(null);
//在查询到List集合后,打印分页数据
System.out.println(page);
}
分页相关数据:
Page{count=true, pageNum=1, pageSize=4, startRow=0, endRow=4, total=8, pages=2, reasonable=false, pageSizeZero=false}
[Emp{eid=1, empName='admin', age=22, sex='男', email='456@qq.com', did=3}, Emp{eid=2, empName='admin2', age=22, sex='男', email='456@qq.com', did=3}, Emp{eid=3, empName='王五', age=12, sex='女', email='123@qq.com', did=3}, Emp{eid=4, empName='赵六', age=32, sex='男', email='123@qq.com', did=1}]
8.4.2 获取PageInfo
- 在查询获取结果后,使用
PageInfo<T> pageInfo = new PageInfo<>(List<T> list, intnavigatePages)
获取分页相关数据 - list:分页之后的数据
- navigatePage:导航分页的页码数
@Test
public void testPageHelper() throws IOException {
InputStream is = Resources.getResourceAsStream("mybatis-config.xml");
SqlSessionFactoryBuilder sqlSessionFactoryBuilder = new SqlSessionFactoryBuilder();
SqlSessionFactory sqlSessionFactory = sqlSessionFactoryBuilder.build(is);
SqlSession sqlSession = sqlSessionFactory.openSession(true);
EmpMapper mapper = sqlSession.getMapper(EmpMapper.class);
PageHelper.startPage(1, 4);
List<Emp> emps = mapper.selectByExample(null);
PageInfo<Emp> page = new PageInfo<>(emps,5);
System.out.println(page);
}
分页相关数据:
- 其中list相当于8.4.1中获取的Page数据
PageInfo{pageNum=1, pageSize=4, size=4, startRow=1, endRow=4, total=8, pages=2,
list=Page{count=true, pageNum=1, pageSize=4, startRow=0, endRow=4, total=8, pages=2, reasonable=false, pageSizeZero=false}
[Emp{eid=1, empName='admin', age=22, sex='男', email='456@qq.com', did=3}, Emp{eid=2, empName='admin2', age=22, sex='男', email='456@qq.com', did=3}, Emp{eid=3, empName='王五', age=12, sex='女', email='123@qq.com', did=3}, Emp{eid=4, empName='赵六', age=32, sex='男', email='123@qq.com', did=1}],
prePage=0, nextPage=2, isFirstPage=true, isLastPage=false, hasPreviousPage=false, hasNextPage=true, navigatePages=5, navigateFirstPage=1, navigateLastPage=2, navigatepageNums=[1, 2]}
相关数据:
- pageNum:当前页的页码
- pageSize:每页显示的条数
- size:当前页显示的真实条数
- total:总记录数
- pages:总页数
- prePage:上一页的页码
- nextPage:下一页的页码
- isFirstPage/isLastPage:是否为第一页/最后一页
- hasPreviousPage/hasNextPage:是否存在上一页/下一页
- navigatePages:导航分页的页码数
- navigatepageNums:导航分页的页码,[1,2,3,4,5]
九、MyBatis的逆向工程
- 正向工程:先创建Java实体类,由框架负责根据实体类生成数据库表。Hibernate是支持正向工程的
- 逆向工程:先创建数据库表,由框架负责根据数据库表,反向生成如下资源:
- Java实体类
- Mapper接口
- Mapper映射文件
9.1 创建逆向工程的步骤
9.1.1 添加依赖和插件
<dependencies>
<!-- MyBatis核心依赖包 -->
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.5.9</version>
</dependency>
<!-- junit测试 -->
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.13.2</version>
<scope>test</scope>
</dependency>
<!-- MySQL驱动 -->
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>8.0.27</version>
</dependency>
<!-- log4j日志 -->
<dependency>
<groupId>log4j</groupId>
<artifactId>log4j</artifactId>
<version>1.2.17</version>
</dependency>
</dependencies>
<!-- 控制Maven在构建过程中相关配置 -->
<build>
<!-- 构建过程中用到的插件 -->
<plugins>
<!-- 具体插件,逆向工程的操作是以构建过程中插件形式出现的 -->
<plugin>
<groupId>org.mybatis.generator</groupId>
<artifactId>mybatis-generator-maven-plugin</artifactId>
<version>1.3.0</version>
<!-- 插件的依赖 -->
<dependencies>
<!-- 逆向工程的核心依赖 -->
<dependency>
<groupId>org.mybatis.generator</groupId>
<artifactId>mybatis-generator-core</artifactId>
<version>1.3.2</version>
</dependency>
<!-- 数据库连接池 -->
<dependency>
<groupId>com.mchange</groupId>
<artifactId>c3p0</artifactId>
<version>0.9.2</version>
</dependency>
<!-- MySQL驱动 -->
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>8.0.27</version>
</dependency>
</dependencies>
</plugin>
</plugins>
</build>
9.1.2 创建MyBatis的核心配置文件
<?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="jdbc.properties"/>
<typeAliases>
<package name=""/>
</typeAliases>
<environments default="development">
<environment id="development">
<transactionManager type="JDBC"/>
<dataSource type="POOLED">
<property name="driver" value="${jdbc.driver}"/>
<property name="url" value="${jdbc.url}"/>
<property name="username" value="${jdbc.username}"/>
<property name="password" value="${jdbc.password}"/>
</dataSource>
</environment>
</environments>
<mappers>
<package name=""/>
</mappers>
</configuration>
9.1.3 创建逆向工程的配置文件
- 文件名必须是:
generatorConfig.xml
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE generatorConfiguration
PUBLIC "-//mybatis.org//DTD MyBatis Generator Configuration 1.0//EN"
"http://mybatis.org/dtd/mybatis-generator-config_1_0.dtd">
<generatorConfiguration>
<!--
targetRuntime: 执行生成的逆向工程的版本
MyBatis3Simple: 生成基本的CRUD(清新简洁版)
MyBatis3: 生成带条件的CRUD(奢华尊享版)
-->
<context id="DB2Tables" targetRuntime="MyBatis3Simple">
<!-- 数据库的连接信息 -->
<jdbcConnection driverClass="com.mysql.cj.jdbc.Driver"
connectionURL="jdbc:mysql://localhost:3306/mybatis"
userId="root"
password="123456">
</jdbcConnection>
<!-- javaBean的生成策略-->
<javaModelGenerator targetPackage="com.atguigu.mybatis.pojo" targetProject=".\src\main\java">
<property name="enableSubPackages" value="true" />
<property name="trimStrings" value="true" />
</javaModelGenerator>
<!-- SQL映射文件的生成策略 -->
<sqlMapGenerator targetPackage="com.atguigu.mybatis.mapper"
targetProject=".\src\main\resources">
<property name="enableSubPackages" value="true" />
</sqlMapGenerator>
<!-- Mapper接口的生成策略 -->
<javaClientGenerator type="XMLMAPPER"
targetPackage="com.atguigu.mybatis.mapper" targetProject=".\src\main\java">
<property name="enableSubPackages" value="true" />
</javaClientGenerator>
<!-- 逆向分析的表 -->
<!-- tableName设置为*号,可以对应所有表,此时不写domainObjectName -->
<!-- domainObjectName属性指定生成出来的实体类的类名 -->
<table tableName="t_emp" domainObjectName="Emp"/>
<table tableName="t_dept" domainObjectName="Dept"/>
</context>
</generatorConfiguration>
9.1.4 执行MBG插件的generate功能
- 如果出现报错:
Exception getting JDBC Driver
,可能是pom.xml中,数据库驱动配置错误- mybatis-generator-maven-plugin插件中的驱动
- 两者的驱动版本应该相同
9.2 QBC
9.2.1 查询
selectByExample
:按条件查询,需要传入一个example对象或者null;如果传入一个null,则表示没有条件,也就是查询所有数据example.createCriteria().xxx
:创建条件对象,通过andXXX方法为SQL添加查询添加,每个条件之间是and关系example.or().xxx
:将之前添加的条件通过or拼接其他条件
@Test public void testMBG() throws IOException {
InputStream is = Resources.getResourceAsStream("mybatis-config.xml");
SqlSessionFactoryBuilder sqlSessionFactoryBuilder = new SqlSessionFactoryBuilder();
SqlSessionFactory sqlSessionFactory = sqlSessionFactoryBuilder.build(is);
SqlSession sqlSession = sqlSessionFactory.openSession(true);
EmpMapper mapper = sqlSession.getMapper(EmpMapper.class);
EmpExample example = new EmpExample();
//名字为张三,且年龄大于等于20
example.createCriteria().andEmpNameEqualTo("张三").andAgeGreaterThanOrEqualTo(20);
//或者did不为空
example.or().andDidIsNotNull();
List<Emp> emps = mapper.selectByExample(example);
emps.forEach(System.out::println);
}
9.2.2 增改
updateByPrimaryKey
:通过主键进行数据修改,如果某一个值为null,也会将对应的字段改为nullmapper.updateByPrimaryKey(new Emp(1,"admin",22,null,"456@qq.com",3));
updateByPrimaryKeySelective()
:通过主键进行选择性数据修改,如果某个值为null,则不修改这个字段mapper.updateByPrimaryKeySelective(new Emp(2,"admin2",22,null,"456@qq.com",3));
用bigint因为mybatis生成ID用雪花算法,生成id比较长
十、Mybatis-Plus
10.1 简介
MyBatis-Plus (简称 MP)是一个 MyBatis 的增强工具,在 MyBatis 的基础上只做增强不做改变,为简化开发、提高效率而生。
愿景
我们的愿景是成为 MyBatis 最好的搭档,就像 魂斗罗 中的 1P、2P,基友搭配,效率翻倍。
10.2 特性
- 无侵入:只做增强不做改变,引入它不会对现有工程产生影响,如丝般顺滑
- 损耗小:启动即会自动注入基本 CURD,性能基本无损耗,直接面向对象操作
- 强大的 CRUD 操作:内置通用 Mapper、通用 Service,仅仅通过少量配置即可实现单表大部分 CRUD 操作,更有强大的条件构造器,满足各类使用需求
- 支持 Lambda 形式调用:通过 Lambda 表达式,方便的编写各类查询条件,无需再担心字段写错
- 支持主键自动生成:支持多达 4 种主键策略(内含分布式唯一 ID 生成器 - Sequence),可自由配置,完美解决主键问题
- 支持 ActiveRecord 模式:支持 ActiveRecord 形式调用,实体类只需继承 Model 类即可进行强大的 CRUD 操作
- 支持自定义全局通用操作:支持全局通用方法注入( Write once, use anywhere )
- 内置代码生成器:采用代码或者 Maven 插件可快速生成 Mapper 、 Model 、 Service 、 Controller 层代码,支持模板引擎,更有超多自定义配置等您来使用
- 内置分页插件:基于 MyBatis 物理分页,开发者无需关心具体操作,配置好插件之后,写分页等同于普通 List 查询
- 分页插件支持多种数据库:支持 MySQL、MariaDB、Oracle、DB2、H2、HSQL、SQLite、Postgre、SQLServer 等多种数据库
- 内置性能分析插件:可输出 SQL 语句以及其执行时间,建议开发测试时启用该功能,能快速揪出慢查询
- 内置全局拦截插件:提供全表 delete 、 update 操作智能分析阻断,也可自定义拦截规则,预防误操作
10.3 框架结构
个人理解:
使用Mybatis-plus后,sql语句动态生成,当前操作的表由实体类决定,所以首先扫描实体,通过反射机制,将实体类中的属性进行抽取,分析实体类和表的关系,实体类中的属性与表中的字段的关系,再根据调用的方法,动态的生成sql注入到Mybatis容器中
10.4 入门案例
引入依赖
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-test</artifactId>
<scope>test</scope>
</dependency>
<!-- mybatis-plus启动器 -->
<dependency>
<groupId>com.baomidou</groupId>
<artifactId>mybatis-plus-boot-starter</artifactId>
<version>3.4.0</version>
</dependency>
<!-- 简化实体类开发-->
<dependency>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
<optional>true</optional>
</dependency>
<!-- mysql驱动-->
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<scope>runtime</scope>
</dependency>
</dependencies>
yml
spring:
# 配置数据源信息
datasource:
# 配置数据源类型
type: com.zaxxer.hikari.HikariDataSource
# 配置连接数据库的连接信息
driverClassName: com.mysql.cj.jdbc.Driver
# mysql驱动5.7版本不需要设置时区 8版本需要设置时区,不然会报错
url: jdbc:mysql://localhost:3306/db01?serverTimezone=GMT%2B8&characterEncoding=utf-8&useSSL=false
username: root
password: 467775
注意:
-
驱动类driver-class-name
- spring boot 2.0(内置jdbc5驱动),驱动类使用:driver-class-name: com.mysql.jdbc.Driver
- spring boot 2.1及以上(内置jdbc8驱动),驱动类使用:driver-class-name: com.mysql.cj.jdbc.Driver,否则运行测试用例的时候会有 WARN 信息。
-
连接地址url
- MySQL5.7版本的url:jdbc:mysql://localhost:3306/mybatis_plus?characterEncoding=utf-8&useSSL=false
- MySQL8.0版本的url:jdbc:mysql://localhost:3306/mybatis_plus?serverTimezone=GMT%2B8&characterEncoding=utf-8&useSSL=false
- 否则运行测试用例报告如下错误:java.sql.SQLException: The server time zone value ‘Öйú±ê׼ʱ¼ä’ is unrecognized or represents more
启动类
@SpringBootApplication
@MapperScan("com.juice.mybatisplus.mapper")
public class MybatisPlusApplication {
public static void main(String[] args) {
SpringApplication.run(MybatisPlusApplication.class, args);
}
}
在Springboot启动类中添加MapperScan注解,扫描指定包下mapper接口
实体类
package com.juice.mybatisplus.pojo;
import lombok.Data;
/**
* @author juice
* @version V1.00
* @date : 2023/04/22 17:56
* @since V1.00
**/
@Data
public class User {
private Long id;
private String name;
private Integer age;
private String email;
}
-
注:@Data是lombok的注解,需要引入lombok依赖,@Data注解可以生成该类的无参构造、Getter、Setter方法、equals方法、hashcode方法、toString方法。
-
lombok中还有其他注解:
@NoArgsConstructor // 无参构造
@AllArgsConstructor // 有参构造
@Getter // get方法
@Setter // set方法
@EqualsAndHashCode // equals方法、hashcode方法
@ToString // toString方法
Mapper接口继承通用接口BaseMapper
package com.juice.mybatisplus.mapper;
import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.juice.mybatisplus.pojo.User;
// UserMapper继承通用接口,通用接口中的方法也会被继承过来
public interface UserMapper extends BaseMapper<User> {
}
通用接口
package com.baomidou.mybatisplus.core.mapper;
import com.baomidou.mybatisplus.core.conditions.Wrapper;
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.core.toolkit.Constants;
import org.apache.ibatis.annotations.Param;
import java.io.Serializable;
import java.util.Collection;
import java.util.List;
import java.util.Map;
/**
* Mapper 继承该接口后,无需编写 mapper.xml 文件,即可获得CRUD功能
* <p>这个 Mapper 支持 id 泛型</p>
*
* @author hubin
* @since 2016-01-23
*/
public interface BaseMapper<T> extends Mapper<T> {
/**
* 插入一条记录
*
* @param entity 实体对象
*/
int insert(T entity);
/**
* 根据 ID 删除
*
* @param id 主键ID
*/
int deleteById(Serializable id);
/**
* 根据 columnMap 条件,删除记录
*
* @param columnMap 表字段 map 对象
*/
int deleteByMap(@Param(Constants.COLUMN_MAP) Map<String, Object> columnMap);
/**
* 根据 entity 条件,删除记录
*
* @param wrapper 实体对象封装操作类(可以为 null)
*/
int delete(@Param(Constants.WRAPPER) Wrapper<T> wrapper);
/**
* 删除(根据ID 批量删除)
*
* @param idList 主键ID列表(不能为 null 以及 empty)
*/
int deleteBatchIds(@Param(Constants.COLLECTION) Collection<? extends Serializable> idList);
/**
* 根据 ID 修改
*
* @param entity 实体对象
*/
int updateById(@Param(Constants.ENTITY) T entity);
/**
* 根据 whereEntity 条件,更新记录
*
* @param entity 实体对象 (set 条件值,可以为 null)
* @param updateWrapper 实体对象封装操作类(可以为 null,里面的 entity 用于生成 where 语句)
*/
int update(@Param(Constants.ENTITY) T entity, @Param(Constants.WRAPPER) Wrapper<T> updateWrapper);
/**
* 根据 ID 查询
*
* @param id 主键ID
*/
T selectById(Serializable id);
/**
* 查询(根据ID 批量查询)
*
* @param idList 主键ID列表(不能为 null 以及 empty)
*/
List<T> selectBatchIds(@Param(Constants.COLLECTION) Collection<? extends Serializable> idList);
/**
* 查询(根据 columnMap 条件)
*
* @param columnMap 表字段 map 对象
*/
List<T> selectByMap(@Param(Constants.COLUMN_MAP) Map<String, Object> columnMap);
/**
* 根据 entity 条件,查询一条记录
*
* @param queryWrapper 实体对象封装操作类(可以为 null)
*/
T selectOne(@Param(Constants.WRAPPER) Wrapper<T> queryWrapper);
/**
* 根据 Wrapper 条件,查询总记录数
*
* @param queryWrapper 实体对象封装操作类(可以为 null)
*/
Integer selectCount(@Param(Constants.WRAPPER) Wrapper<T> queryWrapper);
/**
* 根据 entity 条件,查询全部记录
*
* @param queryWrapper 实体对象封装操作类(可以为 null)
*/
List<T> selectList(@Param(Constants.WRAPPER) Wrapper<T> queryWrapper);
/**
* 根据 Wrapper 条件,查询全部记录
*
* @param queryWrapper 实体对象封装操作类(可以为 null)
*/
List<Map<String, Object>> selectMaps(@Param(Constants.WRAPPER) Wrapper<T> queryWrapper);
/**
* 根据 Wrapper 条件,查询全部记录
* <p>注意: 只返回第一个字段的值</p>
*
* @param queryWrapper 实体对象封装操作类(可以为 null)
*/
List<Object> selectObjs(@Param(Constants.WRAPPER) Wrapper<T> queryWrapper);
/**
* 根据 entity 条件,查询全部记录(并翻页)
*
* @param page 分页查询条件(可以为 RowBounds.DEFAULT)
* @param queryWrapper 实体对象封装操作类(可以为 null)
*/
<E extends IPage<T>> E selectPage(E page, @Param(Constants.WRAPPER) Wrapper<T> queryWrapper);
/**
* 根据 Wrapper 条件,查询全部记录(并翻页)
*
* @param page 分页查询条件
* @param queryWrapper 实体对象封装操作类
*/
<E extends IPage<Map<String, Object>>> E selectMapsPage(E page, @Param(Constants.WRAPPER) Wrapper<T> queryWrapper);
}
测试类
@Test
void testSelect(){
// 根据条件查询器查询多条数据,没有条件是可以传null,即查全部 SELECT id,name,age,email FROM user
List<User> users = userMapper.selectList(null);
users.forEach(System.out::println);
// 根据id查询 SELECT id,name,age,email FROM user WHERE id=?
User user = userMapper.selectById(1L);
System.out.println(user);
// SELECT id,name,age,email FROM user WHERE id IN ( ? , ? )
List<User> list = userMapper.selectBatchIds(Arrays.asList(1L, 2L));
list.forEach(System.out::println);
// 根据条件查询 SELECT id,name,age,email FROM user WHERE name = ? AND age = ?
Map<String, Object> map = new HashMap<>(2);
map.put("name","Billie");
map.put("age",21);
List<User> byMap = userMapper.selectByMap(map);
byMap.forEach(System.out::println);
}
@Test
void testAdd(){
User juice = User.builder().name("juice").age(18).email("xxx").build();
// 插入一个对象 INSERT INTO user ( id, name, age, email ) VALUES ( ?, ?, ?, ? )
int insert = userMapper.insert(juice);
System.out.println("插入的条数," + insert + "插入返回的id" + juice.getId() );
// output: 插入的条数1,插入返回的id1649727353075281921
}
@Test
void testDel(){
// 根据主键id删除 DELETE FROM user WHERE id=?
int i = userMapper.deleteById(1L);
// 根据主键id批量删除 DELETE FROM user WHERE id IN ( ? , ? )
int i1 = userMapper.deleteBatchIds(Arrays.asList(2L, 3L));
// 根据map集合中设置的条件删除 DELETE FROM user WHERE name = ? AND id = ?
Map<String, Object> map = new HashMap<>(2);
map.put("id",4L);
map.put("name","juice");
int i2 = userMapper.deleteByMap(map);
}
@Test
void testUpdate(){
// 根据id去设置值,如果没有值不会设置,UPDATE user SET name=?, age=? WHERE id=?
User juice = User.builder().name("juice").age(20).build();
int i = userMapper.updateById(juice);
}
注:使用Autowired,会报红,但是编译运行时没有异常,因为mapper接口在被扫描的时候,是将接口动态生成的的代理类注入到IOC容器中(ioc容器不会存放接口),所以ide在编译的时候会认为,mapper接口不能被自动装配,所以报红。
解决方法:**在mapper接口上加上@Repository,将他标记为类或接口标记成持久层组件,**报红就会消失。
日志功能
application.yml中加入
mybatis-plus:
configuration:
logImpl: org.apache.ibatis.logging.stdout.StdOutImpl
使用IService功能
package com.juice.mybatisplus.service;
import com.baomidou.mybatisplus.extension.service.IService;
import com.juice.mybatisplus.pojo.User;
public interface UserService extends IService<User> {
}
package com.juice.mybatisplus.service.impl;
import com.baomidou.mybatisplus.extension.service.impl.ServiceImpl;
import com.juice.mybatisplus.mapper.UserMapper;
import com.juice.mybatisplus.pojo.User;
import com.juice.mybatisplus.service.UserService;
/**
* @author juice
* @version V1.00
* @date : 2023/04/22 20:47
* @since V1.00
**/
// UserService继承了IService,所以IService接口中的方法都会被继承到UserService中,当UserServiceImpl实现UserService接口,也需要全部重写其中的方法,所以需要继承IService的实现类ServiceImpl即可。
@Service
public class UserServiceImpl extends ServiceImpl<UserMapper, User> implements UserService {
}
说明:
- 通用 Service CRUD 封装IService接口,进一步封装 CRUD 采用
get 查询单行
remove 删除
list 查询集合
page 分页
前缀命名方式区分Mapper
层避免混淆,- 泛型
T
为任意实体对象- 建议如果存在自定义通用 Service 方法的可能,请创建自己的
IBaseService
继承Mybatis-Plus
提供的基类- 对象
Wrapper
为 条件构造器
测试类
package com.juice.mybatisplus;
import com.juice.mybatisplus.pojo.User;
import com.juice.mybatisplus.service.UserService;
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
import java.util.ArrayList;
import java.util.LinkedList;
import java.util.List;
@SpringBootTest
public class IServiceTest {
@Autowired
private UserService userService;
@Test
void testCount(){
// SELECT COUNT( 1 ) FROM user
int count = userService.count();
System.out.println("条数" + count);
}
@Test
void testSave(){
List<User> list = new ArrayList<>(10);
for (int i = 0; i < 10; i++) {
User juice = User.builder().name("juice" + i).age(i).email("xxx" + i).build();
list.add(juice);
}
// 批量添加也是通过循环插入,INSERT INTO user ( id, name, age, email ) VALUES ( ?, ?, ?, ? )
boolean b = userService.saveBatch(list);
// 根据判断id是否有值,没有id就是add,有id就是update
List<User> list2 = new ArrayList<>(2);
User add = User.builder().age(2).name("xxx").email("xxx").build();
User update = User.builder().id(4L).name("update").build();
list2.add(add);
list2.add(update);
boolean b1 = userService.saveOrUpdateBatch(list2);
}
}
==> Preparing: INSERT INTO user ( id, name, age, email ) VALUES ( ?, ?, ?, ? )
> Parameters: 1649763169780727810(Long), xxx(String), 2(Integer), xxx(String)
> Preparing: SELECT id,name,age,email FROM user WHERE id=?
> Parameters: 4(Long)
< Columns: id, name, age, email
< Row: 4, Sandy, 21, test4@baomidou.com
< Total: 1==> Preparing: UPDATE user SET name=? WHERE id=?
==> Parameters: update(String), 4(Long)
saveOrUpdateBatch,根据判断id是否有值,没有id就是add,有id就是update
本篇博客,根据尚硅谷杨博超老师的MyBatis的教程学习所记,地址如下:尚硅谷-Mybatisspm_id_from=333.1007.top_right_bar_window_history.content.click如有不正确的地方,欢迎同学们指正,喜欢的话,欢迎点赞收藏评论哦~