Mybatis应用：Sql Annotation

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的应以和使用参考这里：
　　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功能的介绍参考这里：。
　　这四个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特性，能在使用时节省不少的代码量。