03.Mybatis SQL 映射的 XML 文件

MyBatis 真正的力量是在映射语句中,SQL 映射文件有以下几个顶级元素.

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

<br/>

select

查询语句是使用 MyBatis 时最常用的元素之一,对于每次插入，更新或删除，那也会有很多的查询。这是 MyBatis 的一个基本原则，也是将重心和努力放到查询和结果映射的原因。对简单类别的查询元素是非常简单的。

比如：

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

这个语句被称作 selectPerson，使用一个 int（或 Integer）类型的参数，并返回一个 HashMap类型的对象，其中的键是列名，值是列对应的值。
<br/>
这就告诉 MyBatis 创建一个 PreparedStatement（预处理语句）参数。使用JDBC，这样的一个参数在 SQL 中会由一个“?”来标识，并被传递到一个新的预处理语句中，就像这样：

// 相似的JDBC代码，不是MyBatis的
String selectPerson = “SELECT * FROM PERSON WHERE ID=?”;
PreparedStatement ps = conn.prepareStatement(selectPerson);
ps.setInt(1,id);

当然，这需要很多单独的 JDBC 的代码来提取结果并将它们映射到对象实例中，这就是MyBatis 节省你时间的地方。我们需要深入了解参数和结果映射.

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

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

如下内容为各个参数的介绍:

• id [在命名空间中唯一的标识符，可以被用来引用SQL语句]
• parameterType [传入SQL语句的参数类的类型]
• resultTyp [SQL语句中返回的期望类型的类的类型或者别名。对于集合来说，那应该是集合可以包含的类型，而不能是集合本身]
• resultMap [命名引用外部的 resultMap]

   <!--设置domain类和数据库中表的字段一一对应，注意数据库字段和domain类中的字段名称不致，此处一定要！-->
    <resultMap id="BaseResultMap" type="User">
        <id column="USER_ID" property="userId" jdbcType="INTEGER" />
        <result column="USER_NAME" property="userName" jdbcType="CHAR" />
        <result column="USER_PASSWORD" property="userPassword" jdbcType="CHAR" />
        <result column="USER_EMAIL" property="userEmail" jdbcType="CHAR" />
    </resultMap>
    <!-- 查询单条记录 -->
    <select id="selectUserById" parameterType="int" resultMap="BaseResultMap">
        SELECT * FROM t_user WHERE USER_ID = #{userId}
    </select>

• flushCache [将其设置为 true，无论语句什么时候被调用，都会导致缓存被清
  空。默认值：false]
• useCache [将其设置为 true，将会导致本条语句的结果被缓存。默认值：true]
• timeout [驱动程序等待数据库返回请求结果，并抛出异常时间的
  最大等待值]
• fetchSize [驱动程序每次批量返回的结果行数]
• statementType [STATEMENT,PREPARED 或 CALLABLE 的一种，这会让 MyBatis使用选择使用 Statement，PreparedStatement 或 CallableStatement，
  默认值：PREPARED]
• resultSetType [FORWARD_ONLY|SCROLL_SENSITIVE|SCROLL_INSENSITIVE
  中的一种。默认是不设置（驱动自行处理）]

insert

<insert
id="insertAuthor"
parameterType="domain.blog.Author"
flushCache="true"
statementType="PREPARED"
keyProperty=""
useGeneratedKeys=""
timeout="20000">

对于插入操作,假如数据库表结构中支持自动生成主键的字段,那么你可以设置 useGeneratedKeys=”true”，而且设置 keyProperty 到你已经做好的目标属性上.

例如:

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

update

<update
id="insertAuthor"
parameterType="domain.blog.Author"
flushCache="true"
statementType="PREPARED"
timeout="20000">

例如:

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

delete

<delete
id="insertAuthor"
parameterType="domain.blog.Author"
flushCache="true"
statementType="PREPARED"
timeout="20000">

例如:

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