Example類使用說明 · Java 開源項目中文文檔

# Example類使用說明 Example類指定如何構建一個動態的where子句. 表中的每個non-BLOB列可以被包括在where子句中. 例子是展示此類用法的最好方式. Example類可以用來生成一個幾乎無限的where子句. Example類包含一個內部靜態類 `Criteria` 包含一個用 `anded` 組合在where子句中的條件列表. Example類包含一個 `List<Criteria>` 屬性,所有內部類Criteria中的子句會用 `ored`組合在一起. 使用不同屬性的 `Criteria` 類允許您生成無限類型的where子句. 創建 `Criteria` 對象可以使用Example類中的 `createCriteria()` 或者 `or()` . 如果 `Criteria` 對象是用 `createCriteria()` 創建的，它會自動為 `List<Criteria>` 屬性添加一個 `Criteria` 對象 - 這使得它更容易寫一個簡單的where子句，如果您不需要 `or` 或者其他幾個子句組合的話. 用 `or(Criteria criteria)` 方法創建 `Criteria` 對象, 方法里的 `criteria` 對象會被添加進 `Criteria` 對象的列表中. **重要** 我們推薦您只使用 `or()` 方法創建 `Criteria` 對象. 我們相信這種方法使代碼更有可讀性. ## 簡單查詢這個例子展示了如何用生成后的Example類去生成一個簡單的where子句: ``` TestTableExample example = new TestTableExample(); example.createCriteria().andField1EqualTo(5); ``` 作為另一種選擇, 下面的方式也是可以的: ``` TestTableExample example = new TestTableExample(); example.or().andField1EqualTo(5); ``` 在上面的例子中, 動態生成的where子句是: ``` where field1 = 5 ``` ## 復雜查詢下面的例子展示了如何用生成后的Example類去生成一個復雜的where子句 (用到了 JSE 5.0 的泛型): ``` TestTableExample example = new TestTableExample(); example.or() .andField1EqualTo(5) .andField2IsNull(); example.or() .andField3NotEqualTo(9) .andField4IsNotNull(); List<Integer> field5Values = new ArrayList<Integer>(); field5Values.add(8); field5Values.add(11); field5Values.add(14); field5Values.add(22); example.or() .andField5In(field5Values); example.or() .andField6Between(3, 7); ``` 在上面的例子中, 動態生成的where子句是: ``` where (field1 = 5 and field2 is null) or (field3 <> 9 and field4 is not null) or (field5 in (8, 11, 14, 22)) or (field6 between 3 and 7) ``` 將會返回滿足這些條件的記錄結果. ## 去重復查詢您可以在所有的Example類中調用 `setDistinct(true)` 方法進行強制去重復查詢. ## Criteria類 `Criteria` 內部類的每個屬性都包含 `andXXX` 方法，以及如下的標準的SQL查詢方法: * IS NULL - 指相關的列必須為NULL * IS NOT NULL - 指相關的列必須不為NULL * = (equal) - 指相關的列必須等于方法參數中的值 * <> (not equal) - 指相關的列必須不等于方法參數中的值 * > (greater than) - 指相關的列必須大于方法參數中的值 * >= (greater than or equal) - 指相關的列必須大于等于方法參數中的值 * < (less than) - 指相關的列必須小于于方法參數中的值 * <= (less than or equal) - 指相關的列必須小于等于方法參數中的值 * LIKE - 指相關的列必須 "like" 方法參數中的值. 這個方法不用必須加入 '%', 您必須設置方法參數中的值. * NOT LIKE - 指相關的列必須 "not like" 方法參數中的值. 這個方法不用必須加入 '%', 您必須設置方法參數中的值. * BETWEEN - 指相關的列必須在 "between" 方法參數中的兩個值之間. * NOT BETWEEN - 指相關的列必須不在 "not between" 方法參數中的兩個值之間. * IN - 指相關的列必須在傳入的方法參數的list中. * NOT IN - 指相關的列必須不在傳入的方法參數的list中.