MyBatis03--Mapper XML映射文件

前言：

在上一篇文章我们介绍了MyBatis的XML映射配置文件，configuration.xml。其实，Mybatis真正的强大在于它的映射语句，也是它的魔力所在。Mybatis就是针对SQL构建的，比普通方法做的更好，映射器的xml文件也显的相对简单。

SQL 映射文件有几个顶级元素:

cache – 给定命名空间的缓存配置。
cache-ref – 其他命名空间缓存配置的引用。
resultMap – 是最复杂也是最强大的元素，用来描述如何从数据库结果集中来加载对象。
sql – 可被其他语句引用的可重用语句块。
insert – 映射插入语句
update – 映射更新语句
delete – 映射删除语句
select – 映射查询语句

最常用的，无可厚非，就是insert、delete、update、select，分别对应于增、删、改、查嘛。

select：

查询语句是 MyBatis 中最常用的元素之一，大多数的应用，查询都比修改要繁琐，对每个插入、更新或删除操作，通常对应多个查询操作。这是 MyBatis 的基本原则之一，也是将焦点和努力放到查询和结果映射的原因。

1、简单的查询语句：

<select id="selectBlogById" parameterType="int" resultType="Blog">
    <![CDATA[
        select * from blog where blogId = #{blogId}
    ]]>
</select>

这个语句被称作 selectBlogById，接受一个 int（或 Integer）类型的参数，并返回一个 Blog 类型的对象，其中的键是列名，值便是结果行中的对应值。

使用参数的时候使用了”#”，另外还有一个符号”$”也可以引用参数，使用”#”最重要的作用就是防止SQL注入。

2、select 元素有很多属性允许你配置，来决定每条语句的作用细节。

<select
  id="selectPerson"
  parameterType="int"
  parameterMap="deprecated"
  resultType="hashmap"
  resultMap="personResultMap"
  flushCache="false"
  useCache="true"
  timeout="10000"
  fetchSize="256"
  statementType="PREPARED"
  resultSetType="FORWARD_ONLY">

下面解释一下这些属性的作用：

id——在命名空间中唯一的标识符，可以被用来引用这条语句。
parameterType——参数类型，如果SQL语句中的动态参数只有一个，这个属性可有可无
resultType——结果类型，注意如果返回结果是集合，应该是集合所包含的类型，而不是集合本身。使用 resultType 或 resultMap，但不能同时使用。
resultMap——外部 resultMap 的命名引用。结果集的映射是 MyBatis 最强大的特性，对其有一个很好的理解的话，许多复杂映射的情形都能迎刃而解。使用 resultMap 或 resultType，但不能同时使用。
flushCache——将其设置为 true，任何时候只要语句被调用，都会导致本地缓存和二级缓存都会被清空，默认值：false。
useCache——将其设置为 true，将会导致本条语句的结果被二级缓存，默认值：对 select 元素为 true。
timeout——这个设置是在抛出异常之前，驱动程序等待数据库返回请求结果的秒数。默认值为 unset（依赖驱动）。
fetchSize——这是尝试影响驱动程序每次批量返回的结果行数和这个设置值相等。默认值为 unset（依赖驱动）。
statementType——STATEMENT，PREPARED 或 CALLABLE 的一个。这会让 MyBatis 分别使用 Statement，PreparedStatement 或 CallableStatement，默认值：PREPARED。
resultSetType——FORWARD_ONLY，SCROLL_SENSITIVE 或 SCROLL_INSENSITIVE 中的一个，默认值为 unset （依赖驱动）。

insert：

<insert id="insertAuthor">
  insert into Author (id,username,password,email,bio)
  values (#{id},#{username},#{password},#{email},#{bio})
</insert>

插入语句，涉及到了一个主键的问题：

如果你的数据库支持自动生成主键的字段（比如 MySQL 和 SQL Server），那么你可以设置 useGeneratedKeys=”true”，然后再把 keyProperty 设置到目标属性上就OK了。例如，如果上面的 Author 表已经对 id 使用了自动生成的列类型，那么语句可以修改为:

<insert id="insertAuthor" useGeneratedKeys="true"
    keyProperty="id">
  insert into Author (username,password,email,bio)
  values (#{username},#{password},#{email},#{bio})
</insert>

update：

<update id="updateAuthor">
  update Author set
    username = #{username},
    password = #{password},
    email = #{email},
    bio = #{bio}
  where id = #{id}
</update>

delete：

<delete id="deleteAuthor">
  delete from Author where id = #{id}
</delete>

SQL：

这个元素可以被用来定义可重用的 SQL 代码段，可以包含在其他语句中。它可以被静态地(在加载参数) 参数化. 不同的属性值通过包含的实例变化.。

<sql id="userColumns"> ${alias}.id,${alias}.username,${alias}.password
</sql>

上面这段sql片段可以被包含在其他语句中，

<select id="selectUsers" resultType="map">
  select
    <include refid="userColumns"><property name="alias" value="t1"/></include>,
    <include refid="userColumns"><property name="alias" value="t2"/></include>
  from some_table t1
    cross join some_table t2
</select>

ResultMap:

resultMap 元素是 MyBatis 中最重要最强大的元素。它就是让你远离 90%的需要从结果集中取出数据的 JDBC 代码的那个东西, 而且在一些情形下允许你做一些 JDBC 不支持的事情。事实上, 编写相似于对复杂语句联合映射这些等同的代码, 也许可以跨过上千行的代码。 ResultMap 的设计就是简单语句不需要明确的结果映射,而很多复杂语句确实需要描述它们的关系。

补充：

resultType和resultMap的区别：
MyBatis中在查询进行select映射的时候，返回类型可以用resultType，也可以用resultMap，resultType是直接表示返回类型的，而resultMap则是对外部ResultMap的引用，但是resultType跟resultMap不能同时存在。在MyBatis进行查询映射时，其实查询出来的每一个属性都是放在一个对应的Map里面的，其中键是属性名，值则是其对应的值。

当提供的返回类型属性是resultType时，MyBatis会将Map里面的键值对取出赋给resultType所指定的对象对应的属性。所以其实MyBatis的每一个查询映射的返回类型都是ResultMap，只是当提供的返回类型属性是resultType的时候，MyBatis对自动的给把对应的值赋给resultType所指定对象的属性。
当提供的返回类型是resultMap时，因为Map不能很好表示领域模型，就需要自己再进一步的把它转化为对应的对象，这常常在复杂查询中很有作用。

（ResultMap暂时先不详细介绍，会在以后的文章中通过具体的案例进行展现其强大的功能。）

K.SHI

发布了128 篇原创文章 · 获赞 239 · 访问量 33万+

私信关注