MyBatis技术总结
什么是MyBatis?
MyBatis 是一款优秀的持久层框架,它支持自定义 SQL、存储过程以及高级映射。MyBatis 避免了几乎所有的 JDBC 代码和手动设置参数以及获取结果集。MyBatis 可以通过简单的 XML 或注解来配置和映射原始类型、接口和 Java POJO(Plain Old Java Objects,普通老式 Java 对象)为数据库中的记录。
MyBatis中的主要组成部分
SqlSessionFactoryBuilder( 工厂构造器 ) :根据配置文件来生成SqlSessionFactory SqlSessionFactoryBuilder生命周期及其作用域:(就是SqlSessionFactory的建造器,典型的工厂模式。创建后就不再需要了,因为就是为了创造SqlSessionFactory的工具类。因此 SqlSessionFactoryBuilder 实例的最佳作用域是方法作用域(也就是局部方法变量)。你可以重用 SqlSessionFactoryBuilder 来创建多个 SqlSessionFactory 实例,但是最好还是不要让其一直存在以保证所有的 XML 解析资源开放给更重要的事情。SqlSessionFactory(SqlSession工厂):通过SqlSessionFactory创建SqlSessionSqlSessionFactory生命周期及其作用域:类似于数据库连接池。qlSessionFactory 一旦被创建就应该在应用的运行期间一直存在,没有任何理由对它进行清除或重建。使用 SqlSessionFactory 的最佳实践是在应用运行期间不要重复创建多次,多次重建 SqlSessionFactory会导致资源被消耗尽,所以尽量哦i便这样的情况,因此 SqlSessionFactory 的最佳作用域是应用作用域。SqlSession(会话):执行SQL并返回结果。SQL Mapper:它由一个Java接口和XML文件(或注解)构成。接口负责定义数据访问接口, XML文件(或注解)负责定义SQL和映射规则。
SqlSessionFactory创建代码示例:
//单例模式
privatestaticfinalStringCONFIG="mybatis-config.xml";//配置文件
privatestaticSqlSessionFactorysqlSessionFactory;//SqlSessionFactory对象
privatestaticfinalClass<MyBatisUtils>CLASS_LOCK=MyBatisUtils.class;//类级别锁
static{
//初始化
initSqlSessionFactory();
}
//私有的构造方法,保证MyBatis工具类不会被实例化
privateMyBatisUtils() {
}
privatestaticSqlSessionFactoryinitSqlSessionFactory() {
if(sqlSessionFactory==null) {
synchronized(CLASS_LOCK) {
try(InputStreaminputStream=Resources.getResourceAsStream(CONFIG)) {
sqlSessionFactory=new。SqlSessionFactoryBuilder().build(inputStream);
}catch(IOExceptione) {
e.printStackTrace();
}
}
}
returnsqlSessionFactory;
}
publicstaticSqlSessionopenSqlSession() {
if(sqlSessionFactory==null) {
initSqlSessionFactory();
}
returnsqlSessionFactory.openSession();
}
SqlSession的作用和生命周期:执行SQL并返回结果。类似数据库的一个Connection对象。因此每次使用完就应该要关闭,这样才能回收到SqlSessionFactory中继续利用,而且SqlSession不是线程安全的,不能被共享。所以它的最佳的作用域是请求或方法作用域,绝对不能将 SqlSession 实例的引用放在一个类的静态域,甚至一个类的实例变量也不行。也绝不能将 SqlSession 实例的引用放在任何类型的管理作用域中。
SqlSession创建代码示例:
try(SqlSessionsqlSession=MyBatisUtils.openSqlSession();){
}catch(Exceptione) {
e.printStackTrace();
MyBatis配置
设置(settings)
主要作用:MyBatis框架运行规则配置
设置(settings)代码示例:
<settings>
<!-- 开启日志 -->
<settingname="logImpl"value="STDOUT_LOGGING"/>
</settings>
类型别名(typeAliases)
主要作用:别名处理器,是为 Java 类型设置一个短的名字,可以方便我们引用某个类。
类型别名(typeAliases)代码示例:
<!-- 设置别名(为实体类设置别名) -->
<typeAliases>
<!-- 为每一个实体设置别名 -->
<!--
<typeAlias type="com.apesource.entity.Employee" alias="Employee"/>
<typeAlias type="com.apesource.entity.Order" alias="Order"/>
-->
<!-- 设置实体类包,为该package中的每个实体类自动设置别名 -->
<packagename="com.apesource.entity"/>
</typeAliases>
环境配置(environments)
主要作用:元素体包含事务管理器和数据源配置
环境配置(environments)代码示例:
<!-- 环境列表 -->
<!-- default:设置当前使用的环境environment id -->
<environmentsdefault="development">
<!-- 环境1(开发) -->
<environmentid="development">
<!-- 事务管理器:采用JDBC事务 -->
<transactionManagertype="JDBC"/>
<!-- 数据源(数据库连接池) -->
<!-- type设置为pooled,启动数据库连接池 -->
<dataSourcetype="POOLED">
<!-- 数据库连接参数 -->
<propertyname="driver"value="${driver_class}"/>
<propertyname="url"value="${jdbc_url}"/>
<propertyname="username"value="${db_username}"/>
<propertyname="password"value="${db_password}"/>
</dataSource>
</environment>
</environments>
映射器(mappers)
主要作用:包含了一组映射器(mapper),这些映射器的XML文件包含了SQL代码和映射定义信息。
映射器(mappers)代码示例:
<!-- 映射器列表 -->
<mappers>
<!-- SQL映射文件 -->
<!--使用相对于类路径的资源引用【推荐使用】-->
<mapperresource="com/apesource/dao/mapper/AnswerRecordMapper.xml"/>
<!-- Mapper接口:使用映射器接口实现类的完全限定名
<mapper class="com.apesource.dao.mapper.AnswerRecordMapper"/>
-->
</mappers>
MyBatis XML 映射器
1.常用节点作用总结
select :映射select查询SQL语句
update:映射update修改SQL语句
delete:映射delete删除SQL语句
insert:映射insert插入SQL语句
2.常用属性作用总结
id 属性:唯一标识名称,与接口方法名称一致
resultType 属性:返回值类型,与接口方法返回值类型一致
parameterType 属性:设置某种操作时使用的实体类(别名)
useGeneratedKeys属性:开启主键回填
keyProperty属性:设置主键回填的属性名称
3.常见SQL映射示例
示例1:普通增加
SQL映射配置
<!-- 添加新答题记录 -->
<insertid="insertAnswerRecord"
parameterType="AnswerRecord"
useGeneratedKeys="true"
keyProperty="recordId">
insert into answer_record(respondent,question,right_answer,submit_answer,submit_datetime)
values(#{respondent},#{question},#{rightAnswer},#{submitAnswer},now())
</insert>
接口方法定义
/** 添加新答题记录
* @param answerRecord 答题记录对象
* @return 影响行数
* ps.测试时需要输出新答题记录的编号
*/
intinsertAnswerRecord(AnswerRecordanswerRecord);
示例2:批量增加
SQL映射配置
<insertid="insertAnswerRecordBatch"
parameterType="list"
useGeneratedKeys="true"keyProperty="recordId">
INSERT INTO answer_record(respondent,question,right_answer,submit_answer,submit_datetime)
VALUES
<foreachcollection="list"item="record"separator=",">
(
#{record.respondent},
#{record.question},
#{record.rightAnswer},
#{record.submitAnswer},
now()
)
</foreach>
</insert>
接口方法定义
/**
* 批量添加新答题记录
* @param answerRecordList 添加数据集合
* @return 影响行数
*/
intinsertAnswerRecordBatch(List<AnswerRecord>answerRecordList);
示例3:普通删除
SQL映射配置
<deleteid="deleteAnswerRecord">
delete from answer_record
where record_id = #{id}
</delete>
接口方法定义
/**
* 删除答题记录
* @param recordId 答题记录编号
* @param recordId 答题记录编号
* @return 影响行数
*/
intdeleteAnswerRecord(@Param("id")intrecordId);
示例4:批量删除
SQL映射配置
<deleteid="deleteAnswerRecordBatch"
parameterType="list">
DELETE FROM answer_record
WHERE record_id IN
<foreachcollection="list"item="rid"separator=","open="("close=")">
#{rid}
</foreach>
</delete>
接口方法定义
/**
* 批量删除答题记录
* @param recordIdList
* @return
*/
intdeleteAnswerRecordBatch(List<Integer>recordIdList);
示例5:动态修改
SQL映射配置
<!-- set节点用于动态处理update语句中的set -->
<!-- if节点用于条件判断 -->
<updateid="updateAnswerRecord"parameterType="AnswerRecord">
update answer_record
<set>
<iftest="respondent!=null">respondent = #{respondent},</if>
<iftest="question!=null">question = #{question},</if>
<iftest="rightAnswer!=null">right_answer = #{rightAnswer},</if>
<iftest="submitAnswer!=null">submit_answer = #{submitAnswer},</if>
submit_datetime = now()
</set>
where record_id = #{recordId}
</update>
接口方法定义
/**
* 修改答题记录
* @param answerRecord 答题记录对象(包含答题记录编号)
* @return 影响行数
*/
intupdateAnswerRecord(AnswerRecordanswerRecord);
示例6:动态查询
SQL映射配置
<!-- where节点:处理where子句和条件之间的关系 -->
<selectid="listAnswerRecordByCondition"
resultType="AnswerRecord"
parameterType="AnswerRecord">
SELECT record_id AS recordId,
respondent,
question,
right_answer AS rightAnswer,
submit_answer AS submitAnswer,
submit_datetime AS submitDatetime
FROM answer_record
<where>
<iftest="respondent != null">
AND respondent = #{respondent}
</if>
<iftest="question != null">
AND question LIKE concat('%',#{question},'%')
</if>
<iftest="rightAnswer != null">
AND right_answer = #{rightAnswer}
</if>
<iftest="submitAnswer != null">
AND submit_answer = #{submitAnswer}
</if>
</where>
</select>
接口方法定义
/**
* 按照条件对象中的多条件值,动态查询
* @param condition 条件对象
* @return 答题记录集合
*/
List<AnswerRecord>listAnswerRecordByCondition(AnswerRecordcondition);
示例7:查询结果封装为Map
SQL映射配置
<selectid="countAnswerRecordDataByRespondent"
resultType="map">
SELECT count(record_id) as total,
(SELECT count(record_id) FROM answer_record WHERE respondent = #{name} AND right_answer = submit_answer ) as right_count,
(SELECT count(record_id) FROM answer_record WHERE respondent = #{name} AND right_answer != submit_answer ) as fail_count
FROM answer_record
WHERE respondent = #{name}
</select>
接口方法定义
/**
* 按照答题者姓名,统计该答题者的总答题数目、正确题目数目、错误题目数目
* @param respondent
* @return
*/
Map<String,Integer>countAnswerRecordDataByRespondent(@Param("name")Stringrespondent);