自动映射

正如你在前面一节看到的,在简单的场景下,MyBatis可以替你自动映射查询结果。 如果遇到复杂的场景,你需要构建一个result map。 但是在本节你将看到,你也可以混合使用这两种策略。 让我们到深一点的层面上看看自动映射是怎样工作的。

当自动映射查询结果时,MyBatis会获取sql返回的列名并在java类中查找相同名字的属性(忽略大小写)。 这意味着如果Mybatis发现了ID列和id属性,Mybatis会将ID的值赋给id

通常数据库列使用大写单词命名,单词间用下划线分隔;而java属性一般遵循驼峰命名法。 为了在这两种命名方式之间启用自动映射,需要将 mapUnderscoreToCamelCase设置为true。

自动映射甚至在特定的result map下也能工作。在这种情况下,对于每一个result map,所有的ResultSet提供的列, 如果没有被手工映射,则将被自动映射。自动映射处理完毕后手工映射才会被处理。 在接下来的例子中, iduserName列将被自动映射, hashed_password 列将根据配置映射。

  1. <select id="selectUsers" resultMap="userResultMap">
  2. select
  3. user_id as "id",
  4. user_name as "userName",
  5. hashed_password
  6. from some_table
  7. where id = #{id}
  8. </select>
  1. <resultMap id="userResultMap" type="User">
  2. <result property="password" column="hashed_password"/>
  3. </resultMap>

有三种自动映射等级:

  • NONE - 禁用自动映射。仅设置手动映射属性。
  • PARTIAL - 将自动映射结果除了那些有内部定义内嵌结果映射的(joins).
  • FULL - 自动映射所有。
    默认值是PARTIAL,这是有原因的。当使用FULL时,自动映射会在处理join结果时执行,并且join取得若干相同行的不同实体数据,因此这可能导致非预期的映射。下面的例子将展示这种风险:
  1. <select id="selectBlog" resultMap="blogResult">
  2. select
  3. B.id,
  4. B.title,
  5. A.username,
  6. from Blog B left outer join Author A on B.author_id = A.id
  7. where B.id = #{id}
  8. </select>
  1. <resultMap id="blogResult" type="Blog">
  2. <association property="author" resultMap="authorResult"/>
  3. </resultMap>
  4.  
  5. <resultMap id="authorResult" type="Author">
  6. <result property="username" column="author_username"/>
  7. </resultMap>

在结果中BlogAuthor均将自动映射。但是注意Author有一个id属性,在ResultSet中有一个列名为id, 所以Author的id将被填充为Blog的id,这不是你所期待的。所以需要谨慎使用FULL

通过添加autoMapping属性可以忽略自动映射等级配置,你可以启用或者禁用自动映射指定的ResultMap。

  1. <resultMap id="userResultMap" type="User" autoMapping="false">
  2. <result property="password" column="hashed_password"/>
  3. </resultMap>