Mybatis基础操作
<h2 id="mybatis基础使用">Mybatis基础使用</h2><h3 id="mybatis编程式开发">Mybatis编程式开发</h3>
<ol>
<li>mybatis和MySQL jar包依赖</li>
</ol>
<pre><code class="language-xml"><dependencies>
<!-- MyBatis 核心 -->
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.5.10</version>
</dependency>
<!-- MySQL 驱动 -->
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>8.0.33</version>
</dependency>
<!-- 连接池（可选，推荐） -->
<dependency>
<groupId>com.zaxxer</groupId>
<artifactId>HikariCP</artifactId>
<version>5.0.1</version>
</dependency>
</dependencies>
</code></pre>
<ol start="2">
<li>全局配置文件mybatis-config.xml</li>
</ol>
<p>配置文件对应标签可以看官方文档：https://mybatis.org/mybatis-3/configuration.html</p>
<pre><code class="language-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 resource="jdbc.properties"/>
<!-- 2. 全局设置 -->
<settings>
<!-- 开启下划线到驼峰命名自动映射 -->
<setting name="mapUnderscoreToCamelCase" value="true"/>
<!-- 开启二级缓存 -->
<setting name="cacheEnabled" value="true"/>
<!-- 延迟加载的触发方法 -->
<setting name="lazyLoadTriggerMethods" value=""/>
<!-- 查询时，关闭关联对象即时加载 -->
<setting name="lazyLoadingEnabled" value="true"/>
<!-- 设置超时时间 -->
<setting name="defaultStatementTimeout" value="3000"/>
<!-- 使用列标签代替列名 -->
<setting name="useColumnLabel" value="true"/>
<!-- 允许JDBC支持自动生成主键 -->
<setting name="useGeneratedKeys" value="true"/>
</settings>
<!-- 3. 类型别名配置 -->
<typeAliases>
<!-- 扫描包，自动注册别名 -->
<package name="com.example.entity"/>
<!-- 也可以单独配置 -->
<!-- <typeAlias type="com.example.entity.User" alias="User"/> -->
</typeAliases>
<!-- 4. 环境配置（可配置多个，通过default属性切换） -->
<environments default="development">
<!-- 开发环境 -->
<environment id="development">
<!-- 事务管理器 -->
<transactionManager type="JDBC">
<property name="closeConnection" value="false"/>
</transactionManager>
<!-- 数据源配置 -->
<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}"/>
<!-- 连接池配置 -->
<property name="poolMaximumActiveConnections" value="20"/>
<property name="poolMaximumIdleConnections" value="10"/>
<property name="poolMaximumCheckoutTime" value="20000"/>
<property name="poolTimeToWait" value="20000"/>
</dataSource>
</environment>
<!-- 测试环境 -->
<environment id="test">
<transactionManager type="JDBC"/>
<dataSource type="POOLED">
<property name="driver" value="${jdbc.driver}"/>
<property name="url" value="${jdbc.test.url}"/>
<property name="username" value="${jdbc.test.username}"/>
<property name="password" value="${jdbc.test.password}"/>
</dataSource>
</environment>
</environments>
<!-- 5. 映射器配置 -->
<mappers>
<!-- 方式1：通过resource指定XML文件 -->
<mapper resource="com/example/mapper/UserMapper.xml"/>
<!-- 方式2：通过class指定接口（需要接口和XML同名同路径） -->
<!-- <mapper class="com.example.mapper.UserMapper"/> -->
<!-- 方式3：扫描包下所有mapper接口 -->
<!-- <package name="com.example.mapper"/> -->
</mappers>
</configuration>
</code></pre>
<ol start="3">
<li>映射器 Mapper.xml</li>
</ol>
<pre><code class="language-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="com.example.mapper.UserMapper">
<!-- 基础ResultMap映射 -->
<resultMap id="BaseResultMap" type="User">
<id property="id" column="id"/>
<result property="username" column="username"/>
<result property="password" column="password"/>
<result property="email" column="email"/>
<result property="age" column="age"/>
<result property="status" column="status"/>
<result property="createTime" column="create_time"/>
<result property="updateTime" column="update_time"/>
<!-- 枚举类型处理 -->
<result property="gender" column="gender"
typeHandler="org.apache.ibatis.type.EnumOrdinalTypeHandler"/>
</resultMap>
<!-- 包含订单的ResultMap（一对多） -->
<resultMap id="UserWithOrdersResultMap" type="User" extends="BaseResultMap">
<!-- 一对多关联：用户的订单 -->
<collection property="orders" ofType="Order" column="id"
select="com.example.mapper.OrderMapper.selectByUserId"/>
</resultMap>
<!-- 插入用户 -->
<insert id="insert" parameterType="User" useGeneratedKeys="true" keyProperty="id">
INSERT INTO users (username, password, email, age, status, create_time, update_time, gender)
VALUES (#{username}, #{password}, #{email}, #{age}, #{status}, #{createTime}, #{updateTime},
#{gender, typeHandler=org.apache.ibatis.type.EnumOrdinalTypeHandler})
</insert>
<!-- 批量插入用户 -->
<insert id="batchInsert" parameterType="java.util.List" useGeneratedKeys="true" keyProperty="id">
INSERT INTO users (username, password, email, age, status, create_time, update_time)
VALUES
<foreach collection="list" item="user" separator=",">
(#{user.username}, #{user.password}, #{user.email}, #{user.age},
#{user.status}, #{user.createTime}, #{user.updateTime})
</foreach>
</insert>
<!-- 根据ID删除 -->
<delete id="deleteById" parameterType="Long">
DELETE FROM users WHERE id = #{id}
</delete>
<!-- 根据用户名删除 -->
<delete id="deleteByUsername" parameterType="String">
DELETE FROM users WHERE username = #{username}
</delete>
<!-- 更新用户 -->
<update id="update" parameterType="User">
UPDATE users
<set>
<if test="username != null">username = #{username},</if>
<if test="password != null">password = #{password},</if>
<if test="email != null">email = #{email},</if>
<if test="age != null">age = #{age},</if>
<if test="status != null">status = #{status},</if>
<if test="updateTime != null">update_time = #{updateTime},</if>
</set>
WHERE id = #{id}
</update>
<!-- 更新用户状态 -->
<update id="updateStatus">
UPDATE users SET status = #{status} WHERE id = #{id}
</update>
<!-- 根据ID查询 -->
<select id="selectById" parameterType="Long" resultMap="BaseResultMap">
SELECT * FROM users WHERE id = #{id}
</select>
<!-- 查询所有用户 -->
<select id="selectAll" resultMap="BaseResultMap">
SELECT * FROM users ORDER BY create_time DESC
</select>
<!-- 根据用户名查询（模糊查询） -->
<select id="selectByUsername" parameterType="String" resultMap="BaseResultMap">
SELECT * FROM users
WHERE username LIKE CONCAT('%', #{username}, '%')
</select>
<!-- 条件查询（动态SQL） -->
<select id="selectByCondition" parameterType="map" resultMap="BaseResultMap">
SELECT * FROM users
<where>
<if test="username != null and username != ''">
AND username LIKE CONCAT('%', #{username}, '%')
</if>
<if test="email != null and email != ''">
AND email = #{email}
</if>
<if test="minAge != null">
AND age >= #{minAge}
</if>
<if test="maxAge != null">
AND age &lt;= #{maxAge}
</if>
<if test="status != null">
AND status = #{status}
</if>
<if test="startTime != null">
AND create_time >= #{startTime}
</if>
<if test="endTime != null">
AND create_time &lt;= #{endTime}
</if>
</where>
ORDER BY id DESC
</select>
<!-- 分页查询 -->
<select id="selectByPage" resultMap="BaseResultMap">
SELECT * FROM users
ORDER BY id DESC
LIMIT #{offset}, #{pageSize}
</select>
<!-- 统计数量 -->
<select id="count" resultType="int">
SELECT COUNT(*) FROM users
</select>
<!-- 查询用户及其订单（关联查询） -->
<select id="selectUserWithOrders" parameterType="Long" resultMap="UserWithOrdersResultMap">
SELECT * FROM users WHERE id = #{userId}
</select>
</mapper>
</code></pre>
<ol start="4">
<li>Mapper接口</li>
</ol>
<pre><code class="language-java">package com.example.mapper;
import com.example.entity.User;
import org.apache.ibatis.annotations.Param;
import org.apache.ibatis.annotations.Select;
import org.apache.ibatis.annotations.Update;
import java.util.List;
import java.util.Map;
/**
* User 数据访问接口
* 注意：不使用Spring时，这个接口不需要添加@Repository等注解
*/
public interface UserMapper {
// ========== 增 ==========
/**
* 插入用户
*/
int insert(User user);
/**
* 批量插入用户
*/
int batchInsert(List<User> users);
// ========== 删 ==========
/**
* 根据ID删除用户
*/
int deleteById(Long id);
/**
* 根据用户名删除用户
*/
int deleteByUsername(String username);
// ========== 改 ==========
/**
* 更新用户
*/
int update(User user);
/**
* 更新用户状态
* 使用@Param注解指定参数名
*/
int updateStatus(@Param("id") Long id, @Param("status") Integer status);
// 使用注解定义SQL（不需要在XML中配置）
@Update("UPDATE users SET age = #{age} WHERE id = #{id}")
int updateAge(@Param("id") Long id, @Param("age") Integer age);
// ========== 查 ==========
/**
* 根据ID查询用户
*/
User selectById(Long id);
/**
* 查询所有用户
*/
List<User> selectAll();
/**
* 根据用户名查询
*/
List<User> selectByUsername(String username);
/**
* 条件查询
* @param condition 查询条件
*/
List<User> selectByCondition(Map<String, Object> condition);
/**
* 分页查询
* @param pageNum 页码
* @param pageSize 每页大小
*/
List<User> selectByPage(@Param("offset") int offset, @Param("pageSize") int pageSize);
/**
* 统计用户数量
*/
int count();
/**
* 使用注解定义查询
*/
@Select("SELECT * FROM users WHERE email = #{email}")
User selectByEmail(String email);
/**
* 关联查询：查询用户及其订单（一对多）
* 需要在XML中配置resultMap
*/
User selectUserWithOrders(Long userId);
}
</code></pre>
<ol start="5">
<li>mybatis工具类</li>
</ol>
<pre><code class="language-java">package com.example.app;
import org.apache.ibatis.io.Resources;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;
import java.io.IOException;
import java.io.InputStream;
/**
* MyBatis 工具类 - 手动管理 SqlSessionFactory
*/
public class MyBatisUtil {
private static SqlSessionFactory sqlSessionFactory;
// 静态代码块，在类加载时初始化
static {
try {
// 1. 加载 MyBatis 配置文件
String resource = "mybatis-config.xml";
InputStream inputStream = Resources.getResourceAsStream(resource);
// 2. 创建 SqlSessionFactory
sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
System.out.println("MyBatis SqlSessionFactory 初始化成功!");
} catch (IOException e) {
System.err.println("MyBatis 初始化失败: " + e.getMessage());
throw new RuntimeException("MyBatis 初始化失败", e);
}
}
/**
* 获取 SqlSession 对象
*/
public static SqlSession getSqlSession() {
return sqlSessionFactory.openSession();
}
/**
* 获取 SqlSession 对象（自动提交事务）
*/
public static SqlSession getSqlSessionWithAutoCommit() {
return sqlSessionFactory.openSession(true);
}
/**
* 关闭 SqlSession
*/
public static void closeSession(SqlSession session) {
if (session != null) {
session.close();
}
}
/**
* 获取 SqlSessionFactory
*/
public static SqlSessionFactory getSqlSessionFactory() {
return sqlSessionFactory;
}
/**
* 获取 Mapper 接口的代理对象
*/
public static <T> T getMapper(Class<T> type) {
try (SqlSession session = getSqlSession()) {
return session.getMapper(type);
}
}
}
</code></pre>
<ol start="6">
<li>编程式使用示例</li>
</ol>
<pre><code class="language-java">package com.example.app;
import com.example.entity.User;
import com.example.mapper.UserMapper;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;
import java.io.InputStream;
import java.time.LocalDateTime;
import java.util.Date;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
/**
* 不使用 Spring 时，MyBatis 编程式使用示例
*/
public class MyBatisDemo {
public static void main(String[] args) {
// 示例1：基础用法
basicUsage();
// 示例2：事务管理
transactionManagement();
// 示例3：动态SQL
dynamicSqlExample();
// 示例4：批量操作
batchOperation();
// 示例5：手动构建 SqlSessionFactory
manualSqlSessionFactory();
}
/**
* 示例1：基础CRUD操作
*/
private static void basicUsage() {
System.out.println("=== 示例1：基础CRUD操作 ===");
SqlSession sqlSession = null;
try {
// 1. 获取 SqlSession
sqlSession = MyBatisUtil.getSqlSession();
// 2. 获取 Mapper 接口的代理对象
UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
// 3. 插入数据
User newUser = new User();
newUser.setUsername("zhangsan");
newUser.setPassword("123456");
newUser.setEmail("zhangsan@example.com");
newUser.setAge(25);
newUser.setStatus(1);
newUser.setCreateTime(new Date());
newUser.setUpdateTime(LocalDateTime.now());
int insertResult = userMapper.insert(newUser);
System.out.println("插入结果：" + insertResult + "，生成ID：" + newUser.getId());
// 4. 查询数据
User user = userMapper.selectById(newUser.getId());
System.out.println("查询用户：" + user);
// 5. 更新数据
user.setEmail("updated@example.com");
int updateResult = userMapper.update(user);
System.out.println("更新结果：" + updateResult);
// 6. 分页查询
List<User> userList = userMapper.selectByPage(0, 10);
System.out.println("分页查询结果：" + userList.size() + " 条");
// 7. 统计
int count = userMapper.count();
System.out.println("总用户数：" + count);
// 8. 提交事务
sqlSession.commit();
System.out.println("事务提交成功");
} catch (Exception e) {
// 回滚事务
if (sqlSession != null) {
sqlSession.rollback();
}
System.err.println("操作失败：" + e.getMessage());
e.printStackTrace();
} finally {
// 关闭 SqlSession
MyBatisUtil.closeSession(sqlSession);
}
}
/**
* 示例2：事务管理
*/
private static void transactionManagement() {
System.out.println("\n=== 示例2：事务管理 ===");
SqlSession sqlSession = null;
try {
sqlSession = MyBatisUtil.getSqlSession();
UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
// 开启事务（默认不会自动提交）
// 操作1：插入用户
User user1 = new User("lisi", "lisi@example.com");
user1.setPassword("123456");
user1.setCreateTime(new Date());
userMapper.insert(user1);
// 操作2：模拟业务逻辑异常
if (user1.getUsername().equals("lisi")) {
throw new RuntimeException("模拟业务异常，事务应该回滚");
}
// 操作3：更新用户（不会执行，因为上面抛出异常）
userMapper.updateAge(user1.getId(), 30);
// 提交事务
sqlSession.commit();
System.out.println("事务提交成功");
} catch (Exception e) {
if (sqlSession != null) {
sqlSession.rollback();
System.out.println("事务回滚：" + e.getMessage());
}
} finally {
MyBatisUtil.closeSession(sqlSession);
}
}
/**
* 示例3：动态SQL和条件查询
*/
private static void dynamicSqlExample() {
System.out.println("\n=== 示例3：动态SQL和条件查询 ===");
try (SqlSession sqlSession = MyBatisUtil.getSqlSession()) {
UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
// 构建查询条件
Map<String, Object> condition = new HashMap<>();
condition.put("username", "zhang");// 模糊查询
condition.put("minAge", 20); // 年龄 >= 20
condition.put("maxAge", 30); // 年龄 <= 30
condition.put("status", 1); // 状态为启用
List<User> users = userMapper.selectByCondition(condition);
System.out.println("条件查询结果：" + users.size() + " 条记录");
for (User user : users) {
System.out.println(user);
}
sqlSession.commit();
} catch (Exception e) {
e.printStackTrace();
}
}
/**
* 示例4：批量操作
*/
private static void batchOperation() {
System.out.println("\n=== 示例4：批量操作 ===");
SqlSession sqlSession = null;
try {
sqlSession = MyBatisUtil.getSqlSession();
UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
// 批量插入
List<User> users = createTestUsers(5);
int result = userMapper.batchInsert(users);
System.out.println("批量插入：" + result + " 条记录");
sqlSession.commit();
} catch (Exception e) {
if (sqlSession != null) {
sqlSession.rollback();
}
e.printStackTrace();
} finally {
MyBatisUtil.closeSession(sqlSession);
}
}
/**
* 示例5：手动构建 SqlSessionFactory
*/
private static void manualSqlSessionFactory() {
System.out.println("\n=== 示例5：手动构建 SqlSessionFactory ===");
String resource = "mybatis-config.xml";
try (InputStream inputStream = Resources.getResourceAsStream(resource)) {
// 1. 手动构建 SqlSessionFactoryBuilder
SqlSessionFactoryBuilder builder = new SqlSessionFactoryBuilder();
// 2. 构建 SqlSessionFactory
SqlSessionFactory sqlSessionFactory = builder.build(inputStream);
// 3. 从 SqlSessionFactory 中获取 SqlSession
try (SqlSession sqlSession = sqlSessionFactory.openSession()) {
// 4. 获取 Mapper
UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
// 5. 执行查询
List<User> users = userMapper.selectAll();
System.out.println("手动构建查询结果：" + users.size() + " 条记录");
// 6. 手动提交事务
sqlSession.commit();
}
} catch (Exception e) {
e.printStackTrace();
}
}
/**
* 创建测试用户
*/
private static List<User> createTestUsers(int count) {
List<User> users = new java.util.ArrayList<>();
for (int i = 1; i <= count; i++) {
User user = new User();
user.setUsername("test" + i);
user.setPassword("pass" + i);
user.setEmail("test" + i + "@example.com");
user.setAge(20 + i);
user.setStatus(1);
user.setCreateTime(new Date());
users.add(user);
}
return users;
}
}
</code></pre>
<h3 id="整合spring">整合Spring</h3>
<ol>
<li>添加依赖</li>
</ol>
<p>较编程式开发主要是需要添加spring核心和MyBatis-Spring整合包</p>
<pre><code class="language-xml"><dependencies>
<!-- Spring 核心依赖 -->
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-context</artifactId>
<version>${spring.version}</version>
</dependency>
<!-- MyBatis-Spring 整合包（关键！） -->
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis-spring</artifactId>
<version>${mybatis.spring.version}</version>
</dependency>
</dependencies>
</code></pre>
<ol start="2">
<li><strong>mybatis.xml</strong> - MyBatis 和事务配置</li>
</ol>
<pre><code class="language-xml"><?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:tx="http://www.springframework.org/schema/tx"
xmlns:aop="http://www.springframework.org/schema/aop"
xsi:schemaLocation="http://www.springframework.org/schema/beans
http://www.springframework.org/schema/beans/spring-beans.xsd
http://www.springframework.org/schema/tx
http://www.springframework.org/schema/tx/spring-tx.xsd
http://www.springframework.org/schema/aop
http://www.springframework.org/schema/aop/spring-aop.xsd">
<!-- 导入数据源配置 -->
<import resource="datasource.xml"/>
<!-- 1. 配置 SqlSessionFactory -->
<bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
<!-- 引用数据源 -->
<property name="dataSource" ref="dataSource"/>
<!-- MyBatis 主配置文件路径（如果有的话） -->
<property name="configLocation" value="classpath:mybatis-config.xml"/>
<!-- 实体类别名包 -->
<property name="typeAliasesPackage" value="com.example.entity"/>
<!-- MyBatis 映射文件路径 -->
<property name="mapperLocations">
<array>
<value>classpath:com/example/dao/mapper/*.xml</value>
</array>
</property>
<!-- MyBatis 全局配置 -->
<property name="configuration">
<bean class="org.apache.ibatis.session.Configuration">
<!-- 下划线转驼峰 -->
<property name="mapUnderscoreToCamelCase" value="true"/>
<!-- 开启二级缓存 -->
<property name="cacheEnabled" value="true"/>
<!-- 使用列标签代替列名 -->
<property name="useColumnLabel" value="true"/>
<!-- 延迟加载的触发方法 -->
<property name="lazyLoadTriggerMethods">
<array>
<value>equals</value>
<value>clone</value>
<value>hashCode</value>
<value>toString</value>
</array>
</property>
</bean>
</property>
<!-- 插件配置 -->
<property name="plugins">
<array>
<!-- 分页插件示例 -->
<!--
<bean class="com.github.pagehelper.PageInterceptor">
<property name="properties">
<props>
<prop key="helperDialect">mysql</prop>
</props>
</property>
</bean>
-->
</array>
</property>
</bean>
<!-- 2. 配置 Mapper 扫描器（方式一：扫描包） -->
<bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">
<!-- 扫描的包路径 -->
<property name="basePackage" value="com.example.dao"/>
<!-- 可选：指定 SqlSessionFactory -->
<property name="sqlSessionFactoryBeanName" value="sqlSessionFactory"/>
<!-- 可选：指定注解，只有标记了指定注解的接口才会被扫描 -->
<!-- <property name="annotationClass" value="org.springframework.stereotype.Repository"/> -->
</bean>
<!-- 3. 配置事务管理器 -->
<bean id="transactionManager" class="org.springframework.jdbc.datasource.DataSourceTransactionManager">
<property name="dataSource" ref="dataSource"/>
</bean>
<!-- 4. 开启注解驱动的事务管理 -->
<tx:annotation-driven transaction-manager="transactionManager"/>
<!-- 5. 事务AOP配置（可选，如果使用注解则不需要） -->
<!--
<tx:advice id="txAdvice" transaction-manager="transactionManager">
<tx:attributes>
<tx:method name="get*" read-only="true" propagation="SUPPORTS"/>
<tx:method name="find*" read-only="true" propagation="SUPPORTS"/>
<tx:method name="select*" read-only="true" propagation="SUPPORTS"/>
<tx:method name="*" propagation="REQUIRED" rollback-for="Exception"/>
</tx:attributes>
</tx:advice>
<aop:config>
<aop:pointcut id="serviceMethods" expression="execution(* com.example.service.*.*(..))"/>
<aop:advisor advice-ref="txAdvice" pointcut-ref="serviceMethods"/>
</aop:config>
-->
<!-- 6. 配置 SqlSessionTemplate（可选，如果需要在DAO中直接使用） -->
<bean id="sqlSessionTemplate" class="org.mybatis.spring.SqlSessionTemplate">
<constructor-arg index="0" ref="sqlSessionFactory"/>
</bean>
</beans>
</code></pre>
<ol start="3">
<li><strong>applicationContext.xml</strong> - Spring 主配置文件</li>
</ol>
<pre><code class="language-xml"><?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:context="http://www.springframework.org/schema/context"
xsi:schemaLocation="http://www.springframework.org/schema/beans
http://www.springframework.org/schema/beans/spring-beans.xsd
http://www.springframework.org/schema/context
http://www.springframework.org/schema/context/spring-context.xsd">
<!-- 开启注解扫描 -->
<context:component-scan base-package="com.example">
<!-- 排除 Controller，如果使用 MVC 的话 -->
<context:exclude-filter type="annotation"
expression="org.springframework.stereotype.Controller"/>
</context:component-scan>
<!-- 导入 MyBatis 配置 -->
<import resource="classpath:spring/mybatis.xml"/>
<!-- 其他 Bean 配置 -->
<bean id="userService" class="com.example.service.impl.UserServiceImpl"/>
<!-- 属性占位符配置 -->
<context:property-placeholder location="classpath:*.properties"/>
</beans>
</code></pre>
<ol start="4">
<li>测试案例</li>
</ol>
<pre><code class="language-java">package com.example.config;
import org.apache.commons.dbcp2.BasicDataSource;
import org.mybatis.spring.SqlSessionFactoryBean;
import org.mybatis.spring.mapper.MapperScannerConfigurer;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.ComponentScan;
import org.springframework.context.annotation.Configuration;
import org.springframework.context.annotation.PropertySource;
import org.springframework.core.io.ClassPathResource;
import org.springframework.core.io.Resource;
import org.springframework.jdbc.datasource.DataSourceTransactionManager;
import org.springframework.transaction.PlatformTransactionManager;
import org.springframework.transaction.annotation.EnableTransactionManagement;
import javax.sql.DataSource;
@Configuration
@ComponentScan("com.example")
@PropertySource("classpath:jdbc.properties")
@EnableTransactionManagement
public class AppConfig {
@Bean
public DataSource dataSource(
@Value("${jdbc.driverClassName}") String driverClassName,
@Value("${jdbc.url}") String url,
@Value("${jdbc.username}") String username,
@Value("${jdbc.password}") String password) {
BasicDataSource dataSource = new BasicDataSource();
dataSource.setDriverClassName(driverClassName);
dataSource.setUrl(url);
dataSource.setUsername(username);
dataSource.setPassword(password);
dataSource.setInitialSize(5);
dataSource.setMaxTotal(20);
return dataSource;
}
@Bean
public SqlSessionFactoryBean sqlSessionFactory(DataSource dataSource) {
SqlSessionFactoryBean factoryBean = new SqlSessionFactoryBean();
factoryBean.setDataSource(dataSource);
factoryBean.setTypeAliasesPackage("com.example.entity");
// 配置 MyBatis
org.apache.ibatis.session.Configuration configuration =
new org.apache.ibatis.session.Configuration();
configuration.setMapUnderscoreToCamelCase(true);
factoryBean.setConfiguration(configuration);
// 设置映射文件位置
Resource[] mapperLocations = new Resource[]{
new ClassPathResource("com/example/dao/mapper/*.xml")
};
factoryBean.setMapperLocations(mapperLocations);
return factoryBean;
}
@Bean
public MapperScannerConfigurer mapperScannerConfigurer() {
MapperScannerConfigurer scanner = new MapperScannerConfigurer();
scanner.setBasePackage("com.example.dao");
scanner.setSqlSessionFactoryBeanName("sqlSessionFactory");
return scanner;
}
@Bean
public PlatformTransactionManager transactionManager(DataSource dataSource) {
return new DataSourceTransactionManager(dataSource);
}
}
</code></pre>
<h3 id="整合springboot">整合SpringBoot</h3>
<ol>
<li>添加依赖</li>
</ol>
<pre><code class="language-xml"><dependency>
<groupId>org.mybatis.spring.boot</groupId>
<artifactId>mybatis-spring-boot-starter</artifactId>
<version>3.0.0</version>
</dependency>
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-j</artifactId>
</dependency>
<!-- 无需显式添加连接池，Spring Boot 默认使用 HikariCP -->
</code></pre>
<ol start="2">
<li> <code>application.yml</code>配置，无需创建<code>mybatis-config.xml</code>文件，可直接在yaml文件中配置</li>
</ol>
<pre><code class="language-yaml">spring:
datasource:
url: jdbc:mysql://localhost:3306/testdb
username: root
password: 123456
driver-class-name: com.mysql.cj.jdbc.Driver
hikari:
maximum-pool-size: 20
minimum-idle: 5
mybatis:
mapper-locations: classpath:mapper/**/*.xml
type-aliases-package: com.example.entity
configuration:
map-underscore-to-camel-case: true
</code></pre>
<ol start="3">
<li>配置自动扫描 Mapper 接口</li>
</ol>
<pre><code class="language-java">@SpringBootApplication
@MapperScan("com.example.mapper") // 自动扫描 Mapper 接口
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
</code></pre>
<ol start="4">
<li>自动注入 Mapper</li>
</ol>
<pre><code class="language-java">@Service
public class UserService {
@Autowired
private UserMapper userMapper; // 直接注入
public User getUser(Long id) {
return userMapper.selectById(id); // 直接使用
}
}
</code></pre>
<h2 id="mybatis代码生成器">Mybatis代码生成器</h2>
<p>https://github.com/mybatis/generator</p>
<h2 id="mybatis动态sql">Mybatis动态sql</h2>
<p>https://mybatis.org/mybatis-3/dynamic-sql.html</p>
<h2 id="mybatis批量操作">Mybatis批量操作</h2>
<p>进行批量操作时，有三种方式，操作方式对比：</p>
<table>
<thead>
<tr>
<th>操作类型</th>
<th>适用场景</th>
<th>实现方式</th>
<th>优点</th>
<th>缺点</th>
</tr>
</thead>
<tbody>
<tr>
<td><strong>foreach SQL</strong></td>
<td>小批量数据插入/更新/删除</td>
<td>在 XML 中写 <code><foreach></code>生成 SQL</td>
<td>简单直观，一次性执行</td>
<td>SQL 长度有限制，大数据量可能超限</td>
</tr>
<tr>
<td><strong>Batch Executor</strong></td>
<td>大批量数据操作</td>
<td>使用 <code>ExecutorType.BATCH</code></td>
<td>性能最优，预编译 SQL</td>
<td>需要手动管理事务和提交</td>
</tr>
<tr>
<td><strong>JDBC Batch</strong></td>
<td>需要底层控制</td>
<td>使用原生 JDBC Batch</td>
<td>完全控制，灵活性高</td>
<td>代码复杂，需处理底层细节</td>
</tr>
</tbody>
</table>
<h3 id="使用-foreach-标签的批量操作案例">使用 foreach 标签的批量操作案例</h3>
<h4 id="批量插入">批量插入</h4>
<pre><code class="language-xml"><!-- 1. 基本批量插入 -->
<insert id="batchInsert" parameterType="java.util.List">
INSERT INTO users (username, email, age, status, create_time)
VALUES
<foreach collection="list" item="user" separator=",">
(#{user.username}, #{user.email}, #{user.age}, #{user.status}, NOW())
</foreach>
</insert>
<!-- 2. 批量插入（返回自增主键） -->
<insert id="batchInsertWithKeys" parameterType="java.util.List"
useGeneratedKeys="true" keyProperty="id">
INSERT INTO users (username, email, age, status, create_time)
VALUES
<foreach collection="list" item="user" separator=",">
(#{user.username}, #{user.email}, #{user.age}, #{user.status}, #{user.createTime})
</foreach>
</insert>
<!-- 3. 批量插入或更新（MySQL ON DUPLICATE KEY UPDATE） -->
<insert id="batchInsertOrUpdate" parameterType="java.util.List">
INSERT INTO users (username, email, age, status, create_time)
VALUES
<foreach collection="list" item="user" separator=",">
(#{user.username}, #{user.email}, #{user.age}, #{user.status}, #{user.createTime})
</foreach>
ON DUPLICATE KEY UPDATE
email = VALUES(email),
age = VALUES(age),
status = VALUES(status),
update_time = NOW()
</insert>
</code></pre>
<h4 id="批量更新">批量更新</h4>
<pre><code class="language-xml"><!-- 1. 批量更新（根据ID） -->
<update id="batchUpdate" parameterType="java.util.List">
UPDATE users
<trim prefix="SET" suffixOverrides=",">
<trim prefix="username = CASE" suffix="END,">
<foreach collection="list" item="user">
<if test="user.username != null">
WHEN id = #{user.id} THEN #{user.username}
</if>
</foreach>
</trim>
<trim prefix="email = CASE" suffix="END,">
<foreach collection="list" item="user">
<if test="user.email != null">
WHEN id = #{user.id} THEN #{user.email}
</if>
</foreach>
</trim>
<trim prefix="age = CASE" suffix="END,">
<foreach collection="list" item="user">
<if test="user.age != null">
WHEN id = #{user.id} THEN #{user.age}
</if>
</foreach>
</trim>
<trim prefix="status = CASE" suffix="END,">
<foreach collection="list" item="user">
<if test="user.status != null">
WHEN id = #{user.id} THEN #{user.status}
</if>
</foreach>
</trim>
update_time = NOW()
</trim>
WHERE id IN
<foreach collection="list" item="user" open="(" separator="," close=")">
#{user.id}
</foreach>
</update>
<!-- 2. 批量更新（简单版，逐条更新） -->
<update id="batchUpdateSimple">
<foreach collection="list" item="user" separator=";">
UPDATE users
<set>
<if test="user.username != null">username = #{user.username},</if>
<if test="user.email != null">email = #{user.email},</if>
<if test="user.age != null">age = #{user.age},</if>
update_time = NOW()
</set>
WHERE id = #{user.id}
</foreach>
</update>
<!-- 3. 批量更新状态 -->
<update id="batchUpdateStatus">
UPDATE users
SET status = #{status},
update_time = NOW()
WHERE id IN
<foreach collection="ids" item="id" open="(" separator="," close=")">
#{id}
</foreach>
</update>
</code></pre>
<h4 id="批量删除">批量删除</h4>
<pre><code class="language-xml"><!-- 1. 批量删除（根据ID列表） -->
<delete id="batchDeleteByIds">
DELETE FROM users
WHERE id IN
<foreach collection="ids" item="id" open="(" separator="," close=")">
#{id}
</foreach>
</delete>
<!-- 2. 批量删除（根据条件） -->
<delete id="batchDeleteByCondition">
DELETE FROM users
WHERE (username, email) IN
<foreach collection="list" item="user" open="(" separator="," close=")">
(#{user.username}, #{user.email})
</foreach>
</delete>
</code></pre>
<h4 id="批量查询">批量查询</h4>
<pre><code class="language-xml"><!-- 1. 批量查询（根据ID列表） -->
<select id="batchSelectByIds" resultMap="BaseResultMap">
SELECT * FROM users
WHERE id IN
<foreach collection="ids" item="id" open="(" separator="," close=")">
#{id}
</foreach>
ORDER BY
<foreach collection="ids" item="id" separator=",">
id = #{id} DESC
</foreach>
</select>
<!-- 2. 批量查询（分页批量查询） -->
<select id="batchSelectByPage" parameterType="map" resultMap="BaseResultMap">
SELECT * FROM users
WHERE id IN
<foreach collection="ids" item="id" open="(" separator="," close=")">
#{id}
</foreach>
LIMIT #{offset}, #{pageSize}
</select>
</code></pre>
<h3 id="使用-foreach-标签的注意事项">使用 foreach 标签的注意事项</h3>
<h4 id="sql-长度限制">SQL 长度限制</h4>
<pre><code class="language-java">/**
* 处理超长 SQL 的批量操作
*/
public int safeBatchInsert(List<User> userList) {
int batchSize = 1000; // 根据数据库配置调整
int total = 0;
for (int i = 0; i < userList.size(); i += batchSize) {
int end = Math.min(i + batchSize, userList.size());
List<User> subList = userList.subList(i, end);
// 检查 SQL 长度
String sql = generateInsertSQL(subList);
if (sql.length() > 1000000) { // 1MB
// 进一步减小批次
batchSize = batchSize / 2;
i -= batchSize; // 回退
continue;
}
total += userMapper.batchInsert(subList);
}
return total;
}
</code></pre>
<h4 id="事务管理">事务管理</h4>
<pre><code class="language-java">@Service
public class UserBatchService {
@Transactional(rollbackFor = Exception.class)
public int batchInsertWithTransaction(List<User> userList) {
int result = 0;
try {
result = userMapper.batchInsert(userList);
// 如果后续操作失败，整个事务回滚
someOtherOperation();
} catch (Exception e) {
// 抛出异常触发回滚
throw new RuntimeException("批量插入失败，已回滚", e);
}
return result;
}
/**
* 手动控制事务
*/
public int batchInsertManualTransaction(List<User> userList) {
// 获取事务定义
DefaultTransactionDefinition def = new DefaultTransactionDefinition();
def.setPropagationBehavior(TransactionDefinition.PROPAGATION_REQUIRED);
// 获取事务状态
TransactionStatus status = transactionManager.getTransaction(def);
try {
int result = userMapper.batchInsert(userList);
// 提交事务
transactionManager.commit(status);
return result;
} catch (Exception e) {
// 回滚事务
transactionManager.rollback(status);
throw new RuntimeException("批量操作失败，已回滚", e);
}
}
}
</code></pre>
<h2 id="mybatis关联查询和延迟加载">Mybatis关联查询和延迟加载</h2>
<table>
<thead>
<tr>
<th>特性</th>
<th>嵌套查询（Nested Query）</th>
<th>嵌套结果（Nested Result）</th>
</tr>
</thead>
<tbody>
<tr>
<td><strong>原理</strong></td>
<td>执行多条SQL查询，在结果映射中引用其他查询</td>
<td>执行一条联合查询，在结果映射中处理嵌套对象</td>
</tr>
<tr>
<td><strong>SQL数量</strong></td>
<td>N+1 条（主查询 + N 条关联查询）</td>
<td>1 条（联合查询）</td>
</tr>
<tr>
<td><strong>性能</strong></td>
<td>有 N+1 问题，性能较差</td>
<td>性能较好，避免 N+1 问题</td>
</tr>
<tr>
<td><strong>复杂度</strong></td>
<td>简单，易于理解和维护</td>
<td>复杂，SQL 语句较复杂</td>
</tr>
<tr>
<td><strong>适用场景</strong></td>
<td>关联数据较少，延迟加载场景</td>
<td>关联数据较多，需要一次性加载所有数据</td>
</tr>
<tr>
<td><strong>内存占用</strong></td>
<td>较低，按需加载</td>
<td>较高，一次性加载所有数据</td>
</tr>
</tbody>
</table>
<h3 id="嵌套查询">嵌套查询</h3>
<p>在查询一个对象时，可以同时通过另一个查询语句来加载关联的另一个对象。例如，查询用户时，通过另一个查询语句来加载该用户的订单。</p>
<pre><code class="language-xml"><!-- UserMapper.xml -->
<!-- 1. 基本的嵌套查询 -->
<select id="selectUserWithOrders" parameterType="Long" resultMap="userWithOrdersMap">
SELECT * FROM users WHERE id = #{userId}
</select>
<resultMap id="userWithOrdersMap" type="User">
<id property="id" column="id"/>
<result property="username" column="username"/>
<result property="email" column="email"/>
<!-- 嵌套查询：通过 select 属性引用另一个查询 -->
<!-- 问题：会为每个用户执行一次 selectOrdersByUserId 查询 -->
<collection
property="orders"
column="id"<!-- 将主查询的 id 列值作为参数传递给嵌套查询 -->
ofType="Order"
select="selectOrdersByUserId"/><!-- 引用另一个查询语句 -->
</resultMap>
<select id="selectOrdersByUserId" parameterType="Long" resultType="Order">
SELECT * FROM orders WHERE user_id = #{userId}
</select>
<!-- 2. 一对多 + 一对一 多重嵌套 -->
<!-- 假设订单中还有订单项 -->
<select id="selectUserWithOrdersAndItems" resultMap="userWithOrdersAndItemsMap">
SELECT * FROM users WHERE id = #{userId}
</select>
<resultMap id="userWithOrdersAndItemsMap" type="User">
<id property="id" column="id"/>
<result property="username" column="username"/>
<result property="email" column="email"/>
<!-- 一级嵌套：用户的订单 -->
<collection
property="orders"
column="id"
ofType="Order"
select="selectOrdersByUserId"/>
</resultMap>
<!-- 订单映射，包含订单项 -->
<resultMap id="orderWithItemsMap" type="Order">
<id property="id" column="id"/>
<result property="orderNo" column="order_no"/>
<result property="amount" column="amount"/>
<result property="createTime" column="create_time"/>
<!-- 二级嵌套：订单中的订单项 -->
<collection
property="orderItems"
column="id"
ofType="OrderItem"
select="selectOrderItemsByOrderId"/>
</resultMap>
<select id="selectOrdersByUserId" parameterType="Long" resultMap="orderWithItemsMap">
SELECT * FROM orders WHERE user_id = #{userId}
</select>
<select id="selectOrderItemsByOrderId" parameterType="Long" resultType="OrderItem">
SELECT * FROM order_items WHERE order_id = #{orderId}
</select>
</code></pre>
<p>嵌套查询可能引起N+1问题：因为当我们查询一个列表时，对于列表中的每一条记录，都会执行一次额外的查询来加载关联数据。这样，如果有N条记录，就会执行1次主查询和N次关联查询，即N+1次查询。</p>
<h3 id="嵌套结果">嵌套结果</h3>
<p>通过一次复杂的联表查询，将结果映射到多个对象中。例如，通过一个SQL语句查询用户及其订单，然后通过结果映射将用户和订单的数据分别映射到用户对象和订单对象中。</p>
<pre><code class="language-xml"><!-- UserMapper.xml -->
<!-- 嵌套结果查询：一条SQL获取所有数据 -->
<select id="selectUserWithOrdersNested" parameterType="Long" resultMap="userWithOrdersNestedMap">
SELECT
u.id AS user_id,
u.username,
u.email,
o.id AS order_id,
o.order_no,
o.amount,
o.create_time
FROM users u
LEFT JOIN orders o ON u.id = o.user_id
WHERE u.id = #{userId}
</select>
<resultMap id="userWithOrdersNestedMap" type="User">
<id property="id" column="user_id"/>
<result property="username" column="username"/>
<result property="email" column="email"/>
<!-- 嵌套结果映射：处理联合查询的结果集 -->
<collection
property="orders"
ofType="Order"
resultMap="orderResultMap"/><!-- 引用订单的结果映射 -->
</resultMap>
<resultMap id="orderResultMap" type="Order">
<id property="id" column="order_id"/>
<result property="orderNo" column="order_no"/>
<result property="amount" column="amount"/>
<result property="createTime" column="create_time"/>
</resultMap>
</code></pre>
<h3 id="n1-查询问题详解">N+1 查询问题详解</h3>
<p>什么是 N+1 问题：当使用嵌套查询时，如果有 N 个主记录，每个主记录都有 M 个关联记录，那么会执行：</p>
<ul>
<li>1 条主查询</li>
<li>N 条关联查询</li>
</ul>
<p>总共执行 1 + N 条查询</p>
<p>演示案例：</p>
<pre><code class="language-java">@Test
public void testNPlusOneProblem() {
// 查询10个用户
List<User> users = userMapper.selectAllUsers();
// 嵌套查询会执行：
// 1. 查询所有用户: SELECT * FROM users; (1次)
// 2. 为每个用户查询订单: SELECT * FROM orders WHERE user_id = ? (N次，N=10)
// 总共执行 1 + 10 = 11 次查询！
for (User user : users) {
// 访问订单时触发额外查询
List<Order> orders = user.getOrders();
System.out.println("用户 " + user.getUsername() + " 有 " + orders.size() + " 个订单");
}
}
</code></pre>
<p>延迟加载可以解决N+1问题：延迟加载是指在需要使用关联数据时才去加载。在MyBatis中，可以配置延迟加载，这样在查询主对象时，不会立即加载关联对象，只有当访问关联对象时才会执行额外的查询。这样，如果访问了所有关联对象，那么还是会执行N+1次查询，但如果我们只访问部分主对象的关联对象，那么就可以减少查询次数。</p>
<h4 id="延迟加载解决方案">延迟加载解决方案</h4>
<ul>
<li>配置延迟加载：mybatis-config.xml 配置</li>
</ul>
<pre><code class="language-xml"><configuration>
<settings>
<!-- 开启延迟加载 -->
<setting name="lazyLoadingEnabled" value="true"/>
<!-- 关闭积极加载（3.4.1版本后默认为false），当开启时，任何方法的调用都会加载该对象的所有属性，否则，每个属性会按需加载 -->
<setting name="aggressiveLazyLoading" value="false"/>
<!-- 延迟加载触发方法，默认equals,clone,hashCode,toString -->
<setting name="lazyLoadTriggerMethods" value=""/>
<!-- 启用多结果集（某些数据库需要） -->
<setting name="multipleResultSetsEnabled" value="true"/>
</settings>
</configuration>
</code></pre>
<p>application.yml 配置（Spring Boot）</p>
<pre><code class="language-yaml">mybatis:
configuration:
lazy-loading-enabled: true
aggressive-lazy-loading: false
</code></pre>
<ul>
<li>在映射中使用延迟加载</li>
</ul>
<pre><code class="language-xml"><!-- 延迟加载配置示例 -->
<resultMap id="userWithLazyOrdersMap" type="User">
<id property="id" column="id"/>
<result property="username" column="username"/>
<result property="email" column="email"/>
<!-- 配置延迟加载 -->
<collection
property="orders"
column="id"
ofType="Order"
select="selectOrdersByUserId"
fetchType="lazy"/><!-- 设置为延迟加载 -->
</resultMap>
<!-- 或者通过全局配置，不在每个collection单独设置 -->
<collection
property="orders"
column="id"
ofType="Order"
select="selectOrdersByUserId"/>
</code></pre>
<p>但是，延迟加载只是将N+1次查询的时机推迟了，并没有从根本上减少查询次数。要解决N+1问题，更好的方式是使用嵌套结果（即一次联表查询）或者批量加载（MyBatis 3.4.1以上支持关联的批量加载）来减少查询次数。</p>
<h4 id="批量加载">批量加载</h4>
<pre><code class="language-xml"><!-- 配置批量加载 -->
<settings>
<!-- 开启批量加载 -->
<setting name="defaultExecutorType" value="BATCH"/>
<!-- 或者通过Mapper方法单独设置 -->
<!--
<select id="selectUserWithOrders" resultMap="userWithOrdersMap"
fetchSize="100" statementType="PREPARED">
-->
</settings>
</code></pre>
<h4 id="使用嵌套结果推荐">使用嵌套结果（推荐）</h4>
<pre><code class="language-xml"><!-- 使用嵌套结果替代嵌套查询 -->
<select id="selectUsersWithOrdersInBatch" resultMap="usersWithOrdersBatchMap">
SELECT
u.id AS user_id,
u.username,
u.email,
o.id AS order_id,
o.order_no,
o.amount,
o.create_time
FROM users u
LEFT JOIN orders o ON u.id = o.user_id
WHERE u.id IN
<foreach collection="userIds" item="id" open="(" separator="," close=")">
#{id}
</foreach>
ORDER BY u.id, o.create_time DESC
</select>
<resultMap id="usersWithOrdersBatchMap" type="User">
<id property="id" column="user_id"/>
<result property="username" column="username"/>
<result property="email" column="email"/>
<!-- 嵌套结果集合 -->
<collection property="orders" ofType="Order">
<id property="id" column="order_id"/>
<result property="orderNo" column="order_no"/>
<result property="amount" column="amount"/>
<result property="createTime" column="create_time"/>
</collection>
</resultMap>
</code></pre>
<h4 id="使用子查询--in-语句">使用子查询 + IN 语句</h4>
<pre><code class="language-xml"><!-- 通过子查询减少查询次数 -->
<select id="selectUsersWithOrdersSmart" resultMap="userWithOrdersMap">
SELECT * FROM users WHERE id IN (
SELECT DISTINCT user_id FROM orders
)
</select>
<select id="selectOrdersForUsers" resultType="Order">
SELECT * FROM orders
WHERE user_id IN
<foreach collection="userIds" item="userId" open="(" separator="," close=")">
#{userId}
</foreach>
</select>
</code></pre>
</div>
<div id="MySignature" role="contentinfo">
<p>本文来自在线网站：seven的菜鸟成长之路，作者：seven，转载请注明原文链接：www.seven97.top</p><br><br>
来源：https://www.cnblogs.com/sevencoding/p/19808942
頁:
[1]