NHibernate - ICriteria 查询

 

条件查询

NHibernate.ICriteria接口表示特定持久类的一个查询。ISession是 ICriteria实例的工厂。

 

这里以Northwind数据库为示例数据库

示例数据表：Employees

现在只用雇员表中部分字段。

持久类如下：

public class Employees

    {

        public virtual int EmployeeID { get; set; }

        public virtual string LastName { get; set; }

        public virtual string FirstName { get; set; }

        public virtual DateTime BirthDate { get; set; }

        public virtual string Address { get; set; }

        public virtual string City { get; set; }

        public virtual string PostalCode { get; set; }

    }

 

映射文件如下：

<?xml version="1.0" encoding="utf-8" ?>

<hibernate-mapping xmlns="urn:nhibernate-mapping-2.2" assembly="Domain" namespace="Domain.Entities">

  <class table="Employees">

    <id column="EmployeeID">

      <generator ></generator>

    </id>

    <property column="LastName" type="String"></property>

    <property column="FirstName" type="String"></property>

    <property column="BirthDate" type="DateTime"></property>

    <property column="Address" type="String"></property>

    <property column="City" type="String"></property>

    <property column="PostalCode" type="String"></property>

  </class>

</hibernate-mapping>

 

开始

（一） 返回所有实例（返回所有雇员）

这里返回的所有实例，且是全部的属性（字段）

ICriteria crt = _session.CreateCriteria(typeof(Employees));           

return crt.List<Employees>();

Isession创建条件查询实例有4个构造方法。

（二）  返回部分实例（返回2个雇员）

ICriteria crt = _session.CreateCriteria(typeof(Employees));

        crt.SetMaxResults(2);

return crt.List<Employees>();

（三）条件查询的约束条件

（1）Expression

ICriteria crt = _session.CreateCriteria(typeof(Employees));

        crt.Add(Expression.Eq("City","< XMLNAMESPACE PREFIX ="ST1" />London"));

        return crt.List<Employees>();

       查询内容为：雇员的城市是在伦敦的。其中Expression的名字空间为：NHibernate.Criterion

Expression类 定义了获得某些内置ICriterion类型的工厂方法，这里用到了等于

（2）Restrictions

ICriteria crt = _session.CreateCriteria(typeof(Employees));

        crt.Add(Restrictions.Eq("City", "London"));

return crt.List<Employees>();

查询内容为：雇员的城市是在伦敦的。其中Restrictions的名字空间为：NHibernate.Criterion

（3）通过实例来查询

Employees ee = new Employees { City = "London", BirthDate = Convert.ToDateTime("1955-03-04 00:00:00.000") };

         ICriteria crt = _session.CreateCriteria(typeof(Employees));

         crt.Add(Example.Create(ee));

     return crt.List<Employees>();

 

查询伦敦的，生日在那个时间的。（为什么这里我要加个生日上去？因为我的持久类中有这个属性，如果在实例查询中不给定这个值，会有日期越界的异常。在下边的例子中，来处理这种情况）这是限制的相等的实现。下边实现一个相似的例子：

Employees ee = new Employees { FirstName = "a"};

    Example exp=Example.Create(ee)

                .EnableLike(MatchMode.Start)

                .ExcludeProperty("BirthDate")

                .IgnoreCase();

    ICriteria crt = _session.CreateCriteria(typeof(Employees));

    crt.Add(exp);

return crt.List<Employees>();

 

这个例子中，指定相似的姓名等a，看实例exp：

·采用相似比较EnableLike

·相似比较匹配模式MatchMode.Start，开头匹配，这个应该类似于SQL中的a%

·排除比较属性ExcludeProperty，这个方法就是用于处理排除的。上个例子中日期没给，所以会出现异常，而这个方法则排除了这种异常发生（其实就是排除不比较的属性（字段））。

·忽略大小写

（四）排序

ICriteria crt = _session.CreateCriteria(typeof(Employees));

crt.AddOrder(new NHibernate.Criterion.Order("FirstName", true));

return crt.List<Employees>();

排序字段：名字，升序（true）

（五）聚合

（1）查询人数

ICriteria crt = _session.CreateCriteria(typeof(Employees));

         crt.SetProjection(Projections.RowCount());

return crt.List();

NHibernate.Expression.Projections是 IProjection 的实例工厂。通过调用 SetProjection()应用投影到一个查询。

（2）Avg

从这个开始到以下的例子又回到以Products为示例数据表

       ICriteria crt = _session.CreateCriteria(typeof(Products));           

         crt.SetProjection(Projections.ProjectionList()

                .Add(Projections.Avg("Price"))

                );

     return crt.List();

通过投影列表来添加投影聚合方法。

这里取得产品的平均价格，这里没有条件约束，下边这个例子取得产品类别为2的产品的平均价格：

ICriteria crt = _session.CreateCriteria(typeof(Products));           

         crt.SetProjection(Projections.ProjectionList()

                .Add(Projections.Avg("Price")))

                .Add(Expression.Eq("CategoryID",2));

    return crt.List();

（3）Max（最大价格）

ICriteria crt = _session.CreateCriteria(typeof(Products));

         crt.SetProjection(Projections.ProjectionList()

                .Add(Projections.Max("Price")));

     return crt.List();

（4）Min（最低价格）

ICriteria crt = _session.CreateCriteria(typeof(Products));

         crt.SetProjection(Projections.ProjectionList()

                .Add(Projections.Min ("Price")));

     return crt.List();

（5）Sum（和）

ICriteria crt = _session.CreateCriteria(typeof(Products));

         crt.SetProjection(Projections.ProjectionList()

                .Add(Projections.Sum ("Price")));

     return crt.List();

（6）分组

ICriteria crt = _session.CreateCriteria(typeof(Products));

         crt.SetProjection(Projections.ProjectionList()

                .Add(Projections.GroupProperty("CategoryID")));

     return crt.List<int>();

这个分组只是返回一个属性，所以用int泛型可以了。下边的例子返回分组，并返回各组的数目

ICriteria crt = _session.CreateCriteria(typeof(Products));

    crt.SetProjection(Projections.ProjectionList()

                .Add(Projections.GroupProperty("CategoryID"))

                .Add(Projections.RowCount()));

return crt.List();

·这里的List为System.Collections.Ilist，且是object[]类型的

 

 

Hibernate-Criteria 模糊查询

Criteria Query通过面向对象化的设计，将数据查询条件封装为一个对象。简单来

 讲，Criteria Query可以看作是传统SQL的对象化表示，如：

 Criteria criteria = session.createCriteria(User.class);

 criteria.add(Expression.eq("name","Erica"));

 criteria.add(Expression.eq("sex",new Integer(1)));

 这里的criteria 实例实际上是SQL “Select * from t_user where

 name=’Erica’ and sex=<chmetcnv w:st="on" tcsc="0" numbertype="1" negative="False" hasspace="False" sourcevalue="1" unitname="”"></chmetcnv>1”的封装（我们可以打开Hibernate 的show_sql 选项，

 以观察Hibernate在运行期生成的SQL语句）。

 Hibernate 在运行期会根据Criteria 中指定的查询条件（也就是上面代码中通过

 criteria.add方法添加的查询表达式）生成相应的SQL语句。

 这种方式的特点是比较符合Java 程序员的编码习惯，并且具备清晰的可读性。正因

 为此，不少ORM实现中都提供了类似的实现机制（如Apache OJB）。

 对于Hibernate的初学者，特别是对SQL了解有限的程序员而言，Criteria Query

 无疑是上手的极佳途径，相对HQL，Criteria Query提供了更易于理解的查询手段，借

 助IDE的Coding Assist机制，Criteria的使用几乎不用太多的学习。

 Criteria 查询表达式

 Criteria 本身只是一个查询容器，具体的查询条件需要通过Criteria.add

 方法添加到Criteria实例中。

 如前例所示，Expression 对象具体描述了查询条件。针对SQL 语法，

 Expression提供了对应的查询限定机制，包括：

 方法 描述

 Expression.eq 对应SQL“field = value”表达式。

 如Expression.eq("name","Erica")

 Expression.allEq 参数为一个Map对象，其中包含了多个属性－值对

 应关系。相当于多个Expression.eq关系的叠加。

 Expression.gt 对应SQL中的 “field > value ” 表达式

 Expression.ge 对应SQL中的 “field >= value” 表达式

 Expression.lt 对应SQL中的 “field < value” 表达式

 Expression.le 对应SQL中的 “field <= value” 表达式

 Expression.between 对应SQL中的 “between” 表达式

 如下面的表达式表示年龄（age）位于13到50区间内。

 Expression.between("age",new

 Integer(13),new Integer(50));

 表达式

 Expression.in 对应SQL中的 ”field in …” 表达式

 Expression.eqProperty 用于比较两个属性之间的值，对应SQL中的“field = field”。

 如：

 Expression.eqProperty(

 "TUser.groupID",

 "TGroup.id"

 );

 Expression.gtProperty 用于比较两个属性之间的值，对应SQL中的“field > field”。

 Expression.geProperty 用于比较两个属性之间的值，对应SQL中的“field >= field”。

 Expression.ltProperty 用于比较两个属性之间的值，对应SQL中的“field < field”。

 Expression.leProperty 用于比较两个属性之间的值，对应SQL中的“field <= field”。

 Expression.and and关系组合。

 如：

 Expression.and(

 Expression.eq("name","Erica"),

 Expression.eq(

 "sex",

 new Integer(1)

 )

 );

 Expression.or or关系组合。

 如：

 Expression.or(

 Expression.eq("name","Erica"),

 Expression.eq("name","Emma")

 );

 Expression.sql 作为补充，本方法提供了原生SQL语法的支持。我

 们可以通过这个方法直接通过SQL语句限定查询条件。

 下面的代码返回所有名称以“Erica”起始的记录：

 Expression.sql(

 “lower({alias}.name) like lower(?)”,

 "Erica%",

 Hibernate.STRING

 );

 其中的“{alias}”将由Hibernate在运行期使

 用当前关联的POJO别名替换。

 注意Expression 各方法中的属性名参数（如Express.eq中的第一个参数），这里

 所谓属性名是POJO中对应实际库表字段的属性名（大小写敏感），而非库表中的实

 际字段名称。

 Criteria 高级特性

 限定返回的记录范围

 通过criteria. setFirstResult/setMaxResults 方法可以限制一次查询返回

 的记录范围:

 Criteria criteria = session.createCriteria(TUser.class);

 //限定查询返回检索结果中，从第一百条结果开始的20条记录

 criteria.setFirstResult(100);

 criteria.setMaxResults(20);

 对查询结果进行排序

 //查询所有groupId=2的记录

 //并分别按照姓名(顺序)和groupId（逆序）排序

 Criteria criteria = session.createCriteria(TUser.class);

 criteria.add(Expression.eq("groupId",new Integer(2)));

 criteria.addOrder(Order.asc("name"));

 criteria.addOrder(Order.desc("groupId"));

 

 Criteria作为一种对象化的查询封装模式，不过由于Hibernate在实现过程中将精力

 更加集中在HQL查询语言上，因此Criteria的功能实现还没做到尽善尽美（这点上，OJB

 的Criteria 实现倒是值得借鉴），因此，在实际开发中，建议还是采用Hibernate 官

 方推荐的查询封装模式：HQL。

 

【转】 http://blog.163.com/xhy_cy/blog/static/10497623201122365013118/