mybatis--mapper配置总结

mapper介绍
1. mapper使用规则：按业务划分，一个业务模块相关的sql均定义在一个mapper文件
2. mapper的xml格式：
  1. doctype：
    - <!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
  2. 使用mapper标签包含：
  - - <mapper namespace="com.pro.dao.UserDao"></mapper>
mapper概览
- cache：指定名称的缓存
- cache-ref：引用其他文件的命名配置
- resultMap：描述如何加载数据库结果的对象
- sql：可重用的sql块，也可以被其他语句使用
- insert：插入
- update：更新
- delete：删除
- select：查询

使用介绍

select标签

<select
  id="selectPerson" //唯一标识sql语句，与接口中的标识一致。
  parameterType="int"//入参类型
  resultType="hashmap"//期望返回类型的类名或别名，集合时,应该是集合可以包含的类型,而不能是集合本身
  resultMap="personResultMap"//引用resultMap标签定义
  flushCache="false"//设置为true，清空缓存
  useCache="true"//使用cache：本条结果将被缓存
  timeout="10000"
  fetchSize="256"
  statementType="PREPARED"//Statement,PreparedStatement 或 CallableStatement。 默认值:PREPARED
  resultSetType="FORWARD_ONLY">//FORWARD_ONLY|SCROLL_SENSITIVE|SCROLL_INSENSITIVE 中的一种。默认是不设置(驱动自行处理)。

多表查询:

<!-- Very Complex Statement -->
<select id="selectBlogDetails" resultMap="detailedBlogResultMap">
  select
       B.id as blog_id,
       B.title as blog_title,
       B.author_id as blog_author_id,
       A.id as author_id,
       A.username as author_username,
       A.password as author_password,
       A.email as author_email,
       A.bio as author_bio,
       A.favourite_section as author_favourite_section,
       P.id as post_id,
       P.blog_id as post_blog_id,
       P.author_id as post_author_id,
       P.created_on as post_created_on,
       P.section as post_section,
       P.subject as post_subject,
       P.draft as draft,
       P.body as post_body,
       C.id as comment_id,
       C.post_id as comment_post_id,
       C.name as comment_name,
       C.comment as comment_text,
       T.id as tag_id,
       T.name as tag_name
  from Blog B
       left outer join Author A on B.author_id = A.id
       left outer join Post P on B.id = P.blog_id
       left outer join Comment C on P.id = C.post_id
       left outer join Post_Tag PT on PT.post_id = P.id
       left outer join Tag T on PT.tag_id = T.id
  where B.id = #{id}
</select>

insert、update、delete标签

<insert id="insertAuthor"//唯一标签，与接口中的方法名称一致 parameterType="domain.blog.Author"//参数类型，限定名 flushCache="true" statementType="PREPARED" keyProperty="" keyColumn="" useGeneratedKeys="" timeout="20">

selectKey：selectKey 元素将会首先运行, id 会被设置,然后插入语句 会被调用

<insert id="insertAuthor">
  <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>

sql标签

这个元素可以被用来定义可重用的 SQL 代码段,可以包含在其他语句中

<sql id="userColumns"> id,username,password </sql>
<select id="selectUsers" resultType="map">
  select <include refid="userColumns"/>
  from some_table
  where id = #{id}
</select>
<insert id="insertUser" parameterType="User"> 
　　insert into users (id, username, password) values (#{id}, #{username}, #{password}) 
</insert>

resultMap标签

结果映射定义：
constructor - 类在实例化时,用来注入结果到构造方法中
- idArg - ID 参数;标记结果作为 ID 可以帮助提高整体效能
- arg - 注入到构造方法的一个普通结果
id – 一个 ID 结果;标记结果作为 ID 可以帮助提高整体效能
result – 注入到字段或 JavaBean 属性的普通结果

association – 一个复杂的类型关联;许多结果将包成这种类型

嵌入结果映射 – 结果映射自身的关联,或者参考一个
has a关系：

关联元素处理“有一个”类型的关系。

<resultMap id="blogResult" type="Blog">
  <id property="id" column="blog_id" />
  <result property="title" column="blog_title"/>
  <association property="author" column="blog_author_id" javaType="Author" resultMap="authorResult"/>
</resultMap>

<resultMap id="authorResult" type="Author">
  <id property="id" column="author_id"/>
  <result property="username" column="author_username"/>
  <result property="password" column="author_password"/>
  <result property="email" column="author_email"/>
  <result property="bio" column="author_bio"/>
</resultMap>

<select id="selectBlog" resultMap="blogResult">
  select
    B.id            as blog_id,
    B.title         as blog_title,
    B.author_id     as blog_author_id,
    A.id            as author_id,
    A.username      as author_username,
    A.password      as author_password,
    A.email         as author_email,
    A.bio           as author_bio
  from Blog B left outer join Author A on B.author_id = A.id
  where B.id = #{id}
</select>

collection – 复杂类型的集
- 嵌入结果映射 – 结果映射自身的集,或者参考一个
discriminator – 使用结果值来决定使用哪个结果映射case – 基于某些值的结果映射
- 嵌入结果映射 – 这种情形结果也映射它本身,因此可以包含很多相同的元素,或者它可以参照一个外部的结果映射。

Cache标签
- ```
<cache/>
```
  字面上看就是这样。这个简单语句的效果如下:
  - 映射语句文件中的所有 select 语句将会被缓存。
  - 映射语句文件中的所有 insert,update 和 delete 语句会刷新缓存。
  - 缓存会使用 Least Recently Used(LRU,最近最少使用的)算法来收回。
  - 根据时间表(比如 no Flush Interval,没有刷新间隔), 缓存不会以任何时间顺序来刷新。
  - 缓存会存储列表集合或对象(无论查询方法返回什么)的 1024 个引用。
  - 缓存会被视为是 read/write(可读/可写)的缓存,意味着对象检索不是共享的,而且可以安全地被调用者修改,而不干扰其他调用者或线程所做的潜在修改。
  所有的这些属性都可以通过缓存元素的属性来修改。比如:
```
<cache
  eviction="FIFO"
  flushInterval="60000"
  size="512"
  readOnly="true"/>
```

mybatis--mapper配置总结

推荐阅读