https://mybatis.org/mybatis-3/zh/sqlmap-xml.html
http://www.broadview.com.cn/book/3643

SQL 映射文件只有很少的几个顶级元素（按照应被定义的顺序列出）：

• cache – 对给定命名空间的缓存配置。
• cache-ref – 对其他命名空间缓存配置的引用。
• resultMap – 是最复杂也是最强大的元素，用来描述如何从数据库结果集中来加载对象。
• sql – 可被其他语句引用的可重用语句块。
• insert – 映射插入语句
• update – 映射更新语句
• delete – 映射删除语句
• select – 映射查询语句

<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE mapper
        PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
        "http://mybatis.org/dtd/mybatis-3-mapper.dtd">

<mapper namespace="com.bin.mapper.CountryMapper">

</mapper>

命名空间的作用有两个，一个是利用更长的完全限定名来将不同的语句隔离开来，同时也实现了你上面见到的接口绑定。就算你觉得暂时用不到接口绑定，你也应该遵循这里的规定，以防哪天你改变了主意。 长远来看，只要将命名空间置于合适的 Java 包命名空间之中，你的代码会变得更加整洁，也有利于你更方便地使用 MyBatis。

select

简单查询的 select 元素是非常简单的。比如：

<select id="selectPerson" parameterType="int" resultType="hashmap">
    SELECT * FROM PERSON WHERE ID = #{id}
</select>

这个语句被称作 selectPerson，接受一个 int（或 Integer）类型的参数，并返回一个 HashMap 类型的对象，其中的键是列名，值便是结果行中的对应值。

如果查询一个 country 下的所有 user，resultType 的类型必须包含 country 和 user 的全部属性。这样不利于扩展，所以可以在 country 中加入 user 属性：private SysUser user; private Integer userid;

<select id="selectPerson2" parameterType="int" resultType="country">
    select u.id, c.countryname, c.countrycode, u.username as "user.userName"
    from sys_user u left join country c on u.id=c.userid
    WHERE u.id = #{id}
</select>

这里设置别名的时候，使用的是 “user.属性名”，可以通过这种方式直接赋值给 country 中的 user 字段的属性。

select 元素允许你配置很多属性来配置每条语句的作用细节。

<select
    id="selectPerson"
    parameterType="int"
    parameterMap="deprecated"
    resultType="hashmap"
    resultMap="personResultMap"
    flushCache="false"
    useCache="true"
    timeout="10"
    fetchSize="256"
    statementType="PREPARED"
    resultSetType="FORWARD_ONLY">

多个接口参数的用法

• 将多个参数合并到一个 JavaBean 中
• 使用 Map 类型
• 使用 @Param 注解

List<SysRole> selectUserAndEnabled(@Param("userId")Long userid , @Param("enabled")Integer enabled);

<select id="selectUserAndEnabled" resultType ="SysUser">
    select * from sys_user where id = #{userld) and enabled = #{enabled)
</select>

当只有一个参数时，MyBatis 会不关心参数叫什么名字就直接把这个唯一的参数值拿来使用。

// @Param 注解，可以将方法的参数换成 JavaBean 类型
List<SysRole> selectRolesByUserAndRole(@Param("user") SysUser user, @Param("role") SysRole role);
// 这时，XML 中需要通过点取值方式，#{user.id}

insert, update 和 delete

<insert
    id="insertAuthor"
    parameterType="domain.blog.Author"
    flushCache="true"
    statementType="PREPARED"
    keyProperty=""
    keyColumn=""
    useGeneratedKeys=""
    timeout="20">

<update
    id="updateAuthor"
    parameterType="domain.blog.Author"
    flushCache="true"
    statementType="PREPARED"
    timeout="20">

<delete
    id="deleteAuthor"
    parameterType="domain.blog.Author"
    flushCache="true"
    statementType="PREPARED"
    timeout="20">

<!-- MySQL -->
<insert id="addShop" useGeneratedKeys="true" keyProperty="id" >
    INSERT INTO t_shop(shopname) VALUES(#{shopname})
</insert>

<!-- 批量 -->
<insert id="addShops" useGeneratedKeys="true" keyProperty="id">
    insert into t_shop (shopname) values
    <foreach item="item" collection="list" separator=",">
        (#{item.shopname})
    </foreach>
</insert>

selectKey

selectKey 元素描述如下：

<selectKey
    keyProperty="id"
    resultType="int"
    order="BEFORE"
    statementType="PREPARED">

selectKey 元素的属性

<!-- MySQL -->
<insert id="addShop">
    INSERT INTO t_shop(shopname) VALUES(#{shopname})
    <selectKey keyColumn="id" resultType="long" keyProperty="id" order="AFTER">
        SELECT LAST_INSERT_ID()
    </selectKey>
</insert>

<!-- Oracle -->
<insert id="insert" >
    <selectKey resultType="int" keyProperty="id" order="BEFORE">
        <![CDATA[SELECT T_SHOP_SEQ.NEXTVAL FROM DUAL]]>
    </selectKey>
    insert into T_SHOP (id, shopname) values (#{id}, #{shopname})
</insert>

sql

这个元素可以被用来定义可重用的 SQL 代码段，这些 SQL 代码可以被包含在其他语句中。它可以（在加载的时候）被静态地设置参数。 在不同的包含语句中可以设置不同的值到参数占位符上。比如：

<sql id="userColumns"> ${alias}.id,${alias}.username,${alias}.password </sql>

这个 SQL 片段可以被包含在其他语句中，例如：

<select id="selectUsers" resultType="map">
    select
        <include refid="userColumns"><property name="alias" value="t1"/></include>,
        <include refid="userColumns"><property name="alias" value="t2"/></include>
    from some_table t1
        cross join some_table t2
</select>

属性值也可以被用在 include 元素的 refid 属性里或 include 元素的内部语句中，例如：

<sql id="sometable">
    ${prefix}Table
</sql>

<sql id="someinclude">
    from
        <include refid="${include_target}"/>
</sql>

<select id="select" resultType="map">
    select
        field1, field2, field3
    <include refid="someinclude">
        <property name="prefix" value="Some"/>
        <property name="include_target" value="sometable"/>
    </include>
</select>

参数

参数也可以指定一个特殊的数据类型。

#{property, javaType=int, jdbcType=NUMERIC}

JDBC 要求，如果一个列允许 null 值，并且会传递值 null 的参数，就必须要指定 JDBC Type。

数据库中区分 date、time、datetime，但 Java 中一般都使用 java.util.Date 类型。所以需要指定类型，分别对应的 JDBC 类型为 DATE、TIME、TIMESTAMP。

字符串替换

默认情况下,使用 #{} 格式的语法会导致 MyBatis 创建 PreparedStatement 参数占位符并安全地设置参数（就像使用 ? 一样）。 这样做更安全，更迅速，通常也是首选做法。不过有时你就是想直接在 SQL 语句中插入一个不转义的字符串。 比如，像 ORDER BY，你可以这样来使用：ORDER BY ${columnName}

@Select("select * from user where ${column} = #{value}")
User findByColumn(@Param("column") String column, @Param("value") String value);

其中 ${column} 会被直接替换，而 #{value} 会被使用 ? 预处理。