mybatis属性详解

前言

MyBatis是基于“数据库结构不可控”的思想创建的，也就是咱们但愿数据库遵循第三范式或BCNF，但实际事与愿违，那么结果集映射就是MyBatis为咱们提供这种理想与现实间转换的手段了，而resultMap就是结果集映射的配置标签了。 
在深刻ResultMap标签前，咱们须要了解从SQL查询结果集到JavaBean或POJO实体的过程。

从SQL查询结果到领域模型实体　

1. 经过JDBC查询获得ResultSet对象
2. 遍历ResultSet对象并将每行数据暂存到HashMap实例中，以结果集的字段名或字段别名为键，以字段值为值
3. 根据ResultMap标签的type属性经过反射实例化领域模型
4. 根据ResultMap标签的type属性和id、result等标签信息将HashMap中的键值对，填充到领域模型实例中并返回

1、resultMap

一、属性说明

• id属性 ，resultMap标签的标识。
• type属性 ，返回值的全限定类名，或类型别名。
• autoMapping属性 ，值范围true（默认值）|false, 设置是否启动自动映射功能，自动映射功能就是自动查找与字段名小写同名的属性名，并调用setter方法。而设置为false后，则须要在resultMap内明确注明映射关系才会调用对应的setter方法。

二、基本做用：创建SQL查询结果字段与实体属性的映射关系 
示例1：经过setter构造领域模型

public class EStudent{ private long id; private String name; private int age; // getter,setter方法 /** * 必须提供一个无参数的构造函数 */ public EStudent(){} }

 

<select id="getStudent" resultMap="getStudentRM"> SELECT ID, Name, Age FROM TStudent </select> <resultMap id="getStudentRM" type="EStudnet"> <id property="id" column="ID"/> <result property="studentName" column="Name"/> <result property="studentAge" column="Age"/> </resultMap>

 

子元素说明：

• id元素 ，用于设置主键字段与领域模型属性的映射关系
• result元素 ，用于设置普通字段与领域模型属性的映射关系

id、result语句属性配置细节：

属性	描述
property	须要映射到JavaBean 的属性名称。
column	数据表的列名或者标签别名。
javaType	一个完整的类名，或者是一个类型别名。若是你匹配的是一个JavaBean，那MyBatis 一般会自行检测到。而后，若是你是要映射到一个HashMap，那你须要指定javaType 要达到的目的。
jdbcType	数据表支持的类型列表。这个属性只在insert,update 或delete 的时候针对容许空的列有用。JDBC 须要这项，但MyBatis 不须要。若是你是直接针对JDBC 编码，且有容许空的列，而你要指定这项。
typeHandler	使用这个属性能够覆写类型处理器。这项值能够是一个完整的类名，也能够是一个类型别名。

示例2：经过构造函数构造领域模型

<select id="getStudent" resultMap="getStudentRM"> SELECT ID, Name, Age FROM TStudent </select> <resultMap id="getStudentRM" type="EStudnet"> <constructor> <idArg column="ID" javaType="_long"/> <arg column="Name" javaType="String"/> <arg column="Age" javaType="_int"/> </constructor> </resultMap>

 

子元素说明：

• constructor元素 ，指定使用指定参数列表的构造函数来实例化领域模型。注意：其子元素顺序必须与参数列表顺序对应
• idArg子元素 ，标记该入参为主键
• arg子元素 ，标记该入参为普通字段(主键使用该子元素设置也是能够的)

三、一对一关系、一对多关系查询

注意：在采用嵌套结果的方式查询一对1、一对多关系时，必需要经过resultMap下的id或result标签来显式设置属性/字段映射关系，不然在查询多条记录时会仅仅返回最后一条记录的状况。

association联合

联合元素用来处理“一对一”的关系。须要指定映射的Java实体类的属性，属性的javaType（一般MyBatis 本身会识别）。对应的数据库表的列名称。若是想覆写的话返回结果的值，须要指定typeHandler。 
不一样状况须要告诉MyBatis 如何加载一个联合。MyBatis 能够用两种方式加载：

• select: 执行一个其它映射的SQL 语句返回一个Java实体类型。较灵活；
• resultsMap: 使用一个嵌套的结果映射来处理经过join查询结果集，映射成Java实体类型。

例如，一个班级对应一个班主任。 
首先定义好班级中的班主任 private TeacherEntity teacherEntity;

使用select实现联合 
例：班级实体类中有班主任的属性，经过联合在获得一个班级实体时，同时映射出班主任实体。 
这样能够直接复用在TeacherMapper.xml文件中定义好的查询teacher根据其ID的select语句。并且不须要修改写好的SQL语句，只须要直接修改resultMap便可。

ClassMapper.xml文件部份内容：

<resultMap type="ClassEntity" id="classResultMap"> <id property="classID" column="CLASS_ID" /> <result property="className" column="CLASS_NAME" /> <result property="classYear" column="CLASS_YEAR" /> <association property="teacherEntity" column="TEACHER_ID" select="getTeacher"/> </resultMap> <select id="getClassByID" parameterType="String" resultMap="classResultMap"> SELECT * FROM CLASS_TBL CT WHERE CT.CLASS_ID = #{classID}; </select> 

 

TeacherMapper.xml文件部份内容：

<resultMap type="TeacherEntity" id="teacherResultMap"> <id property="teacherID" column="TEACHER_ID" /> <result property="teacherName" column="TEACHER_NAME" /> <result property="teacherSex" column="TEACHER_SEX" /> <result property="teacherBirthday" column="TEACHER_BIRTHDAY"/> <result property="workDate" column="WORK_DATE"/> <result property="professional" column="PROFESSIONAL"/> </resultMap> <select id="getTeacher" parameterType="String" resultMap="teacherResultMap"> SELECT * FROM TEACHER_TBL TT WHERE TT.TEACHER_ID = #{teacherID} </select> 

 

使用resultMap实现联合 
与上面一样的功能，查询班级，同时查询器班主任。需在association中添加resultMap（在teacher的xml文件中定义好的），新写sql（查询班级表left join教师表），不须要teacher的select。

修改ClassMapper.xml文件部份内容：

<resultMap type="ClassEntity" id="classResultMap"> <id property="classID" column="CLASS_ID" /> <result property="className" column="CLASS_NAME" /> <result property="classYear" column="CLASS_YEAR" /> <association property="teacherEntity" column="TEACHER_ID" resultMap="teacherResultMap"/> </resultMap> <select id="getClassAndTeacher" parameterType="String" resultMap="classResultMap"> SELECT * FROM CLASS_TBL CT LEFT JOIN TEACHER_TBL TT ON CT.TEACHER_ID = TT.TEACHER_ID WHERE CT.CLASS_ID = #{classID}; </select> 

其中的teacherResultMap请见上面TeacherMapper.xml文件部份内容中。

collection汇集

汇集元素用来处理“一对多”的关系。须要指定映射的Java实体类的属性，属性的javaType（通常为ArrayList）；列表中对象的类型ofType（Java实体类）；对应的数据库表的列名称； 
不一样状况须要告诉MyBatis 如何加载一个汇集。MyBatis 能够用两种方式加载： 
1. select: 执行一个其它映射的SQL 语句返回一个Java实体类型。较灵活； 
2. resultsMap: 使用一个嵌套的结果映射来处理经过join查询结果集，映射成Java实体类型。

例如，一个班级有多个学生。 
首先定义班级中的学生列表属性：private List<StudentEntity> studentList;

使用select实现汇集 
用法和联合很相似，区别在于，这是一对多，因此通常映射过来的都是列表。因此这里须要定义javaType为ArrayList，还须要定义列表中对象的类型ofType，以及必须设置的select的语句名称（须要注意的是，这里的查询student的select语句条件必须是外键classID）。

ClassMapper.xml文件部份内容：

<resultMap type="ClassEntity" id="classResultMap"> <id property="classID" column="CLASS_ID" /> <result property="className" column="CLASS_NAME" /> <result property="classYear" column="CLASS_YEAR" /> <association property="teacherEntity" column="TEACHER_ID" select="getTeacher"/> <collection property="studentList" column="CLASS_ID" javaType="ArrayList" ofType="StudentEntity" select="getStudentByClassID"/> </resultMap> <select id="getClassByID" parameterType="String" resultMap="classResultMap"> SELECT * FROM CLASS_TBL CT WHERE CT.CLASS_ID = #{classID}; </select> 

StudentMapper.xml文件部份内容：

<!-- java属性，数据库表字段之间的映射定义 --> <resultMap type="StudentEntity" id="studentResultMap"> <id property="studentID" column="STUDENT_ID" /> <result property="studentName" column="STUDENT_NAME" /> <result property="studentSex" column="STUDENT_SEX" /> <result property="studentBirthday" column="STUDENT_BIRTHDAY" /> </resultMap> <!-- 查询学生list，根据班级id --> <select id="getStudentByClassID" parameterType="String" resultMap="studentResultMap"> <include refid="selectStudentAll" /> WHERE ST.CLASS_ID = #{classID} </select> 

 

使用resultMap实现汇集 
使用resultMap，就须要重写一个sql，left join学生表。

<resultMap type="ClassEntity" id="classResultMap"> <id property="classID" column="CLASS_ID" /> <result property="className" column="CLASS_NAME" /> <result property="classYear" column="CLASS_YEAR" /> <association property="teacherEntity" column="TEACHER_ID" resultMap="teacherResultMap"/> <collection property="studentList" column="CLASS_ID" javaType="ArrayList" ofType="StudentEntity" resultMap="studentResultMap"/> </resultMap> <select id="getClassAndTeacherStudent" parameterType="String" resultMap="classResultMap"> SELECT * FROM CLASS_TBL CT LEFT JOIN STUDENT_TBL ST ON CT.CLASS_ID = ST.CLASS_ID LEFT JOIN TEACHER_TBL TT ON CT.TEACHER_ID = TT.TEACHER_ID WHERE CT.CLASS_ID = #{classID}; </select> 

 

其中的teacherResultMap请见上面TeacherMapper.xml文件部份内容中。studentResultMap请见上面StudentMapper.xml文件部份内容中。

4. 动态映射关系 
经过 discriminator子元素 （鉴别器）能够实现动态映射关系信息的设置。具体示例以下：

public class EStudent{ private long id; private String name; private String juniorHighSchool; private String seniorHighSchool; private int during; // 在本校就读时间 // getter,setter方法 /** * 必须提供一个无参数的构造函数 */ public EStudent(){} }

情景：查询学生信息的seniorHighSchool信息，若就读时间during字段值为四、五、6时，则以juniorHighSchool字段做所为seniorHighSchool信息。

<select id="getStundent" resultMap="rm"> SELECT ID, Name, JuniorHighSchool, SeniorHighSchool, during FROM TStudent </select> <resultMap id="rm" type="EStudent"> // 若不加这句，则当将juniorHighSchool赋予给seniorHighSchool属性时，juniorHighSchool属性将为null <result column="juniorHighSchool" property="juniorHighSchool"/> <discriminator column="during" javaType="_int"> // 形式1：经过resultType设置动态映射信息 <case value="4" resultType="EStudent"> <result column="juniorHighSchool" property="seniorHighSchool"/> </case> // 形式2: 经过resultMap设置动态映射信息 <case value="5" resultMap="dynamicRM"/> <case value="6" resultMap="dynamicRM"/> </discriminator> </resultMap> <resultMap id="dynamicRM" type="EStudent"> <result column="juniorHighSchool" property="seniorHighSchool"/> </resultMap>

注意：上面关于 discriminator子元素 的 case元素 的 resultType属性 和 resultMap元素 的 type属性 ，均不是直指返回的领域模型类型，而是指定根据判断条件后获得映射关系，可经过 id子元素 和 result子元素 重写映射关系。

5. id元素,result元素,idArg元素,arg元素,discriminator元素的共同属性

• javaType属性 ：Java类的全限定名，或别名
• jdbcType属性 ：JDBC类型, JDBC类型为CUD操做时列可能为空时进行处理
• typeHandler属性 ：指定类型处理器的全限定类名或类型别名
• column属性 ：指定SQL查询结果的字段名或字段别名。将用于JDBC的 resultSet.getString(columnName)