nh会话提供一种使用表达式(就像SQL语句的where表达式)来载入数据的方法, 以取得满足条件的对象集合。

通过CreateCriteria方法, 可以取得一个ICriteria接口, 这个接口用于操作表达式和排序字段. 由CriteriaImpl类实现,此类加有Internal修饰,因此不能在程序集外显示创建, CreateCriteria方法需要一个要加载对象类型的参数.

这里列出ICriteria接口中的一些常用方法:

Add:加入条件表达式(Expression对象),此方法可多次调用以组合多个条件;
AddOrder:加入排序的字段(Order对象);
List:执行查询, 返回满足条件的对象集合。
SetMaxResults:设置返回的最大结果数,可用于分页;
SetFirstResult:设置首个对象返回的位置,可用于分页;
SetTimeout:设置操作的超时值,此值将传递给IDbCommand对象;

Expression(表达式)

Expression类是所有表达式类的祖先. 这是一个抽象(abstract)类, 同时也是一个类工厂(Factory Method模式), 用于创建派生的表达式对象, 用意是很明显的, 隐藏了派生类的细节,使我们可通过一致的方法来创建表达式对象.

下面列出一些Expression中常用的方法:

Eq:得到一个相等判断的表达式, 等同于 propertyName = value;
Gt:得到一个大于判断的表达式, 等同于 propertyName > value;
Like:得到一个相似判断的表达式, 等同于 propertyName like value;
And:得到两个表达式And操作后的表达式, 等同于 expression1 and expression2;
Or:重到两个表达式Or操作后的表达式, 等同于 expression1 or expression2;

更多的Expression请参考相关文档或源代码。

Order(排序)

Order类用于向ICriteria接口提供排序信息. 这个类提供了两个静态方法, 分别是Asc和Desc, 顾名思义就是创建升序和降序的Order对象.
例如要取得一个按更新日期(Updated)降序的Order对象, 使用Order.Desc("Updated")就可以了.

示例

下面以几个例子来说明使用Criteria载入对象的用法:

1. 取得用户名(Username)为billy的用户对象:

Expression ex = Expression.Eq( "Username", "billy" ); // ( Username = 'billy' )
IList users = session.CreateCriteria(typeof(User)).Add( ex ).List();

2。取得用户名(Username)为billy, 密码(Password)为123456的用户对象

Expression ex = Expression.And(
Expression.Eq("Username", "billy"),
Expression.Eq("Password", "123456")
); // ( Username='billy' and Password='123456' )
IList users = session.CreateCriteria(type(User)).Add( ex ).List();

3. 取得数据中第20-40的用户对象。

ICriteria c = session.CreateCriteria(typeof(User));
IList users = c.SetFirstResult(20).SetMaxResults(20).List();

对于SQLSERVER,数据定位采用的是IDataReader前滚至firstResult处,然后取maxResults条记录.

4. 取得按注册日期(Regdate)降序排序后的用户对象.

ICriteria c = session.CreateCriteria(typeof(User));
IList users = c.AddOrder( Order.Desc("Regdate") ).List();

使用Criteria加载数据的不足:

1. 当使用SetFirstResult和SetMaxResults限制返回的对象数时,无法得知对象的总数;
2. 当前版本不支持关联查询(hibernate好像可以);
1. 返回所有的会员:
    string query = "from Member";
    IList member = session.CreateQuery(query).List();

2. 返回以b开头的会员:
    string query = "from Member m where m.name like b%";
    IList members= session.CreateQuery(query).List();

3. 返回所有的会员ID和名称:
    string query = "select m.MemberId, m.Name from Member m";
    IList members = session.CreateQuery(query).List();
    注意:此处的MemberId, Name均为Member对象的属性.
    返回的并不是members对象的集合,而是一个一维数组的集合,
    其中array[0]为MemberId, array[1]为Name

4. 返回会员的总数:
    string query = "select count(*) from Member";
    IEnumerator e = Session.CreateQuery(query).Enumerable().GetEnumerator();
    e.MoveNext;
    int rowCount = (int)(e.Current);

5. 返回指定(从20-40)的会员
    string query = "from Member";
    IList Members = session.CreateQuery(query)
                                .SetFirstResult(20).SetMaxResults(20).List()

HQL也支持统计函数、子查询等,更多例子请参考相关文档。