简述
映射器(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语句量较少的情况下,使用注解方式会效率更高,但是与代码的耦合度较高。