MyBatis框架学习:＜select＞节点中的resultType和resultMap属性

Dear 丶 2023-03-01 11:48 143阅读 0赞

### 1.为什么要进行resultType或resultMap注解配置 ###

当需要实现的数据访问是**查询类型**的，在`<select>`节点中必须配置`resultType`或`resultMap`中的某1个属性（二选一），如果都没有指定，则会出现如下错误：

Caused by: org.apache.ibatis.executor.ExecutorException: A query was run and no Result Maps were found for the Mapped Statement 'cn.tedu.mybatis.UserMapper.count'.  It's likely that neither a Result Type nor a Result Map was specified.

解决因为**名称不一致**导致MyBatis**无法自动封装查询结果**的问题

*  当自定义字段列表时，自定义别名，使得名称保持一致，并且，在`<select>`节点中使用`resultType`即可；
 *  当使用星号表示字段列表时，配置`<resultMap>`以指导MyBatis封装，并且，在`<select>`节点中使用`resultMap`应用配置的`<resultMap>`。

### 2.resultType ###

其中，`resultType`指的就是“封装查询结果的数据的类型”，也可以理解为“抽象方法的返回值的类型”，例如可以配置为：

<select id="count" resultType="java.lang.Integer">
    	SELECT COUNT(*) FROM t_user
    </select>

如果某个查询的抽象方法的返回值是`List`集合类型的，例如：

List<User> findAll();

在配置`<select>`的`resultType`属性时，该属性值必须是集合中的元素的类型，例如：

<select id="findAll" resultType="cn.tedu.mybatis.User">
        SELECT * FROM t_user ORDER BY id
    </select>

**注意：使用了这种做法后，就需要对抽象方法名称的定义增加一个要求“不允许重载”！**

### 3.resultMap ###

#### 3.1 一对一查询中的resultMap的使用 ####

在没有自定义别名的情况下，如果查询结果的列名与类的属性名不一致，还可以自定义`<resultMap>`节点进行配置，该节点的作用就是指导MyBatis封装查询到的数据！

<resultMap id="UserMap" type="cn.tedu.mybatis.User">
        
        <result column="id" property="id"/>
        <result column="username" property="username"/>
        <result column="password" property="password"/>
        <result column="age" property="age"/>
        <result column="phone" property="phone"/>
        <result column="email" property="email"/>
        <result column="group_id" property="groupId"/>
    </resultMap>
    
    <select id="findById" resultMap="UserMap">
        SELECT
            *
        FROM 
            t_user 
        WHERE 
            id=#{id}
    </select>

在以上配置中，需要注意：`<resultMap>`节点中的`id`属性值就是`<select>`节点的`resultMap`属性值！

如果需要执行的查询操作是**单表数据查询**，在配置`<resultMap>`时，对于那些列名与属性名一致的，可以不作配置！

在配置`<resultMap>`时，推荐在子级使用`<id>`节点配置主键，然后使用`<result>`节点配置其它的，便于实现缓存！MyBatis有2级缓存，其中，MyBatis的1级缓存是SqlSession缓存，开发人员无法干预，2级缓存是namespace缓存，一旦开启，默认情况下，将作用于整个XML文件，需要事先在当前XML文件中添加`<cache></cache>`节点，表示“启用缓存”，理启用缓存，需要封装查询结果的数据类型是实现了`Serializable`接口的，如果某个查询不需要使用缓存，还可以在`<select>`节点中配置`useCache="false"`，然后，就不需要开发人员进行其它配置了，MyBatis会自动处理缓存的数据，并且，一旦当前namespace执行了增删改类型的操作，就会重建缓存！

**小结**：在SQL中使用自定义别名，并在`<select>`中使用`resultType`指定封装结果的数据类型，或在SQL中使用星号表示字段列表，并配置`<resultMap>`节点后在`<select>`中使用`resultMap`，均可解决由于名称不一致导致无法封装查询结果的问题。

#### 3.2 一对多查询中的resultMap的使用 ####

在一对多的查询中，MyBatis根本就不知道怎么封装查询结果中的数据！当没有匹配的查询结果，或只有1条查询结果时，并不会报错，只是查询结果的数据不正确而已，如果查询结果有多条，则会出现如下错误信息：

Caused by: org.apache.ibatis.exceptions.TooManyResultsException: Expected one result (or null) to be returned by selectOne(), but found: 2

为了保障能够正确的封装查询结果，**必须**使用`<resultMap>`来指导MyBatis封装！并且，在SQL语句中，还需要为某个`id`定义别名，以保证查询结果每一列的名称都不同，否则，MyBatis只会从相同的列名中排列靠前的那一列中取数据，甚至，如果在`<resultMap>`中使用`<id>`配置主键，当出现多条数据的最靠前的那一列id值相同时，重复id的数据将不会被封装！

具体配置如下：

<?xml version="1.0" encoding="UTF-8" ?>
    <!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
      
    <mapper namespace="cn.tedu.mybatis.GroupMapper">
    
    	<resultMap id="GroupVOMap" type="cn.tedu.mybatis.GroupVO">
    		<id column="gid" property="id" />
    		<result column="name" property="name"/>
    		
    		
    		<collection property="users" ofType="cn.tedu.mybatis.User">
    			<id column="id" property="id"/>
    			<result column="username" property="username"/>
    			<result column="password" property="password"/>
    			<result column="age" property="age"/>
    			<result column="phone" property="phone"/>
    			<result column="email" property="email"/>
    			<result column="group_id" property="groupId"/>
    		</collection>
    	</resultMap>
    
    	<select id="findVOById" resultMap="GroupVOMap">
    		SELECT
    			t_group.id AS gid, name,
    			t_user.*
    		FROM 
    			t_group
    		LEFT JOIN
    			t_user
    		ON
    			t_group.id=t_user.group_id
    		WHERE
    			t_group.id=#{id}
    	</select>
    
    </mapper>

**注意：在配置一对多的查询时，在`<resultMap>`中，即使存在列名与属性名完全相同的数据，也必须通过`<id>`或`<result>`节点进行配置！**