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=”10000” 这个设置驱动程序等待数据库返回请求结果,并抛出异常时间的最大等待值。默认不设置(驱动自行处理)。 fetchSize=”256” 这是暗示驱动程序每次批量返回的结果行数。默认不设置(驱动自行处理)。 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="20000" 这个设置驱动程序等待数据库返回请求结果,并抛出异常时间的最大等待值。
默认不设置(驱动自行处理)。 >
以下就是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>
兴许将会具体介绍缓存和resultMap