Mybatis使用：Sql Annotation

Mybatis使用：Sql Annotation

上节我们学习了Mybatis的入门，能够实现简单的CRUD操作，这个算是基本技能了。另外Mybatis提供了Sql的Annotation形式来控制CRUD操作，我们对于数据库的操作也就不外乎这些操作。对于简单的Sql，或者功能简单的Sql来说，将方法和Sql对应起来最为直观，不用根据Id去Mapper.xml中查找，出问题后还得各种分析。而能够做到这点的就是Annotation操作。

下面我们来看下Sql的Annotation操作CRUD：

方法还使用上节Mybatis入门时的UserDao操作，将UserDaoMapper.xml中的Sql语句全部删除，只保留基本格式就行。

我们先看下Insert的操作：

@Insert("insert into user(userId,userName,password,comment) values(#{userId},#{userName},#{password},#{comment})")
@Options(useGeneratedKeys = true, keyProperty = "id", keyColumn = "id")
public int insert ( User user );

这个操作有没有和Mapper.xml中的Sql很相似，没错注解@Insert就是干这样的事。

注意@Insert注解中Value的值是个数组，那么下面这个Insert注解也是合法的：

@Insert(value={"insert into user(userId,userName,password,comment) "," values(#{userId},#{userName},#{password},#{comment})"})
@Options(useGeneratedKeys = true, keyProperty = "id", keyColumn = "id")
public int insert ( User user );

mybatis生成Sql语句时，会将数组拼接，生成最终的Sql，不过貌似这个功能不应该这么鸡肋，大家可以仔细思考下这个功能点究竟在什么地方。

@Options注解中的工作就比较有意思，我们在插入记录时，一般是定义主键自增(auto_increment)，但是在某些情况下，我们插入一条记录后，还想得到这条记录的自增主键ID，useGeneratedKeys=true就是定义数据库返回主键ID的。

在Options中，定义了不少的属性：

boolean useCache() default true;
  boolean flushCache() default false;
  ResultSetType resultSetType() default ResultSetType.FORWARD_ONLY;
  StatementType statementType() default StatementType.PREPARED;
  int fetchSize() default -1;
  int timeout() default -1;
  boolean useGeneratedKeys() default false;
  String keyProperty() default "id";
  String keyColumn() default "";

对于这些属性，还是比较好理解的，如useCache、flushCache、timeout等。其中跟主键返回功能相关的属性就是useGeneratedKeys、keyProperty、keyColumn这三个。这个功能在某种情况下还是比较有用的。

对于Options的使用，根据官方文档有个特别重要的注意点：

once you engage the Options annotation, your statement is subject to all of the default values.

如果你使用了这个属性，SQL的执行就会使用Options的默认值，如果你没有重新定义的话。仔细看下keyColumn的默认值是空，这个如果和你数据库设定不一致的话，就会出问题；所以一旦决定使用主键返回功能，推荐同时使用useGeneratedKeys、keyProperty、keyColumn这三个属性，即使是冗余也没有关系。

下面看下删除操作：

@Delete("delete from user where userName = #{userName}")
public int delete ( String userName );

这个没有什么特殊的操作，理解了Insert操作之后这个delete操作就比较简单了。

更新操作也没有什么问题：

@Update("update user set userId=#{userId},password=#{password},comment=#{comment} where userName=#{userName}")
public int update ( User user );

我们现在操作的是对象User，如果User属性比较多，我们只是更新User的单个属性，难道我们再重新生成一个User传进去？

No，我们可以使用下面这种形式的update

@Update("update user set  userName=#{userName} where userId=#{userId}")
public int updateUser(@Param("userName")String userName,@Param("userId")String userId);

我们使用@Param参数，只是传递我们感兴趣的参数即可。

有人可能会有疑问，@Param参数貌似没有什么用，这个参数本身就可以获取的。没错，看下面这种格式的update：

@Update("update user set  userName=#{name} where userId=#{Id}")
public int updateUser ( @Param("name") String userName, @Param("Id") String userId );

传入的参数是userName，而在@Param中被重新定义成name，那么在Sql中就可以通过${name}直接使用了，这个实际上是解决函数参数和Sql参数的阻抗不匹配情况。

最后我们再看下数据库和POJO阻抗不匹配时的解决方法：

@Select("select * from user order by id asc")
// @Results(value = {
  // @Result(property="userId",column="userId",javaType=Integer.class,jdbcType=JdbcType.VARCHAR,typeHandler=UnknownTypeHandler.class),
  // @Result(property="name", column="userName"),
  // @Result(property="psword", column="password"),
  // @Result(property="comment", column="comment")
// })
public List<User> selectAll ();

@Results能够重新定义数据库和POJO之间字段的对应关系，其中每一个属性对应都由Result重新定义，和上面代码中注掉的地方一样。

那么Result能够重新定义哪些字段呢？注意上文代码中注掉的代码仅供演示使用，并无真正实际映射的必要。如JDBC的Varchar本身就被映射为String类型。

boolean id() default false;
  String column() default "";
  String property() default "";
  Class<?> javaType() default void.class;
  JdbcType jdbcType() default JdbcType.UNDEFINED;
  Class<? extends TypeHandler<?>> typeHandler() default UnknownTypeHandler.class;
  One one() default @One;
  Many many() default @Many;

其中比较好理解的是column、property、javaType、jdbcType这四个，typeHandler是重新定义JdbcType和javaType的映射处理handler。TypeHandler的应以和使用参考这里：http://www.mybatis.org/core/zh/configuration.html

The one attribute is for single associations, similar to <association>, and the many attribute is for collections, similar to <collection>. They are named as they are to avoid class naming conflicts.

而One和Many属性就是定义字段的对应关系。

在注解中还有这四个Provider，他们有什么用呢？

@InsertProvider 
@UpdateProvider 
@DeleteProvider 
@SelectProvider

Mybatis本身提供了SQL Builder功能，SQL Builder功能的介绍参考这里：http://www.mybatis.org/core/statement-builders.html。

这四个Provider是用来提供SQL Builder的配置的，会将Sql按照类功能描述的形式表示出来，Provider将这些SQL提供给CRUD执行。

再简单的说，Provider提供了类SQL和SQL之间的转换，并提供最终生成的执行SQL。

这些注解已经能够提供普通SQL语句的替换功能了，如果你的需求比这个还要复杂，那还是使用xml配置为最好。真正能控制SQL和功能之间的协调关系的还是直接写SQL为宜，将SQL统一管理放置也是通用的做法。

还有一点：Annotation和Xml配置可以同时存在，这个也是必须的。我们有些Sql特别长且功能比较复杂，写在代码里非常不容易管理，因此提供统一的xml管理还是很有必要的。

注意本文的注解是mybatis本身提供的，和Spring的AOP、IoC特性没有关系，我们现在做的就是单独使用mybatis来进行开发。至于mybatis和Spring的结合，其实就是将mybatis的SqlSessionFactory委托为Spring管理，再加上IoC特性，能在使用时节省不少的代码量。

本次的内容就到这里。