resultMap元素是MyBatis中最重要和强大的元素。它使您可以摆脱90%的JDBC代码,用于从结果集中检索数据,并且在某些情况下,它还允许您执行JDBC甚至不支持的操作。实际上,要为复杂语句编写类似于连接映射的等效代码可能需要数千行代码。ResultMaps的设计是这样的,简单的语句根本不需要显式的结果映射,而更复杂的语句仅需要尽可能少的描述关系的内容。
您已经看到了一些简单的映射语句的示例,它们没有显式的resultMap。例如:
<select id="selectUsers" resultType="map">
select id, username, hashedPassword
from some_table
where id = #{id}
</select>
这样一个语句将自动将所有列映射到HashMap的键中,如resultType属性所指定。虽然在许多情况下很有用,但HashMap并不是一个很好的领域模型。更有可能的是,您的应用程序将使用JavaBeans或POJOs(Plain Old Java Objects)作为领域模型。MyBatis支持这两种方式。考虑以下JavaBean:
package com.someapp.model;
public class User {
private int id;
private String username;
private String hashedPassword;
public int getId() {
return id;
}
public void setId(int id) {
this.id = id;
}
public String getUsername() {
return username;
}
public void setUsername(String username) {
this.username = username;
}
public String getHashedPassword() {
return hashedPassword;
}
public void setHashedPassword(String hashedPassword) {
this.hashedPassword = hashedPassword;
}
}
根据JavaBeans规范,上述类具有3个属性:id、username和hashedPassword。这与select语句中的列名完全匹配。
这样的JavaBean和HashMap一样容易与ResultSet进行映射。
<select id="selectUsers" resultType="com.someapp.model.User">
select id, username, hashedPassword
from some_table
where id = #{id}
</select>
记住,TypeAliases是你的朋友。使用它们来避免反复输入类的全限定路径。例如:
<!-- In Config XML file -->
<typeAlias type="com.someapp.model.User" alias="User"/>
<!-- In SQL Mapping XML file -->
<select id="selectUsers" resultType="User">
select id, username, hashedPassword
from some_table
where id = #{id}
</select>
在这些情况下,MyBatis会在后台自动创建一个ResultMap,根据名称将列自动映射到JavaBean属性。如果列名不完全匹配,您可以在列名上使用select子句别名(标准SQL特性)来使标签匹配。例如:
<select id="selectUsers" resultType="User">
select
user_id as "id",
user_name as "userName",
hashed_password as "hashedPassword"
from some_table
where id = #{id}
</select>
ResultMap的好处是,您已经学到了很多关于它们的知识,但您甚至还没有看到一个示例!这些简单的情况不需要比您在这里看到的更多内容。为了举例,让我们看看将最后一个示例作为外部resultMap的情况,因为这是解决列名不匹配的另一种方式。
<resultMap id="userResultMap" type="User">
<id property="id" column="user_id" />
<result property="username" column="user_name"/>
<result property="password" column="hashed_password"/>
</resultMap>
引用resultMap的语句使用resultMap属性来实现(注意我们删除了resultType属性)。例如:
<select id="selectUsers" resultMap="userResultMap">
select user_id, user_name, hashed_password
from some_table
where id = #{id}
</select>