最近遇到同事在MyBatis的 mapper.xml文件里,定义了<resultMap>标签,但是里面并没有<result>将数据库的列映射为java对象的属性的标签,我认为这种写法是错误的,这样会导致映射不到实体的属性上。
之前以为mapper.xml文件如果select标签指定为resultMap="XXX",就是是通过resultMap的<result>标签指定映射关系才可以映射。
通过查询官方文档,才明白,查询即使使用了resultMap, Mabatis也会自定装配属性,然后再根据<result>的映射来手动装配属性。
自动映射
普通自动映射
<select id="selectUsers" resultType="com.someapp.model.User">
select id, username, hashedPassword
from some_table
where id = #{id}
</select>
可以设置别名
<!-- In mybatis-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>
当自动映射查询结果时,MyBatis会获取sql返回的列名并在java类中查找相同名字的属性(忽略大小写)。
这意味着如果Mybatis发现了ID列和id属性,Mybatis会将ID的值赋给id。
通常数据库列使用大写单词命名,单词间用下划线分隔;而java属性一般遵循驼峰命名法。 为了在这两种命名方式之间启用自动映射,需要将 mapUnderscoreToCamelCase设置为true。
ResultMap是为了解决列名不一致的问题。
自动映射和手动映射
自动映射在特定的result map下也能工作。
在这种情况下,对于每一个result map,所有的ResultSet提供的列, _如果没有被手工映射,则将被自动映射_ 。
自动映射处理完毕后手工映射才会被处理。
在接下来的例子中, id 和 userName列将被自动映射, hashed_password 列将根据配置映射。
<select id="selectUsers" resultMap="userResultMap">
select
user_id as "id",
user_name as "userName",
hashed_password
from some_table
where id = #{id}
</select>
对应的reusltMap
<resultMap id="userResultMap" type="User">
<result property="password" column="hashed_password"/>
</resultMap>
参考文章:
博客 http://blog.51cto.com/13542372/2056353
官方文档 http://www.mybatis.org/mybatis-3/zh/sqlmap-xml.html#select