Junky's IT Notebook

最近在項目中使用 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 提供了那些類和方法來滿足開發中查詢條件的創建和組裝，其結構層次如何。這樣使用起來便可得心應手。

?