mybatis3 中几个 @Provider 的使用方式

Mybatis 的原身是 ibatis，现在已经脱离了 apache 基金会，新官网是 http://www.mybatis.org/。Mybatis3 中增加了使用注解来配置 Mapper 的新特性，这里主要介绍 @SelectProvider、@UpdateProvider、@InsertProvider 和 @DeleteProvider 的使用方式

这几个注解声明在 Mapper 对应的 interface 的方法上的，注解用于生成查询用的 sql 语句。如果对应的 Mapper 中已使用 @Param 来注解参数，则在对应的 Prodiver 的方法中无需写参数。

注解中的参数：

type 参数指定的 Class 类，必须要能够通过无参的构造函数来初始化；

method 参数指定的方法，必须是 public 的，返回值必须为 String，可以为 static。

一、@SelectProvider

@ResultMap 注解用于从查询结果集 RecordSet 中取数据然后拼装实体 bean。

public interface UserMapper {
     @SelectProvider(type = SqlProvider.class, method = "selectUser")
     @ResultMap("userMap") public User getUser(long userId);
}

public class SqlProvider { 
public String selectUser(long userId){
         SELECT("id, name, email");
          FROM("USER");
          WHERE("ID = #{userId}");
  }
}

上例中定义了一个 Mapper 接口，其中定义了一个 getUser 方法，这个方法根据用户 id 来获取用户信息，并返回相应的 User。而对应的 SQL 语句则写在 SqlProvider 类中。

二、@InsertProvider

public interface UserMapper {
    @InsertProvider(type = SqlProvider.class, method = "addUser")
    @Options(useGeneratedKeys = true, keyProperty = "id") int addUser(Tutor tutor);
}
public class SqlProvider { public String addUser(User user) { return new SQL() {
            {
                INSERT_INTO("USER"); if (user.getName() != null) {
                    VALUES("NAME", "#{name}");
                } if (user.getEmail() != null) {
                    VALUES("EMAIL", "#{email}");
                }
            }
        }.toString();
    }
}

三、@UpdateProvider

public interface UserMapper {
    @UpdateProvider(type = SqlProvider.class, method = "updateUser") int updateUser(User user);
}

public class SqlProvider { public String updateUser(User user) { return new SQL() {
            {
                UPDATE("USER"); if (user.getName() != null) {
                    SET("NAME = #{name}");
                } if (user.getEmail() != null) {
                    SET("EMAIL = #{email}");
                }
                WHERE("ID= #{id}");
            }
        }.toString();
    }
}

四、@DeleteProvider

public interface UserMapper {
    @DeleteProvider(type = SqlProvider.class, method = "deleteUser") int deleteUser(int id);
}
public class SqlProvider { public String deleteUser(int id) { return new SQL() {
            {
                DELETE_FROM("USER");
                WHERE("ID= #{id}");
            }
        }.toString();
    }
}

注意：在 Mapper 接口和 @SelectProvide 方法类中，不要使用重载，也就是说，不要使用方法名相同参数不同的方法。