MyBatis真正的力量在于映射语句(Mapped Statements)。这是魔力发生的地方。尽管拥有强大的功能,Mapper XML文件相对来说比较简单。如果将其与等效的JDBC代码进行比较,您会立即看到代码减少了95%。MyBatis专注于SQL的编写,并尽最大努力不干扰您的方式。
Mapper XML文件仅有几个一级元素(按照定义的顺序):
- cache – 针对给定命名空间的缓存配置。
- cache-ref – 从另一个命名空间引用缓存配置。
- resultMap – 最复杂和强大的元素,描述如何从数据库结果集加载对象。
- sql – 可以被其他语句引用的可重用SQL代码片段。
- insert – 映射的INSERT语句。
- update – 映射的UPDATE语句。
- delete – 映射的DELETE语句。
- select – 映射的SELECT语句。
select
在MyBatis中,select语句是最常用的元素之一。将数据存入数据库并不是非常有价值,直到你将其取回才变得有意义,因此大多数应用程序进行的操作更多是查询而不是修改数据。对于每个插入、更新或删除操作,可能会有很多查询操作。这是MyBatis的一个基本原则,也是为什么在查询和结果映射方面付出了如此多的关注和努力的原因。对于简单的情况,select元素非常简单。例如:
<select id="selectPerson" parameterType="int" resultType="hashmap">SELECT * FROM PERSON WHERE ID = #{id}
</select>
这个语句被称为selectPerson,接受一个类型为int(或Integer)的参数,并返回一个以列名为键,行值为值的HashMap。
请注意参数表示方式:
#{id}
这告诉MyBatis要创建一个PreparedStatement参数。在JDBC中,这样的参数会被一个“?”来表示,在传递给新的PreparedStatement的SQL中会是这样的形式:
// Similar JDBC code, NOT MyBatis…
String selectPerson = "SELECT * FROM PERSON WHERE ID=?";
PreparedStatement ps = conn.prepareStatement(selectPerson);
ps.setInt(1,id);
当然,仅使用JDBC需要更多的代码来提取结果并将其映射到对象的实例中,而这正是MyBatis帮助您避免做的。
select元素还有更多的属性,允许您配置每个语句的详细行为。
<selectid="selectPerson"parameterType="int"parameterMap="deprecated"resultType="hashmap"resultMap="personResultMap"flushCache="false"useCache="true"timeout="10"fetchSize="256"statementType="PREPARED"resultSetType="FORWARD_ONLY">
Attribute(属性) | Description(描述) |
---|---|
id | 在这个命名空间中的一个唯一标识符,可以用来引用这个语句。 |
parameterType | 完全限定的类名或参数的别名,将传递给这个语句。这个属性是可选的,因为MyBatis可以通过实际传递给语句的参数来计算要使用的TypeHandler。默认是未设置的。 |
parameterMap | 这是一种已过时的引用外部参数映射的方法。请使用内联参数映射和parameterType属性。 |
resultType | 这是期望从该语句返回的结果类型的完全限定类名或别名。请注意,在集合的情况下,应该是集合所包含的类型,而不是集合本身的类型。使用resultType或resultMap,而不要同时使用两者。 |
resultMap | 对外部resultMap的命名引用。结果映射是MyBatis最强大的特性,通过对其进行良好理解,可以解决许多复杂的映射情况。使用resultMap或resultType,而不要同时使用两者。 |
flushCache | 将此设置为true将导致在每次调用该语句时刷新本地缓存和二级缓存。对于select语句,默认值为false。 |
useCache | 将此设置为true将导致该语句的结果被缓存在二级缓存中。对于select语句,默认值为true。 |
timeout | 这个属性设置驱动程序在请求后等待数据库返回的时间,超过该时间将抛出异常。默认值是未设置的(依赖于驱动程序)。 |
fetchSize | 这是一个驱动程序提示,它会尝试使驱动程序以指定大小的行批量返回结果。默认值是未设置的(依赖于驱动程序)。 |
statementType | 可以选择其中的一个:STATEMENT、PREPARED或CALLABLE。这会让MyBatis分别使用Statement、PreparedStatement或CallableStatement。默认值为PREPARED。 |
resultSetType | 可以选择其中之一:FORWARD_ONLY、SCROLL_SENSITIVE、SCROLL_INSENSITIVE或DEFAULT(与未设置相同)。默认值为unset(依赖于驱动程序)。 |
databaseId | 如果配置了databaseIdProvider,MyBatis将加载所有没有databaseId属性或者其databaseId与当前数据库Id匹配的语句。如果发现相同的语句既有databaseId,又没有databaseId,后者将被丢弃。 |
resultOrdered | 这仅适用于嵌套的结果选择语句:如果设置为true,则假定嵌套结果被包含或分组在一起,以便当返回新的主结果行时,不会再出现对以前结果行的引用。这样可以使嵌套结果填充更加友好地使用内存。默认值为false。 |
resultSets | 这仅适用于多个结果集。它列出了语句将返回的结果集,并为每个结果集提供一个名称。名称之间用逗号分隔。 |
affectData | 当编写返回数据的INSERT、UPDATE或DELETE语句时,将其设置为true,以便正确控制事务。还可参见事务控制方法。默认值为false(自3.5.12版起)。 |