[NHibernate]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中的查詢的是對象的屬性。例如

 1         /// <summary>
 2         /// 根據客戶姓名進行模糊查詢
 3         /// </summary>
 4         /// <param name="strName">查詢條件</param>
 5         /// <returns>知足條件的客戶信息</returns>
 6         public IList<Customer> SearchByName(string strName)
 7         {
 8             NHibernateHelper nhibernateHelper = new NHibernateHelper();
 9             ISession session = nhibernateHelper.GetSession();
10             //from後面跟的是持久化類Customer而不是數據表名TB_Customer
11             return session.CreateQuery("from Customer as customer where customer.CustomerName like '%" + strName + "%'").List<Customer>();
12         }

在from後面跟的是持久化類的名，而不是表名。不然會出現以下異常：

一樣也支持select，查詢多個屬性時返回的是IList<Object[]> object數組泛型集合。

 1         /// <summary>
 2         /// 根據客戶姓名進行模糊查詢
 3         /// </summary>
 4         /// <param name="strName">查詢條件</param>
 5         /// <returns>知足條件的客戶信息</returns>
 6         public IList<object[]> SearchByName(string strName)
 7         {
 8             NHibernateHelper nhibernateHelper = new NHibernateHelper();
 9             ISession session = nhibernateHelper.GetSession();
10             //from後面跟的是持久化類Customer而不是數據表名TB_Customer
11             return session.CreateQuery("select customer.CustomerID,customer.CustomerName,customer.CustomerAddress from Customer as customer where customer.CustomerName like '%" + strName + "%'").List<object[]>();
12         }

當查詢單個屬性時，例如查詢全部客戶的id，此時返回IList<Guid>

 1         /// <summary>
 2         /// 得到全部客戶的id
 3         /// </summary>
 4         /// <returns></returns>
 5         public IList<Guid> GetAllCustomerID()
 6         {
 7             NHibernateHelper nhibernateHelper = new NHibernateHelper();
 8             ISession session = nhibernateHelper.GetSession();
 9             return session.CreateQuery("select customer.CustomerID from Customer as customer").List<Guid>();
10         }

另外的order by ，group by,distinct的使用與sql相似，就再也不舉例子了。
注意：在HQL中，也是大小寫不敏感的，也就是不區分大小寫的。

一個例子

where條件子句中除sql的大部分狀況外，還支持命名參數和位置參數。
根據用戶名查詢客戶信息

 1         /// <summary>
 2         /// 根據姓名查詢客戶信息
 3         /// </summary>
 4         /// <param name="strName"></param>
 5         /// <returns></returns>
 6         public IList<Customer> GetCustomerByName(string strName)
 7         {
 8             NHibernateHelper nhibernateHelper = new NHibernateHelper();
 9             ISession session = nhibernateHelper.GetSession();
10             //方式一
11             // return session.CreateQuery("from Customer c where c.CustomerName='" + strName + "'").List<Customer>();
12             //方式二:位置型參數
13             //return session.CreateQuery("from Customer c where c.CustomerName=?")
14             //    .SetString(0, strName)
15             //     .List<Customer>();
16             //寫法3:命名型參數(推薦)
17             return session.CreateQuery("from Customer c where c.CustomerName=:cn")
18                 .SetString("cn", strName)
19                 .List<Customer>();
20         }

以上代碼，列出了常見的三種風格的HQL語句寫法。
方式一：相似ADO.NET中的通常查詢語句的寫法，此種寫法可能形成SQL注入，不建議使用。

方式二：ADO.NET風格的?參數，NHibernate的參數從0開始計數。

方式三：命名參數用:name的形式在查詢字符串中表示，這時IQuery接口把實際參數綁定到命名參數。（相似ADO.NET中參數化查詢，推薦這種查詢方式）。

咱們監控一下方式三生成的sql語句：

經過上圖咱們發現，在生成的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

相關標籤/搜索

每日一句

每一个你不满意的现在，都有一个你没有努力的曾经。

[NHibernate]HQL查詢

目錄

寫在前面

文檔與系列文章

查詢的幾種方式

HQL查詢

一個例子

總結