MyBatis的构建就是聚焦于SQL的,使其远离于普通的方式。
SQL映射文件有很少的几个顶级元素(按照它们应该被定义的顺序):
cache - 配置给定命名空间的缓存。
cache-ref – 从其他命名空间引用缓存配置。
resultMap – 最复杂,也是最有力量的元素,用来描述如何从数据库结果集中来加载你的对象。
parameterMap – 已经被废弃了!老式风格的参数映射。内联参数是首选,这个元素可能在将来被移除。这里不会记录。
sql – 可以重用的SQL块,也可以被其他语句引用。
insert – 映射插入语句
update – 映射更新语句? delete – 映射删除语句
select – 映射查询语句
下面将从语句本身开始来描述每个元素的细节。
select
查询语句是使用MyBatis时最常用的元素之一。直到你从数据库取出数据时才会发现将数据存在数据库中是多么的有价值,所以许多应用程序的查询操作要比更改数据操作多的多。对于每次插入,更新或删除,那也会有很多的查询。这是MyBatis的一个基本原则,也是将重心和努力放到查询和结果映射的原因。对简单类别的查询元素是非常简单的。比如:
- <select id=”selectPerson” parameterType=”int” resultType=”hashmap”>
- SELECT * FROM PERSON WHERE ID = #{id}
- </select>
注意参数注释:
#{id}
这就告诉MyBatis创建一个PreparedStatement(预处理语句)参数。使用JDBC,这样的一个参数在SQL中会由一个“?”来标识,并被传递到一个新的预处理语句中。
属性 | 描述 |
id | 在命名空间中唯一的标识符,可以被用来引用这条语句。 |
parameterType | 将会传入这条语句的参数类的完全限定名或别名。 |
parameterMap | 这是引用外部parameterMap的已经被废弃的方法。使用内联参数映射和parameterType属性。 |
resultType | 从这条语句中返回的期望类型的类的完全限定名或别名。注意集合情形,那应该是集合可以包含的类型,而不能是集合本身。使用resultType或resultMap,但不能同时使用。 |
resultMap | 命名引用外部的resultMap。返回map是MyBatis最具力量的特性,对其有一个很好的理解的话,许多复杂映射的情形就能被解决了。使用resultMap或resultType,但不能同时使用。 |
flushCache | 将其设置为true,无论语句什么时候被调用,都会导致缓存被清空。默认值:false。 |
useCache | 将其设置为true,将会导致本条语句的结果被缓存。默认值:true。 |
timeout | 这个设置驱动程序等待数据库返回请求结果,并抛出异常时间的最大等待值。默认不设置(驱动自行处理)。 |
fetchSize | 这是暗示驱动程序每次批量返回的结果行数。默认不设置(驱动自行处理)。 |
statementType | STATEMENT,PREPARED或CALLABLE的一种。这会让MyBatis使用选择使用Statement,PreparedStatement或CallableStatement。默认值:PREPARED。 |
resultSetType | FORWARD_ONLY|SCROLL_SENSITIVE|SCROLL_INSENSITIVE中的一种。默认是不设置(驱动自行处理)。 |
- <select id="doSelectDemo"
- fetchSize="256"
- flushCache="false"
- parameterType="parameterType"
- resultMap="persistenceMap"
- resultType="PersistenceType"
- resultSetType="FORWARD_ONLY"
- statementType="STATEMENT"
- timeout="1000"
- useCache="true"
- >
- SELECT COLUMNS FROM TABLE
- </select>
insert,update,delete
数据修改语句insert,update和delete在它们的实现中非常相似:
属性 | 描述 |
id | 在命名空间中唯一的标识符,可以被用来引用这条语句。 |
parameterType | 将会传入这条语句的参数类的完全限定名或别名。 |
parameterMap | 这是引用外部parameterMap的已经被废弃的方法。使用内联参数映射和parameterType属性。 |
flushCache | 将其设置为true,不论语句什么时候被调用,都会导致缓存被清空。默认值:false。 |
timeout | 这个设置驱动程序等待数据库返回请求结果,并抛出异常时间的最大等待值。默认不设置(驱动自行处理)。 |
statementType | STATEMENT,PREPARED或CALLABLE的一种。这会让MyBatis使用选择使用Statement,PreparedStatement或CallableStatement。默认值:PREPARED。 |
useGeneratedKeys | (仅对insert有用)这会告诉MyBatis使用JDBC的getGeneratedKeys方法来取出由数据(比如:像MySQL和SQL Server这样的数据库管理系统的自动递增字段)内部生成的主键。默认值:false。 |
keyProperty | (仅对insert有用)标记一个属性,MyBatis会通过getGeneratedKeys或者通过insert语句的selectKey子元素设置它的值。默认:不设置。 |
- <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和SQL Server数据库),那么你可以设置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>
这里有一个简单(甚至很傻)的示例,它可以生成一个随机ID(可能你不会这么做,但是这展示了MyBatis处理问题的灵活性,因为它并不真的关心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会被设置,然后插入语句会被调用。这给你了一个简单的行为在你的数据库中来处理自动生成的主键,而不需要使你的Java代码变得复杂。
selectKey元素描述如下:
- <selectKey
- keyProperty="id"
- resultType="int"
- order="BEFORE"
- statementType="PREPARED">
属性 | 描述 |
keyProperty | selectKey语句结果应该被设置的目标属性。 |
resultType | 结果的类型。MyBatis通常可以算出来,但是写上也没有问题。MyBatis允许任何简单类型用作主键的类型,包括字符串。 |
order | 这可以被设置为BEFORE或AFTER。如果设置为BEFORE,那么它会首先选择主键,设置keyProperty然后执行插入语句。如果设置为AFTER,那么先执行插入语句,然后是selectKey元素-这和如Oracle数据库相似,可以在插入语句中嵌入序列调用。 |
statementType | 和前面的相同,MyBatis支持STATEMENT,PREPARED和CALLABLE语句的映射类型,分别代表PreparedStatement和CallableStatement类型。 |
sql
这个元素可以被用来定义可重用的SQL代码段,可以包含在其他语句中。比如:
- <sql id=”userColumns”> id,username,password </sql>
- <select id=”selectUsers” parameterType=”int” resultType=”hashmap”>
- select <include refid=”userColumns”/>
- from some_table
- where id = #{id}
- </select>
Parameters
以下代码:
- <insert id=”insertUser” parameterType=”User” >
- insert into users (id, username, password)
- values (#{id}, #{username}, #{password})
- </insert>
这点对于传递参数到语句中非常好。但是对于参数映射也有一些其他的特性。
首先,像MyBatis的其他部分,参数可以指定一个确定的数据类型。
- #{property,javaType=int,jdbcType=NUMERIC}
注意:如果null被当作值来传递,对于所有可能为空的列,JDBC Type是需要的。也可以通过阅读PreparedStatement. setNull()方法的JavaDocs文档来研究它。
为了以后自定义类型处理器,你可以指定一个确定的类型处理器类(或别名),比如:
- #{age,javaType=int,jdbcType=NUMERIC,typeHandler=MyTypeHandler}
对于数值类型,对于决定有多少数字是相关的,有一个数值范围。
- #{height,javaType=double,jdbcType=NUMERIC,numericScale=2}
- #{department,
- mode=OUT,
- jdbcType=CURSOR,
- javaType=ResultSet,
- resultMap=departmentResultMap}
默认情况下,使用#{}格式的语法会导致MyBatis创建预处理语句属性并以它为背景设置安全的值(比如?)。这样做很安全,很迅速,也是首选的做法,有时你只是想直接在SQL语句中插入一个不改变的字符串。比如,像ORDER BY,你可以这样来使用:
ORDER BY ${columnName}
这里MyBatis不会修改或转义字符串。
重要:接受从用户输出的内容并提供给语句中不变的字符串,这样做是不安全的。这会导致潜在的SQL注入攻击,因此你不应该允许用户输入这些字段,或者通常自行转义并检查。
resultMap
resultMap元素是MyBatis中最重要最强大的元素。ResultMap的设计就是简单语句不需要明确的结果映射,而很多复杂语句确实需要描述它们的关系。
我们来看下面代码:
- package com.someapp.model;
- public class User {
- private int id;
- private String username;
- private String hashedPassword;
- public int getId() {
- return id;
- }
- public void setId(int id) {
- this.id = id;
- }
- public String getUsername() {
- return username;
- }
- public void setUsername(String username) {
- this.username = username;
- }
- public String getHashedPassword() {
- return hashedPassword;
- }
- public void setHashedPassword(String hashedPassword) {
- this.hashedPassword = hashedPassword;
- }
- }
这样的一个JavaBean可以被映射到结果集,就像映射到HashMap一样简单。
- <select id=”selectUsers” parameterType=”int”
- resultType=”com.someapp.model.User”>
- select id, username, hashedPassword
- from some_table
- where id = #{id}
- </select>
ResultMap最优秀的地方你已经了解了很多了,但是你还没有真正的看到一个。只是出于示例的原因,让我们来看看最后一个示例中外部的resultMap是什么样子的,这也是解决列名不匹配的另外一种方式。
- <resultMap id="userResultMap" type="User">
- <id property="id" column="user_id" />
- <result property="username" column="user_name"/>
- <result property="password" column="hashed_password"/>
- </resultMap>
- <select id=”selectUsers” parameterType=”int”
- resultMap=”userResultMap”>
- select user_id, user_name, hashed_password
- from some_table
- where id = #{id}
- </select>