MyBatis映射器总结

Mybatis映射器xml配置包含如下标签：

• select 查询语句，自定义参数返回结果集
• insert 插入语句
• update 更新语句
• delete 删除语句
• parameterMap 定义参数映射关系，不建议使用
• sql 定义一段SQL，可以再其他部分引用
• resultMap 结果集，提供映射规则
• cache 给定命名空间的缓存配置
• cache-ref 其他命名空间缓存配置的引用

1.select

1.1 select标签包含如下属性：

1.2 自动映射和驼峰映射

在setting元素中提供了两个可以配置的选项：

• autoMappingBehavior（SQL列名和属性名保持一致）
  • NONE，不进行自动映射
  • PARTIAL，默认值，只对没有嵌套结果集进行自动映射
  • FULL，对所有的结果集进行自动映射，包括嵌套结果集。
• mapUnderscoreToCamelCase （true/false ， user_name ===>> userName）

1.3 传递多个参数

• map
  • 需要 parameterType="map"
  • 但是使用map不能限定其传递的数据类型
• 使用@Param注解
  • 代码可读性大大提高
  • 不需要给出parameterType属性了，让MyBatis自动探索
• JavaBean传递参数
  • 事先定义好POJO 如：User{ private String name;private Integer age}
  • 接口方法传值 selectByxxx（User user） ，同时parameterType="xxx.xxx.xxx.User"
• 混合使用

  public Paging fidPageByUser(@Param("user") User user,@Param("page")PageParam pageParam);

  <select id="fidPageByUser" resultType="paging">
    select * from t_user
      where user_name like
      concat('%',#{user.name},'%')
      and age != #{user.age}
      limit #{page.start},#{page.limit}
  </select>

总结：

• 使用 map传递参数导致了业务可读性的丧失，导致后续扩展和维护的困难，在实际
  的应用中要果断废弃这种方式。
• 使用＠Param 注解传递多个参数，受到参数个数 （n）的影响。当 你 <= 5 时， 这是最
  佳的传参方式，它比用 Java Bean 更好，因为它更加直观 n>5 时， 多个参数将
  给调用带来困难，此时不推荐使用它。
• 当参数个数多于 5个时，建议使用 Java Bean 方式。
• 对于使用混合参数的，要明确参数的合理性。

1.4 使用resultMap映射结果集

resultMap标签可以支持复杂的映射，如typeHandler、联级等。同时select标签也提供了resultMap属性将定义好的resultMap作为映射结果集。

2. insert/update

2.1 insert标签包含如下属性：

2.2 主键回填

<insert id="insertUser" parameterType="user" useGeneratedKeys="true" keyProperty="id">
    insert into t_user(user_name,user_age) values(#{userName},#{age})
</insert>

2.3 selectKey实现自定义主键

<insert id="insertUser" parameterType="user">
    <selectKey keyProperty="id" resultType="long" order="BEFORE">
        select if(max(id)=null,1,max(id)+3) from t_user
    </selectKey>
    insert into t_user(user_name,user_age) values(#{userName},#{age})
</insert>

3. SQL标签

sql标签的作用在于可以定义一条SQL的一部分，方便后面的SQL引用它，比如最典型的列名。通常在select、insert等语句中反复编译他们。

<sql id="userCols">
    id,user_name,user_age
</sql>
<select id="selectOneById" parameterType="long" resultMap="userMap">
    select <include refid="userCols" /> from t_user where id = #{id}
</select>
<insert id="insertUser" parameterType="user">
    insert into t_user(<include refid="userCols" />) values(#{id},#{userName},#{userAge})
</insert>

传递变量给sql标签：

<sql id="userCols">
    ${alias}.id,${alias}.user_name,${alias}.user_age
</sql>
<select id="selectOneById" parameterType="long" resultMap="userMap">
    select
    <include refid="userCols" >
        <property name="alias" value="r" />
    </include>
    from t_user r where id = #{id}
</select>

4. 参数

#{userName,typeHandler=com.example.mybatis.StringTypeHandler},#{userAge}

#{age,javaType=int,jdbcType=NUMERIC,typeHandler=MyTypeHandler} 

#{width , javaType=double , jdbcType=NUMERIC, numericScale=2} 

• 存储过程支持

  #{id,mode=IN}
  #{userName,mode=OUT}
  #{age,mode=INOUT}

• 特殊字符串的替换和处理
• 接口参数可以传递子类实例

  insert(A a); B extends A; ==> insert(b);

5. resultMap

resultMap的作用是定义映射规则、联级更新、定制类型转换器等。但是只支持resultMap的查询。

5.1 resultMap元素的构成

• resultMap元素的子元素：

  <resultMap>
    <constructor> <!--用于配置构造方法，不存在没有参数的构造方法的情况-->
        <idArg />
          <arg />
      </constructor>
      <id />
      <result />
      <association />
      <collection />
      <discriminator>
        <case />
      </discriminator>
  </resultMap>

• result元素和idArg元素的属性
  • property POJO的属性
  • column 对应的是SQL的lie
  • javaType 配置java的类型
  • jdbcType 配置数据库的类型
  • typeHandler 类型处理器

5.2 使用map存储结果集

一般而言，任何select语句都可以使用map存储：

<select id="select" parameterType="string" resultType="map">
    select xxxxxxxxxxx ...
</select>

map原则上是可以匹配所有的结果集，但是可读性下降。更多推荐POJO的方式。

5.3 使用POJO存储结果集

使用resultMap映射了。

5.4 联级

mybatis的联级分为3种：

• 鉴别器 discriminator
• 一对一 association
• 一对多 collection

5.5 N+1问题与延迟加载

假设现在有 个关联关系完成了级联，那么只要再加入 个关联关系，就变成了 N+1个级联，所有的级联 SQL 会被执行，显然会有很多并不是我们关心的数据被取出，这样会造成很大的资源浪费，这就是 N+1问题，尤其是在那些需要高性能的互联网系统中，这往往是不被允许的。

所以有了延迟加载的功能，一开始只加载需要的部分，当我们需要时对应的记录才通过SQL取出来。

6. 缓存

mybatis中允许使用缓存，缓存一般都存放置在高速读/写的存储器上。

• 一级缓存，是在SqlSession上的缓存
• 二级缓存，是在SqlSessionFactory上的缓存 <cache />
• 缓存配置项、自定义和引用

原文地址：https://www.cnblogs.com/nm666/p/11329972.html