SQL映射文件顶级元素有cache，cache-ref，resultMap，sql，insert，update，delete，select。
- select，对每个插入、更新或删除操作，通常都对应多个查询操作。select元素有多个属性。
- id 在命名空间中唯一的标识符，可以被用来引用这条语句。
- parameterType，参数类型，完全限定名或别名，这个属性是可选的，mybatis可以通过TypeHandler推断出传入参数的具体类型，默认为unset。
- resultType，select语句返回的期望类型。不能和resultMap同时使用
- resultMap，外部resultMap的引用，不能和resultType同时使用
- flushCache，select为false，其他语句为true，false表示不刷新本地缓存和二级缓存。
- useCache，默认为true，true表示把结果被二级缓存
- timeout， 抛出异常之前，驱动程序等待数据库返回请求结果的秒数。默认值为 unset（依赖驱动）。
- fetchSize， 每次批量返回的结果行数和这个设置值相等。默认值为 unset（依赖驱动）。
- statementType，有三个候选项，Statement，Prepared，Callable
- resultSetType FORWARD_ONLY，SCROLL_SENSITIVE 或 SCROLL_INSENSITIVE 中的一个，默认值为 unset （依赖驱动）。
- databaseId， 如果配置了 databaseIdProvider，MyBatis 会加载所有的不带 databaseId 或匹配当前 databaseId 的语句；如果带或者不带的语句都有，则不带的会被忽略。
- resultOrdered， 这个设置仅针对嵌套结果 select 语句适用：如果为 true，就是假设包含了嵌套结果集或是分组了，这样的话当返回一个主结果行的时候，就不会发生有对前面结果集的引用的情况。这就使得在获取嵌套的结果集的时候不至于导致内存不够用。默认值：false。
- resultSets， 这个设置仅对多结果集的情况适用，它将列出语句执行后返回的结果集并每个结果集给一个名称，名称是逗号分隔的。
- Insert和update可以使用useGeneratorKeys和keyProperty属性，可以返回数据库在执行这个语句时内部生成的主键。mapper.xml代码：
<insert id="insert" useGeneratedKeys="true" keyProperty="id" >
insert into student (id, name, grade_id
)
values (#{id,jdbcType=INTEGER}, #{name,jdbcType=VARCHAR}, #{gradeId,jdbcType=SMALLINT}
)
</insert>
返回的主键被设置为插入实体对象的id属性中。
- sql，定义可重用的代码块。
- paremeters，mybatis的参数类型可以自动判断，也可以定义自己的typeHandler。如果 null 被当作值来传递，对于所有可能为空的列，JDBC Type 是需要的。
- resultMap的属性有id，type，autoMapping。它的子元素有
- constructor，类在实例化时，用来注入结果到构造方法中
- idArg，ID 参数;标记结果作为 ID 可以帮助提高整体效能
- arg，注入到构造方法的一个普通结果
- id，一个 ID 结果;标记结果作为 ID 可以帮助提高整体效能
- result，注入到字段或 JavaBean 属性的普通结果，ID和Result的区别是ID对应的是数据库表的主键。这两个元素的属性有，property，column，javaType，jdbcType（JDBC 类型是仅 仅需要对插入,更新和删除操作可能为空的列进行处理。这是 JDBC jdbcType 的需要,），typeHandler
- association， 一个复杂的类型关联;许多结果将包成这种类型。关联元素处理"has a"类型的关系，mybatis有两种不同的关联加载方式：
- 嵌套查询：通过执行另外一个 SQL 映射语句来返回预期的复杂类型。通过select属性
- 嵌套结果：使用嵌套结果映射来处理重复的联合结果的子集。首先,然让我们来查看这个元素的属性。所有的你都会看到,它和普通的只由 select 和
resultMap 属性的结果映射不同。
- collection，复杂类型的集合，和关联类似。要映射嵌套结果集合到 List 中,我们使用集合元素。就像关联元素一样,我们可以从 连接中使用嵌套查询,或者嵌套结果。在嵌套查询和嵌套结果中和association不同的是，它有一个ofType，表示集合中元素的类型。
- discriminator，使用结果值来决定使用哪个结果映射，和java switch类似
- case，基于某些值的结果映射
- 缓存，如果要开启二级缓存，需要添加<cache>。效果如下：
- 映射语句文件中的所有 select 语句将会被缓存。
- 映射语句文件中的所有 insert,update 和 delete 语句会刷新缓存。
- 缓存会使用 Least Recently Used(LRU,最近最少使用的)算法来收回。
- 根据时间表(比如 no Flush Interval,没有刷新间隔), 缓存不会以任何时间顺序 来刷新。
- 缓存会存储列表集合或对象(无论查询方法返回什么)的 1024 个引用。
- 缓存会被视为是 read/write(可读/可写)的缓存,意味着对象检索不是共享的,而 且可以安全地被调用者修改,而不干扰其他调用者或线程所做的潜在修改。
网友评论