目录
MyBatis
使用XML文件配置SQL语句
下载http://doc.canglaoshi.org/config/Mapper.xml.zip，解压得到SomeMapper.xml。
在项目的src/main/resources下创建mappers文件夹，并将SomeMapper.xml复制到该文件夹，并重命名为UserMapper.xml。
此步骤中创建的文件夹的名称是自定义的，与后续的配置有关。
此步骤中XML文件的名称是自定义的，与其它任何配置都无关。
以上添加的UserMapper.xml就是用于配置SQL语句的文件，通常称之为映射文件！该文件中的以下代码是固定的，且不可缺少的：
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd">该文件的根节点是<mapper>节点，必须配置namespace的属性，该属性的值是对应的MyBatis接口文件的全名，例如：
< namespace="cn.tedu.mybatis.UserMapper">
</mapper>接下来，根据需要执行的SQL语句的种类，选择使用<insert>、<delete>、<update>、<select>这4个节点中的某1个来配置SQL语句，这些节点都必须配置id属性，该属性的值就是接口中的抽象方法的名称，然后，在节点内部编写SQL语句即可：
<?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">
<!-- namespace属性：接口的全名 -->
<mapper namespace="cn.tedu.mybatis.UserMapper">
<!-- id属性：抽象方法的名称 -->
<insert id="insert">
INSERT INTO t_user (
username, password, age, phone, email
) VALUES (
#{username}, #{password}, #{age}, #{phone}, #{email}
)
</insert>
</mapper>目前，MyBatis框架并不知道存在mappers文件夹，更加不知道哪个文件配置的SQL语句！可以将配置SQL语句的XML文件的位置配置在jdbc.properties中：
mybatis.mapper-locations=classpath:mappers/*.xml以上代码就用于表示“在src/main/resouces下的mappers文件夹中的所有XML文件都是用于配置SQL语句的”，在后续使用时，也必须保证不会在mappers文件夹中添加其它作用的XML文件！
接下来，还应该读取以上配置信息：
@Value("${mybatis.mapper-locations}")
private Resource[] mapperLocations;并应用于SqlSessionFactoryBean对象的属性中：
@Bean
public SqlSessionFactoryBean sqlSessionFactoryBean(DataSource dataSource) {
SqlSessionFactoryBean bean = new SqlSessionFactoryBean();
bean.setDataSource(dataSource);
bean.setMapperLocations(mapperLocations);
return bean;
}最后，在运行或测试之前，还需要注意：每个抽象方法只能通过1种方式配置SQL语句，要么使用注解，要么使用XML文件，不可以同时使用！否则将报错，错误提示的关键信息例如：
Caused by: java.lang.IllegalArgumentException:
Mapped Statements collection already contains value for
cn.tedu.mybatis.UserMapper.insert. please check file
[D:\eclipse-workspace-202003\mybatis\target\classes\mappers\UserMapper.xml]
and cn/tedu/mybatis/UserMapper.java (best guess)以上提示中的Mapped Statements collection already contains value for cn.tedu.mybatis.UserMapper.insert.就表示“cn.tedu.mybatis.UserMapper.insert方法被映射了多个SQL语句的配置”，并且还推荐了检查UserMapper.xml和UserMapper.java文件！
如果配置的是<insert>节点，且需要获取自动编号的ID值，则在<insert>节点中继续配置属性即可，例如：
<insert id="insert" useGeneratedKeys="true" keyProperty="id">
INSERT INTO t_user (
username, password, age, phone, email
) VALUES (
#{username}, #{password}, #{age}, #{phone}, #{email}
)
</insert>当需要实现的数据访问是查询类型的，在<select>节点中必须配置resultType或resultMap中的某1个属性（二选一），如果都没有指定，则会出现如下错误：
Caused by: org.apache.ibatis.executor.ExecutorException:
A query was run and no Result Maps were found for the Mapped Statement 'cn.tedu.mybatis.UserMapper.count'.
It's likely that neither a Result Type nor a Result Map was specified.其中，resultType指的就是“封装查询结果的数据的类型”，也可以理解为“抽象方法的返回值的类型”，例如可以配置为：
<select id="count" resultType="java.lang.Integer">
SELECT COUNT(*) FROM t_user
</select>如果某个查询的抽象方法的返回值是List集合类型的，例如：
List<User> findAll();在配置<select>的resultType属性时，该属性值必须是集合中的元素的类型，例如：
<select id="findAll" resultType="cn.tedu.mybatis.User">
SELECT * FROM t_user ORDER BY id
</select>至于resultMap属性，后面专门介绍。
注意：使用了这种做法后，就需要对抽象方法名称的定义增加一个要求“不允许重载”！
关于多参数的问题
当抽象方法的参数列表中超过1个参数时，在配置SQL语句时直接使用#{参数名称}是无法访问到参数值的！
因为Java源文件在运行之前需要被编译成字节码文件（.class文件），编译时，会丢失所有局部的量的名称，所以，会导致运行时原有的“参数名称”无法使用的问题！
MyBatis允许使用arg作为前缀并添加从0开始编号的名称（例如arg0、arg1等等）表示第?个参数的名称，后续，在配置SQL语句时，就可以通过例如#{arg0}来表示抽象方法的第1个参数的值，使用#{arg1}表示抽象方法的第2个参数的值……以此类推！另外，还可以使用param作为前缀并添加从1开始编号的名称（例如param1、param2等等），在具体使用时，使用arg系列的名称和param系列的名称均可！
但是，使用arg和param 系列的名称不便于表示语义，并且，当抽象方法的参数列表发生变化时，这些名称中的序号也可能需要调整！
@Param注解
如果注解是 @Param("person")，那么参数就会被命名为 #{person}。
MyBatis提供了@Param注解，这个注解是添加在抽象方法的各参数之前的，可以在该注解中指定名称，后续，在配置SQL语句时，占位符中就使用注解中配置的名称！
在不使用@Param注解的时候，函数的参数只能为一个，并且在查询语句取值时只能用#{ }，且其所属的类必须为Javabean,
而使用@Param注解则可以使用多个参数，在查询语句中使用时可以使用#{ }或者${ }
例如这里的代码 @Param
使用@Param后，接口中的参数顺序也可以打乱，只要id唯一即可
当只有一个参数的时候可以不使用此注解
/**
* 根据用户的id 修改用户的邮箱
* UPDATE t_user set email=#{email} WHERE id=#{id};
*/
//编译时-->局部变量的参数会丢失
//@Update("UPDATE t_user SET email=#{arg0} WHERE id=#{arg0}")
//@Update("UPDATE t_user SET email=#{param1} WHERE id=#{param2}")
//Integer updateEmailById(String email,Integer id);
//Integer updateEmailById(String arg0,Integer arg1);
//Integer updateEmailById(String param1,Integer param2);
@Update("UPDATE t_user SET email=#{email} WHERE id=#{id}")
Integer updateEmailById(@Param("email") String email, @Param("id")Integer id); 动态SQL -- foreach
假设存在需求：批量删除用户数据（一次性删除若干条用户数据）；
需要执行的SQL语句大致是：
DELETE FROM t_user WHERE id=? OR id=? OR id=?;
DELETE FROM t_user WHERE id IN (?,?,?);数值！只能确定以上参数的数据类型及所表示的意义！
以上功能最终将由用户（软件的使用者）来决定需要删除的数据的数量（问号的数量），及删除的数据是哪几条（问号对应的参数值）！就会导致“当用户的操作不同时（选中需要删除的数据不同），最终需要执行的SQL语句是不同的”！MyBatis框架提供了“动态SQL”机制来解决这个问题！
动态SQL：根据用户提供的参数值不同，最终需要执行的SQL语句可以不同！
当需要实现以上批量删除的需求时，可以将抽象方法设计为：
Integer deleteByIds(List<Integer> ids);或者，也可以设计为（本次案例就使用这个）
Integer deleteByIds(Integer[] ids);甚至，还可以设计为：
Integer deleteByIds(Integer... ids);可变参数在被处理时，本质上就是数据。
在配置SQL语句时，需要通过<foreach>节点来配置SQL语句中需要通过循环生成的部分：
<delete id="deleteByIds">
DELETE FROM t_user WHERE id IN (
<foreach collection="array" item="id" separator=",">
#{id}
</foreach>
)
</delete>关于<foreach>节点的配置：
collection：
需要被遍历的对象，当抽象方法的参数只有1个且没有添加@Param注解时，如果参数类型是List集合，则取值为list，如果参数类型是数组，则取值为array；当抽象方法的参数超过1个，就一定添加了@Param注解，则取值为@Param注解配置的参数值；
item :
遍历过程中的每一个元素数据，当前属性可以自定义值表示元素数据的名称，在<foreach>节点的子级，使用#{}占位符时，就可以使用这个名称来表示数据；
separator：
遍历生成的代码片段中，各元素数据之间的分隔符号；
练习：根据若干个用户的id将这些用户的密码设置为某个值。
需要执行的SQL语句大致是：
UPDATE t_user SET password=? WHERE id IN (?,?,?)可以将抽象方法设计为：
Integer updatePasswordByIds(
@Param("ids") List<Integer> ids,
@Param("password") String password
); 然后，配置SQL语句（配置映射）：
<update id="updatePasswordByIds">
UPDATE t_user SET password=#{password} WHERE id IN (
<foreach collection="ids" item="id" separator=",">
#{id}
</foreach>
)
</update>动态SQL -- if
在配置SQL语句时，可以添加<if>节点用于判断参数值，从而决定最终执行的SQL语句中是否包括某个SQL语句片段。
例如存在：
List<User> find(
@Param("where") String where,
@Param("orderBy") String orderBy,
@Param("offset") Integer offset,
@Param("count") Integer count
);则可以配置为：
<select id="find" resultType="cn.tedu.mybatis.User">
SELECT * FROM t_user
<if test="where != null">
WHERE ${where}
</if>
<if test="orderBy != null">
ORDER BY ${orderBy}
</if>
<if test="offset != null and count != null">
LIMIT #{offset}, #{count}
</if>
</select>需要注意：以上案例只是假想中的代码，在实际开发时，一定不要这样来使用！
需要注意：在动态SQL中，<if>节点并没有匹配的else部分！如果一定需要实现if...else的语法效果，可以写2个条件完全相反的<if>节点，或者，通过<choose>、<when>、<otherwise>节点进行配置，其基本格式是：
<choose>
<when test="">
满足条件时的SQL语句片段
</when>
<otherwise>
不满足条件时的SQL语句片段
</otherwise>
</choose>
MyBatis中的 #{ } 与 ${ }占位符
MyBatis允许在配置SQL语句时使用#{}和${}这2种格式的占位符来表示参数值。
简单原则：
在原本使用JDBC技术编程时，编写SQL语句时可以写问号( ? )的位置，都使用#{ }格式的占位符，不可以写问号的位置，必须使用${ }格式的占位符！
使用#{}格式的占位符，只能表示某个值！MyBatis在处理时，会通过预编译的方式进行处理，即：先使用问号对占位符表示的值进行占位，并将整个SQL语句交由MySQL进行编译相关的处理（包括词法分析、语义分析、编译），当编译完成后，再将值代入到编译成功的SQL语句中一并执行。简单来说，使用#{}格式的占位符时，最终处理机制是使用了预编译的！所以，使用这种格式的占位符时，在编写SQL时不需要关心值的数据类型的问题，并且，不存在SQL注入的风险！
使用${}格式的占位符，可以表示SQL语句中的任意片段！MyBatis在处理时，会先将${}格式占位符对应的值拼接到SQL语句中，然后再将SQL语句交由MySQL进行编译相关处理，也就是说，${}格式占位符的值在编译之前就已经代入到SQL语句中了！很显然，在处理${}格式的占位符时，没有（也不可能）使用预编译！所以，使用这种格式的占位符时，需要自行在SQL语句中考虑数据类型的问题，例如字符串类型的值需要使用一对单引号框住！另外，还存在SQL注入的风险！
区别：
- 在sql中当传入的参数是字符型，则用#号会带上单引号，不会引起sql注入
- 在sql中当传入的参数是字符型，则用$号不会带上单引号，会引起sql注入
<select id="find" resultType="cn.tedu.mybatis.User">
SELECT * FROM t_user
<if test="where !=null">
WHERE ${where}
</if>
<if test="orderBy != null">
ORDER BY ${orderBy}
</if>
<if test="offset != null and count != null">
LIMIT #{offset}, #{count}
</if>
</select>