MyBatis

1. 配置

1.1 SQL脚本

/*
 Navicat Premium Data Transfer

 Source Server         : MySQL8
 Source Server Type    : MySQL
 Source Server Version : 80033 (8.0.33)
 Source Host           : localhost:3308
 Source Schema         : ssm

 Target Server Type    : MySQL
 Target Server Version : 80033 (8.0.33)
 File Encoding         : 65001

 Date: 04/07/2023 01:23:12
*/

SET NAMES utf8mb4;
SET FOREIGN_KEY_CHECKS = 0;

-- ----------------------------
-- Table structure for t_dept
-- ----------------------------
DROP TABLE IF EXISTS `t_dept`;
CREATE TABLE `t_dept`  (
  `dept_id` int NOT NULL AUTO_INCREMENT,
  `dept_name` varchar(20) CHARACTER SET utf8mb3 COLLATE utf8mb3_general_ci NULL DEFAULT NULL,
  PRIMARY KEY (`dept_id`) USING BTREE
) ENGINE = InnoDB AUTO_INCREMENT = 4 CHARACTER SET = utf8mb3 COLLATE = utf8mb3_general_ci ROW_FORMAT = Dynamic;

-- ----------------------------
-- Table structure for t_emp
-- ----------------------------
DROP TABLE IF EXISTS `t_emp`;
CREATE TABLE `t_emp`  (
  `emp_id` int NOT NULL AUTO_INCREMENT,
  `emp_name` varchar(20) CHARACTER SET utf8mb3 COLLATE utf8mb3_general_ci NULL DEFAULT NULL,
  `age` int NULL DEFAULT NULL,
  `gender` char(1) CHARACTER SET utf8mb3 COLLATE utf8mb3_general_ci NULL DEFAULT NULL,
  `dept_id` int NULL DEFAULT NULL,
  PRIMARY KEY (`emp_id`) USING BTREE
) ENGINE = InnoDB AUTO_INCREMENT = 5 CHARACTER SET = utf8mb3 COLLATE = utf8mb3_general_ci ROW_FORMAT = Dynamic;

-- ----------------------------
-- Table structure for t_user
-- ----------------------------
DROP TABLE IF EXISTS `t_user`;
CREATE TABLE `t_user`  (
  `id` int NOT NULL AUTO_INCREMENT,
  `username` varchar(20) CHARACTER SET utf8mb3 COLLATE utf8mb3_general_ci NULL DEFAULT NULL,
  `password` varchar(20) CHARACTER SET utf8mb3 COLLATE utf8mb3_general_ci NULL DEFAULT NULL,
  `age` int NULL DEFAULT NULL,
  `gender` char(1) CHARACTER SET utf8mb3 COLLATE utf8mb3_general_ci NULL DEFAULT NULL,
  `email` varchar(50) CHARACTER SET utf8mb3 COLLATE utf8mb3_general_ci NULL DEFAULT NULL,
  PRIMARY KEY (`id`) USING BTREE
) ENGINE = InnoDB AUTO_INCREMENT = 6 CHARACTER SET = utf8mb3 COLLATE = utf8mb3_general_ci ROW_FORMAT = Dynamic;

SET FOREIGN_KEY_CHECKS = 1;

1.2 引入依赖

		<dependency>
			<groupId>org.projectlombok</groupId>
			<artifactId>lombok</artifactId>
			<version>1.18.20</version>
		</dependency>
		<!-- 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.16</version>
		</dependency>
		<!-- log4j日志 -->
		<dependency>
			<groupId>log4j</groupId>
			<artifactId>log4j</artifactId>
			<version>1.2.17</version>
		</dependency>

1.3 核心配置文件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>

	<!--
		MyBatis核心配置文件中的标签必须要按照指定的顺序配置：
		properties?,settings?,typeAliases?,typeHandlers?,
		objectFactory?,objectWrapperFactory?,reflectorFactory?,
		plugins?,environments?,databaseIdProvider?,mappers?
	-->

	<!--引入properties文件，此后就可以在当前文件中使用${key}的方式访问value-->
	<properties resource="jdbc.properties"/>

	<!--
		typeAliases：设置类型别名，即为某个具体的类型设置一个别名
		在MyBatis的范围中，就可以使用别名表示一个具体的类型
	-->
	<typeAliases>
		<!--
			type：设置需要起别名的类型
			alias：设置某个类型的别名
		-->
		<!--<typeAlias type="com.nick.mybatis.pojo.User" alias="abc"></typeAlias>-->
		<!--若不设置alias，当前的类型拥有默认的别名，即类名且不区分大小写-->
		<!--<typeAlias type="com.nick.mybatis.pojo.User"></typeAlias>-->
		<!--通过包设置类型别名，指定包下所有的类型将全部拥有默认的别名，即类名且不区分大小写-->
		<package name="com.nick.mybatis.pojo"/>
	</typeAliases>

	<!--
		environments：配置连接数据库的环境
		属性：
		default：设置默认使用的环境的id
	-->
	<environments default="development">
		<!--
			environment：设置一个具体的连接数据库的环境
			属性：
			id：设置环境的唯一标识，不能重复
		-->
		<environment id="development">
			<!--
				transactionManager：设置事务管理器
				属性：
				type：设置事务管理的方式
				type="JDBC|MANAGED"
				JDBC：表示使用JDBC中原生的事务管理方式
				MANAGED：被管理，例如Spring
			-->
			<transactionManager type="JDBC"/>
			<!--
				dataSource：设置数据源
				属性：
				type：设置数据源的类型
				type="POOLED|UNPOOLED|JNDI"
				POOLED：表示使用数据库连接池
				UNPOOLED：表示不使用数据库连接池
				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>

	<!--引入mybatis的映射文件-->
	<mappers>
		<!--<mapper resource="mappers/UserMapper.xml"/>-->
		<!--
			以包的方式引入映射文件，但是必须满足两个条件：
			1、mapper接口和映射文件所在的包必须一致
			2、mapper接口的名字和映射文件的名字必须一致
		-->
		<package name="com.nick.mybatis.mapper"/>
	</mappers>
</configuration>

1.4 映射文件配置

<?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.nick.mybatis.mapper.UserMapper">
	<!--
        mapper接口和映射文件要保证两个一致：
        1、mapper接口的全类名和映射文件的namespace一致
        2、mapper接口中的方法的方法名要和映射文件中的sql的id保持一致
    -->

	<!--int insertUser();-->
	<insert id="insertUser">
		insert into t_user
		values (null, 'admin', '123456', 23, '男', '12345@qq.com')
	</insert>

	<!--User getUserById();-->
	<!--
        resultType：设置结果类型，即查询的数据要转换为的java类型,
					自动映射，用于属性名和表中字段名一致的情况
        resultMap：自定义映射，处理多对一或一对多或字段名和属性名不一致的情况的映射关系
    -->
	<select id="getUserById" resultType="com.nick.mybatis.pojo.User">
		select *
		from t_user
		where id = 1
	</select>

	<!--	List<User> getAllUser();-->
	<!--	注意,resultType-->
	<select id="getAllUser" resultType="User">
		select *
		from t_user
	</select>
</mapper>

1.5 用户接口

public interface UserMapper {
	/**
	 * 添加用户信息
	 */
	int insertUser();

	/**
	 * 根据id查询用户信息
	 *
	 * @return
	 */
	User getUserById();

	/**
	 * 查询所有的用户信息
	 *
	 * @return
	 */
	List<User> getAllUser();
}

1.6 测试

public class MyBatisTest {

	@Test
	public void testInsert() throws IOException {
		// 获取核心配置文件的输入流
		InputStream is = Resources.getResourceAsStream("mybatis-config.xml");
		// 获取SqlSessionFactoryBuilder对象
		SqlSessionFactoryBuilder builder = new SqlSessionFactoryBuilder();
		// 获取SqlSessionFactory对象
		SqlSessionFactory factory = builder.build(is);
		// 获取sql的会话对象SqlSession(不会自动提交事务)，是MyBatis提供的操作数据库的对象
		SqlSession sqlSession = factory.openSession();
		// 获取sql的会话对象SqlSession(会自动提交事务)，是MyBatis提供的操作数据库的对象
		// SqlSession sqlSession = factory.openSession(true);
		// 获取UserMapper的代理实现类对象
		UserMapper mapper = sqlSession.getMapper(UserMapper.class);
		// 调用mapper接口中的方法，实现添加用户信息的功能
		int result = mapper.insertUser();
		// 提供sql以及的唯一标识找到sql并执行，唯一标识是namespace.sqlId
		// int result = sqlSession.insert("com.nick.mybatis.mapper.UserMapper.insertUser");
		System.out.println("结果: " + result);
		// 提交事务
		sqlSession.commit();
		// 关闭SqlSession
		sqlSession.close();
	}

	@Test
	public void testGetUserById() {
		SqlSession sqlSession = SqlSessionUtil.getSqlSession();
		UserMapper mapper = sqlSession.getMapper(UserMapper.class);
		User user = mapper.getUserById();
		System.out.println(user);
	}

	@Test
	public void testGetAllUser() {
		SqlSession sqlSession = SqlSessionUtil.getSqlSession();
		UserMapper mapper = sqlSession.getMapper(UserMapper.class);
		List<User> list = mapper.getAllUser();
		list.forEach(System.out::println);
	}
}

1.7 jdbc.properties

jdbc.driver=com.mysql.cj.jdbc.Driver
jdbc.url=jdbc:mysql://localhost:3308/ssm?serverTimezone=UTC
jdbc.username=root
jdbc.password=1234

1.8 日志log4j.xml

日志级别日志的级别😊 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>

1.9 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>

	<!--
		MyBatis核心配置文件中的标签必须要按照指定的顺序配置：
		properties?,settings?,typeAliases?,typeHandlers?,
		objectFactory?,objectWrapperFactory?,reflectorFactory?,
		plugins?,environments?,databaseIdProvider?,mappers?
	-->

	<!--引入properties文件，此后就可以在当前文件中使用${key}的方式访问value-->
	<properties resource="jdbc.properties"/>

	<typeAliases>
		<!--通过包设置类型别名，指定包下所有的类型将全部拥有默认的别名，即类名且不区分大小写-->
		<package name=""/>
	</typeAliases>

	<!--
		environments：配置连接数据库的环境
		属性：
		default：设置默认使用的环境的id
	-->
	<environments default="development">
		<environment id="development">
			<!--
				transactionManager：设置事务管理器
				属性：
				type：设置事务管理的方式
				type="JDBC|MANAGED"
				JDBC：表示使用JDBC中原生的事务管理方式
				MANAGED：被管理，例如Spring
			-->
			<transactionManager type="JDBC"/>
			<!--
				dataSource：设置数据源
				属性：
				type：设置数据源的类型
				type="POOLED|UNPOOLED|JNDI"
				POOLED：表示使用数据库连接池
				UNPOOLED：表示不使用数据库连接池
				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>

	<!--引入mybatis的映射文件-->
	<mappers>
		<!--
			以包的方式引入映射文件，但是必须满足两个条件：
			1、mapper接口和映射文件所在的包必须一致
			2、mapper接口的名字和映射文件的名字必须一致
		-->
		<package name=""/>
	</mappers>
</configuration>

1.10 mybatis-mapper模板

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper
		PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
		"http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="">

</mapper>

2. MyBatis各种查询与更新

2.1 ${}和#{}

2.1.1 查询一个实体类对象

${}的本质就是字符串拼接，#{}的本质就是占位符赋值
${}使用字符串拼接的方式拼接sql，若为字符串类型或日期类型的字段进行赋值时，需要手动加单引号
#{}使用占位符赋值的方式拼接sql，此时为字符串类型或日期类型的字段进行赋值时，可以自动添加单引号

	<!--User getUserByUsername(String username);-->
	<select id="getUserByUsername" resultType="User">
		<!--select * from t_user where username = #{username}-->
		select * from t_user where username = '${username}'
	</select>

	<!--User checkLogin(String username, String password);-->
	<select id="checkLogin" resultType="User">
		<!--select * from t_user where username = #{param1} and password = #{param2}-->
		select * from t_user where username = '${param1}' and password = '${param2}'
	</select>

	<!--User checkLoginByMap(Map<String, Object> map);-->
	<select id="checkLoginByMap" resultType="User">
		select *
		from t_user
		where username = #{username}
		  and password = #{password}
	</select>

	<!--void insertUser(User user);-->
	<insert id="insertUser">
		insert into t_user
		values (null, #{username}, #{password}, #{age}, #{gender}, #{email})
	</insert>

	<!--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>

若mapper接口方法的参数为单个的字面量类型此时可以通过#{}和 ${}以任意的内容获取参数值，一定要注意$ {}的单引号问题
若mapper接口方法的参数为多个的字面量类型

此时MyBatis会将参数放在map集合中，以两种方式存储数据 a>以arg0,arg1...为键，以参数为值 b>以param1,param2...为键，以参数为值因此，只需要通过#{}和 ${}访问map集合的键，就可以获取相对应的值,一定要注意$ {}的单引号问题
若mapper接口方法的参数为map集合类型的参数只需要通过#{}和 ${}访问map集合的键，就可以获取相对应的值,一定要注意$ {}的单引号问题
若mapper接口方法的参数为实体类类型的参数只需要通过#{}和 ${}访问实体类中的属性名，就可以获取相对应的属性值，一定要注意$ {}的单引号问题
可以在mapper接口方法的参数上设置@Param注解

此时MyBatis会将这些参数放在map中，以两种方式进行存储 a>以@Param注解的value属性值为键，以参数为值 b>以param1,param2...为键，以参数为值只需要通过#{}和 ${}访问map集合的键，就可以获取相对应的值,一定要注意$ {}的单引号问题

2.1.2 查询单行单列与map集合

	<!--User getUserById(@Param("id") Integer id);-->
	<select id="getUserById" resultType="User">
		select *
		from t_user
		where id = #{id}
	</select>

	<!--List<User> getAllUser();-->
	<select id="getAllUser" resultType="User">
		select *
		from t_user
	</select>

	<!--Integer getCount();-->
	<!--
		MyBatis中为Java中常用的类型设置了类型别名
		Integer：Integer，int
		int：_int,_integer
		Map：map
		String：string
	-->
	<select id="getCount" resultType="int">
		select count(*)
		from t_user
	</select>

	<!--Map<String, Object> getUserByIdToMap(@Param("id") Integer id);-->
	<select id="getUserByIdToMap" resultType="map">
		select *
		from t_user
		where id = #{id}
	</select>

	<!--Map<String, Object> getAllUserToMap();-->
	<select id="getAllUserToMap" resultType="map">
		select *
		from t_user
	</select>

若sql语句查询的结果为多条时，一定不能以实体类类型作为方法的返回值

否则会抛出异常TooManyResultsException
若sql语句查询的结果为1条时，此时可以使用实体类类型或list集合类型作为方法的返回值
查询所有的用户信息为map集合若查询的数据有多条时，并且要将每条数据转换为map集合此时有两种解决方案： 1、将mapper接口方法的返回值设置为泛型是map的list集合 List<Map<String, Object>> getAllUserToMap(); 结果：{password=123456, gender=男, id=1, age=23, email=12345@qq.com, username=admin},{password= 2、可以将每条数据转换的map集合放在一个大的map中，但是必须要通过@MapKey注解将查询的某个字段的值作为大的map的键 @MapKey("id") Map<String, Object> getAllUserToMap(); 结果： { 1={password=123456, gender=男, id=1, age=23, email=12345@qq.com, username=admin}, 2={password=123, gender=男, id=2, age=23, email=12345@qq.com, username=zhangsan}, 3={password=123456, gender=女, id=3, age=33, email=123@qq.com, username=root}, 4={password=123, id=4, username=lisi} }

2.2 特殊SQL

2.2.1 模糊查询,批量删除,动态设置表名,返回自增主键

	<!--List<User> getUserByLike(@Param("mohu") String mohu);-->
	<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>

	<!--void deleteMoreUser(@Param("ids") String ids);//ids:9,10-->
	<delete id="deleteMoreUser">
		delete
		from t_user
		where id in (${ids})
	</delete>

	<!--List<User> getUserList(@Param("tableName") String tableName);-->
	<select id="getUserList" resultType="User">
		select *
		from ${tableName}
	</select>

	<!--void insertUser(User user);-->
	<!--
		useGeneratedKeys:表示当前添加功能使用自增的主键
		keyProperty:将添加的数据的自增主键为实体类类型的参数的属性赋值
	-->
	<insert id="insertUser" useGeneratedKeys="true" keyProperty="id">
		insert into t_user
		values (null, #{username}, #{password}, #{age}, #{gender}, #{email})
	</insert>

2.3 自定义映射resultMap

字段名和属性名不一致的情况，如何处理映射关系?

为查询的字段设置别名，和属性名保持一致
当字段符合MySQL的要求使用_，而属性符合java的要求使用驼峰此时可以在MyBatis的核心配置文件中设置一个全局配置，可以自动将下划线映射为驼峰 emp_id:empId,emp_name:empName
使用resultMap自定义映射处理

<!--    核心配置文件加上-->
<settings>
	<!--将下划线映射为驼峰-->
	<setting name="mapUnderscoreToCamelCase" value="true"/>
	<!--开启延迟加载-->
	<setting name="lazyLoadingEnabled" value="true"/>
	<!--按需加载-->
	<setting name="aggressiveLazyLoading" value="false"/>
</settings>

2.3.1 多对一映射

在多里面注入对象

级联方式处理
association
分步查询

		<!--	自定义映射-->
	<!--
		resultMap：设置自定义的映射关系
		id：唯一标识
		type：处理映射关系的实体类的类型
		常用的标签：
			id：处理主键和实体类中属性的映射关系
			result：处理普通字段和实体类中属性的映射关系
			association：处理多对一的映射关系（处理实体类类型的属性）
			column：设置映射关系中的字段名，必须是sql查询出的某个字段
			property：设置映射关系中的属性的属性名，必须是处理的实体类类型中的属性名
	-->
	<resultMap id="empResultMap" type="Emp">
		<id column="emp_id" property="empId"></id>
		<result column="emp_name" property="empName"></result>
		<result column="age" property="age"></result>
		<result column="gender" property="gender"></result>
	</resultMap>

	<!--Emp getEmpByEmpId(@Param("empId") Integer empId);-->
	<select id="getEmpByEmpId" resultMap="empResultMap">
		select *
		from t_emp
		where emp_id = #{empId}
	</select>

	<!--	为查询字段设置别名-->
	<select id="getEmpByEmpIdOld" resultType="Emp">
		<!--select emp_id empId,emp_name empName,age,gender from t_emp where emp_id = #{empId}-->
		select * from t_emp where emp_id = #{empId}
	</select>

	<!--	自定义映射三种方式-->
	<!--	1. 级联方式-->
	<resultMap id="empAndDeptResultMapOne" type="Emp">
		<id column="emp_id" property="empId"></id>
		<result column="emp_name" property="empName"></result>
		<result column="age" property="age"></result>
		<result column="gender" property="gender"></result>
		<result column="dept_id" property="dept.deptId"></result>
		<result column="dept_name" property="dept.deptName"></result>
	</resultMap>

	<!--	2. association-->
	<resultMap id="empAndDeptResultMap" type="Emp">
		<id column="emp_id" property="empId"></id>
		<result column="emp_name" property="empName"></result>
		<result column="age" property="age"></result>
		<result column="gender" property="gender"></result>
		<!--
			association：处理多对一的映射关系（处理实体类类型的属性）
			property：设置需要处理映射关系的属性的属性名
			javaType：设置要处理的属性的类型
		-->
		<association property="dept" javaType="Dept">
			<id column="dept_id" property="deptId"></id>
			<result column="dept_name" property="deptName"></result>
		</association>
	</resultMap>

	<!--Emp getEmpAndDeptByEmpId(@Param("empId") Integer empId);-->
	<select id="getEmpAndDeptByEmpId" resultMap="empAndDeptResultMap">
		select t_emp.*,
		       t_dept.*
		from t_emp
			     left join t_dept
			               on t_emp.dept_id = t_dept.dept_id
		where t_emp.emp_id = #{empId}
	</select>

	<!--	3. 分步查询-->
	<resultMap id="empAndDeptByStepResultMap" type="Emp">
		<id column="emp_id" property="empId"></id>
		<result column="emp_name" property="empName"></result>
		<result column="age" property="age"></result>
		<result column="gender" property="gender"></result>
		<!--
			property：设置需要处理映射关系的属性的属性名
			select：设置分步查询的sql的唯一标识
			column：将查询出的某个字段作为分步查询的sql的条件
			fetchType：在开启了延迟加载的环境中，通过该属性设置当前的分步查询是否使用延迟加载
			fetchType="eager(立即加载)|lazy(延迟加载)"
		-->
		<association property="dept" fetchType="eager"
		             select="com.nick.mybatis.mapper.DeptMapper.getEmpAndDeptByStepTwo"
		             column="dept_id"></association>
	</resultMap>

	<!--Dept getEmpAndDeptByStepTwo(@Param("deptId") Integer deptId);-->
	<select id="getEmpAndDeptByStepTwo" resultType="Dept">
		select *
		from t_dept
		where dept_id = #{deptId}
	</select>

	<!--Emp getEmpAndDeptByStepOne(@Param("empId") Integer empId);-->
	<select id="getEmpAndDeptByStepOne" resultMap="empAndDeptByStepResultMap">
		select *
		from t_emp
		where emp_id = #{empId}
	</select>

2.3.2 多对一映射模板

<?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="">

	<resultMap id="" type="">
		<id column="" property=""></id>
		<result column="" property=""></result>
		<!--
				property：设置需要处理映射关系的属性的属性名
				select：设置分步查询的sql的唯一标识
				column：将查询出的某个字段作为分步查询的sql的条件
				fetchType：在开启了延迟加载的环境中，通过该属性设置当前的分步查询是否使用延迟加载
				fetchType="eager(立即加载)|lazy(延迟加载)"
			-->
		<association property="" fetchType=""
		             select=""
		             column="">
		</association>
	</resultMap>

	<select id="" resultMap="">

	</select>
</mapper>

2.3.3 一对多关系映射

在一里面注入集合存储对象

collection
分步查询

	<!--	collection：处理一对多的映射关系（处理集合类型的属性）-->
	<!--	1.collection-->
	<resultMap id="deptAndEmpResultMap" type="Dept">
		<id column="dept_id" property="deptId"></id>
		<result column="dept_name" property="deptName"></result>
		<!--
			ofType：设置集合类型的属性中存储的数据的类型
		-->
		<collection property="emps" ofType="Emp">
			<id column="emp_id" property="empId"></id>
			<result column="emp_name" property="empName"></result>
			<result column="age" property="age"></result>
			<result column="gender" property="gender"></result>
		</collection>
	</resultMap>

	<!--Dept getDeptAndEmpByDeptId(@Param("deptId") Integer deptId);-->
	<select id="getDeptAndEmpByDeptId" resultMap="deptAndEmpResultMap">
		SELECT *
		FROM t_dept
			     LEFT JOIN t_emp
			               ON t_dept.dept_id = t_emp.dept_id
		WHERE t_dept.dept_id = #{deptId}
	</select>

	<!--	2.分步查询-->
	<resultMap id="deptAndEmpResultMapByStep" type="Dept">
		<id column="dept_id" property="deptId"></id>
		<result column="dept_name" property="deptName"></result>
		<collection property="emps"
		            select="com.nick.mybatis.mapper.EmpMapper.getDeptAndEmpByStepTwo"
		            column="dept_id"></collection>
	</resultMap>

	<!--List<Emp> getDeptAndEmpByStepTwo(@Param("deptId") Integer deptId);-->
	<select id="getDeptAndEmpByStepTwo" resultType="Emp">
		select *
		from t_emp
		where dept_id = #{deptId}
	</select>

	<!--Dept getDeptAndEmpByStepOne(@Param("deptId") Integer deptId);-->
	<select id="getDeptAndEmpByStepOne" resultMap="deptAndEmpResultMapByStep">
		select *
		from t_dept
		where dept_id = #{deptId}
	</select>

2.3.4 一对多映射模板

<?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="">

	<resultMap id="" type="">
		<id column="" property=""></id>
		<result column="" property=""></result>
		<!--
				property：设置需要处理映射关系的属性的属性名
				select：设置分步查询的sql的唯一标识
				column：将查询出的某个字段作为分步查询的sql的条件
				fetchType：在开启了延迟加载的环境中，通过该属性设置当前的分步查询是否使用延迟加载
				fetchType="eager(立即加载)|lazy(延迟加载)"
			-->
		<collection property="" fetchType=""
		            select=""
		            column=""></collection>
	</resultMap>
	
	<select id="" resultMap="">
		
	</select>
</mapper>

2.4 动态SQL

if，通过test属性中的表达式判断标签中的内容是否有效（是否会拼接到sql中）
where a.若where标签中有条件成立，会自动生成where关键字 b.会自动将where标签中内容前多余的and去掉，但是其中内容后多余的and无法去掉 c.若where标签中没有任何一个条件成立，则where没有任何功能
trim prefix、suffix：在标签中内容前面或后面添加指定内容 prefixOverrides、suffixOverrides：在标签中内容前面或后面去掉指定内容
choose、when、otherwise 相当于java中的if...else if...else when至少设置一个，otherwise最多设置一个
foreach collection：设置要循环的数组或集合 item：用一个字符串表示数组或集合中的每一个数据 separator：设置每次循环的数据之间的分隔符 open：循环的所有内容以什么开始 close：循环的所有内容以什么结束
sql片段可以记录一段sql，在需要用的地方使用include标签进行引用 emp_id,emp_name,age,gender,dept_id

	<sql id="empColumns">
		emp_id
		,emp_name,age,gender,dept_id
	</sql>

	<!--List<Emp> getEmpByCondition(Emp emp);-->
	<select id="getEmpByCondition" resultType="Emp">
		select <include refid="empColumns"></include> from t_emp
		<trim prefix="where" suffixOverrides="and">
			<if test="empName != null and empName != ''">
				emp_name = #{empName} and
			</if>
			<if test="age != null and age != ''">
				age = #{age} and
			</if>
			<if test="gender != null and gender != ''">
				gender = #{gender}
			</if>
		</trim>
	</select>
	<select id="getEmpByConditionTwo" 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="gender != null and gender != ''">
				and gender = #{gender}
			</if>
		</where>
	</select>
	<select id="getEmpByConditionOne" 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="gender != null and gender != ''">
			and gender = #{gender}
		</if>
	</select>

	<!--List<Emp> getEmpByChoose(Emp emp);-->
	<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="gender != null and gender != ''">
					gender = #{gender}
				</when>
			</choose>
		</where>
	</select>

	<!--void insertMoreEmp(@Param("emps") List<Emp> emps);-->
	<insert id="insertMoreEmp">
		insert into t_emp values
		<foreach collection="emps" item="emp" separator=",">
			(null,#{emp.empName},#{emp.age},#{emp.gender},null)
		</foreach>
	</insert>

	<!--void deleteMoreEmp(@Param("empIds") Integer[] empIds);-->
	<delete id="deleteMoreEmp">
		<!--delete from t_emp where emp_id in
		<foreach collection="empIds" item="empId" separator="," open="(" close=")">
			#{empId}
		</foreach>-->
		delete from t_emp where
		<foreach collection="empIds" item="empId" separator="or">
			emp_id = #{empId}
		</foreach>
	</delete>

3. 缓存

3.1 一级缓存

MyBatis的一级缓存是SqlSession级别的，即通过同一个SqlSession查询的数据会被缓存再次使用同一个SqlSession查询同一条数据，会从缓存中获取,默认开启

使一级缓存失效的四种情况：

不同的SqlSession对应不同的一级缓存
同一个SqlSession但是查询条件不同
同一个SqlSession两次查询期间执行了任何一次增删改操作
同一个SqlSession两次查询期间手动清空了缓存

3.2 二级缓存

MyBatis的二级缓存是SqlSessionFactory级别的，即通过同一个SqlSessionFactory所获取的SqlSession对象查询的数据会被缓存，在通过同一个SqlSessionFactory所获取的SqlSession查询相同的数据会从缓存中获取

MyBatis二级缓存开启的条件：

在核心配置文件中，设置全局配置属性cacheEnabled="true"，默认为true，不需要设置
在映射文件中设置标签
二级缓存必须在SqlSession关闭或提交之后有效
查询的数据所转换的实体类类型必须实现序列化的接口

使二级缓存失效的情况：

两次查询之间执行了任意的增删改，会使一级和二级缓存同时失效

3.3 二级缓存的相关配置

在mapper配置文件中添加的cache标签可以设置一些属性：

eviction属性：缓存回收策略，默认的是 LRU。

LRU（Least Recently Used） – 最近最少使用的：移除最长时间不被使用的对象。

FIFO（First in First out） – 先进先出：按对象进入缓存的顺序来移除它们。

SOFT – 软引用：移除基于垃圾回收器状态和软引用规则的对象。

WEAK – 弱引用：更积极地移除基于垃圾收集器状态和弱引用规则的对象。
flushInterval属性：刷新间隔，单位毫秒

默认情况是不设置，也就是没有刷新间隔，缓存仅仅调用语句时刷新
size属性：引用数目，正整数

代表缓存最多可以存储多少个对象，太大容易导致内存溢出
readOnly属性：只读， true/false

true：只读缓存；会给所有调用者返回缓存对象的相同实例。因此这些对象不能被修改。这提供了很重要的性能优势。

false：读写缓存；会返回缓存对象的拷贝（通过序列化）。这会慢一些，但是安全，因此默认false。

3.4 缓存查询的顺序

先查询二级缓存，因为二级缓存中可能会有其他程序已经查出来的数据，可以拿来直接使用。
如果二级缓存没有命中，再查询一级缓存
如果一级缓存也没有命中，则查询数据库
SqlSession关闭之后，一级缓存中的数据会写入二级缓存

3.5 整合第三方缓存EHCache

3.5.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>

3.5.2 各jar包功能

jar包名称	作用
mybatis-ehcache	Mybatis和EHCache的整合包
ehcache	EHCache核心包
slf4j-api	SLF4J日志门面包(接口)
logback-classic	支持SLF4J门面接口的一个具体实现

3.5.3 创建EHCache的配置文件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:\test\ehcache"/>
	<defaultCache
			maxElementsInMemory="1000"
			maxElementsOnDisk="10000000"
			eternal="false"
			overflowToDisk="true"
			timeToIdleSeconds="120"
			timeToLiveSeconds="120"
			diskExpiryThreadIntervalSeconds="120"
			memoryStoreEvictionPolicy="LRU">
	</defaultCache>
</ehcache>

3.5.4 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 （先进先出）

3.5.5 设置二级缓存的类型

<cache type="org.mybatis.caches.ehcache.EhcacheCache"/>

3.5. 加入logback日志

<?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.nick.mybatis.mapper" level="DEBUG"/>
</configuration>

4. 逆向工程

4.1 步骤

①添加依赖和插件

<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>

   <!-- log4j日志 -->
   <dependency>
      <groupId>log4j</groupId>
      <artifactId>log4j</artifactId>
      <version>1.2.17</version>
   </dependency>

   <dependency>
      <groupId>mysql</groupId>
      <artifactId>mysql-connector-java</artifactId>
      <version>8.0.16</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>

            <!-- MySQL驱动 -->
            <dependency>
               <groupId>mysql</groupId>
               <artifactId>mysql-connector-java</artifactId>
               <version>8.0.16</version>
            </dependency>
         </dependencies>
      </plugin>
   </plugins>
</build>

②创建MyBatis核心配置文件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>

   <!--
      MyBatis核心配置文件中的标签必须要按照指定的顺序配置：
      properties?,settings?,typeAliases?,typeHandlers?,
      objectFactory?,objectWrapperFactory?,reflectorFactory?,
      plugins?,environments?,databaseIdProvider?,mappers?
   -->

   <properties resource="jdbc.properties"/>

   <settings>
      <!--将下划线映射为驼峰-->
      <setting name="mapUnderscoreToCamelCase" value="true"/>
   </settings>

   <typeAliases>
      <package name="com.nick.mybatis.pojo"/>
   </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>

   <!--引入mybatis的映射文件-->
   <mappers>
      <package name="com.nick.mybatis.mapper"/>
   </mappers>
</configuration>

③创建逆向工程配置文件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="MyBatis3">
      <!-- 数据库的连接信息 -->
      <jdbcConnection driverClass="com.mysql.cj.jdbc.Driver"
                      connectionURL="jdbc:mysql://localhost:3306/ssm?serverTimezone=UTC"
                      userId="root"
                      password="123456">
      </jdbcConnection>
      <!-- javaBean的生成策略-->
      <javaModelGenerator targetPackage="com.nick.mybatis.pojo" targetProject=".\src\main\java">
         <property name="enableSubPackages" value="true"/>
         <property name="trimStrings" value="true"/>
      </javaModelGenerator>
      <!-- SQL映射文件的生成策略 -->
      <sqlMapGenerator targetPackage="com.nick.mybatis.mapper" targetProject=".\src\main\resources">
         <property name="enableSubPackages" value="true"/>
      </sqlMapGenerator>
      <!-- Mapper接口的生成策略 -->
      <javaClientGenerator type="XMLMAPPER" targetPackage="com.nick.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>

④执行MBG插件的generate目标

MBG插件的执行目标.png

4.2 QBC查询

public class MBGTest {

   @Test
   public void testMBG() {
      SqlSession sqlSession = SqlSessionUtil.getSqlSession();
      EmpMapper mapper = sqlSession.getMapper(EmpMapper.class);
      // 根据id查询数据
        /*Emp emp = mapper.selectByPrimaryKey(1);
        System.out.println(emp);*/
      // 查询所有数据
        /*List<Emp> list = mapper.selectByExample(null);
        list.forEach(System.out::println);*/
      // 根据条件查询数据
        /*EmpExample example = new EmpExample();
        example.createCriteria().andEmpNameEqualTo("张三").andAgeGreaterThanOrEqualTo(20);
        example.or().andGenderEqualTo("男");
        List<Emp> list = mapper.selectByExample(example);
        list.forEach(System.out::println);*/
      Emp emp = new Emp(1, "小黑", null, "女");
      // 测试普通修改功能
      // mapper.updateByPrimaryKey(emp);
      // 测试选择性修改
      mapper.updateByPrimaryKeySelective(emp);
   }

}

5. 分页插件

limit index,pageSize pageSize：每页显示的条数 pageNum：当前页的页码 index：当前页的起始索引，index=(pageNum-1)*pageSize count：总记录数 totalPage：总页数 totalPage = count / pageSize; if(count % pageSize != 0){ totalPage += 1; } pageSize=4，pageNum=1，index=0 limit 0,4 pageSize=4，pageNum=3，index=8 limit 8,4 pageSize=4，pageNum=6，index=20 limit 8,4 首页上一页 2 3 4 5 6 下一页末页

5.1 添加插件

<dependency>
   <groupId>com.github.pagehelper</groupId>
   <artifactId>pagehelper</artifactId>
   <version>5.2.0</version>
</dependency>

5.2 配置分页插件

<plugins>
   <!--配置分页插件-->
   <plugin interceptor="com.github.pagehelper.PageInterceptor"></plugin>
</plugins>

5.3 使用

在查询功能之前使用PageHelper.startPage(int pageNum, int pageSize)开启分页功能

pageNum：当前页的页码

pageSize：每页显示的条数
在查询获取list集合之后,使用PageInfo pageInfo = new PageInfo<>(List list, int navigatePages)

navigatePages)获取分页相关数据

list：分页之后的数据

navigatePages：导航分页的页码数
分页相关数据

PageInfo{

pageNum=8, pageSize=4, size=2, startRow=29, endRow=30, total=30, pages=8,

list=Page{count=true, pageNum=8, pageSize=4, startRow=28, endRow=32, total=30,

pages=8, reasonable=false, pageSizeZero=false},

prePage=7, nextPage=0, isFirstPage=false, isLastPage=true, hasPreviousPage=true,

hasNextPage=false, navigatePages=5, navigateFirstPage4, navigateLastPage8,

navigatepageNums=[4, 5, 6, 7, 8]

}

pageNum：当前页的页码

pageSize：每页显示的条数

size：当前页显示的真实条数

total：总记录数

pages：总页数

prePage：上一页的页码

nextPage：下一页的页码

isFirstPage/isLastPage：是否为第一页/最后一页

hasPreviousPage/hasNextPage：是否存在上一页/下一页

navigatePages：导航分页的页码数

navigatepageNums：导航分页的页码，[1,2,3,4,5]

MyBatis学习笔记