最近在項目中使用 spring 和 hibernate 進行開發，有感于 criteria 比較好用，在查詢方法設計上可以靈活的根據 criteria 的特點來方便地進行查詢條件的組裝。所以現在對 hibernate 的 criteria 深入研究一下。《 hibernate reference 》及網上其它一些資料對 criteria 已經做了很多介紹。本文主要是從 criteria 的結構入手來進行分析。
如圖 1 。 hibernate 設計了 criteriaspecification 作為 criteria 的頂級接口，其下面提供了 criteria 和 detachedcriteria 。
criteria 和 detachedcriteria 的主要區別在于創建的形式不一樣， criteria 是在線的，所以它是由 hibernate session 進行創建的；而 detachedcriteria 是離線的，創建時無需 session ， detachedcriteria 提供了 4 個靜態方法 forclass(class) 或 forentityname(name) 進行 detachedcriteria 實例的創建。 spring 的框架提供了
gethibernatetemplate().findbycriteria(detachedcriteria) 方法可以很方便地根據
detachedcriteria 來返回查詢結果。
如圖 1 ， criteria 和 detachedcriteria 均可使用 criterion 和 projection 設置查詢條件。可以設置 fetchmode( 聯合查詢抓取的模式 ) ，設置排序方式。對于 criteria 還可以設置 flushmodel （沖刷 session 的方式）和 lockmode （數據庫鎖模式）。
下面就對 criterion 和 projection 進行詳細說明。
圖 1
criterion 是 criteria 的查詢條件。
criteria 提供了 add(criterion criterion) 方法來添加查詢條件。圖 2 是 criterion 的結構圖。 criterion 接口的主要實現包括： example 、 junction 和 simpleexpression 。而 junction 的實際使用是它的兩個子類 conjunction 和 disjunction ，分別是使用 and 和 or 操作符進行來聯結查詢條件集合。
criterion 的實例可以通過 restrictions 工具類來創建， restrictions 提供了大量的靜態方法，如 eq （等于）、 ge （大于等于）、 between 等來方法的創建 criterion 查詢條件
（ simpleexpression 實例）。除此之外， restrictions 還提供了方法來創建 conjunction 和 disjunction 實例，通過往該實例的 add(criteria) 方法來增加查詢條件形成一個查詢條件集合。
至于 example 的創建有所不同， example 本身提供了一個靜態方法 create(object entity) ，即根據一個對象（實際使用中一般是映射到數據庫的對象）來創建。然后可以設置一些過濾條件：
example exampleuser =example.create(u)
.ignorecase() // 忽略大小寫
.enablelike(matchmode.anywhere);
// 對 string 類型的屬性，無論在那里值在那里都匹配。相當于 %value%
圖 2
project 主要是讓 criteria 能夠進行報表查詢，并可以實現分組。 project 主要有 simpleprojection 、 projectionlist 和 property 三個實現。其中 simpleprojection 和 projectionlist 的實例化是由內建的 projections 來完成，如提供的 avg 、 count 、 max 、 min 、 sum 可以讓開發者很容易對某個字段進行統計查詢。
property 是對某個字段進行查詢條件的設置，如通過
porperty.forname(“color”).in(new string[]{“black”,”red”,”write”}); 則可以創建一個 project 實例。通過 criteria 的 add(project) 方法加入到查詢條件中去。
圖 3
使用 criteria 進行查詢，主要要清晰的是 hibernate 提供了那些類和方法來滿足開發中查詢條件的創建和組裝，其結構層次如何。這樣使用起來便可得心應手。