该笔记来自B站SGG-Mybatis学习记录及其配套资料，文章末贴出链接
2022.06.08
Mybatis特性
1. MyBatis 是支持定制化 SQL、存储过程以及高级映射的优秀的持久层框架
2. MyBatis 避免了几乎所有的 JDBC 代码和手动设置参数以及获取结果集
3. MyBatis可以使用简单的XML或注解用于配置和原始映射，将接口和Java的POJO（Plain Old Java
Objects，普通的Java对象）映射成数据库中的记录
4. MyBatis 是一个 半自动的ORM（Object Relation Mapping）框架
Mybatis与其他持久层技术对比
1. JDBC
SQL 夹杂在Java代码中耦合度高，导致硬编码内伤
维护不易且实际开发需求中 SQL 有变化，频繁修改的情况多见
代码冗长，开发效率低
2. Hibernate 和 JPA
操作简便，开发效率高
程序中的长难复杂 SQL 需要绕过框架
内部自动生产的 SQL，不容易做特殊优化
基于全映射的全自动框架，大量字段的 POJO 进行部分映射时比较困难。
反射操作太多，导致数据库性能下降
3. MyBatis
轻量级，性能出色
SQL 和 Java 编码分开，功能边界清晰。Java代码专注业务、SQL语句专注数据
开发效率稍逊于HIbernate，但是完全能够接受
搭建Mybatis开发环境
1. 新建maven模块工程
2. 引入依赖
// pom.xml
<!-- 打包方式为Jar包-->
<packaging>jar</packaging>
<dependencies>
<!-- Mybatis核心 -->
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.5.7</version>
</dependency>
<!-- junit测试 -->
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.12</version>
<scope>test</scope>
</dependency>
<!-- MySQL驱动 -->
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>8.0.29</version>
</dependency>
<!-- log4j日志 -->
<dependency>
<groupId>log4j</groupId>
<artifactId>log4j</artifactId>
<version>1.2.17</version>
</dependency>
</dependencies>
3. 创建Mybatis配置文件
// resources\mybatis-config.xml
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configuration
PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration>
<environments default="development">
<environment id="development">
<transactionManager type="JDBC"/>
<dataSource type="POOLED">
<property name="driver" value="com.mysql.cj.jdbc.Driver"/>
<property name="url" value="jdbc:mysql://localhost:3306/mybatis"/>
<property name="username" value="root"/>
<property name="password" value="xxx"/>
</dataSource>
</environment>
</environments>
<mappers>
<mapper resource="mappers/UserMapper.xml"/>
</mappers>
</configuration>
4. 创建数据库表
DROP TABLE IF EXISTS `t_user`;
CREATE TABLE `t_user` (
`id` int NOT NULL AUTO_INCREMENT,
`username` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci NULL DEFAULT NULL,
`age` int NULL DEFAULT NULL,
`password` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci NULL DEFAULT NULL,
`sex` char(1) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci NULL DEFAULT NULL,
`email` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci NULL DEFAULT NULL,
PRIMARY KEY (`id`) USING BTREE
) ENGINE = InnoDB CHARACTER SET = utf8mb4 COLLATE = utf8mb4_general_ci ROW_FORMAT = Dynamic;
5. 创建实体类
// com.company.mybatis.bean.User
public class User {
private Integer id;
private String username;
private String password;
private Integer age;
private String sex;
private String email;
public User() {
}
public User(Integer id, String username, String password, Integer age, String sex, String email) {
this.id = id;
this.username = username;
this.password = password;
this.age = age;
this.sex = sex;
this.email = email;
}
public Integer getId() {
return id;
}
public void setId(Integer id) {
this.id = id;
}
public String getUsername() {
return username;
}
public void setUsername(String username) {
this.username = username;
}
public String getPassword() {
return password;
}
public void setPassword(String password) {
this.password = password;
}
public Integer getAge() {
return age;
}
public void setAge(Integer age) {
this.age = age;
}
public String getSex() {
return sex;
}
public void setSex(String sex) {
this.sex = sex;
}
public String getEmail() {
return email;
}
public void setEmail(String email) {
this.email = email;
}
@Override
public String toString() {
return "User{" +
"id=" + id +
", username='" + username + '\'' +
", password='" + password + '\'' +
", age=" + age +
", sex='" + sex + '\'' +
", email='" + email + '\'' +
'}';
}
}
6. 创建mapper接口（类似于以前的dao层接口）
// com.company.mybatis.mappers.UserMapper
public interface UserMapper {
// 插入数据
int insertUser();
// 更新数据
int updateUser();
// 删除数据
int deleteUser();
// 查询所有数据
List<User> queryAllUser();
// 查询单个用户
User queryUser();
}
7. 创建mapper映射文件(类名+Mapper.xml，常规情况下避免了再写dao层实现类，直接走sql)
// resources\mappers\UserMapper.xml
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper
PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-mapper.dtd">
// 注意这里的namespace 它是指定到我们的mapper接口
<mapper namespace="com.company.mybatis.mappers.UserMapper">
// 这里的id 必须唯一 指定到我们接口定义的方法 由namespace+id就能定位到具体的接口方法，即倒过来就会定位到具体的sql实现
<!-- insertUser 插入数据-->
<insert id="insertUser">
insert into t_user
values (null, "李大爷3", 40, "123456", "男", "1234@qq.com");
</insert>
<!-- updateUser 更新数据-->
<update id="updateUser">
update t_user
set username="李大爷被修改",
age=30
where id = 1
</update>
<!-- deleteUser 删除数据-->
<delete id="deleteUser">
delete
from t_user
where id = 2;
</delete>
<!-- queryAllUser 查询所有-->
<select id="queryAllUser" resultType="com.company.mybatis.bean.User">
select *
from t_user
</select>
<!-- queryUser 查询单个用户-->
<select id="queryUser" resultType="com.company.mybatis.bean.User">
select *
from t_user
where id = 1
</select>
</mapper>
8. 创建测试类
// src.test.java.com.company.mybatis.test.TestMybatis
public class TestMyBatis {
@Test
public void testCURD() throws IOException {
InputStream is = Resources.getResourceAsStream("mybatis-config.xml"); //加载核心配置文件
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(is); //获取SqlSessionFactoryBuilder并获取sqlSessionFactory
SqlSession sqlSession = sqlSessionFactory.openSession(true); //获取SqlSession 并设置为自动提交事务
UserMapper mapper = sqlSession.getMapper(UserMapper.class); //获取mapper接口对象
// mapper.insertUser(); // 新增用户
// mapper.updateUser(); // 更新用户
// mapper.deleteUser(); // 删除用户
// 查询所有用户
// List<User> userList = mapper.queryAllUser();
// userList.forEach(user -> System.out.println(user));
// 写死查询id为1的用户
User user = mapper.queryUser();
System.out.println(user);
}
}
9. 加入log4j.xml配置
// resources.log4j.xml
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE log4j:configuration SYSTEM "http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/xml/doc-files/log4j.dtd">
<log4j:configuration>
<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映射文件
1. ORM（Object Relationship Mapping）对象关系映射。
对象：Java的实体类对象
关系：关系型数据库
映射：二者之间的对应关系
2. java与数据库对应关系
Java概念 数据库概念
类 表
属性 字段/列
对象 记录/行
3. 规则
3.1 映射文件的命名规则：
表所对应的实体类的类名+Mapper.xml
例如：表t_user，映射的实体类为User，所对应的映射文件为UserMapper.xml
因此一个映射文件对应一个实体类，对应一张表的操作
3.2 MyBatis映射文件用于编写SQL，访问以及操作表中的数据
MyBatis映射文件存放的位置是src/main/resources/mappers目录下
3.3 MyBatis中可以面向接口操作数据，要保证两个一致：
a>mapper接口的全类名和映射文件的命名空间（namespace）保持一致
b>mapper接口中方法的方法名和映射文件中编写SQL的标签的id属性保持一致
Mybatis中select查询时注意事项
1.在使用<select>标签时，必须设置属性"resultType"或者"resultMap"，主要用途是设置实体类和数据库表的映射关系
1.1 resultType："自动映射"（用于属性名和表中字段名一致的情况）
其中无需定义，可直接使用
基本类型: resultType="基本类型"
如：查询所有用户 resultType="java.lang.Long"
List类型: resultType="List中元素的类型"
当满足sql查询出的字段对应的pojo中有相同字段，则将resultType设置为当前pojo的类路径全限定名，如查询所有用户: com.company.mybatis.bean.User
1.2 resultMap："自定义映射"（用于一对多、多对一、字段名和属性名不一致的情况）
其中需要在当前的mapper.xml文件中定义resultMap
使用场景：
字段有自定义的转化规则
复杂的多表查询
<resultMap id="userResultMap" type="com.company.mybatis.bean.User">
<id property="id" column="id" />
<result property="username" column="username" />
<result property="password" column="password" />
<result property="age" column="age" />
<result property="email" column="email" />
</resultMap>
id –一个 ID 结果;标记出作为 ID 的结果可以帮助提高整体性能,一对多的查询中用于结果集合并；
result – 注入到字段或 JavaBean 属性的普通结果
column：对应表字段
property：对应java实体
association – 一个复杂类型的关联;许多结果将包装成这种类型。关联可以指定为一个 resultMap 元素，或者引用一个
collection – 一个复杂类型的集合
2022.06.09
mybatis-config.xml核心配置文件
1. 标签顺序
核心配置文件中的标签必须按照固定的顺序：
properties,
settings,
typeAliases,
typeHandlers,
objectFactory,
objectWrapperFactory,
reflectorFactory,
plugins,
environments,
databaseIdProvider,
mappers
2. properties
<!--引入properties文件，此时就可以${属性名}的方式访问属性值-->
<properties resource="jdbc.properties"></properties>
3. typeAliases
<typeAliases>
<!--
typeAlias：设置某个具体的类型的别名
属性：
type：需要设置别名的类型的全类名
alias：设置此类型的别名，若不设置此属性，该类型拥有默认的别名，即类名且不区分大小
写
若设置此属性，此时该类型的别名只能使用alias所设置的值
-->
<!--<typeAlias type="com.company.mybatis.bean.User"></typeAlias>-->
<!--<typeAlias type="com.company.mybatis.bean.User" alias="abc">-->
</typeAlias>
<!--以包为单位，设置改包下所有的类型都拥有默认的别名，即类名且不区分大小写-->
<typeAliases>
<package name="com.company.mybatis.bean"/>
</typeAliases>
4. environments
<!--
environments：设置多个连接数据库的环境
属性：
default：设置默认使用的环境的id
-->
<environments default="mysql_test">
<!--
environment：设置具体的连接数据库的环境信息
属性：
id：设置环境的唯一标识，可通过environments标签中的default设置某一个环境的id，
表示默认使用的环境
-->
<environment id="mysql_test">
<!--
transactionManager：设置事务管理方式
type：设置事务管理方式，type="JDBC|MANAGED"
type="JDBC"：设置当前环境的事务管理都必须手动处理
type="MANAGED"：设置事务被管理，例如spring中的AOP
-->
<transactionManager type="JDBC"/>
<!--
dataSource：设置数据源
属性：
type：设置数据源的类型，type="POOLED|UNPOOLED|JNDI"
type="POOLED"：使用数据库连接池，即会将创建的连接进行缓存，下次使用可以从
缓存中直接获取，不需要重新创建
type="UNPOOLED"：不使用数据库连接池，即每次使用连接都需要重新创建
type="JNDI"：调用上下文中的数据源
-->
<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>
5. mappers
<!--引入映射文件-->
<mappers>
<mapper resource="UserMapper.xml"/>
<!--
以包为单位，将包下所有的映射文件引入核心配置文件
注意：此方式必须保证mapper接口和mapper映射文件必须在相同的包下
-->
<package name="com.company.mybatis.mapper"/>
</mappers>
Idea中创建mybatis-config.xml模板文件
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configuration
PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration>
<!--1. 引入properties文件，此时就可以${属性名}的方式访问属性值-->
<properties resource=""></properties>
<!--2. 以包为单位，设置改包下所有的类型都拥有默认的别名，即类名且不区分大小写-->
<typeAliases>
<package name=""/>
</typeAliases>
<!-- 3. 数据库配置-->
<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>
<!-- 4. mapper映射文件-->
<mappers>
<package name=""/>
</mappers>
</configuration>
Idea中创建xxxMapper.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="">
</mapper>
Idea中创建log4j.xml模板文件
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE log4j:configuration SYSTEM "http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/xml/doc-files/log4j.dtd">
<log4j:configuration>
<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>
2022.06.11
单个字面量类型参数
// UserMapper.java
public interface UserMapper {
// 1. 单个字面量传参 int类型 查询 getUserById
User getUserById(int id);
// 1. 单个字面量传参 String类型 查询 getUserByName
User getUserByName(String username);
}
// UserMapper.xml
<!-- 1. 单个字面量传参 查询 getUserById-->
<select id="getUserById" resultType="user">
select *
from t_user
where id = #{id}
</select>
<!-- <select id="getUserById" resultType="user">-->
<!-- select *-->
<!-- from t_user-->
<!-- where id = ${id}-->
<!-- </select>-->
<!-- 1. 单个字面量传参 String类型 查询 getUserByName-->
<!-- <select id="getUserByName" resultType="user">-->
<!-- select *-->
<!-- from t_user-->
<!-- where username = #{username}-->
<!-- </select>-->
<select id="getUserByName" resultType="user">
select *
from t_user
where username = '${username}'
</select>
<select id="getUserByName" resultType="user">
select *
from t_user
where username = '${xxx}'
</select>
// test
User user = mapper.getUserById(1);
User user = mapper.getUserByName("李大爷");
System.out.println("单个字面量参数获取方式: " + user);
注意：
1. 当mapper接口中的方法参数为"单个"的字面量类型时，使用"#{}"或者"${}"均可
2. 切在#{}、${}中的参数名称可以以"任意名称"来获取,如上面的username可以用"xxx"获取
3. 但在使用${}时需要注意的时为String类型时需要主动加上单引号
4. #{}本质为占位符，而${}本质为字符串sql拼接
多个字面量类型的参数
// UserMapper.java
// 2. 多个字面量参数传参 查询 getUserByIdName
User getUserByIdName(int id, String username);
// UserMapper.xml
<!-- 2. 多个字面量参数传参 查询 getUserByIdName-->
<!-- <select id="getUserByIdName" resultType="user">-->
<!-- select *-->
<!-- from t_user-->
<!-- where id = #{arg0}-->
<!-- and username = #{arg1}-->
<!-- </select>-->
<select id="getUserByIdName" resultType="user">
select *
from t_user
where id = #{param1}
and username = '${param2}'
</select>
// test
User user = mapper.getUserByIdName(1, "李大爷");
System.out.println("多个字面量参数获取方式: " + user);
注意：
1. 当mapper接口中的方法参数为多个时，Mybatis会自动将这些参数放在一个map集合中，按照常规的写法我们不能直接用形参来获取对应值
2. 可以通过"arg0","arg1"...为键，真实的参数值为值来访问
也可以通过"param1","param2"...为键，真实的参数值为值来访问
3. 使用#{}或者${}均可以访问，但需要注意${}需要考虑是否手动添加单引号，如上
map类型的参数
基于上述多参数时，我们可以手动的构建一个Map集合在mapper接口方法
// UserMapper.java
// 3. map类型参数传参 查询 getUserByMap
User getUserByMap(Map<String,Object> userMap);
// UserMapper.xml
<!-- 3. map类型参数传参 查询 getUserByMap-->
<select id="getUserByMap" resultType="user">
select *
from t_user
where id = #{id}
and username = '${username}'
</select>
// test
Map<String, Object> userMap = new HashMap<>();
userMap.put("id",2);
userMap.put("username","李二爷");
User user = mapper.getUserByMap(userMap);
System.out.println("map类型参数获取方式: " + user);
注意：
1. 通过访问map集合的键就可以获取对应的值 如id,username
2. #{}、${}均可以使用，但仍需注意${}的单引号问题
实体类类型的参数
可以在mapper接口中方法传入实体类对象
// UserMapper.java
// 4. 实体类类型参数传参 插入 insertUserByPojo
int insertUserByPojo(User user);
// UserMapper.xml
<!-- 4. 实体类类型参数传参 插入 insertUserByPojo-->
<insert id="insertUserByPojo">
insert into t_user
values (null, #{username}, #{password}, #{sex}, #{age}, #{email})
</insert>
// test
User user = new User(null, "李四爷", "4", 24, "男", "4@qq.com");
int result = mapper.insertUserByPojo(user);
System.out.println("实体类型参数获取方式: " + result);
注意：
1. 通过访问实体类对象中的属性名来获取属性值
2. #{}、${}均可以使用，但仍需注意${}的单引号问题
使用@Param注解标识的参数
可以通过@Param注解标识mapper接口中的方法参数
// UserMapper.java
// 5. @Parma注解形参 查询 getUserByAnnoParam
User getUserByAnnoParam(@Param("id") int id, @Param("username") String username);
// UserMapper.xml
<!-- 5. @Parma注解形参 查询 getUserByAnnoParam-->
<!-- <select id="getUserByAnnoParam" resultType="user">-->
<!-- select *-->
<!-- from t_user-->
<!-- where id = #{id}-->
<!-- and username = '${username}'-->
<!-- </select>-->
<select id="getUserByAnnoParam" resultType="user">
select *
from t_user
where id = #{param1}
and username = '${username}'
</select>
// test
User user = mapper.getUserByAnnoParam(4, "李四爷");
System.out.println("注解形参参数获取方式: " + user);
注意：
1. 若使用了注解形参方式，Mybatis会将这些参数放在map集合中
2. 使用注解的value值来访问或者也可以使用param1...等来访问（注意区别多字面量参数方式）
3. #{}、${}均可以使用，但仍需注意${}的单引号问题
各种查询
1. 查询一个实体类对象
// UserMapper.java
User getUserById(@Param("id") int id);
2. 查询一个List集合
List<User> getUser();
3. 查询总数
int getUserCount();
其中在mapper.xml文件中，需要注意的是resultType的设置，比如查询所有用户，此时我们可以设置resultType="java.lang.Integer"
在Mybatis中，对于常用的类型它都给我们设置了类型别名，如：
java.lang.Integer -> int || integer
int -> _int || _integer
java.lang.Long -> Long
Map -> map
List -> list
4. 查询map
Map<String,Object> getUserByName();
此时resultType="map"
5. 查询多条数据为map集合
List<Map<String,Object>> getAllUser2Map();
此时resultType="map"
或者：
@MapKey("id")
Map<String,Object> getAllUser2Map();
此时resultType="map"
它将表中的数据以map集合的方式查询，一条数据对应一个map；若有多条数据，就会产生多个map集合，并
且最终要以一个map的方式返回数据，此时需要通过@MapKey注解设置map集合的键，值是每条数据所对应的
map集合
特殊SQL
1. 模糊查询
1.1 ${}方式
<select id="getUserSpecialByName" resultType="user">
select *
from t_user
where username like '%${username}%'
</select>
1.2 #{}方式
<select id="getUserSpecialByName" resultType="user">
select *
from t_user
where username like "%"#{username}"%"
</select>
注意是使用双引号来包括的%，而#{}占位符不需要
1.3 sql函数方式
<select id="getUserSpecialByName" resultType="user">
select *
from t_user
where username like concat('%', #{username}, '%')
</select>
注意此时百分号使用单双引号均可
2. 批量删除
使用mysql的in操作符实现
<delete id="deleteUserByIds">
delete
from t_user
where id in (${ids})
</delete>
注意此处使用的是${}来获取
3. 动态设置表名
<select id="getUserDynamicTableName" resultType="user">
select *
from ${tableName}
</select>
注意此处使用的是${}来获取
4. 自动获取自增主键
useGeneratedKeys：设置使用自增的主键
keyProperty: 因为增删改有统一的返回值是受影响的行数，因此只能将获取的自增的主键放在传输的参数user对象的某个属性中
<insert id="insertAutoSetPrimaryKey" useGeneratedKeys="true" keyProperty="id">
insert into t_user
values (null, #{username}, #{password}, #{sex}, #{age}, #{email})
</insert>
// console
自动设置主键前：User{id=null, username='李五爷', password='5', age=25, sex='女', email='5@qq.com'}
自动设置主键后：User{id=9, username='李五爷', password='5', age=25, sex='女', email='5@qq.com'}
2022.06.11
resultType与resultMap
1. resultType
当数据库表字段与java实体类属性一一对应时，我们只需设置resultType即可
2. resultMap
当数据库表字段与java实体类属性不能一一对应时，我们需要设置resultMap
通过sql别名满足字段与实体类映射
1. 未处理（其它能对应的字段有值，未对应的字段无值）
// CourseMapper.java
public interface CourseMapper {
// 通过sql 别名方式来处理处理字段名和实体类中的属性的映射关系 getAllCourse
List<Course> getAllCourse();
}
// CourseMapper.xml
<!-- 通过sql 别名方式来处理处理字段名和实体类中的属性的映射关系 getAllCourse-->
<select id="getAllCourse" resultType="course">
select tc.*
from t_courses tc
</select>
// test
List<Course> courseList = courseMapper.getAllCourse();
courseList.forEach(course -> System.out.println(course));
// console
Course{cid=1, courseName='null'}
Course{cid=2, courseName='null'}
2. 使用别名
// CourseMapper.xml
<select id="getAllCourse" resultType="course">
select tc.cid, tc.course_name as courseName
from t_courses tc
</select>
// console
Course{cid=1, courseName='chinese'}
Course{cid=2, courseName='english'}
开启Mybatis核心配置mapUnderscoreToCamelCase选项
针对这种下划线和驼峰，我们可以严格按照约定这样我们开启配置后，不用再使用别名
// mybatis-config.xml
<!-- 5. 核心配置项-->
<settings>
<!-- 5.1 开启将数据库表中字段名称中的下划线自动转换为驼峰格式-->
<setting name="mapUnderscoreToCamelCase" value="true"/>
</settings>
resultMap属性值及其作用
1. 属性说明
resultMap : 设置自定义映射
其属性：
id : 表示自定义映射的唯一标识(对应到select标签中的resultMap)
type ： 查询的数据要映射的"实体类的类型"
其子标签：
<id> : 设置主键的映射关系 （一般为数据库表主键字段）
<result> : 设置普通字段的映射关系
<association> : 设置多对一的映射关系
<collection> : 设置一对多的映射关系
其属性：
property : 设置映射关系中实体类中的属性名
column ： 设置映射关系中表中的字段名
2. 学生表和老师表 sql
CREATE DATABASE /*!32312 IF NOT EXISTS*/`mybatis` /*!40100 DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci */ /*!80016 DEFAULT ENCRYPTION='N' */;
USE `mybatis`;
/*Table structure for table `t_students` */
DROP TABLE IF EXISTS `t_students`;
CREATE TABLE `t_students` (
`sid` int NOT NULL AUTO_INCREMENT,
`student_name` varchar(20) COLLATE utf8mb4_general_ci DEFAULT NULL,
`student_age` int DEFAULT NULL,
`tid` int DEFAULT NULL,
PRIMARY KEY (`sid`)
) ENGINE=InnoDB AUTO_INCREMENT=7 DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci;
/*Data for the table `t_students` */
insert into `t_students`(`sid`,`student_name`,`student_age`,`tid`) values
(1,'Tom',20,1),
(2,'Jerry',21,2),
(3,'Bob',22,1),
(4,'Cindy',23,2),
(5,'Jake',24,3),
(6,'Oliver',25,3);
/*Table structure for table `t_teachers` */
DROP TABLE IF EXISTS `t_teachers`;
CREATE TABLE `t_teachers` (
`tid` int NOT NULL AUTO_INCREMENT,
`teacher_name` varchar(20) COLLATE utf8mb4_general_ci DEFAULT NULL,
PRIMARY KEY (`tid`)
) ENGINE=InnoDB AUTO_INCREMENT=4 DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci;
/*Data for the table `t_teachers` */
insert into `t_teachers`(`tid`,`teacher_name`) values
(1,'T1'),
(2,'T2'),
(3,'T3');
3. 实体类
// student.java
public class Student {
private Integer sid;
private String studentName;
private Integer studentAge;
// 多对一 用类型
private Teacher teacher;
public Student() {
}
public Student(Integer sid, String studentName, Integer studentAge) {
this.sid = sid;
this.studentName = studentName;
this.studentAge = studentAge;
}
public Integer getSid() {
return sid;
}
public void setSid(Integer sid) {
this.sid = sid;
}
public String getStudentName() {
return studentName;
}
public void setStudentName(String studentName) {
this.studentName = studentName;
}
public Integer getStudentAge() {
return studentAge;
}
public void setStudentAge(Integer studentAge) {
this.studentAge = studentAge;
}
@Override
public String toString() {
return "Student{" +
"sid=" + sid +
", studentName='" + studentName + '\'' +
", studentAge=" + studentAge +
", teacher=" + teacher +
'}';
}
}
// Teacher.java
public class Teacher {
private Integer tid;
private String teacherName;
// 一对多 使用集合
private List<Student> students;
public Teacher() {
}
public Teacher(Integer tid, String teacherName) {
this.tid = tid;
this.teacherName = teacherName;
}
public Integer getTid() {
return tid;
}
public void setTid(Integer tid) {
this.tid = tid;
}
public String getTeacherName() {
return teacherName;
}
@Override
public String toString() {
return "Teacher{" +
"tid=" + tid +
", teacherName='" + teacherName + '\'' +
", students=" + students +
'}';
}
public void setTeacherName(String teacherName) {
this.teacherName = teacherName;
}
}
多对一映射关系设置resultMap
1. 级联方式设置
// StudentMapper.java
// 查询Jerry学生及老师信息 getStudentAndTeacherByName
Student getStudentAndTeacherByName(@Param("studentName") String studentName);
// StudentMapper.xml
<resultMap id="stResultMap" type="Student">
<id property="sid" column="sid"/>
<result property="studentName" column="student_name"/>
<result property="studentAge" column="student_age"/>
<!-- 级联-->
<result property="teacher.tid" column="tid"/>
<result property="teacher.teacherName" column="teacher_name"/>
</resultMap>
<select id="getStudentAndTeacherByName" resultMap="stResultMap">
select *
from t_students ts
left join t_teachers tt on ts.tid = tt.tid
where ts.student_name = #{studentName}
</select>
注意级联主要体现在：
<result property="teacher.tid" column="tid"/>
<result property="teacher.teacherName" column="teacher_name"/>
private Teacher teacher; <!--实体类属性-->
1. 其中property设置为我们Student实体类中的teacher属性的子属性，如：teacher.tid,teacher.teacherName 而column属性设置为下面sql执行所查出的字段名，如：tid,teacher_name
2. 使用子标签association设置
// StudentMapper.xml
<resultMap id="stResultMap2" type="Student">
<id property="sid" column="sid"/>
<result property="studentName" column="student_name"/>
<result property="studentAge" column="student_age"/>
<!-- 子标签association -->
<association property="teacher" javaType="Teacher">
<id property="tid" column="tid"/>
<result property="teacherName" column="teacher_name"/>
</association>
</resultMap>
<select id="getStudentAndTeacherById" resultMap="stResultMap2">
select *
from t_students ts
left join t_teachers tt on ts.tid = tt.tid
where ts.sid = #{sid}
</select>
private Teacher teacher; <!--实体类属性-->
注意：
1. association标签中的property对应实体类中的属性名，如teacher（需要处理多对的映射关系的属性名），而设置的javaType则表示当前属性的实体类型，如Teacher （该属性的类型）
2. 而association标签中，就有点类似上面兄弟标签有id,有result，其中的property，column属性设置一样
3. 分布查询设置
目前两张表作关联能查询出学生及老师的信息，而分布查询就是将一个sql，拆分为两个独立的sql，一个通过条件查询出学生，而根据这个学生的tid再去查询出老师
// StudentMapper.xml
<!-- 第一步查询学生 -->
<resultMap id="stResultMap3" type="Student">
<id property="sid" column="sid"/>
<result property="studentName" column="student_name"/>
<result property="studentAge" column="student_age"/>
<!-- 分布设置 -->
<association property="teacher" select="com.home.mybatis.mapper.TeacherMapper.getTeacherById"
column="tid"></association>
</resultMap>
<select id="getStudentAndTeacherByAge" resultMap="stResultMap3">
select ts.*
from t_students ts
where ts.student_age = #{studentAge}
</select>
// TeacherMapper.xml
<!-- 第二步查询老师 -->
<resultMap id="ttResultMap" type="Teacher">
<id column="tid" property="tid"/>
<result column="teacher_name" property="teacherName"/>
</resultMap>
<select id="getTeacherById" resultMap="ttResultMap">
select tt.*
from t_teachers tt
where tt.tid = #{tid}
</select>
注意此时association标签所需要设置的属性：
1. property：ssociation标签中的"property"对应实体类中的属性名，如teacher（需要处理多对的映射关系的属性名）
2. select: 设置分步查询，查询某个属性的值的sql的标识（namespace.sqlId）
3. column: 将sql以及查询结果中的某个字段设置为分步查询的条件
4. fetchType: 当开启了全局的延迟加载之后，可通过此属性手动控制延迟加载的效果 lazy表示延迟加载，eager表示立即加载
3.1 分布查询中延迟加载
如目前我们有2个sql，但是当我们不开启延迟加载时，默认会执行所有sql即2次，当我们只需要获取结果集中的某个属性值，比如学生的名称，那么此时根本不需要去查找老师
// mybatis-config.xml
<!-- 5. 核心配置项-->
<settings>
<!-- 5.1 开启将数据库表中字段名称中的下划线自动转换为驼峰格式-->
<setting name="mapUnderscoreToCamelCase" value="false"/>
<!-- 5.2 开启延迟加载-->
<setting name="lazyLoadingEnabled" value="true"/>
</settings>
一对多映射关系设置resultMap
// 一对多 使用集合
private List<Student> students; <!--实体类属性-->
1. collection标签设置
// TeacherMapper.xml
<resultMap id="ttResultMap2" type="Teacher">
<id column="tid" property="tid"/>
<result column="teacher_name" property="teacherName"/>
<!-- 一对多-->
<collection property="students" ofType="Student">
<id column="sid" property="sid"/>
<result column="student_name" property="studentName"/>
<result column="student_age" property="studentAge"/>
</collection>
</resultMap>
<select id="getTeacherAndStudentByName" resultMap="ttResultMap2">
select tt.*, ts.*
from t_teachers tt
left join t_students ts on tt.tid = ts.tid
where tt.teacher_name = #{teacherName}
</select>
注意 collection标签属性：
1. property： 为当前实体类中的属性名，如students
2. ofType: 设置collection标签所处理的集合属性中存储数据的类型，如集合中为学生类Student
2. 分布查询设置（原理同上）
2022.06.12
动态SQL
动态sql是一种根据特定条件来"拼装"sql语句的功能，是为了解决拼接sql语句字符串的问题
if
if标签可以通过"test"属性的表达式进行判断，若为true，则拼接标签中的内容，反之不会拼接
<select id="xxx" resultType="Xxx">
select * from t_students where 1 = 1
<if test="studentName != null and studentName != ''">
and student_name = #{studentName}
-- student_name = #{studentName} and
</if>
<if test="studentAge != null and studentAge != ''">
and student_age = #{studentAge}
-- student_age = #{studentAge}
</if>
</select>
注意：
1. if标签中的"and"或者"or"关键字拼接在前面或者后面均可
2. 当studentName|studentAge均无时，此时只留下where，sql语法不通过，因此我们可以先在前面写上where 1 = 1让其能执行sql
where
由于在上面的where关键字后面我们手动的补充了1=1的条件，这样显的不是很优雅，因此还有<where>标签
<select id="xxx" resultType="Xxx">
select * from t_students
<where>
<if test="studentName != null and studentName != ''">
and student_name = #{studentName}
-- student_name = #{studentName} and
</if>
<if test="studentAge != null and studentAge != ''">
and student_age = #{studentAge}
-- student_age = #{studentAge} and
</if>
</where>
</select>
注意：
1. where标签一般和if标签一起结合使用
2. 若where标签中的if条件均不满足时，则Mybatis不会单独的将where关键字拼接在sql中
3. 若where标签中的if条件满足时，则Mybatis会自动的添加where关键字并将条件"最前方"多余的and|or去掉，如上面的 and student_name = #{studentName}中的and关键字
4. 特别需要注意：where标签不能自动的去掉条件后面的and|or 如上面的 -- student_name = #{studentName} and
5. 因此在写where&if时将拼接关键字写在条件的前方最好
trim
在上面使用where的过程中，我们建议把and|or写在条件的前方，因此Mybatis还提供了trim标签，配置合理后，写在前写在后均可,但需要我们在trim上设置对应的属性
<select id="xxx" resultType="Xxx">
select * from t_students
<trim prefix="where" suffixOverrides="and">
<if test="studentName != null and studentName != ''">
-- and student_name = #{studentName}
student_name = #{studentName} and
</if>
<if test="studentAge != null and studentAge != ''">
-- and student_age = #{studentAge}
student_age = #{studentAge}
</if>
</where>
</select>
注意：
1. trim标签的作用是：用来"去掉"或者"添加"标签中的内容
2. prefix: 在"trim"标签中的内容"前方"添加指定内容
如上面prefix="where"在前面添加指定的where关键字
suffix: 在"trim"标签中的内容"后方"添加指定内容
prefixOverrides: 在"trim"标签中的内容"前方"去掉指定内容
suffixOverrides: 在"trim"标签中的内容"后方"去掉指定内容
如上面的suffixOverrides="and"，若无studentAge，则去掉studentName后面多出来的and关键字
choose\when\otherwise
choose、when、otherwise相当于if...else if..else | choose标签中的内容只会执行(拼接)一个条件
<select id="xxx" resultType="Xxx">
select * from t_students
<where>
<choose>
<when test="studentName != null and studentName != ''">
student_name = #{studentName}
</when>
<when test="studentAge != null and studentAge != ''">
student_age = #{studentAge}
</when>
<otherwise>
sid = 1
</otherwise>
</choose>
</where>
</select>
注意：
1. choose类似父级根标签，无属性设置
2. when标签同if标签 需要test属性表达式
3. 整套choose标签最终返回1个sql片段作为拼接
4. when标签最小1个，而otherwise标签最多1个
foreach
循环遍历生成需要拼接的sql片段，一般多用于批量删除，或者批量插入中
1. 批量删除
1.1 in关键字写法
<delete id="xxx">
delete from t_students where sid
in
<foreach collection="sids" item="sid" separator"," open="(" close = ")"> #{sid}
</foreach>
</delete>
1.2 or关键字写法
<delete id="xxx">
delete from t_students where
<foreach collection="sids" item="sid" separator"or"> sid = #{sid}
</foreach>
</delete>
2. 批量插入
<insert id="xxx">
insert into t_students values
<foreach collection="students" item="student" separator=",">
(null,#{student.studentName},#{student.studentAge})
</foreach>
</insert>
注意：
1. collection： 设置要遍历的数组或者集合
若没使用@Param注解指定参数，则数组对应array,而List集合对应list
若设置了注解，则使用注解参数，若上面的 sids
2. item: 数组或者集合中的每项
3. separator: 设置每个循环体之间的分割符，若上面的逗号分隔
4. open：设置foreach标签内容的开始符，如上面的in后面跟括号
5. close: 设置foreach标签内容的结束符
sql片段
记录一段公共的sql片段，在需要使用的地方使用include标签进行引入
<sql id="commonSql">
sid, student_name, student_age, tid
</sql>
<select id="xxx" resultType="Student">
select
<include refid="commonSql"/>
from
t_students
</select>
2022.06.13
一级缓存
一级缓存是SqlSession级别的，通过同一个SqlSession查询的数据会被缓存，下次查询相同的数据，就
会从缓存中直接获取，不会从数据库重新访问
使一级缓存失效的四种情况：
1) 不同的SqlSession对应不同的一级缓存
2) 同一个SqlSession但是查询条件不同
3) 同一个SqlSession两次查询期间执行了任何一次增删改操作
4) 同一个SqlSession两次查询期间手动清空了缓存
二级缓存
二级缓存是SqlSessionFactory级别，通过同一个SqlSessionFactory创建的SqlSession查询的结果会被
缓存；此后若再次执行相同的查询语句，结果就会从缓存中获取
二级缓存开启的条件：
a>在核心配置文件中，设置全局配置属性cacheEnabled="true"，默认为true，不需要设置
b>在映射文件中设置标签<cache />
c>二级缓存必须在SqlSession关闭或提交之后有效
d>查询的数据所转换的实体类类型必须实现序列化的接口
使二级缓存失效的情况：
两次查询之间执行了任意的增删改，会使一级和二级缓存同时失效
二级缓存配置
在mapper配置文件中添加的cache标签可以设置一些属性：
eviction属性：缓存回收策略
LRU（Least Recently Used） – 最近最少使用的：移除最长时间不被使用的对象。
FIFO（First in First out） – 先进先出：按对象进入缓存的顺序来移除它们。
SOFT – 软引用：移除基于垃圾回收器状态和软引用规则的对象。
WEAK – 弱引用：更积极地移除基于垃圾收集器状态和弱引用规则的对象。
默认的是 LRU。
flushInterval属性：刷新间隔，单位毫秒
默认情况是不设置，也就是没有刷新间隔，缓存仅仅调用语句时刷新
size属性：引用数目，正整数
代表缓存最多可以存储多少个对象，太大容易导致内存溢出
readOnly属性：只读，true/false
true：只读缓存；会给所有调用者返回缓存对象的相同实例。因此这些对象不能被修改。这提供了
很重要的性能优势。
false：读写缓存；会返回缓存对象的拷贝（通过序列化）。这会慢一些，但是安全，因此默认是
false。
缓存查询的顺序
先查询二级缓存，因为二级缓存中可能会有其他程序已经查出来的数据，可以拿来直接使用。
如果二级缓存没有命中，再查询一级缓存
如果一级缓存也没有命中，则查询数据库
SqlSession关闭之后，一级缓存中的数据会写入二级缓存
Mybatis逆向工程
正向工程：先创建Java实体类，由框架负责根据实体类生成数据库表。Hibernate是支持正向工程
的。
逆向工程：先创建数据库表，由框架负责根据数据库表，反向生成如下资源：
Java实体类
Mapper接口
Mapper映射文件
1. 添加依赖和插件
<!-- 依赖MyBatis核心包 -->
<dependencies>
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.5.7</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>5.1.8</version>
</dependency>
</dependencies>
</plugin>
</plugins>
</build>
2. 创建逆向工程的配置文件
// generatorConfig.xml
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE generatorConfiguration
d>执行MBG插件的generate目标
效果：
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.jdbc.Driver"
connectionURL="jdbc:mysql://localhost:3306/mybatis"
userId="root"
password="123456">
</jdbcConnection>
<!-- javaBean的生成策略-->
<javaModelGenerator targetPackage="com.atguigu.mybatis.bean"
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>
3. QBC查询
@Test
public void testMBG() throws IOException {
InputStream is = Resources.getResourceAsStream("mybatis-config.xml");
SqlSession sqlSession = new
SqlSessionFactoryBuilder().build(is).openSession(true);
EmpMapper mapper = sqlSession.getMapper(EmpMapper.class);
EmpExample empExample = new EmpExample();
//创建条件对象，通过andXXX方法为SQL添加查询添加，每个条件之间是and关系
empExample.createCriteria().andEnameLike("a").andAgeGreaterThan(20).andDidIsNot
Null();
//将之前添加的条件通过or拼接其他条件
empExample.or().andSexEqualTo("男");
List<Emp> list = mapper.selectByExample(empExample);
for (Emp emp : list) {
System.out.println(emp);
}
}
分页插件
1. 添加依赖
<!-- https://mvnrepository.com/artifact/com.github.pagehelper/pagehelper -->
<dependency>
<groupId>com.github.pagehelper</groupId>
<artifactId>pagehelper</artifactId>
<version>5.2.0</version>
</dependency>
2. 配置分页插件
// mybatis-config.xml
<plugins>
<!--设置分页插件-->
<plugin interceptor="com.github.pagehelper.PageInterceptor"></plugin>
</plugins>
3. 如何使用
3.1 在查询功能之前使用PageHelper.startPage(int pageNum, int pageSize)开启分页功能
pageNum：当前页的页码 pageSize：每页显示的条数
3.2 在查询获取list集合之后，使用PageInfo<T> pageInfo = new PageInfo<>(List<T> list, int navigatePages)获取分页相关数据
list：分页之后的数据 navigatePages：导航分页的页码数
3.3 pageNum：当前页的页码
pageSize：每页显示的条数
size：当前页显示的真实条数
total：总记录数
pages：总页数
prePage：上一页的页码
nextPage：下一页的页码
isFirstPage/isLastPage：是否为第一页/最后一页
hasPreviousPage/hasNextPage：是否存在上一页/下一页
navigatePages：导航分页的页码数
navigatepageNums：导航分页的页码，[1,2,3,4,5]
276
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
