MyBatisx详解之SQL映射XML文件

           SQL映射XML文件
           
MyBatis 真正强大之处就在这些映射语句：
SQL 映射XML 文件只有一些基本的元素需要配置，并且要按照下面的顺序来定义：


1.cache ： 在特定的命名空间配置缓存
2.cache-ref ：引用另外一个命名空间配置的缓存
3.resultMap ：最复杂也是最强大的元素，用来描述如何从数据库结果集里加载对象。  --  完成 ORM 映射的关键
4.sql：能被其他语句重用的SQL块
5.insert –INSERT 映射语句
6.update –UPDATE 映射语句
7.delete –DELEETE 映射语句
8.select –SELECT 映射语句






Select 元素；


<select id="selectPerson" parameterType="int" resultType="hashmap">
SELECT * FROM PERSON WHERE ID = #{id}
</select>
这条语句叫做selectPerson，以int 型（或者Integer 型）作为参数，并返回一个以数据库
列名作为键值的HashMap。


参数的表示方法： #{参数}


select元素中的常用数属性：
<select
id=”selectPerson”
parameterType=”int”
resultType=”hashmap”
resultMap=”personResultMap”
flushCache=”false”
useCache=”true”
timeout=”10000”
fetchSize=”256”
statementType=”PREPARED”
>


Select 映射语句中的属性说明：


1.id --- 在这个命名空间下唯一的标识符，可被其它语句引用
2.parameterType --- 传给此语句的参数的完整类名或别名  --- 对象或简单数据类型
3.flushCache --- 如果设为true，则会在每次语句调用的时候就会清空缓存。select 语句默认设为false
4.timeout --- 设置超时时间
5.fetchSize --- 设置从数据库获得记录的条数，默认没有设置，由驱动器自己决定
6.statementType --- 可设置为STATEMENT，PREPARED 或CALLABLE 中的任意一个，告诉MyBatis 分
别使用Statement，PreparedStatement或者CallableStatement。默认：PREPARED


* resultType --- 语句返回值类型的完整类名或别名。注意，如果返回的是集合
（collections），那么应该是集合所包含的具体子类型，而不是集合本身。resultType 与resultMap 不能同时使用


* resultMap --- 引用的外部定义的resultMap。结果集映射是MyBatis 中最强大的特性，同时
又非常好理解。许多复杂的映射都可以轻松解决。resultType 与resultMap不能同时使用




Insert、update、delete 元素:


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


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


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




Insert、update、delete 映射语句中的属性说明：


1.id --- 在这个命名空间下唯一的标识符，可被其它语句引用
2.parameterType --- 传给此语句的参数的完整类名或别名  --- 对象或简单数据类型
3.flushCache --- 如果设为true，则会在每次语句调用的时候就会清空缓存。select 语句默认设为false
4.timeout --- 设置超时时间
5.statementType --- 可设置为STATEMENT，PREPARED 或CALLABLE 中的任意一个，告诉MyBatis 分
别使用Statement，PreparedStatement或者CallableStatement。默认：PREPARED


Insert 元素独有的：


* useGeneratedKeys --- (仅限insert 语句时使用)告诉MyBatis 使用JDBC 的getGeneratedKeys 方
法来获取数据库自动生成主键（如：MySQL、SQLSERVER 等关系型数据库会有自增的字段）。默认：false


* keyProperty --- (仅限insert 语句时使用)设置自动生成主键的字段，这个字段的值由
getGeneratedKeys 方法返回，或者由insert 元素的selectKey 子元素返回。默认不设置。




例子： 自动生成主键：  keyProperty设置id为自动生成的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>


随机生成id并插入：


<insert id="insertAuthor" parameterType="domain.blog.Author">
<selectKey keyProperty="id" resultType="int" order="BEFORE">
select CAST(RANDOM()*1000000 as INTEGER) a from SYSIBM.SYSDUMMY1
</selectKey>
insert into Author
(id, username, password, email,bio, favourite_section)
values
(#{id}, #{username}, #{password}, #{email}, #{bio},
#{favouriteSection,jdbcType=VARCHAR}
)
</insert>


selectKey 语句首先会执行，Author 表的ID 首先会被设值，然后才会调用
insert 语句。这相当于在您的数据库中自动生成键值，不需要编写复杂的java 代码。


selectKey 元素描述如下：
<selectKey
keyProperty="id"
resultType="int"
order="BEFORE"
statementType="PREPARED">


属性说明： 
1. keyProperty --- 设置需要自动生成键值的列
2. resultType --- 返回类型，主键的类型可以是int也可以是String类型
3. order --- 可以设成BEFORE 或者AFTER，如果设为BEFORE，那它会先选择主键，然后设置keyProperty，
再执行insert 语句；如果设为AFTER，它就先执行insert语句再执行selectKey 语句，像数据库如Oracle 
那样在insert 语句中调用内嵌的序列机制一样。






         Sql 元素


这个元素用来定义能够被其它语句引用的可重用SQL 语句块。例如：
<sql id=”userColumns”> id,username,password </sql>
这个SQL 语句块能够被其它语句引用，如:
<select id=”selectUsers” parameterType=”int” resultType=”hashmap”>
select <include refid=”userColumns”/>
from some_table
where id = #{id}
</select>




         resultMap --- JavaBean和数据库结果集的映射
         
使用简单的配置语句而不需要详细地处理结果集映射


JavaBean 可以像HashMap 一样简单地映射到ResultSet 结果集。


<select id=”selectUsers” parameterType=”int”
resultType=”com.someapp.model.User”>
select id, username, hashedPassword
from some_table
where id = #{id}
</sql>


使用别名：


<!-- In Config XML file -->
<typeAlias type=”com.someapp.model.User” alias=”User”/>
<!-- In SQL Mapping XML file -->
<select id=”selectUsers” parameterType=”int”
resultType=”User”>
select id, username, hashedPassword
from some_table
where id = #{id}
</sql>




开发中常用的方式：


解决列名不匹配的方法。


<resultMap id="userResultMap" type="User">
<id property="id" column="user_id" />
<result property="username" column="username"/>
<result property="password" column="password"/>
</resultMap>


这个语句将会被resultMap 属性引用（注意，我们没有使用resultType）。如：


<select id=”selectUsers” parameterType=”int” resultMap=”userResultMap”>
select user_id, user_name, hashed_password
from some_table
where id = #{id}
</sql>