深入理解MyBatis的原理(四):映射器的用法
前言:继续深入学习 mybatis 的用法及原理,还是先会用再学习原理。
映射器的主要元素有:select、insert、update、delete、parameterMap(即将被删除,不建议使用)、sql、resultMap、cache、cache-ref
各个元素的规则定义:见源码中的文件 org/apache/ibatis/builder/xml/mybatis-3-mapper.dtd
目录:
一、select 元素
二、insert 元素
三、update 元素
四、delete 元素
五、参数
六、SQL 片段重用
七、resultMap 结果映射集
一、select 元素
1、查询,select 元素有以下属性:
id:和 Mapper 的命名空间组合起来必须是唯一的,供给 MyBatis 上下文调用。
parameterType:查询参数类型。一般给出类的全命名,也可以给出类的别名。可以选择 JavaBean、Map 等复杂的参数类型传递给 SQL。
resultType:查询返回数据类型。一般给出类的全命名,或者别名,不能和 resultMap 同时使用。
resultMap:查询返回映射集的引用,将执行强大的映射功能。不能和 resultType 同时使用。它是 MyBatis 最复杂的元素,可以自定义映射规则、级联、typeHandle 等。
flushCache:它的作用是在调用 SQL 后,是否要求 MyBatis 清空之前查询的本地缓存和二级缓存。取值为 boolean,默认 false。
useCache:启动二级缓存的开关,是否要求 MyBatis 将此次结果缓存。取值为 boolean,默认 true。
timeout:这是超时参数,等超时的时候将抛出异常,单位为秒。默认值为数据库厂商提供的 JDBC 驱动所设置的秒数。
fetchSize:获取记录的总条数。默认值为数据库厂商提供的 JDBC 驱动所设置的条数。
statementType:选择使用 JDBC 的 Statement 工作,取值为 STATEMENT、PREPARED、CallableStatement。默认 PREPARED。
resultSetType:很少使用
databaseId:数据库厂商标识,提供多数据库的支持。
resultOrdered:很少使用
resultSets:很少使用
2、举例
dao 接口
/*** 通过名字查找用户* @param name* @return*/User queryUserByName(String name);
xml
<select id="queryUserByName" resultType="com.yule.user.entity.User">select t.id, t.name, t.age from t_user twhere t.name = #{name,jdbcType=VARCHAR}</select>
3、自动映射
当配置 autoMappingBehavior 不是 NONE 时,MyBatis 会提供自动映射功能,只要返回的 sql 列名(别名)和 JavaBean 的属性一致,MyBatis 就会帮助我们回填这些字段无需任何配置,它可以在很大程度上简化我们的配置工作。
在实际中,通常我们是使用 sql 列名的别名的方式自动映射。上方例子的 resultType="com.yule.user.entity.User" 就是 MyBatis 的自动映射。
在实际中,也可以通过在配置文件中开启驼峰命名方式:mapUndersoreToCamlCase 为 true。这种方式的前提是数据库命名是规范的,即每一个单词都用下划线分割,POJO 采用的是驼峰命名方式,那么可以设置配置文件,从而达到从数据库到 POJO 的自动映射了。
自动映射在 MyBatis 的配置文件中,元素 settings 中可以配置 autoMappingBehavior 属性值来设置其策略,它包含 3 个值:
- NONE:取消自动映射
- PARTIAL:只会自动映射,没有定义嵌套结果集映射的结果集。为默认值。
- FULL:会自动映射任意复杂的结果集(无论是否嵌套),性能会下降。
在大部分的情况下 MyBatis 都会推断你返回数据的类型,所以大部分情况下你都无需去配置参数类型和结果类型。要我们设置的往往只是可能返回为空的字段类型而已。因为 null 值,MyBatis 无法判断其类型。
4、传递多个参数
一、使用 map,缺点是业务关联性不强,造成代码可读性下降。
二、使用注解 @Param,xml 中无需定义参数类型。可读性增强,但是当参数个数太多时,可读性仍然会下降。
三、使用 JavaBean 传递参数。
这三种方式对比:
- 使用 Map 传递参数。因为 Map 导致代码的可读性下降,会导致后面的扩展和维护比较困难,所以建议少使用这种方式。
- 使用 @Param 注解方式。这种方式可读性高,但是当参数个数很多的时候,同样会导致可读性和维护性下降,所以,当参数个数小于等于 5 时,建议采取这种方式。
- 使用实体 JavaBean 的方式。当参数个数大于 5 时,建议采取这种方式。
5、使用 resultMap 映射结果集
对于简单的映射,建议采用自动映射就好,可以减少配置。resultMap 映射一般就用于复杂、级联这些关联的配置。所以这个放在 resultMap 结果映射集讲。
二、insert 元素
1、插入,insert 元素有一下属性:
id:同 select
parameterType:同 select
flushCache:同 select
timeout:同 select
statemeterType:同 select
keyProperty:表示以哪个列作为属性的主键。不能和 keyColumn 同时使用。联合主键可以用逗号隔开。
useGeneratedKeys:这会令 MyBatis 使用 JDBC 的 getGeneratedKeys 方法来取出数据库内部生成的主键,使用该属性后就必须使用keyColumn或者KeyProperty属性中的一个。取值为 boolean 值,默认 false。
keyColumn:指明第几列是主键。不能和 keyProperty 同时使用。联合主键可以用逗号隔开。只接受整形参数。
databaseId:同 select
lang:使用很少
2、举例
dao 接口
/*** 新增用户* @param user* @return*/int insertUser(User user);
xml,自定义规则:使用序列实现主键回填,即执行完新增后返回主键 id。这个能把主键 id 回填到实体 User 上去。
MyBatis 中 不允许同事包含连两个 selectKey 标签。
<insert id="insertUser"><selectKey keyProperty="id" order="BEFORE" resultType="int">select t_user_s.nextval from dual</selectKey>insert into t_user(id, name, age)values(#{id}, #{name}, #{age})</insert>
测试
@Testpublic void testInsertUser(){SqlSessionFactory sqlSessionFactory = getSqlSessionFactory();SqlSession sqlSession = sqlSessionFactory.openSession();UserDao mapper = sqlSession.getMapper(UserDao.class);User user = new User("yule", "24");mapper.insertUser(user);sqlSession.commit();sqlSession.close();System.out.println(user.toString());}
3、举例2
xml,使用主键自增长(必须在表中设置 id 字段为自增字段),同时 sql 执行完成之后 MyBatis 自动将执行完 sql 后自动生成的 id 回填到我们的参数 User 对象中。
<insert id="insertUser" useGeneratedKeys="true" keyProperty="id">insert into t_user(name, age)values(#{name}, #{age})</insert>
三、update 元素
1、修改,和 insert 一样,MyBatis 执行完后会返回一个整数,标出执行后影响的条数。
2、举例
dao 接口
/*** 修改用户信息* @param user* @return*/int updateUserById(User user);
xml
<update id="updateUserById">update t_user t set t.age = #{age}, t.name = #{name}where t.id = #{id}</update>
四、delete 元素
1、删除,和 insert 一样,MyBatis 执行完后会返回一个整数,标出执行后影响的条数。
2、举例
dao 接口
int deleteUserById(String id);
xml
<delete id="deleteUserById">delete t_user t where t.ID = #{id}</delete>
五、参数
定义参数属性时,MyBatis 不允许换行!!!
1、参数配置
我们可以通过制定参数的类型去让对应的 typeHandle 处理它们,也可以通过指定对应的 JavaType、JdbcType 来明确使用哪个 typeHandle 处理参数。详见 https://www.cnblogs.com/yuxiaole/p/9464019.html#typeHandler
2、存储过程支持
对于存储过程而言,存在 3 种参数,输入参数(IN)、输出参数(OUT)、输入输出参数(INOUT)。MyBatis 的参数规则为其提供了良好的支持。
3、特殊字符串替换和处理(# 和 $)
使用 #{} 方式,MyBatis 会用创建预编译的语句,然后 MyBatis 为它设值。
使用 ${} 方式,传递 SQL 语句本身,比如传递 SQL 的列名、根据某些列排序等。比如 select ${columns} from t_tablename 来支持传递动态列名。不过使用这种方式是不安全的,所以虽然 MyBatis 是给了灵活性,但是自己也需要控制参数来保证 SQL 运转的正确性和安全性。
六、SQL 片段重用
采用 <include refid="sql_id"></include> 来实现 SQL 片段的重用。SQL 片段是指用 <sql></sql> 定义的片段。
比如:给 include 标签加一个 refid 属性进行引用,从而达到重用的功能
<sql id="user_columns">${prefix}.id, ${prefix}.name, ${prefix}.age</sql><select id="queryUserByName" resultType="com.yule.user.entity.User">select<include refid="user_columns"><property name="prefix" value="t"/></include>from t_user twhere t.name = #{name,jdbcType=VARCHAR}</select>
或者,可以直接给 refid 一个参数值,由程序制定引入 SQL
<select id="queryUserList" resultType="User" ><include refid="common_query"><property name="columnsName" value="user_columns"/></include></select>
<sql id="common_query">select<include refid="${columnsName}"><property name="prefix" value="t"/></include>from t_user t</sql>
七、resultMap 结果映射集
resultMap 是 MyBatis 中最复杂的元素。主要是定义一个查询中的结果集的映射关系,不支持修改、删除。作用是定义映射规则、级联的更新、定制类型转换器等。
1、resultMap 元素里面的构成
见源码:org/apache/ibatis/builder/xml/mybatis-3-mapper.dtd
<!ELEMENT resultMap (constructor?,id*,result*,association*,collection*, discriminator?)>
其中,constructor 元素用于配置实体构造方法。表示告诉 MyBatis 用实体的哪个构造方法来构造实体。
<!ELEMENT constructor (idArg*,arg*)>
其中,id 元素是表示哪个列是主键,允许多个主键,多个主键称为联合主键。
其中,result 元素是配置 POJO 到 SQL 列名的映射关系。
result 和 id 两个元素都有如下属性:
- property:代表 POJO 的属性名称。映射到列结果的字段或属性,如果 POJO 的属性匹配是存在的,和给定 SQL 列名(column 元素)相同的,那么 MyBatis 就会映射到 POJO 上。
- column:对应的是 SQL 的列名。
- javaType:配置 Java 的字段类型
- jdbcType:配置数据库中的字段类型
- typeHandle:类型处理器
2、使用 map 存储结果集
select 元素中使用 resultMap 会使可读性下降,所以建议更多时候使用 POJO 的方式来自动映射,即 resultType。
resultMap 元素的属性 id 代表这个 resultMap 的标识,type 代表需要映射的 POJO。
<!ATTLIST resultMap id CDATA #REQUIRED type CDATA #REQUIRED extends CDATA #IMPLIED autoMapping (true|false) #IMPLIED >
举例:SQL 语句的列名需要和 column 一 一对应。
<resultMap id="userResultMap" type="com.yule.user.entity.User"><constructor><idArg column="id" javaType="string"/><arg column="name" javaType="string"/><arg column="age" javaType="string"/></constructor><id property="id" column="id"/><result property="name" column="name"/><result property="age" column="age"/></resultMap>
<select id="queryUserById" resultMap="userResultMap">select t.id, t.name, t.age from t_user twhere t.id = #{id}</select>
3、级联
有 3 中关系:一对一、一对多、多对多。多对多可用一对多双向标识。
在 MyBatis 中级联分为这么 3 种:
- association:一对一。
- collection:一对多。
- discriminator:鉴别器。可以根据实际选择采用哪个类作为实例,允许根据特定的条件去关联不同的结果集。
举例:
转载于:https://www.cnblogs.com/yuxiaole/p/9478618.html
深入理解MyBatis的原理(四):映射器的用法相关推荐
- 深入理解MyBatis的原理(三):配置文件(上)
前言:前文提到一个入门的demo,从这里开始,会了解深入 MyBatis 的配置,本文讲解 MyBatis 的配置文件的用法. 目录 1.properties 元素 2.设置(settings) 3. ...
- Mybatis 强大的结果映射器ResultMap
1. 前言 resultMap 元素是 MyBatis 中最重要最强大的元素.它可以让你从 90% 的 JDBC ResultSets 数据提取代码中解放出来,并在一些情形下允许你进行一些 JDBC ...
- Could not find resource——mybatis 找不到映射器xml文件
今天用IDEA写Mybatis的时候,测试报了如图所示的错,恶心死我了,后来解决了,总结一下,防止下回跳坑,当然,也是做一个分享,如果有朋友遇到这个错,希望有所帮助 Error parsing SQL ...
- MyBatis学习之映射器Mapper(接口映射器+xml映射文件)
Table of Contents 01 MyBatis映射器: 1.1 接口映射器+xml映射器 1.2 接口映射器+注解 02 接口映射器+xml映射器 方式 2.1 mybatis配置文件 引 ...
- 深入理解mybatis原理, Mybatis初始化SqlSessionFactory机制详解(转)
文章转自http://blog.csdn.net/l454822901/article/details/51829785 对于任何框架而言,在使用前都要进行一系列的初始化,MyBatis也不例外.本章 ...
- 深入浅出MyBatis:「映射器」全了解
本篇文章是「深入浅出MyBatis:技术原理与实践」书籍的总结笔记. 上一篇总结了MyBatis的配置,详细说明了各个配置项,其中提到了映射器,它是MyBatis最强大的工具,也是使用最多的工具. 通 ...
- mybatis 原理_深入理解MyBatis原理 MyBatis数据源与连接池
点击上方"程序开发者社区"关注,选择"设为星标" 第一时间送达实用干货 对于ORM框架而言,数据源的组织是一个非常重要的一部分,这直接影响到框架的性能问题.本文 ...
- 《深入理解Mybatis原理》 02-Mybatis数据源与连接池
对于ORM框架而言,数据源的组织是一个非常重要的一部分,这直接影响到框架的性能问题.本文将通过对MyBatis框架的数据源结构进行详尽的分析,并且深入解析MyBatis的连接池. 本文首先会讲述MyB ...
- 《深入理解mybatis原理三》 Mybatis数据源与连接池
对于ORM框架而言,数据源的组织是一个非常重要的一部分,这直接影响到框架的性能问题.本文将通过对MyBatis框架的数据源结构进行详尽的分析,并且深入解析MyBatis的连接池. 本文首先会讲述MyB ...
最新文章
- SQL创建linkserver
- git reset --hard 恢复
- 全套CRC校验的算法
- jenkins搭建流程
- 读写应用程序数据-NSUserDefault、对象归档(NSKeyedArchiver)、文件操作
- GAP(全局平均池化层)操作
- java 不可修改的map_Java中如何实现不可变Map详解
- 工作中应用计算机,浅谈计算机在我国计工作中的应用与发展.doc
- Facebook 游戏开发更新文档 API 参考文档 v6.0
- iview this.$modal 关闭所有的弹窗_一看会用TOB弹窗应用场景
- FileInputStreamFileOutputStream
- 查成语--每天10行python代码系列!
- 系统分析师 VS 系统架构设计师,哪个证书含金量比较高?
- hang计算机术语大全,行业英语学习
- 百度深度学习实验室(IDL)招聘算法实习生
- Html5之canvas重叠矩形、getContext、fillStyle、fillRect
- 高盛为什么认为中国AI领域将超越美国?
- Windows 安装Docker碰到 cannot enable hyper-v service
- Axure 放大与缩小
- 数据库查出数据int类型全是0