日期:2008-06-02  浏览次数:20411 次

NH中,HQL是一个十分强大的面向对象的查询语言,简单的说,就是不需要使用实际的表名和列名来查询数据,而改用类名和属性。
有两种方式来执行HQL数据加载,一种是直接使用ISession的Find方法,另一种是使用IQuery接口。

IQuery接口提供了一些额外的设置,最重要的就是分页了,这个和ICriteria差不多,另外一些就是设置参数的值了。

IQuery最终还是会调用ISession的Find方法,下面来分析一下IQuery中HQL语句的处理.

示例代码:

IQuery query = session.CreateQuery( " from User u where u.Name = :Name " )
query.SetString( "Name", "billy" );
IList users = query.List();

源码分析:

//*** SessionImpl.cs 1760行 ***/
public IQuery CreateQuery(string queryString)
{
   return new QueryImpl(queryString, this);
}
创建一个QueryImpl对象,并传递HQL查询文本和会话.
注意: IQuery的实现类QueryImpl是一个Internal类, 因此不能在nh程序集外直接创建.

//*** QueryImpl.cs 70行 **/
public IQuery SetParameter(int position, object val, IType type) {
   int size = values.Count;
   if ( position<size ) {
      values[position] = val;
      types[position] = type;
   }
   else {
      for (int i=0; i<position-size; i++) {
         values.Add(null);
         types.Add(null);
      }
      values.Add(val);
      types.Add(type);
   }
   return this;
}

public IQuery SetParameter(string name, object val, IType type) {
   namedParameters[name] = new TypedValue(type, val);
   return this;
}
在IQuery中,参数有两种情况,一种是命名参数,一种是未命名参数, 上面给出的示例代码是使用命名参数。
SetString方法直接调用SetParameter方法来设置命名参数,SetParameter参数有多个重载的版本,用于适应不同的IType, 如果要设置未命名参数,那么应通过参数的位置来设置。
TypedValue用对象来于保存参数的类型和值。

//*** QueryImpl.cs 47行 ***/
public virtual IList List() {
   IDictionary namedParams = new Hashtable( namedParameters );

   string query = BindParameterLists(namedParams);
   return session.Find(query, (object[]) values.ToArray(typeof(object)),
      (IType[])types.ToArray(typeof(IType)),
   selection, namedParams, lockModes);
}
在执行查找之前,必须先处理所有的集合参数,像in关健字就用到了集合参数。

//*** QueryImpl.cs 280行 ***
protected string BindParameterLists(IDictionary namedParams) {
   string query = queryString;
   foreach( DictionaryEntry de in namedParametersLists ) {
      query = BindParameterList( query, (string) de.Key, (TypedValue) de.Value, namedParams );
   }
   return query;
}
所有集合参数都存储在namedParametersLists集合中(可参见SetParameterList方法),这里通过枚举对各个集合参数进行绑定。

//*** QueryImpl.cs 288行 ***
private string BindParameterList(string queryString, string name,
   TypedValue typedList, IDictionary namedParams) {
   ICollection vals = (ICollection) typedList.Value;
   IType type = typedList.Type;
   StringBuilder list = new StringBuilder(16);
   int i=0;
   foreach( object obj in vals ) {
      string alias = name + i++ + StringHelper.Underscore;
      namedParams.Add( alias, new TypedValue( type, obj ) );
      list.Append( ':' + alias );
      if ( i < vals.Count ) list.Append( StringHelper.CommASPace );
   }
   return StringHelper.Replace( queryString, ':' + name, list.ToString() );
}
BindParameterList方法遍历值集合,然后将它们加入到命名参数集合(namedParams)中,最后修改HQL查询文本。
例如:在HQL中是" ...