SSM - Mybatis SQL映射文件

MyBatis 真正的力量是在映射语句中。和对等功能的jdbc来比价，映射文件节省很多的代码量。MyBatis的构建就是聚焦于sql的。

sql映射文件有如下几个顶级元素：（按顺序）

cache配置给定命名空间的缓存。

cache-ref从其他命名空间引用缓存配置。

resultMap最复杂，也是最有力量的元素，用来描述如何从数据库结果集中来加载你的对象。

parameterMap已经被废弃了！老式风格的参数映射。内联参数是首选，这个元素可能在将来被移除。

sql可以重用的SQL块，也可以被其他语句引用。

insert映射插入语句。

update映射更新语句。

delete映射删除语句。

select映射查询语句。

下面就详细描述一些元素：

1、select

查询语句是使用 MyBatis 时最常用的元素之一。

<select id=”selectPerson” parameterType=”int” resultType=”hashmap”>
SELECT * FROM PERSON WHERE ID = #{id}
</select>

使用一个int（或Integer）类型的参数，并返回一个HashMap类型的对象，其中的键是列名，值是列对应的值。

#{id}

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

<select
id=”selectPerson” 在命名空间中唯一的标识符，可以被用来引用这条语句。
parameterType=”int” 将会传入这条语句的参数类的完全限定名或别名。
parameterMap=”deprecated” （已废弃）
resultType=”hashmap” 从这条语句中返回的期望类型的类的完全限定名或别名。注意集合情形，那应该是集合可以包含的类型，而不能是集合本身。使用resultType或resultMap，但不能同时使用。
resultMap=”personResultMap” 命名引用外部的resultMap。返回map是MyBatis最具力量的特性，对其有一个很好的理解的话，许多复杂映射的情形就能被解决了。使用 resultMap 或 resultType，但不能同时使用。
flushCache=”false” 将其设置为true，不论语句什么时候被调用，都会导致缓存被清空。默认值： false。
useCache=”true” 将其设置为 true，将会导致本条语句的结果被缓存。默认值： true。
timeout=”” 这个设置驱动程序等待数据库返回请求结果，并抛出异常时间的最大等待值。默认不设置（驱动自行处理）。
fetchSize=”” 这是暗示驱动程序每次批量返回的结果行数。默认不设置（驱动自行处理）。
statementType=”PREPARED” STATEMENT,PREPARED 或 CALLABLE 的一种。这会让 MyBatis使用选择使用 Statement， PreparedStatement 或 CallableStatement。默认值： PREPARED。
resultSetType=”FORWARD_ONLY” FORWARD_ONLY|SCROLL_SENSITIVE|SCROLL_INSENSITIVE中的一种。默认是不设置（驱动自行处理）。

>

2、insert， update， delete
数据变更语句 insert， update 和 delete 在它们的实现中非常相似：

<insert
id="insertAuthor"  在命名空间中唯一的标识符，可以被用来引用这条语句。
parameterType="domain.blog.Author"  将会传入这条语句的参数类的完全限定名或别名。
flushCache="true" 将其设置为 true，不论语句什么时候被调用，都会导致缓存被清
空。默认值： false。
statementType="PREPARED"  STATEMENT,PREPARED 或 CALLABLE 的一种。这会让 MyBatis使用选择使用 Statement， PreparedStatement 或CallableStatement。默认值： PREPARED。
keyProperty=""  （仅对 insert有用）标记一个属性， MyBatis 会通过 getGeneratedKeys或者通过 insert 语句的 selectKey 子元素设置它的值。默认：不设置。
useGeneratedKeys=""  （ 仅 对 insert 有 用 ） 这 会 告 诉 MyBatis 使 用 JDBC 的getGeneratedKeys 方法来取出由数据（比如：像 MySQL 和 SQLServer 这样的数据库管理系统的自动递增字段）内部生成的主键。默认值： false。
timeout=""  这个设置驱动程序等待数据库返回请求结果，并抛出异常时间的最大等待值。默认不设置（驱动自行处理）。

>

下面就是insert， update 和 delete 语句的示例：

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

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

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

如前所述，插入语句有一点多，它有一些属性和子元素用来处理主键的生成。首先，如果你的数据库支持自动生成主键的字段（比如MySQL和SQLServer），那么你可以设置 useGeneratedKeys=”true”，而且设置 keyProperty 到你已经做好的目标属性上。例如，如果上面的 Author 表已经对 id 使用了自动生成的列类型，那么语句可以修改为：

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

3、sql   --> 这个元素可以被用来定义可重用的SQL代码段，可以包含在其他语句中。

<select id=”selectUsers” parameterType=”int” resultType=”hashmap”>
select <include refid=”userColumns”/>
from some_table
where id = #{id}
</select>