MyBatis 入门到精通(三) 高级结果映射

MyBatis的创建基于这样一个思想：数据库并不是您想怎样就怎样的。虽然我们希望所有的数据库遵守第三范式或BCNF（修正的第三范式），但它们不是。如果有一个数据库能够完美映射到所有应用程序，也将是非常棒的，但也没有。结果集映射就是MyBatis为解决这些问题而提供的解决方案。例如，我们如何映射下面这条语句？

<select id="selectBlog_by_id" parameterType="int" resultMap="Blog_result">selectb.id,b.title,b.author_id,a.id,a.username,a.password,a.email,a.biofromBlog b left join Author aonb.author_id = a.idwhereb.id = #{id}</select>

<resultMap type="Blog" id="Blog_result"><id column="id" property="id" /><result column="title" property="title"/><!-- 映射关联的对象 --><association property="author" javaType="Author"><id column="author_id" property="id"/><result column="username" property="username"/><result column="password" property="password"/><result column="email" property="email"/><result column="bio" property="bio"/></association></resultMap>

resultMap

resultMap属性：type为java实体类；id为此resultMap的标识。

resultMap可以设置的映射：

1. constructor 用来将结果反射给一个实例化好的类的构造器

a) idArg ID 参数；将结果集标记为ID，以方便全局调用
b) arg 反射到构造器的通常结果

2. id ID 结果，将结果集标记为ID，以方便全局调用

3. result 反射到JavaBean 属性的普通结果

4. association 复杂类型的结合；多个结果合成的类型

a) nested result mappings 几resultMap 自身嵌套关联，也可以引用到一个其它上

5. collection 复杂类型集合a collection of complex types

6. nested result mappings resultMap 的集合，也可以引用到一个其它上

7. discriminator 使用一个结果值以决定使用哪个resultMap

a) case 基本一些值的结果映射的case 情形

i. nested result mappings 一个case 情形本身就是一个结果映射，因此也可以包括一些相同的元素，也可以引用一个外部resultMap。

è最佳实践:逐步地生成resultMap，单元测试对此非常有帮助。如果您尝试一下子就生成像上面这样巨大的resultMap，可能会出错，并且工作起来非常吃力。从简单地开始，再一步步地扩展，并且进行单元测试。使用框架开发有一个缺点，它们有时像是一个黑合。为了确保达到您所预想的行为，最好的方式就是进行单元测试。这对提交bugs也非常有用。

下面一部分将详细说明每个元素。

id、resultid、result是最简单的映射，id为主键映射；result其他基本数据库表字段到实体类属性的映射。

<resultMap type="Blog" id="Blog_result"><id column="id" property="id" /><result column="title" property="title"/></resultMap>

这些是结果映射最基本内容。id和result都映射一个单独列的值到简单数据类型（字符串，整型，双精度浮点数，日期等）的单独属性或字段。

这两者之间的唯一不同是id表示的结果将是当比较对象实例时用到的标识属性。这帮助来改进整体表现，特别是缓存和嵌入结果映射（也就是联合映射）。

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

属性

描述

property

映射到列结果的字段或属性。如果匹配的是存在的，和给定名称相同的JavaBeans的属性，那么就会使用。

否则MyBatis将会寻找给定名称的字段。这两种情形你可以使用通常点式的复杂属性导航。

比如，你可以这样映射一些东西：“username”，或者映射到一些复杂的东西：“address.street.number”。

column

从数据库中得到的列名，或者是列名的重命名标签。

这也是通常和会传递给resultSet.getString(columnName)方法参数中相同的字符串。

javaType

一个Java类的完全限定名，或一个类型别名（参加上面内建类型别名的列表）。

如果你映射到一个JavaBean，MyBatis通常可以断定类型。

然而，如果你映射到的是HashMap，那么你应该明确地指定javaType来保证所需的行为。

jdbcType

在这个表格之后的所支持的JDBC类型列表中的类型。JDBC类型是仅仅需要对插入，更新和删除操作可能为空的列进行处理。

这是JDBC的需要，而不是MyBatis的。如果你直接使用JDBC编程，你需要指定这个类型-但仅仅对可能为空的值。

typeHandler

我们在前面讨论过默认的类型处理器。使用这个属性，你可以覆盖默认的类型处理器。

这个属性值是类的完全限定名或者是一个类型处理器的实现，或者是类型别名。

支持的JDBC类型

MyBatis支持如下的JDBC类型：

BIT

FLOAT

CHAR

TIMESTAMP

OTHER

UNDEFINED

TINYINT

REAL

VARCHAR

BINARY

BLOB

NVARCHAR

SMALLINT

DOUBLE

LONGVARCHAR

VARBINARY

CLOB

NCHAR

INTEGER

NUMERIC

DATE

LONGVARBINARY

BOOLEAN

NCLOB

BIGINT

DECIMAL

TIME

NULL

CURSOR

constructor <构造方法>

<resultMap type="Blog" id="Blog_result_cs"><constructor><idArg column="id" javaType="int"/><arg column="title" javaType="String"/></constructor></resultMap>

对于大多数数据传输对象(Data Transfer Object，DTO)类型，属性可以起作用，而且像绝大多数的领域模型，指令也许是你想使用一成不变的类的地方。通常包含引用或查询数据的表很少或基本不变的话对一成不变的类来说是合适的。构造方法注入允许你在初始化时为类设置属性的值，而不用暴露出公有方法。MyBatis也支持私有属性和私有JavaBeans属性来达到这个目的，但是一些人更青睐构造方法注入。Constructor（构造方法）元素支持这个。

package com.accp.mybatis.model;public class Blog {private Integer id;private String title;private Integer authorId;public Blog() {}public Blog(Integer id, String title, Integer authorId) {super();System.out.println("使用有参Blog");this.id = id;this.title = title;this.authorId = authorId;}//........}

为了向这个构造方法中注入结果，MyBatis需要通过它的参数的类型来标识构造方法。Java没有自查（或反射）参数名的方法。所以当创建一个构造方法元素时，保证参数是按顺序排列的，而且数据类型也是确定的。

association<关联映射>

<!-- 映射关联的对象 --><association property="author" javaType="Author"><id column="author_id" property="id"/><result column="username" property="username"/><result column="password" property="password"/><result column="email" property="email"/><result column="bio" property="bio"/></association>

关联元素处理“有一个”类型的关系。比如，在我们的示例中，一个博客有一个用户。关联映射就工作于这种结果之上。你指定了目标属性，来获取值的列，属性的java类型（很多情况下MyBatis可以自己算出来），如果需要的话还有jdbc类型，如果你想覆盖或获取的结果值还需要类型控制器。
关联中不同的是你需要告诉MyBatis如何加载关联。MyBatis在这方面会有两种不同的方式：
(1) 嵌套查询：通过执行另外一个SQL映射语句来返回预期的复杂类型。
(2) 嵌套结果：使用嵌套结果映射来处理重复的联合结果的子集。
首先，然让我们来查看这个元素的属性。

属性

描述

property

映射到列结果的字段或属性。如果匹配的是存在的，和给定名称相同的JavaBeans的属性，那么就会使用。否则MyBatis将会寻找给定名称的字段。这两种情形你可以使用通常点式的复杂属性导航。比如，你可以这样映射一些东西：“username”，或者映射到一些复杂的东西：“address.street.number”。

column

来自数据库的列名，或重命名的列标签。这和通常传递给resultSet.getString(columnName)方法的字符串是相同的。

注意：要处理复合主键，你可以指定多个列名通过column=”{prop1=col1,prop2=col2}”这种语法来传递给嵌套查询语句。这会引起prop1和prop2以参数对象形式来设置给目标嵌套查询语句。

javaType

一个Java类的完全限定名，或一个类型别名（参加上面内建类型别名的列表）。如果你映射到一个JavaBean，MyBatis通常可以断定类型。然而，如果你映射到的是HashMap，那么你应该明确地指定javaType来保证所需的行为。

jdbcType

在这个表格之前的所支持的JDBC类型列表中的类型。JDBC类型是仅仅需要对插入，更新和删除操作可能为空的列进行处理。这是JDBC的需要，而不是MyBatis的。如果你直接使用JDBC编程，你需要指定这个类型-但仅仅对可能为空的值。

typeHandler

我们在前面讨论过默认的类型处理器。使用这个属性，你可以覆盖默认的类型处理器。这个属性值是类的完全限定名或者是一个类型处理器的实现，或者是类型别名。

联合嵌套选择（Nested Select for Association）

select

通过这个属性，通过ID引用另一个加载复杂类型的映射语句。从指定列属性中返回的值，将作为参数设置给目标select 语句。表格下方将有一个例子。注意：在处理组合键时，您可以使用column=”{prop1=col1,prop2=col2}”这样的语法，设置多个列名传入到嵌套语句。这就会把prop1和prop2设置到目标嵌套语句的参数对象中。

SELECT<联合查询>

<resultMap type="Blog" id="Blog_result"><association property="author" column="author_id"javaType="Author" select="selectAuthorById" /></resultMap><select id="selectAuthorById" parameterType="int" resultType="Author">select * from Author where id = #{id}</select><!--select关联，建议在一对一的情况下使用。在此处，如果selectBlogById返回多个Blog，将会带来N+1问题 --><select id="selectBlogById" parameterType="int" resultMap="Blog_result">select * from Blog where id = #{id}</select>

我们有两个查询语句：一个来加载博客，另外一个来加载作者，而且博客的结果映射描述了“selectAuthorById”语句应该被用来加载它的author属性。
其他所有的属性将会被自动加载，假设它们的列和属性名相匹配。
这种方式很简单，但是对于大型数据集合和列表将不会表现很好。问题就是我们熟知的“N+1查询问题”。概括地讲，N+1查询问题可以是这样引起的：
(1)你执行了一个单独的SQL语句来获取结果列表（就是“+1”）。
(2)对返回的每条记录，你执行了一个查询语句来为每个加载细节（就是“N”）。

关联的嵌套结果

resultMap

这是结果映射的ID，可以映射关联的嵌套结果到一个合适的对象图中。这是一种替代方法来调用另外一个查询语句。这允许你联合多个表来合成到一个单独的结果集。这样的结果集可能包含重复，数据的重复组需要被分解，合理映射到一个嵌套的对象图。为了使它变得容易，MyBatis让你“链接”结果映射，来处理嵌套结果。例子会很容易来仿照，这个表格后面也有一个示例。

<select id="selectBlog" parameterType="int" resultMap="blogResult">selectB.id as blog_id,B.title as blog_title,B.author_id as blog_author_id,A.id as author_id,A.username as author_username,A.password as author_password,A.email as author_email,A.bio as author_bioFrom Blog B left outer join Author A on B.author_id = A.idwhere B.id = #{id}</select>

注意这个联合查询，以及采取保护来确保所有结果被唯一而且清晰的名字来重命名。这使得映射非常简单。现在我们可以映射这个结果：

<resultMap id="blogResult" type="Blog"><id property=”blog_id” column="id" /><result property="title" column="blog_title"/><association property="author" column="blog_author_id"javaType="Author" resultMap=”authorResult”/></resultMap><resultMap id="authorResult" type="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"/></resultMap>

非常重要：在嵌套结果映射中id元素扮演了非常重要的角色。应该通常指定一个或多个属性，它们可以用来唯一标识结果。实际上就是如果你不使用它（id元素），但是会产生一个严重的性能问题，不过MyBatis仍然可以正常工作。选择的属性越少越好，它们可以唯一地标识结果。主键就是一个显而易见的选择（即便是联合主键）。
现在，上面的示例用了外部的结果映射元素来映射关联。这使得Author结果映射可以重用。然而，如果你不需要重用它的话，或者你仅仅引用你所有的结果映射合到一个单独描述的结果映射中。你可以嵌套结果映射。这里给出使用这种方式的相同示例：

<resultMap id="blogResult" type="Blog"><id property=”blog_id” column="id" /><result property="title" column="blog_title"/><association property="author" column="blog_author_id"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"/></association></resultMap>

collection<集合>

<collection property="posts" ofType="Post"><id property="id" column="id"/><result property="subject" column="subject"/><result property="body" column="body"/></collection>

集合元素的作用几乎和关联是相同的。实际上，它们也很相似。
我们来继续上面的示例，一个博客只有一个作者。但是博客有很多文章。在博客类中，这可以由下面这样的写法来表示：
private List<Post> posts;
要映射嵌套结果集合到List中，我们使用集合元素。就像关联元素一样，我们可以从连接中使用嵌套查询，或者嵌套结果。

集合的嵌套查询首先，让我们看看使用嵌套查询来为博客加载文章。

<resultMap id="vehicleResult" type="Vehicle"><id property=”id” column="id" /><result property="vin" column="vin"/><result property="year" column="year"/><result property="make" column="make"/><result property="model" column="model"/><result property="color" column="color"/><discriminator javaType="int" column="vehicle_type"><case value="1" resultType="carResult"><result property=”doorCount” column="door_count" /></case><case value="2" resultType="truckResult"><result property=”boxSize” column="box_size" /><result property=”extendedCab” column="extended_cab" /></case><case value="3" resultType="vanResult"><result property=”powerSlidingDoor” column="power_sliding_door" /></case><case value="4" resultType="suvResult"><result property=”allWheelDrive” column="all_wheel_drive" /></case></discriminator></resultMap>