mybatis的XML文件

SQL映射文件顶级元素有cache,cache-ref,resultMap,sql,insert,update,delete,select。

  1. 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, 这个设置仅对多结果集的情况适用,它将列出语句执行后返回的结果集并每个结果集给一个名称,名称是逗号分隔的。
  1. Insert和update可以使用useGeneratorKeys和keyProperty属性,可以返回数据库在执行这个语句时内部生成的主键。mapper.xml代码:


    insert into student (id, name, grade_id
    )
    values (#{id,jdbcType=INTEGER}, #{name,jdbcType=VARCHAR}, #{gradeId,jdbcType=SMALLINT}
    )

返回的主键被设置为插入实体对象的id属性中。

  1. sql,定义可重用的代码块。
  2. paremeters,mybatis的参数类型可以自动判断,也可以定义自己的typeHandler。如果 null 被当作值来传递,对于所有可能为空的列,JDBC Type 是需要的。
  3. 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,基于某些值的结果映射
  1. 缓存,如果要开启二级缓存,需要添加。效果如下:
  • 映射语句文件中的所有 select 语句将会被缓存。
  • 映射语句文件中的所有 insert,update 和 delete 语句会刷新缓存。
  • 缓存会使用 Least Recently Used(LRU,最近最少使用的)算法来收回。
  • 根据时间表(比如 no Flush Interval,没有刷新间隔), 缓存不会以任何时间顺序 来刷新。
  • 缓存会存储列表集合或对象(无论查询方法返回什么)的 1024 个引用。
  • 缓存会被视为是 read/write(可读/可写)的缓存,意味着对象检索不是共享的,而 且可以安全地被调用者修改,而不干扰其他调用者或线程所做的潜在修改。

你可能感兴趣的:(mybatis的XML文件)