MyBatis核心组件之SQL Mapper

简述

映射器（SQL Mapper）是MyBatis中最重要、最复杂的组件，它是由一个接口和对应的XML文件组成，它可以配置以下内容：

• 描述映射规则
• 提供SQL语句，并可以配置SQL参数类型、返回类型、缓存刷新等信息
• 配置缓存
• 提供动态SQL

映射器的主要作用就是将SQL查询到的结果映射成一个POJO（Java原生对象），或者将POJO的数据插入到数据库中，并定义一些关于缓存等的重要内容。

下面提供两种方式实现映射器，首先我们先定义一个POJO对象：

public class User{
	private Long id;
	private String username;
	private String password;
	
	/** getter 和 setter 方法**/
}

XML实现映射器

用XML定义映射器分为两个部分：接口和XML。
首先，定义一个映射器接口,提供一个通过id获取用户的方法。

public interface UserMapper{
	public User getUser(Long id);
}

<?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.etc.ssm.mapper.UserMapper">

	<!-- 获取用户 -->
	<select id="getUser" parameterType="long" resultType="user">
		select * from tb_user where id= #{id}
	</select>

</mapper>

注意：select元素节点的id属性值要与其对应的方法名相同！

mapper元素节点：属性namespace所对应的是一个接口的全限定名，MyBatis上下文就可以通过它找到对应的接口。
select元素节点：表明这是一条查询语句，属性id标识了这条SQL，属性parameterType=”long“说明传递给SQL的是一个long型的参数，resultType="user"表示返回的是一个user类型的返回值，user是之前配置文件中设置过的别名。

注解实现映射器

注解实现映射器相对于XML实现映射器较为简单，它只需要一个接口就可以，通过MyBatis的注解来注入SQL语句。

public interface UserMapper{
	@Select("select * from tb_user where id= #{id}");
	public User getUser(Long id);
}

需要注意的是，当XML方式与注解方式同时定义时，XML方式会覆盖掉注解方式，所以MyBatis官方推荐使用的是XML实现映射器的方式，但是不同场景有不同的选择，在SQL语句量较少的情况下，使用注解方式会效率更高，但是与代码的耦合度较高。