Mybatis中Mapper标签总结大全

小白爱喝可乐

已于 2022-03-23 11:32:06 修改

阅读量1.4k

点赞数 2

分类专栏： Java框架学习总结文章标签：数据库 database

于 2021-10-31 17:31:21 首次发布

原文链接：https://blog.csdn.net/cwx397562/article/details/100334210?spm=1001.2101.3001.6650.1&utm_medium=distribute.pc_relevant.none-task-blog-2%7Edefault%7ECTRLIST%7Edefault-1.no_search_link&depth_1-utm_source=distribute.pc_relevant.none-task-blog-2%7Edefault%7ECT

版权

Java框架学习总结专栏收录该内容

8 篇文章 1 订阅

订阅专栏

Mybatis中Mapper标签总结大全

文章目录

一、标签分类

定义SQL语句
- insert
- delete
- update
- select
配置关联关系
- collection
- association
配置java对象属性与查询结果集中列名的对应关系
- resultMap
控制动态SQL拼接
- foreach
- if
- choose
格式化输出
- where
- set
- trim
定义常量
- sql
其他
- include

二、标签总结

1. 基础SQL标签

1.1 查询select

标签属性
- id 唯一的名称，对应dao中mapper的接口名称
- paramterType 定义传入的参数类型
- resultType 返回数据类型对应实体类
- resultMap 外部 resultMap 的命名引用。结果集的映射是 MyBatis 最强大的特性，对其有一个很好的理解的话，许多复杂映射的情形都能迎刃而解。使用 resultMap 或 resultType，但不能同时使用
- flushCache 将其设置为 true，任何时候只要语句被调用，都会导致本地缓存和二级缓存都会被清空，默认值：false
- useCache 将其设置为 true，将会导致本条语句的结果被二级缓存，默认值：对 select 元素为 true
- timeout 这个设置是在抛出异常之前，驱动程序等待数据库返回请求结果的秒数。默认值为 unset（依赖驱动）
- fetchSize 这是尝试影响驱动程序每次批量返回的结果行数和这个设置值相等。默认值为 unset（依赖驱动）。
- statementType STATEMENT，PREPARED 或 CALLABLE 的一个。这会让 MyBatis 分别使用 Statement，PreparedStatement 或 CallableStatement，默认值：PREPARED。
- resultSetType FORWARD_ONLY，SCROLL_SENSITIVE 或 SCROLL_INSENSITIVE 中的一个，默认值为 unset （依赖驱动）。
- databaseId 如果配置了 databaseIdProvider，MyBatis 会加载所有的不带 databaseId 或匹配当前 databaseId 的语句；如果带或者不带的语句都有，则不带的会被忽略。
- resultOrdered 这个设置仅针对嵌套结果 select 语句适用：如果为true，就是假设包含了嵌套结果集或是分组了，这样的话当返回一个主结果行的时候，就不会发生有对前面结果集的引用的情况。这就使得在获取嵌套的结果集的时候不至导致内存不够用。默认值：false。
- resultSets 这个设置仅对多结果集的情况适用，它将列出语句执行后返回的结果集并每个结果集给一个名称，名称是逗号分隔的。

1.2 增删改

标签属性
- id 唯一的名称，对应dao中mapper的接口名称
- parameterType 将要传入语句的参数的完全限定类名或别名。这个属性是可选的，因为 MyBatis 可以通过 TypeHandler 推断出具体传入语句的参数，默认值为 unset。
- flushCache 将其设置为 true，任何时候只要语句被调用，都会导致本地缓存和二级缓存都会被清空，默认值：true（对应插入、更新和删除语句）。
- timeout 这个设置是在抛出异常之前，驱动程序等待数据库返回请求结果的秒数。默认值为 unset（依赖驱动）。
- statementType STATEMENT，PREPARED 或 CALLABLE 的一个。这会让 MyBatis 分别使用 Statement，PreparedStatement 或 CallableStatement，默认值：PREPARED。
- useGeneratedKeys（仅对 insert 和 update 有用）这会令 MyBatis 使用 JDBC 的 getGeneratedKeys 方法来取出由数据库内部生成的主键（比如：像 MySQL 和 SQL Server这样的关系数据库管理系统的自动递增字段, oracle使用序列是不支持的，通过selectKey可以返回主键），默认值：false。
- keyProperty （仅对 insert 和 update 有用）唯一标记一个属性，MyBatis 会通过 getGeneratedKeys 的返回值或者通过 insert 语句的 selectKey子元素设置它的键值，默认：unset。如果希望得到多个生成的列，也可以是逗号分隔的属性名称列表。
- keyColumn（仅对 insert 和 update 有用）通过生成的键值设置表中的列名，这个设置仅在某些数据库（像PostgreSQL）是必须的，当主键列不是表中的第一列的时候需要设置。如果希望得到多个生成的列，也可以是逗号分隔的属性名称列表。
- databaseId 如果配置了 databaseIdProvider，MyBatis 会加载所有的不带 databaseId 或匹配当前 databaseId 的语句；如果带或者不带的语句都有，则不带的会被忽略。
```

<selectKey resultType="long" order="BEFORE" keyProperty="id">
    SELECT user_seq.NEXTVAL as id from DUAL
</selectKey>

insert into User (ID, USERNAME, PASSWORD, SEX, ADRESS, CREATED_BY, CREADTED_DATE)
values (#{id}, #{username}, #{password}, #{sex}, #{adress}, #{createdBy}, SYSDATE)
```

1.3 其他基础标签

1.3.1 sql 标签

定义一些常用的sql语句片段

<sql id="selectParam">
    id, username, password, sex, birthday, address
</sql>

1.3.2 include 标签

引用其他的常量，通常和sql一起使用

<select>
    select <include refid="selectParam"></include>
    from user
</select>

1.3.3 if 标签

基本都是用来判断值是否为空，注意Integer的判断，mybatis会默认把0变成 ‘’

<if test="item != null and item != ''"></if>

<!-- 如果是Integer类型的需要把and后面去掉或是加上or-->
<if test="item != null"></if>
<if test="item != null and item != '' or item == 0"></if>

1.3.4 别名

经常使用的类型可以定义别名，方便使用，mybatis也注册了很多别名方便我们使用，详情见底部附录

<typeAliases>
     <typeAlias type="com.it.bean.User" alias="User"/>
</typeAliases>

2. collection与association标签

collection与association的属性一样，都是用于resultMap返回关联映射使用，collection关联的是集合，而association是关联单个对象

标签属性
- property resultMap返回实体类中字段和result标签中的property一样
- column 数据库的列名或者列标签别名,是关联查询往下一个语句传送值。注意：在处理组合键时，您可以使用column=“{prop1=col1,prop2=col2}”这样的语法，设置多个列名传入到嵌套查询语句。这就会把prop1和prop2设置到目标嵌套选择语句的参数对象中。
- javaType 一般为ArrayList或是java.util.List
- ofType java的实体类，对应数据库表的列名称，即关联查询select对应返回的类
- select 执行一个其他映射的sql语句返回一个java实体类型
/**
*问题表
*/
public class Question {
```
private Long id; //问题id

private String question; //问题

private Integer questionType; //问题类型

private List<QuestionAnswer> answerList; //问题选项集合

//Getter和Setter省略
```
}

/**
*问题选项表
*/
public class QuestionAnswer {
```
private Long id; //选项id

private Long questionId;  //问题id

private String answer; //选项

//Getter和Setter省略
```
}

3. resultMap标签

resultMap属性
- id 唯一标识
- type 返回类型
- extends 继承别的resultMap，可选
关联其他标签
- id 设置主键使用，使用此标签配置映射关系（可能不止一个）
- result 一般属性的配置映射关系，一般不止一个
- association 关联一个对象使用
- collection 关联一个集合使用
select q.id, q.question, q.question_type from question q q.id = #{cond.id} q.id in #{id} select a.id, a.answer from question_answer a where a.question_id = #{id}

4. foreach标签

foreach属性
- collection 循环的集合。传的是集合为list，数组为array, 如果是map为java.util.HashMap
- item 循环的key
- index 循环的下表顺序
- open 循环的开头
- close 循环结束
- separator 循环的分隔符
id, question_id, answer
insert into question_answer ( ) select question_answer_seq.NEXTVAL, A.* from ( select #{item.questionId}, #{item.answer} from dual ) A insert into question_answer ( ) values #{item.id}, #{item.questionId}, #{item.answer}

5. where标签

where用来去掉多条件查询时，开头多余的and

    <select id="selectUserList" parameterType="com.it.bean.User" resultType="com.it.bean.User">
        <!-- 引用Sql片段 -->
        select <include refid="selectParam"> from user u
        <where>
            <!--where 可以自动去掉条件中的第一个and-->
            <if test="id != null">
                and u.id = #{id}
            </if>
            <if test="name != null and name != ''">
                and u.name = #{name}
            </if>
        </where>
    </select>

6. set标签

set是mybatis提供的一个智能标记，当在update语句中使用if标签时，如果前面的if没有执行，则或导致逗号多余错误。使用set标签可以将动态的配置SET 关键字，和剔除追加到条件末尾的任何不相关的逗号。
没有使用if标签时，如果有一个参数为null，都会导致错误，如下示例：

    <update id="updateUser" parameterType="com.it.bean.user">
        update user
        <set>
            <if test="username != null and username != ''">
                username = #{username},
            </if>
            <if test="sex != null and sex == 0 or sex == 1">
                sex = #{sex},
            </if>
            <if test="birthday != null ">  
                birthday = #{birthday},
            </if >  
            <if test="address != null and address != ''">
                address = #{address},
            </if>
            <if test="lastModifiedBy != null and lastModifiedBy != ''">
                last_modified_by = #{lastModifiedBy},
                last_modified_date = SYSDATE,
            </if>
        </set>
        <where>
            id = #{id}
        </where>
    </update>

7. trim标签

trim标记是一个格式化的标记，可以完成set或者是where标记的功能

标签属性
- prefix、suffix 表示再trim标签包裹部分的前面或后面添加内容（注意：是没有prefixOverrides，suffixOverrides的情况下）
- prefixOverrides，suffixOverrides 表示覆盖内容，如果只有这两个属性表示删除内容
update user name= #{username},
```
        <if test="password!=null and password != ''">
            password= #{password},
        </if>

    </trim>
    <where>
        id = #{id}
    </where>
</update>
```

8. choose、when、otherwise标签

有时候我们并不想应用所有的条件，而只是想从多个选项中选择一个。MyBatis提供了choose 元素，按顺序判断when中的条件出否成立，如果有一个成立，则choose结束。当choose中所有when的条件都不满则时，则执行 otherwise中的sql。类似于Java 的switch 语句，choose为switch，when为case，otherwise则为default。if是与(and)的关系，而choose是或（or）的关系

<select id="getUserList" resultType="com.it.bean.User" parameterType="com.it.bean.User">  
    SELECT <include refid="resultParam"></include> FROM User u   
    <where>  
        <choose>  
            <when test="username !=null and username != ''">  
                u.username LIKE CONCAT(CONCAT('%', #{username}),'%')  
            </when >  
            <when test="sex != null">  
                AND u.sex = #{sex}  
            </when >  
            <when test="birthday != null ">  
                AND u.birthday = #{birthday}  
            </when >  
            <otherwise>  
            </otherwise>  
        </choose>  
    </where>    
</select>

小白爱喝可乐

关注

2
点赞
踩
15

收藏

觉得还不错? 一键收藏
1
评论
Mybatis中Mapper标签总结大全

**Mybatis中Mapper标签总结大全**文章目录一、标签分类二、标签总结1. 基础SQL标签1.1 查询select1.2 增删改1.3 其他基础标签1.3.1 sql 标签1.3.2 include 标签1.3.3 if 标签1.3.4 别名2. collection与association标签3. resultMap标签4. foreach标签5. where标签6. set标签7. trim标签8. choose、whe
复制链接

扫一扫