[NHibernate]HQL查询

目录

写在前面

文档与系列文章

查询的几种方式

HQL查询

一个例子

总结

写在前面

上篇文章介绍了nhibernate在项目中的基本配置,包括数据库连接字符串的设置,映射文件的配置及需注意的地方,这篇文章将介绍nhibernate的查询方法。

文档与系列文章

[Nhibernate]体系结构

[NHibernate]ISessionFactory配置

[NHibernate]持久化类(Persistent Classes)

[NHibernate]O/R Mapping基础

[NHibernate]集合类(Collections)映射 

[NHibernate]关联映射

[NHibernate]Parent/Child

[NHibernate]缓存(NHibernate.Caches)

[NHibernate]NHibernate.Tool.hbm2net

[NHibernate]Nullables

[NHibernate]Nhibernate如何映射sqlserver中image字段

[NHibernate]基本配置与测试 

查询的几种方式

nhibernate中常见的查询方式有以下三种:

  1. NHibernate查询语言(HQL,NHibernate Query Language)。
  2. 条件查询(Criteria API,Query By Example(QBE)是Criteria API的一种特殊情况)。
  3. 原生SQL(Literal SQL,T-SQL、PL/SQL)。

HQL查询

这篇文章着重介绍HQL查询方式。

HQL(Hibernate Query Language)查询提供了更加丰富的和灵活的查询特性,因此Hibernate将HQL查询方式立为官方推荐的标准查询方式,HQL查询在涵盖Criteria查询的所有功能的前提下,提供了类似标准SQL语句的查询方式,同时也提供了更加面向对象的封装。

完整的HQL语句形式如下:

Select/update/delete…… from …… where …… group by …… having …… order by …… asc/desc

其中的update/delete为Hibernate3中所新添加的功能,可见HQL查询非常类似于标准SQL查询。(来自百度百科)

注意:HQL是基于面向对象的查询语言。

该怎样理解这就话呢?和sql不同,HQL中的查询的是对象的属性。例如

         /// <summary>
/// 根据客户姓名进行模糊查询
/// </summary>
/// <param name="strName">查询条件</param>
/// <returns>满足条件的客户信息</returns>
public IList<Customer> SearchByName(string strName)
{
NHibernateHelper nhibernateHelper = new NHibernateHelper();
ISession session = nhibernateHelper.GetSession();
//from后面跟的是持久化类Customer而不是数据表名TB_Customer
return session.CreateQuery("from Customer as customer where customer.CustomerName like '%" + strName + "%'").List<Customer>();
}

在from后面跟的是持久化类的名,而不是表名。否则会出现如下异常:
[NHibernate]HQL查询

同样也支持select,查询多个属性时返回的是IList<Object[]> object数组泛型集合。

         /// <summary>
/// 根据客户姓名进行模糊查询
/// </summary>
/// <param name="strName">查询条件</param>
/// <returns>满足条件的客户信息</returns>
public IList<object[]> SearchByName(string strName)
{
NHibernateHelper nhibernateHelper = new NHibernateHelper();
ISession session = nhibernateHelper.GetSession();
//from后面跟的是持久化类Customer而不是数据表名TB_Customer
return session.CreateQuery("select customer.CustomerID,customer.CustomerName,customer.CustomerAddress from Customer as customer where customer.CustomerName like '%" + strName + "%'").List<object[]>();
}

当查询单个属性时,例如查询所有客户的id,此时返回IList<Guid>

         /// <summary>
/// 获得所有客户的id
/// </summary>
/// <returns></returns>
public IList<Guid> GetAllCustomerID()
{
NHibernateHelper nhibernateHelper = new NHibernateHelper();
ISession session = nhibernateHelper.GetSession();
return session.CreateQuery("select customer.CustomerID from Customer as customer").List<Guid>();
}

另外的order by ,group by,distinct的使用与sql类似,就不再举例子了。
注意:在HQL中,也是大小写不敏感的,也就是不区分大小写的。

一个例子

where条件子句中除sql的大部分情况外,还支持命名参数和位置参数。
根据用户名查询客户信息

         /// <summary>
/// 根据姓名查询客户信息
/// </summary>
/// <param name="strName"></param>
/// <returns></returns>
public IList<Customer> GetCustomerByName(string strName)
{
NHibernateHelper nhibernateHelper = new NHibernateHelper();
ISession session = nhibernateHelper.GetSession();
//方式一
// return session.CreateQuery("from Customer c where c.CustomerName='" + strName + "'").List<Customer>();
//方式二:位置型参数
//return session.CreateQuery("from Customer c where c.CustomerName=?")
// .SetString(0, strName)
// .List<Customer>();
//写法3:命名型参数(推荐)
return session.CreateQuery("from Customer c where c.CustomerName=:cn")
.SetString("cn", strName)
.List<Customer>();
}

以上代码,列出了常见的三种风格的HQL语句写法。
方式一:类似ADO.NET中的一般查询语句的写法,此种写法可能造成SQL注入,不建议使用。

方式二:ADO.NET风格的?参数,NHibernate的参数从0开始计数。

方式三:命名参数用:name的形式在查询字符串中表示,这时IQuery接口把实际参数绑定到命名参数。(类似ADO.NET中参数化查询,推荐这种查询方式)。

我们监控一下方式三生成的sql语句:

[NHibernate]HQL查询

通过上图我们发现,在生成的sql中,查询条件为:

customer0_.CustomerName=@p0',N'@p0 nvarchar(4000)',@p0=N'wolfy'

@p0参数,再执行存储过程,将实参wolfy字符串赋给参数@p0了。

总结

HQL查询是基于面向对象的,在使用查询是from后面的是持久化类对象,而不是数据表表名,这点应该注意。其它的地方跟sql查询比较类似,比如order by ,group by,统计函数的使用等。

在使用hql查询时,推荐使用命名参数的方式查询。

参考文章

http://www.cnblogs.com/lyj/archive/2008/10/15/1312089.html

上一篇:JEE , EJB概念深入概括


下一篇:为什么选择Typescript