mybatis使用註解替代xml配置，動態生成Sql

mybatis使用註解替代xml配置時，遇到判斷條件是否為null或者為空時，@Select很難搞定，不知道怎麼辦？

mybatis3中增加了使用註解來配置Mapper的新特性，使用 SelectProvider來動態生成sql。

典型的使用場景

1. 無參數@SelectProvide方法

在Mapper接口方法上和@SelectProvide指定類方法上，均無參數：

UserMapper.java：

 @SelectProvider(type = SqlProvider.class, method = "selectAllUser")
 @ResultMap("userMap")
 public List<user> getAllUser();
/<user>

SqlProvider.java：

 public String selectAllUser() {
 return "select * from user";
 }

2.單個參數使用@SelectProvider

2.1.沒有@Param註解的單個參數使用@SelectProvider

@SelectProvider是聲明在方法基本上的，這個方法定義在Mapper對應的的interface上。

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

上例中是個很簡單的Mapper接口，其中定義了一個方法：getUser，這個方法根據提供的用戶id來查詢用戶信息，並返回一個User實體bean。

這是一個很簡單很常用的查詢場景：根據key來查詢記錄並將結果封裝成實體bean。其中：

@SelectProvider註解用於生成查詢用的sql語句，有別於@Select註解，@SelectProvide指定一個Class及其方法，並且通過調用Class上的這個方法來獲得sql語句。在我們這個例子中，獲取查詢sql的方法是SqlProvider.selectUser。

@ResultMap註解用於從查詢結果集RecordSet中取數據然後拼裝實體bean。

@SelectProvide中type參數指定的Class類，必須要能夠通過無參的構造函數來初始化。

@SelectProvide中method參數指定的方法，必須是public的，返回值必須為String，可以為static。

 public class SqlProvider {
 public String selectUser(long userId) {
 return "select * from user where userId=" + userId;
 }
 }

2.2.帶有@Param註解一個參數的@SelectProvide方法

對於只有一個參數的情況，可以直接使用，參見前面的getUser和selectUser。

但是，如果在getUser方法中，對userId方法使用了@Param註解的話，那麼相應selectUser方法必須接受Map<string>做為參數：/<string>

UserMapper.java：

 @SelectProvider(type = SqlProvider.class, method = "selectUser2")
 @ResultMap("userMap")
 public User getUser2(@Param("userId") long userId);

SqlProvider.java：

 public String selectUser2(Map<string> para) {
 return "select * from user where userId=" + para.get("userId");
 }
/<string>

3.多參數的@SelectProvide方法

在超過一個參數的情況下，@SelectProvide方法必須接受Map<string>做為參數，/<string>

如果參數使用了@Param註解，那麼參數在Map中以@Param的值為key，如下例中的userId；

如果參數沒有使用@Param註解，那麼參數在Map中以參數的順序為key，如下例中的password：

UserMapper.java：

 @SelectProvider(type = SqlProvider.class, method = "selectUserCheck")
 @ResultMap("userMap")
 public User getUserCheck(@Param("userId") long userId, String password);

SqlProvider.java：

 public String selectUserCheck(Map<string> para) {
 return "select * from user where userId=" + para.get("userId") + " and password='" + para.get("1") + "'"; 

 }
/<string>

4.一些限制

在Mapper接口和@SelectProvide方法類中，不要使用重載，也就是說，不要使用方法名相同參數不同的方法，以避免發生詭異問題。

參考文獻：

【1】http://www.blogjava.net/dbstar/archive/2011/08/08/355825.html