一、示例

1、别名

一个参数是可以不用声明别名，但如果该参数涉及到if test之类的判空，是需要声明别名的，否则会出错
dao

Map<String,Object> getBidResult(String projectId);
String getDicName(@Param("dicCode") String dicCode1);

mapper.xml

<select id="getBidResult" parameterType="string" resultType="map">
    select * from t_bid_result a where pms_project_id = #{projectId} limit 1
</select>

<select id="getDicName" parameterType="string" resultType="string">
    select biz_dic_name
    from t_dictionary a
    <if test="dicCode != null and dicCode != ''">
        where biz_dic_code = #{dicCode} limit 1
    </if>

</select>

2、trim

trim标签一般用于去除sql语句中多余的and关键字，逗号，或者给sql语句前拼接 “where“、“set“以及“values(“ 等前缀，或者添加“)“等后缀，可用于选择性插入、更新、删除或者条件查询等操作。

属性	描述
prefix	给sql语句拼接的前缀
suffix	给sql语句拼接的后缀
prefixOverrides	去除sql语句前面的关键字或者字符，该关键字或者字符由prefixOverrides属性指定，假设该属性指定为"AND"，当sql语句的开头为"AND"，trim标签将会去除该"AND"
suffixOverrides	去除sql语句后面的关键字或者字符，该关键字或者字符由suffixOverrides属性指定，比如set的逗号

Map<String,Object> getUserInfo(Map<String,Object> map);

<select id="getUserInfo" parameterType="map" resultType="map">
    select
           a.user_id,
           a.user_name,
           a.emp_name,
           a.emp_code,
           a.email,
           a.mobile,
           a.org_id,
           (SELECT b.org_code from t_eap_sys_organization b WHERE b.ORG_ID = a.org_id) org_code,
           (SELECT b.ORG_NAME from t_eap_sys_organization b WHERE b.ORG_ID = a.org_id) org_name
    from t_sys_user a
    <trim prefix="where" prefixOverrides="AND|OR">
        <if test="user_id != null and user_id != ''"> and a.user_id = #{user_id}</if>
        <if test="emp_code != null and emp_code != ''"> and a.emp_code = #{emp_code}</if>
    </trim>
</select>

3、foreach

foreach元素的属性主要有item，index，collection，open，separator，close。

• item：集合中元素迭代时的别名，该参数为必选。
• index：在list和数组中,index是元素的序号，在map中，index是元素的key，该参数可选
• open：foreach代码的开始符号，一般是(和close=")"合用。常用在in(),values()时。该参数可选
• separator：元素之间的分隔符，例如在in()的时候，separator=","会自动在元素中间用“,“隔开，避免手动输入逗号导致sql错误，如in(1,2,)这样。该参数可选。
• close：foreach代码的关闭符号，一般是)和open="("合用。常用在in(),values()时。该参数可选。
• collection：要做foreach的对象，作为入参时，List对象默认用"list"代替作为键，数组对象有"array"代替作为键，Map对象没有默认的键。当然在作为入参时可以使用@Param(“keyName”)来设置键，设置keyName后，list,array将会失效。除了入参这种情况外，还有一种作为参数对象的某个字段的时候。举个例子：如果User有属性List
  ids。入参是User对象，那么这个collection = “ids”.如果User有属性Ids
  ids;其中Ids是个对象，Ids有个属性List id;入参是User对象，那么collection = “ids.id”

在使用foreach的时候最关键的也是最容易出错的就是collection属性，该属性是必须指定的，但是在不同情况下，该属性的值是不一样的，主要有一下3种情况：

• 如果传入的是单参数且参数类型是一个List的时候，collection属性值为list .
• 如果传入的是单参数且参数类型是一个array数组的时候，collection的属性值为array .
• 如果传入的参数是多个的时候，我们就需要把它们封装成一个Map了，当然单参数也可以封装成map，实际上如果你在传入参数的时候，在MyBatis里面也是会把它封装成一个Map的，map的key就是参数名，所以这个时候collection属性值就是传入的List或array对象在自己封装的map里面的key.

void insertContractInfo( @Param("plan")List<Map<String, Object>> plan, @Param("pay")List<Map> pay);

<insert id="insertContractInfo">
    <if test="plan != null and plan.size() > 0">
        INSERT INTO t_performplan (
        PERFORMID,
        CONTRACT_ID,
        BASENAME,
        MONEYTYPE,
        MONEYTYPESHOW,
        STAGEACCEPTANCECONDITION,
        MONEYPERCENT,
        MONEYAMOUNT,
        CURRENCY,
        CURRENCYTYPE,
        PAYMENTNATURE,
        PAYMENTNATURESHOW,
        PLANDATE
        )
        VALUES
        <foreach collection="plan" item="it" separator=",">
            (
            #{it.objectid},
            #{it.contractid},
            #{it.basename},
            #{it.moneytype},
            #{it.moneytypeshow},
            #{it.stageacceptancecondition},
            #{it.moneypercent},
            #{it.moneyamount},
            #{it.currency},
            #{it.currencytype},
            #{it.paymentnature},
            #{it.paymentnatureshow},
            #{it.plandate}
            )
        </foreach>
        ;
    </if>

    <if test="pay != null and pay.size() > 0">
        INSERT INTO t_payment (
        ID,
        PLANID,
        PAYTYPE,
        PAYTYPESHOW,
        PAYPERCENT
        )
        VALUES
        <foreach collection="pay" item="it" separator=",">
            (
            uuid(),
            #{it.planid},
            #{it.paytype},
            #{it.paytypeshow},
            #{it.paypercent}
            )
        </foreach>
        ;
    </if>
</insert>

4、主键存在则更新，否则插入

on duplicate key update 表示如果主键已经存在，则执行更新语句，更新的字段就是on duplicate key update 后面指定的 参数。
values(?)后面的参数并非前端传递的参数，而是数据库的字段。

INSERT INTO t_file (
OBJECTID,
CONTRACTID,
BASENAME,
FILETYPE,
FILEDOWNLOADURL,
FILEVIEWURL
)
VALUES
<foreach collection="file" item="it" separator=",">
    (
    #{it.objectid},
    #{it.contractid},
    #{it.basename},
    #{it.filetype},
    #{it.filedownloadurl},
    #{it.fileviewurl}
    )
</foreach>
on DUPLICATE KEY UPDATE 
    BASENAME = values(BASENAME),FILETYPE = values(FILETYPE),
    FILEDOWNLOADURL = values(FILEDOWNLOADURL),
    FILEVIEWURL = IFNULL(values(FILEVIEWURL),FILEVIEWURL);<!--  FILEVIEWURL 如果传入的参数值为空，则不更新。 -->

5、时间格式化

1、Oracle

字符串为转化为日期格式

SELECT to_date('2021-09-20 08:30:45', 'yyyy-MM-dd hh24:mi:ss') FROM dual;

日期转化为字符串

SELECT to_char(SYSDATE, 'yyyy-MM-dd hh24:mi:ss') FROM dual;

2、Mysql

字符串为转化为日期格式

SELECT DATE_FORMAT('2021-09-20 08:30:45','%Y-%m-%d %H:%i:%S'); 

日期转化为字符串

SELECT DATE_FORMAT(NOW(),'%Y-%m-%d %H:%i:%S'); 

6、模糊查询

1、Oracle

SELECT 
* 
FROM user
 WHERE
 name LIKE CONCAT('%',#{name},'%') ;
--或 
SELECT
 * 
FROM
 user
 WHERE
 name LIKE '%'||#{name}||'%';

2、Mysql

SELECT 
* 
FROM user
 WHERE
 name LIKE CONCAT('%',#{name},'%') ;