條件查詢(criteria queriesiteye技術網站

條件查詢(criteria queriesiteye技術網站
2011年09月01日
　　條件查詢(Criteria Queries
　　具有一個直觀的、可擴展的條件查詢API是Hibernate的特色。 org.hibernate.Criteria接口表示特定持久類的一個查詢。Session是 Criteria實例的工廠。 一個單獨的查詢條件是org.hibernate.criterion.Criterion 接口的一個實例。org.hibernate.criterion.Restrictions類 定義了獲得某些內置Criterion類型的工廠方法。 約束可以按邏輯分組。 List cats = sess.createCriteria(Cat.class) .add( Restrictions.like("name", "Fritz%") ) .add( Restrictions.or( Restrictions.eq( "age", new Integer(0) ), Restrictions.isNull("age") ) ) .list();List cats = sess.createCriteria(Cat.class) .add( Restrictions.in( "name", new String[] { "Fritz", "Izi", "Pk" } ) ) .add( Restrictions.disjunction() .add( Restrictions.isNull("age") ) .add( Restrictions.eq("age", new Integer(0) ) ) .add( Restrictions.eq("age", new Integer(1) ) ) .add( Restrictions.eq("age", new Integer(2) ) ) ) ) .list();
　　Hibernate提供了相當多的內置criterion類型(Restrictions 子類), 但是尤其有用的是可以允許你直接使用SQL。 {alias}佔位符應當被替換爲被查詢實體的列別名。
　　Property實例是獲得一個條件的另外一種途徑。你可以通過調用Property.forName() 創建一個Property。 你可以使用org.hibernate.criterion.Order來爲查詢結果排序。 你可以使用createCriteria()非常容易的在互相關聯的實體間建立 約束。 注意第二個 createCriteria()返回一個新的 Criteria實例，該實例引用kittens 集合中的元素。
　　接下來，替換形態在某些情況下也是很有用的。 (createAlias()並不創建一個新的 Criteria實例。) Cat實例所保存的之前兩次查詢所返回的kittens集合是 沒有被條件預過濾的。如果你希望只獲得符合條件的kittens， 你必須使用ResultTransformer。 你可以使用setFetchMode()在運行時定義動態關聯抓取的語義。 這個查詢可以通過外連接抓取mate和kittens。
　　15.6.查詢示例 org.hibernate.criterion.Example類允許你通過一個給定實例 構建一個條件查詢。 Cat cat = new Cat(); cat.setSex('F'); cat.setColor(Color.BLACK); List results = session.createCriteria(Cat.class) .add( Example.create(cat) ) .list();
　　版本屬性、標識符和關聯被忽略。默認情況下值爲null的屬性將被排除。
　　你可以自行調整Example使之更實用。 Example example = Example.create(cat) .excludeZeroes() //exclude zero valued properties .excludeProperty("color") //exclude the property named "color" .ignoreCase() //perform case insensitive string comparisons .enableLike(); //use like for string comparisons List results = session.createCriteria(Cat.class) .add(example) .list();
　　你甚至可以使用examples在關聯對象上放置條件。 List results = session.createCriteria(Cat.class) .add( Example.create(cat) ) .createCriteria("mate") .add( Example.create( cat.getMate() ) ) .list();
　　org.hibernate.criterion.Projections是 Projection 的實例工廠。我們通過調用 setProjection()應用投影到一個查詢。 在一個條件查詢中沒有必要顯式的使用 "group by" 。某些投影類型就是被定義爲 分組投影，他們也出現在SQL的group by子句中。 你可以選擇把一個別名指派給一個投影，這樣可以使投影值被約束或排序所引用。下面是兩種不同的實現方式： alias()和as()方法簡便的將一個投影實例包裝到另外一個 別名的Projection實例中。簡而言之，當你添加一個投影到一個投影列表中時 你可以爲它指定一個別名： List results = session.createCriteria(Cat.class) .setProjection( Projections.projectionList() .add( Projections.rowCount(), "catCountByColor" ) .add( Projections.avg("weight"), "avgWeight" ) .add( Projections.max("weight"), "maxWeight" ) .add( Projections.groupProperty("color"), "color" ) ) .addOrder( Order.desc("catCountByColor") ) .addOrder( Order.desc("avgWeight") ) .list();List results = session.createCriteria(Domestic.class, "cat") .createAlias("kittens", "kit") .setProjection( Projections.projectionList() .add( Projections.property("cat.name"), "catName" ) .add( Projections.property("kit.name"), "kitName" ) ) .addOrder( Order.asc("catName") ) .addOrder( Order.asc("kitName") ) .list();
　　你也可以使用Property.forName()來表示投影： List results = session.createCriteria(Cat.class) .setProjection( Property.forName("name") ) .add( Property.forName("color").eq(Color.BLACK) ) .list();List results = session.createCriteria(Cat.class) .setProjection( Projections.projectionList() .add( Projections.rowCount().as("catCountByColor") ) .add( Property.forName("weight").avg().as("avgWeight") ) .add( Property.forName("weight").max().as("maxWeight") ) .add( Property.forName("color").group().as("color" ) ) .addOrder( Order.desc("catCountByColor") ) .addOrder( Order.desc("avgWeight") ) .list();
　　DetachedCriteria類使你在一個session範圍之外創建一個查詢，並且可以使用任意的 Session來執行它。 DetachedCriteria也可以用以表示子查詢。條件實例包含子查詢可以通過 Subqueries或者Property獲得。 甚至相互關聯的子查詢也是有可能的： 對大多數查詢，包括條件查詢而言，因爲查詢緩存的失效(invalidation)發生得太頻繁，查詢緩存不是非常高效。然而，有一種特別的查詢，可以通過不變的自然鍵優化緩存的失效算法。在某些應用中，這種類型的查詢比較常見。條件查詢API對這種用例提供了特別規約。
　　首先，你應該對你的entity使用來映射自然鍵，然後打開第二級緩存。 注意,此功能對具有mutable自然鍵的entity並不適用。 然後，打開Hibernate 查詢緩存。
　　現在，我們可以用Restrictions.naturalId()來使用更加高效的緩存算法。