【MyBatis】XML映射器

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

SQL映射文件只需要很少的几个顶级元素：

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

select

select元素有许多属性：

属性	描述
id	在命名空间中唯一的标识符，可以被用来引用这条语句。
parameterType	将会传入这条语句的参数的类全限定名或别名。这个属性是可选的，因为 MyBatis 可以通过类型处理器（TypeHandler）推断出具体传入语句的参数，默认值为未设置（unset）。
parameterMap	用于引用外部 parameterMap 的属性，目前已被废弃。请使用行内参数映射和 parameterType 属性。
resultType	期望从这条语句中返回结果的类全限定名或别名。 注意，如果返回的是集合，那应该设置为集合包含的类型，而不是集合本身的类型。 resultType 和 resultMap 之间只能同时使用一个。
resultMap	对外部 resultMap 的命名引用。结果映射是 MyBatis 最强大的特性，如果你对其理解透彻，许多复杂的映射问题都能迎刃而解。 resultType 和 resultMap 之间只能同时使用一个。
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 或 DEFAULT（等价于 unset） 中的一个，默认值为 unset （依赖数据库驱动）。
databaseId	如果配置了数据库厂商标识（databaseIdProvider），MyBatis 会加载所有不带 databaseId 或匹配当前 databaseId 的语句；如果带和不带的语句都有，则不带的会被忽略。
resultOrdered	这个设置仅针对嵌套结果 select 语句：如果为 true，将会假设包含了嵌套结果集或是分组，当返回一个主结果行时，就不会产生对前面结果集的引用。 这就使得在获取嵌套结果集的时候不至于内存不够用。默认值：false。
resultSets	这个设置仅适用于多结果集的情况。它将列出语句执行后返回的结果集并赋予每个结果集一个名称，多个名称之间以逗号分隔。

（表格来源官网 link）

下面结合场景演示怎么使用select元素查询各种数据记录
前提：mysql数据库建表t_student

①、查询单行

查找 学号为1001学生的信息：

接口方法签名：

 Student queryStuById (Integer Id ) ;

sql映射语句：

<!--使用id查询-->
    <select id="queryStuById" resultType="student">
        select *from t_student where id =#{id}
    </select>

• resultType="student"代表查询返回的结果将封装成一个student类
• 映射语句id和方法签名需要一致
• 参数占位符为 #{id} ， mybatis会创建一个预处理语句PerparedStatement参数，在JDBC，这样一个语句的参数会被 ”？“标识

测试：

	Student student =studentDao.queryStuById(1001) ;
	System.out.println(student);
// Student{name='王璐', Id=1001, sex=f, age=18, tel='13832371239', classId='1'}

②、查询语句包含多个参数

假设有一个方法：

 Student queryStuByIdAndName( Integer id,String name) ; // 同时使用name和id查询一条记录

对应的sql映射语句不能直接使用参数名对应，有两种方式：

第一种：
sql映射语句：

<!--Available parameters are [arg1, arg0, param1, param2]-->
    <select id="queryStuByIdAndName" resultType="student">
        SELECT * from t_student where id =#{param1}  and name = #{param2}
    </select>

Mybatis规定如果映射语句有多个参数时，参数名称指定只能为arg0,arg1 或者 param1，param2

原理：只要传入了多个参数，mybatis自动封装成一个map 中，封装时使用的key就是参数的索引

注：如果像示例①只传入一个参数时，参数 #{xxx} 不重要，mybatis并没有使用名称对应。

第二种：
使用 Mybatis提供的@Param注解
方法签名：

    Student queryStuByIdAndName(@Param("id") Integer id, @Param("name") String name) ;

使用@Param注解指定sql映射语句中的Key

和方法的形参前的注解Key一一对应
    <select id="queryStuByIdAndName" resultType="student">
        SELECT * from t_student where id = #{id} and name = #{name}
    </select>

③、参数传入map

方法签名

    Student queryStuByIdAndName2(HashMap<String,Object>map) ;

sql映射：

   <select id="queryStuByIdAndName2" resultType="student">
        SELECT * from t_student where id = #{id} and name = #{name}
    </select>

使用：

HashMap<String,Object> map = new HashMap<>() ;
			map.put("id",1002) ;
			map.put("name","王薇");
			student = studentDao.queryStuByIdAndName2(map) ;
			System.out.println(student);
//Student{name='王薇', Id=1002, sex=f, age=17, tel='13832374512', classId='1'}

map中key就是映射的参数名称。

④、多行查询封装成map

  Map<String ,Object> queryStuRetMap(Integer id) ;

   <select id="queryStuRetMap" resultType="map">
        select *from t_student where id = #{id}
    </select>

	Map<String, Object> maps = studentDao.queryStuRetMap(1001);
	System.out.println(maps);
//{sex=f, class_id=1, name=王璐, tel=13832371239, id=1001, age=18}

可以看到这里的resultType是map，返回的map以列名作为key，以值作为value

⑤、多行查询封装成list

  List<Student> queryStuByName(String name) ;

    <select id="queryStuByName" resultType="student" parameterType="string">
        select *from t_student where name like concat('%',#{name},'%')
    </select>

这条语句返回的是一个集合，指定resultType时，类型应该是集合包含的类

多条记录返回map