mybatis从入门到精通(三) 结果映射
一丶什么是结果映射
结果映射是用于将数据库表字段和实体类中的属性名映射起来, 即究竟是哪个字段名与属性名对应. 映射之后, 即可通过mybatis将从数据库查询的结果转换成对应的实体类对象类型, 除去了人工转换的麻烦.
二丶自动映射
所谓的自动映射, 即是默认java实体类的属性名是驼峰式, 而数据库表字段名是以下划线分隔, 如 属性名userName 与 表字段user_name相对应, 如果是这种简单通用的规则, 即可通过配置mybatis, 使得mybatis自动映射.
) 在mybatis-config.xml中配置开启下划线和驼峰式的自动映射
settings>
<!-- 是否开启下划线和驼峰式的自动转换, http://www.mybatis.org/mybatis-3/zh/sqlmap-xml.html#Auto-mapping -->
<setting name="mapUnderscoreToCamelCase" value="true"/>
</settings>
2) 在userReulstMapper.xml中配置对应的<ResultMap>, 只需配置id即可, 用于指定唯一标识, 其他映射由mybatis自动处理
<!--
使用下划线和驼峰式的自动映射(autoMapping)转换, http://www.mybatis.org/mybatis-3/zh/sqlmap-xml.html#Auto-mapping,
需要在mybatis-config.xml配置文件中配置mapUnderscoreToCamelCase属性为true,
可在resultMap中设置autoMapping来控制是否开启自动映射, 默认为true
-->
<resultMap id="UserAutoResultMap" type="com.ttx.example.pojo.UserResult" autoMapping="true">
<id column="user_id"/> <!-- 标识主键-->
</resultMap>
3) 写入mapper查询方法
UserResultMapper.java
List<UserResult> selectUserByUserNameLike(@Param("userName") String userName);
UserResultMapper.xml
<select id="selectUserByUserNameLike" resultMap="UserAutoResultMap">
select * from user where user_name like #{userName}
</select>
4) ResultMapTests.java 测试类方法
@Test
public void autoMappingTest(){
// 测试结果集下划线和驼峰式的自动映射转换
List<UserResult> userResults=userResultMapper.selectUserByUserNameLike("t%");
Assert.assertTrue(userResults.size()>1);
}
二丶普通的单表结果映射
如下方的结果映射配置, type标明该配置会映射转换成对应的实体类型, 其中子元素<id/>用于标明该字段为唯一标识, 用于区分多条数据, <result/>则是普通的字段映射.
column属性用于指明表字段名, property用于指明对应实体类的属性名
<resultMap id="UserMap" type="com.ttx.example.entity.User">
<id column="user_id" property="userId"/>
<result column="user_name" property="userName"/>
<result column="age" property="age"/>
<result column="country" property="country"/>
</resultMap>
更多配置细节可以查看官方文档
三丶关联结果映射
一般的应用, 肯定不仅仅只是单表查询这么简单, 还会存在多表关联查询. 此时,查询的结果会很是复杂, 因此有了 关联<association/> 和 集合<collection/> 映射.
关联<association/> 和 集合<collection/> 作用类似, <collection/> 主要是多了ofType属性, 用于指明List<ofType>中的泛型类型, 但一般无须配置, mybatis会自动处理.
首先, 我们来看两张单表对应的实体类
public class UserResult {
private Integer userId;
private String userName;
private Integer age;
private String country;
public Integer getUserId() {
return userId;
}
public void setUserId(Integer userId) {
this.userId = userId;
}
public String getUserName() {
return userName;
}
public void setUserName(String userName) {
this.userName = userName;
}
public Integer getAge() {
return age;
}
public void setAge(Integer age) {
this.age = age;
}
public String getCountry() {
return country;
}
public void setCountry(String country) {
this.country = country;
}
}
public class Email {
private Integer emailId;
private Integer userId;
private String emailAddress;
private String password;
public Integer getEmailId() {
return emailId;
}
public void setEmailId(Integer emailId) {
this.emailId = emailId;
}
public Integer getUserId() {
return userId;
}
public void setUserId(Integer userId) {
this.userId = userId;
}
public String getEmailAddress() {
return emailAddress;
}
public void setEmailAddress(String emailAddress) {
this.emailAddress = emailAddress;
}
public String getPassword() {
return password;
}
public void setPassword(String password) {
this.password = password;
}
}
再看, 关联的pojo类
public class UserResultEmail {
private Integer userId; //需要使用userId标识
private UserResult userResult;
private List<Email> emailList; // 关联 或者 集合
public Integer getUserId() {
return userId;
}
public void setUserId(Integer userId) {
this.userId = userId;
}
public UserResult getUserResult() {
return userResult;
}
public void setUserResult(UserResult userResult) {
this.userResult = userResult;
}
public List<Email> getEmailList() {
return emailList;
}
public void setEmailList(List<Email> emailList) {
this.emailList = emailList;
}
}
2) 关联的映射配置如下:
<resultMap id="UserResultMap" type="com.ttx.example.pojo.UserResult">
<constructor></constructor> <!-- 用于引用构造参数, 可以省略掉 -->
<id column="user_id" property="userId"/> <!-- id 元素表示的结果将是对象的标识属性 -->
<result column="user_name" property="userName"/>
<result column="age" property="age"/>
<result column="country" property="country"/>
</resultMap>
<resultMap id="EmailMap" type="com.ttx.example.pojo.Email">
<id column="email_id" property="emailId"/> <!-- id 元素表示的结果将是对象的标识属性 -->
<result column="user_id" property="userId"/> <!-- 关联userResult的user_id属性-->
<result column="email_address" property="emailAddress"/>
<result column="password" property="password"/>
</resultMap>
<resultMap id="UserResultEmailMap" type="com.ttx.example.pojo.UserResultEmail">
<id column="user_id" property="userId"/> <!-- 由于是关联查询,会返回多个结果集, 需要指定唯一标识,去掉重复的值 -->
<association property="userResult" resultMap="UserResultMap"/>
<collection ofType="com.ttx.example.pojo.Email" column="email_id" property="emailList" resultMap="EmailMap"/> <!-- association,collection 关联查询, 用法差不多,区别在于ofType类型, 可以指定集合的具体类型 -->
</resultMap>
3) mapper对应的方法
UserResultMapper.java
UserResultEmail selectUserAndEmailByUserId(@Param("userId") int userId);
UserResultMapper.xml
<select id="selectUserAndEmailByUserId" resultMap="UserResultEmailMap" >
select * from user u,email e where u.user_id=#{userId} and u.user_id=e.user_id
</select>
4) 测试类方法
@Test
public void associationTest(){
UserResultEmail userResultEmail=userResultMapper.selectUserAndEmailByUserId(1);
Assert.assertTrue(userResultEmail!=null);
System.out.println("userName: "+userResultEmail.getUserResult().getUserName());
System.out.println("emailSize: "+userResultEmail.getUserResult().getUserName());
}