3_mapper 映射器

👉参照官方文档：https://mybatis.org/mybatis-3/zh/sqlmap-xml.html#

---

MyBatis 的真正强大在于它的语句映射，这是它的魔力所在。由于它的异常强大，映射器的 XML 文件就显得相对简单。如果拿它跟具有相同功能的 JDBC 代码进行对比，你会立即发现省掉了将近 95% 的代码。MyBatis 致力于减少使用成本，让用户能更专注于 SQL 代码。

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

• cache – 该命名空间的缓存配置。
• cache-ref – 引用其它命名空间的缓存配置。
• resultMap – 描述如何从数据库结果集中加载对象，是最复杂也是最强大的元素。
• parameterMap – 老式风格的参数映射。此元素已被废弃，并可能在将来被移除！请使用行内参数映射。文档中不会介绍此元素。
• sql – 可被其它语句引用的可重用语句块。
• insert – 映射插入语句。
• update – 映射更新语句。
• delete – 映射删除语句。
• select – 映射查询语句。

下一部分将从语句本身开始来描述每个元素的细节。

---

主键生成说明

若数据库支持自动生成主键的字段（比如 MySQL 和 SQL Server），则可以设置 useGeneratedKeys=”true”，然后再把 keyProperty 设置到目标属性上。

对于不支持自动生成主键列的数据库和可能不支持自动生成主键的 JDBC 驱动，MyBatis 有另外一种方法来生成主键。

可以使用 selectKey 子元素：selectKey 元素将会首先运行，id 会被设置，然后插入语句会被调用

---

#{key} 与 ${key} 说明

#{key}：获取参数的值，预编译到 SQL 中。安全。
${key}：获取参数的值，拼接到 SQL 中。有 SQL 注入问题。ORDER BY $name，当不能使用参数预编译的时候，就使用${key}的方式获取值

当 SQL 语句中的元数据（如表名或列名）是动态生成的时候，字符串替换将会非常有用

---

参数（Parameters）传递说明

• 单个参数
  可以接受基本类型，对象类型，集合类型的值。这种情况MyBatis可直接使用这个参数，不需要经过任何处理。
• 多个参数
  任意多个参数，都会被MyBatis重新包装成一个Map传入。Map的key是param1，param2，0，1…，值就是参数的值。
• 命名参数
  为参数使用@Param起一个名字，MyBatis就会将这些参数封装进map中，key就是我们自己指定的名字
• POJO
  当这些参数属于我们业务POJO时，我们直接传递POJO
• Map
  我们也可以封装多个参数为map，直接传递

---

#{…}参数处理说明

数位置支持的属性
javaType、jdbcType、mode、numericScale、 resultMap、typeHandler、jdbcTypeName、expression

尽管上面这些选项很强大，但大多时候，你只须简单指定属性名，顶多要为可能为空的列指定 jdbcType，其他的事情交给 MyBatis 自己去推断就行了。

---

结果映射