Mybatis注解
@MapperScan
该注解扫描某个包目录下的Mapper，将Mapper接口类交给Spring进行管理。
import org.mybatis.spring.annotation.MapperScan;
@SpringBootApplication
@MapperScan("com.xxx.xxx.mapper")
public class Application {
//TODO 业务逻辑
}
其实，从名字上就能看出是用来扫描的Mapper的。
扫描包路径可以是一个或多个，也可以在路径中可以使用*作为通配符对报名进行匹配。
@SpringBootApplication
@MapperScan("com.xxx.*.mapper")
public class Application{
//TODO 业务逻辑
}
@SpringBootApplication
@MapperScan({"com.xxx.mapper","com.xxx.mapper1"})
public class Application{
//TODO 业务逻辑
}
@Mapper
该注解目的就是为了不再写mapper映射文件(例如：UserMapper.xml)。可以大大的简化编写xml的繁琐。该注解是由Mybatis框架中定义的一个扫描数据层接口的注解，注解起到一个描述作用，用于告诉Spring框架此接口的实现类由Mybatis负责创建，并将其实现类对象存储到Spring容器中。
使用方式：
@Mapper
public interface UserMapper {
User selectById(Integer id);
}
@Insert
对应xml文件中的<insert>标签。插入记录的时候主键如何生成？对此基本上有三种方案：手动指定(应用层)、自增主键(数据层单表)、选择主键(数据层多表)。
应用层手动指定主键
手动指定的方式不把主键区别看待，插入之前在应用层生成对象的时候就会给主键一个值，插入的时候与普通字段没啥区别。
/**
* 插入记录，手动分配主键
*/
@Insert("INSERT INTO t_user (id, username, passwd) VALUES (#{id}, #{username}, #{passwd})")
int addUserAssignKey(User user);
在上面的这个例子中，mybatis并不知道到底哪个字段是主键，id虽然是主键字段，但并没有被区别对待。
注意
#{username}这种写法，是把User作为了当前上下文，这样访问User的属性的时候直接写属性名字就可以了。
表自增主键
自增主键对应着XML配置中的主键回填，一个简单的例子：
/**
* 插入记录，数据库生成主键
*/
@Options(useGeneratedKeys = true, keyProperty = "id")
@Insert("INSERT INTO t_user (username, passwd) VALUES (#{username}, #{passwd})")
int addUserGeneratedKey(User user);
使用Option来对应着XML设置的select标签的属性，userGeneratordKeys表示要使用自增主键，keyProperty用来指定主键字段的字段名。自增主键会使用数据库底层的自增特性。
选择主键
选择主键从数据层生成一个值，并用这个值作为主键的值。
/**
* 插入记录，选择主键
*/
@Insert("INSERT INTO t_user (username, passwd) VALUES (#{username}, #{passwd})")
@SelectKey(statement = "SELECT UNIX_TIMESTAMP(NOW())", keyColumn = "id", keyProperty = "id", resultType = Long.class, before = true)
int addUserSelectKey(User user);
@Delete
删除的时候只要把语句条件写在@Delete注解的value里就好了，返回一个int类型是被成功删除的记录数。对应xml文件中的<delete>标签。
/**
* 删除记录
*/
@Delete("DELETE FROM t_user WHERE id=#{id}")
int delete(Long id);
@Update
修改的时候和删除一样只要把SQL语句写在@Update的value中就好了，返回一个int类型表示被修改的记录行数。
对应xml文件中的<update>标签。
/**
* 修改记录
*/
@Update("UPDATE t_user SET username=#{username}, passwd=#{passwd} WHERE id=#{id}")
int update(User user);
@Select
查询的时候稍稍有些复杂，因为查询会涉及到如何将查出来的字段设置到对象上，对应xml文件中的<select>标签。
通常有那么三种办法：
在SQL语句中手动指定别名来匹配
在写SQL语句的时候，手动为每一个字段指定一个别名来跟对象的属性做匹配，适用于表字段名与对象属性名差异很大没有规律并且表字段不多的情况。
/**
* 根据ID查询，手动设置别名
*/
@Select("SELECT id, username, passwd, birth_day AS birthDay FROM t_user WHERE id=#{id}")
User loadByIdHandAlias(Long id);
使用mybatis的自动下划线驼峰转换
mybatis有一个选项叫mapUnderscoreToCamelCase，当表中的字段名与对象的属性名相同只是下划线和驼峰写法的差异时适用。
配置了mapUnderscoreToCamelCase之后mybatis在将ResultSet查出的数据设置到对象的时候会尝试先将下划线转换为驼峰然后前面拼接set去设置属性。
开启转换：
mybatis:
mapper-locations: classpath:mapper/*.xml
configuration:
log-impl: org.apache.ibatis.logging.stdout.StdOutImpl
map-underscore-to-camel-case: true
然后查询
/**
* 根据ID查询，开了自动驼峰转换
*/
@Select("SELECT * FROM t_user WHERE id=#{id}")
User loadByIdAutoAlias(Long id);
使用ResultMap
对于表的字段名和对象的属性名没有太大相同点并且表中的字段挺多的情况下，应该使用ResultMap做适配。
/**
* 使用ResultMap
*/
@Results(id = "userMap", value = {
//可以使用这种方式来处理字段名和数据库表字段名不一致的情况
@Result(column = "id", property = "id", id=true, jdbcType=JdbcType.LONG),
@Result(column = "username", property = "username", jdbcType=JdbcType.VARCHAR),
@Result(column = "passwd", property = "passwd", jdbcType=JdbcType.VARCHAR),
@Result(column = "birth_day", property = "birthDay", jdbcType=JdbcType.VARCHAR)
})
@Select("SELECT * FROM t_user WHERE id=#{id}")
User loadByIdResultMap(Long id);
下面为 @Results 各个属性的含义。
- id：表示当前结果集声明的唯一标识；
- value：表示结果集映射关系；
- @Result：代表一个字段的映射关系。其中，column 指定数据库字段的名称，property 指定实体类属性的名称，jdbcType 数据库字段类型，id 为 true 表示主键，默认 false。
@Results对应着XML中的ResultMap，同时可以为其指定一个id，其它地方可以使用这个id来引用它，比如要引用上面的这个Results：
/**
* 引用其他的Result
*/
@ResultMap("userMap")
@Select("SELECT * FROM t_user WHERE id=#{id}")
User loadByIdResultMapReference(Long id);
使用@ResultMap来引用一个已经存在的ResultMap，这个ResultMap可以是在Java中使用@Results注解定义的，也可以是在XML中使用resultMap标签定义的。
@Results:
结果映射的列表, 包含了一个特别结果列如何被映射到属性或字段的详情。
属 性:value, id。
value 属性是 Result 注解的数组。对应xml中的<resultMap> 标签。
@Result:
在列和属性或字段之间的单独结果映射。
属 性:id,column, property, javaType ,jdbcType ,type Handler, one,many。
- id 属性是一个布尔值,表 示了应该被用于比较(和在 XML 映射 中的相似)的属性。
- one 属性是单 独 的 联 系, 和
<association>相 似 ,- many 属 性 是 对 集 合 而 言 的 , 和
<collection>相似。
它们这样命名是为了 避免名称冲突。类似于<resultMap>的子标签 <result>``<id>。
@One:
复杂类型的单独属性值映射。用于一对一关系映射。
属性: select,已映射语句(也就是映射器方法)的完全限定名,它可以加载合适类型的实例。
注意:联合映射在注解 API 中是不支持的。这是因为 Java 注解的限制,不允许循环引用。类似于<association>标签。
@Select("select * from student")
@Results({
@Result(id=true,property="id",column="id"),
@Result(property="name",column="name"),
@Result(property="age",column="age"),
@Result(property="address",column="address_id",
//one指示我们，查询出来的结果只有一个。
one=@One(select="net.biancheng.mapper.AddressMapper.getAddress",
//及时加载
fetchType = FetchType.EAGER))
})
public List<Student> getAllStudents();
@Many:
与@One类似，一对多的关系，类似于<collection>
@Select("select * from t_class where id=#{id}")
@Results({
@Result(id=true,column="id",property="id"),
@Result(column="class_name",property="className"),
@Result(property="students", column="id",
//many指示我们，查询出来的结果有很多个
many=@Many(
//select = sql语句
select="net.biancheng.mapper.StudentMapper.getStudentsByClassId",
//懒加载
fetchType = FetchType.LAZY))
})
public Class getClass(int id);
@Param:
参数标签，我们在Mapper的方法签名上标注的参数，我们可以指定参数名称，然后在注解中或者xml中的SQL里就可以使用我们自定义的参数名称。
int saveUser(@Param(value="user") User user,@Param("name") String name,@Param("age") Int age);
@Param 中的 value 属性可省略，用于指定参数的别名。
@SelectKey:
MySQL 在插入一条数据后，使用 select last_insert_id() 可以获取到自增 id 的值。
@Insert("insert into user(id,name) values(#{id},#{name})")
@SelectKey(statement = "select last_insert_id()", keyProperty = "id", keyColumn = "id", resultType = int,before = false)
public int insert(User user);
@SelectKey 各个属性含义如下。
- statement：表示要运行的 SQL 语句；
- keyProperty：可选项，表示将查询结果赋值给代码中的哪个对象；
- keyColumn：可选项，表示将查询结果赋值给数据表中的哪一列；
- resultType：指定 SQL 语句的返回值；
- before：默认值为 true，在执行插入语句之前，执行 select last_insert_id()。值为 flase，则在执行插入语句之后，执行 select last_insert_id()。
@CacheNamespace:
为给定的命名空间 (比如类) 配置缓存。对应xml中的<cache>。
@CacheNamespaceRef:
参照另外一个命名空间的缓存来使用。
属性:value,应该是一个名空间的字 符串值(也就是类的完全限定名) 。对应xml中的<cacheRef>标签。
@ConstructorArgs:
收集一组结果传递给一个劫夺对象的构造方法。
属性:value,是形式参数 的数组。
@Arg:
单 独 的 构 造 方 法 参 数 , 是 ConstructorArgs 集合的一部分。
属性: id,column,javaType,typeHandler。
id 属性是布尔值, 来标识用于比较的属 性,和XML 元素相似。对应xml中的<arg>标签。
@Case:
单独实例的值和它对应的映射。
属性: value,type,results。
Results 属性是结果数组，因此这个注解和实际的 ResultMap 很相似,由下面的 Results 注解指定。对应xml中标签<case>。
Mybatis注解总结
mybatis最初配置信息是基于 XML ,映射语句(SQL)也是定义在 XML 中的。而到了 MyBatis 3提供了新的基于注解的配置。mybatis提供的注解有很多，笔者进行了分类：
- 增删改查：@Insert、@Update、@Delete、@Select、@MapKey、@Options、@SelelctKey、@Param、
@InsertProvider、@UpdateProvider、@DeleteProvider、@SelectProvider- 结果集映射：@Results、@Result、@ResultMap、@ResultType、@ConstructorArgs、@Arg、@One、@Many、
@TypeDiscriminator、@Case- 缓存：@CacheNamespace、@Property、@CacheNamespaceRef、@Flush
绝大部分注解，在xml映射文件中都有元素与之对应，但是不是所有。此外在mybatis-spring中提供了@Mapper注解和@MapperScan注解，用于和spring进行整合。
