18. Mybatis 查询结果集映射

谁借莪１个温暖的怀抱￠ 2024-04-17 14:59 88阅读 0赞

Mybatis 最强大的特性大概就是结果集映射了吧. 相比Hibernate, Mybatis 的结果集映射不局限于PO, Mybatis可以将结果集映射为任意的java 对象.  
笔者之前的博客中, 多次使用resultType, 这里就不赘述了. 这里主要介绍resultType 和resultMap 的适用场景, 以及resultMap的基本用法.

## 1. resultType 与 resultMap ##

resultType 和 resultMap 两个属性用于指定结果集封装对象, 二者只能用一个. 通常能用resultType时, 优先适用resultType. resultMap 用于处理resultType 不能处理的场景.

### 1.1 resultType 适用场景 ###

resultType 在自动封装java对象时, 必须要求字段名和java中的属性名一致,或使用驼峰映射成功(需全局开启支持驼峰映射), 而且类中属性只能是基本属性, 不能有Java Object 属性.

*  返回值单条记录封装为基本类型:
    
     *  返回值为单个基本类型, 如:string, int, long 等. Mybatis 为基本类型均内置了别名.
     *  返回值为基本类型的集合, List , Set 等
     *  返回值为单个对象的map, key为字段名, value为属性
 *  返回值单条对象封装为Java Object, 前提是java中属性名和字段名完全一致, 或使用驼峰映射成功(需全局开启支持驼峰映射):
    
     *  返回值为单个java 对象, 不局限于仅仅是PO, VO也是没问题的
     *  返回值为java对象的集合
     *  返回值为java 对象和属性组成的Map

### 1.2 resultMap 适用场景 ###

*  处理java 对象中属性名和字段名不一致问题
 *  处理一对一关系自动映射
 *  处理一对多关系自动映射

## 2.resultMap 处理属性名与字段名不一致. ##

resultMap 最简单的用法, 就是处理java 属性值与查询的字段名不一致. 对于处理一对一映射, 一对多映射, 比较复杂, 笔者不在这里讲述.

## 2. resultMap 基本用法 ##

### 2.1 官方例子 ###

result 属性和子标签比较多, 应该是Mybatis中最复杂的一个标签了. 官方给出的复杂的例子:

<resultMap id="detailedBlogResultMap" type="Blog">
      <constructor>
        <idArg column="blog_id" javaType="int"/>
      </constructor>
      <result property="title" column="blog_title"/>
      <association property="author" javaType="Author">
        <id property="id" column="author_id"/>
        <result property="username" column="author_username"/>
        <result property="password" column="author_password"/>
        <result property="email" column="author_email"/>
        <result property="bio" column="author_bio"/>
        <result property="favouriteSection" column="author_favourite_section"/>
      </association>
      <collection property="posts" ofType="Post">
        <id property="id" column="post_id"/>
        <result property="subject" column="post_subject"/>
        <association property="author" javaType="Author"/>
        <collection property="comments" ofType="Comment">
          <id property="id" column="comment_id"/>
        </collection>
        <collection property="tags" ofType="Tag" >
          <id property="id" column="tag_id"/>
        </collection>
        <discriminator javaType="int" column="draft">
          <case value="1" resultType="DraftPost"/>
        </discriminator>
      </collection>
    </resultMap>

### 2.2 常用属性 ###

*  id: 当前命名空间中的一个唯一标识，用于标识一个结果映射。
 *  type: 类的完全限定名, 或者一个类型别名（关于内置的类型别名，可以参考上面的表格）。
 *  autoMapping: 如果设置这个属性，MyBatis将会为本结果映射开启或者关闭自动映射。

### 2.3 常用子标签 ###

*  ## 3. resultMap 小试牛刀 ##
    
    ### 3.1 自定义Java 类Department ###
    
    自定义java 类, 属性名和字段名不对应.
    
        public class Department { 
        
            private Long depId;
        
            private String depName;
            
            // setter/gettter..
            
        }
    
    ### 3.2 sql 映射片段 ###
    
     *  对于处理字段名与属性名不一致的问题, 除了使用resultMap 定义之外, 也可以借助于别名机制处理. 笔者写了两种方式的sql 片段, 均可以实现.
    
        
        <select id="findDepartment" resultMap="Department">
            select id, name from t_department where id = #{id}
        </select>
        
        
        <resultMap id="Department" type="Department">
            <id column="id" property="depId" />
            <result column="name" property="depName" />
        </resultMap>
        
        
    
    ### 3.3 接口定义 ###
    
        // resultMap 自定义
        Department findDepartment(Long id);
    
    ### 3.4 测试用例 ###
    
        @Test
        public void findDepartment(){ 
            Department department = this.departmentMapper.findDepartment(1L);
            Assert.assertNotNull(department);
        }