本節內容
NHibernate中的查詢方法
NHibernate查詢語言(HQL)
1.from子句
2.select子句
3.where子句
4.order by子句
5.group by子句
實例分析
結語
NHibernate中的查詢方法
在NHibernate中提供了三種查詢方式給我們選擇：NHibernate查詢語言(HQL，NHibernate Query Language)、條件查詢(Criteria API，Query By Example(QBE)是Criteria API的一種特殊情況)、原生SQL(Literal SQL，T-SQL、PL/SQL)。每個人有不同的喜好和特長，可以根據自己的情況選擇使用其中的一種或幾種。這一節我們介紹NHibernate查詢語言(HQL，NHibernate Query Language)。
NHibernate查詢語言(HQL)
NHibernate查詢語言(HQL，NHibernate Query Language)是NHibernate特有的基於面向對象的SQL查詢語言，它具有繼承、多態和關聯等特性。實際上是用OOP中的對象和屬性映射了數據庫中的表和列。
例如這一句：select c.Firstname from Customer c
Customer是數據庫表，Firstname是列；而對於HQL：Customer是一個對象，Firstname是Customer對象的屬性。相比之下SQL語句非常靈活，但是沒有編譯時語法驗證支持。
本節介紹基礎語法：from子句，select子句，where子句，order by子句，group by子句並分別舉出可以運行的實例。至於關聯和連接，多態(polymorphism)查詢，子查詢在以后具體實例中學習。注意：HQL不區分大小寫。
注意：由於篇幅有限，我在這里僅僅貼出了數據訪問層的代碼，就是在業務邏輯層可以直接調用的方法。測試這些方法的代碼就沒有貼出來了，你可以下載本系列的源代碼仔細看看測試這些方法的代碼。這節，我們在上一節源代碼的基礎上，在數據訪問層中新建QueryHQL.cs類用於編寫HQL查詢方法，在數據訪問的測試層新建一QueryHQLFixture.cs類用於測試。
1.from子句
顧名思義，同SQL語句類似：
1.簡單用法：返回表中所有數據。
public IList<Customer> From()
{
//返回所有Customer類的實例
return _session.CreateQuery("from Customer")
.List<Customer>();
}
2.使用別名：使用as來賦予表的別名，as可以省略。
public IList<Customer> FromAlias()
{
//返回所有Customer類的實例，Customer賦予了別名customer
return _session.CreateQuery("from Customer as customer")
.List<Customer>();
}
3.笛卡爾積：出現多個類，或者分別使用別名，返回笛卡爾積或者稱為“交叉”連接。
2.select子句
1.簡單用法：在結果集中返回指定的對象和屬性。
public IList<int> Select()
{
//返回所有Customer的CustomerId
return _session.CreateQuery("select c.CustomerId from Customer c")
.List<int>();
}
2.數組：用Object[]的數組返回多個對象和/或多個屬性，或者使用特殊的elements功能，注意一般要結合group by使用。
public IList<object[]> SelectObject()
{
return _session.CreateQuery("select c.Firstname, count(c.Firstname) from Customer c group by c.Firstname")
.List<object[]>();
}
或者使用類型安全的.NET對象，以后在實例中說明。
3.統計函數：用Object[]的數組返回屬性的統計函數的結果，注意統計函數的變量也可以是集合count( elements(c.CustomerId) )
public IList<object[]> AggregateFunction()
{
return _session.CreateQuery("select avg(c.CustomerId),sum(c.CustomerId),count(c) from Customer c")
.List<object[]>();
}
4.Distinct用法：distinct和all關鍵字的用法和語義與SQL相同。實例：獲取不同Customer的FirstName。
public IList<string> Distinct()
{
return _session.CreateQuery("select distinct c.Firstname from Customer c")
.List<string>();
}
3.where子句
where子句讓你縮小你要返回的實例的列表范圍。
public IList<Customer> Where()
{
return _session.CreateQuery("select from Customer c where c.Firstname='YJing'")
.List<Customer>();
}
where子句允許出現的表達式包括了在SQL中的大多數情況：
數學操作符：+, -, *, /
真假比較操作符：=, >=, <=, <>, !=, like
邏輯操作符：and, or, not
字符串連接操作符：||
SQL標量函數：upper(),lower()
沒有前綴的( )：表示分組
in, between, is null
位置參數：?
命名參數：:name, :start_date, :x1
SQL文字：'foo', 69, '1970-01-01 10:00:01.0'
枚舉值或常量：Color.Tabby
4.order by子句
按照任何返回的類或者組件的屬性排序：asc升序、desc降序。
public IList<Customer> Orderby()
{
return _session.CreateQuery("select from Customer c order by c.Firstname asc,c.Lastname desc")
.List<Customer>();
}
5.group by子句
按照任何返回的類或者組件的屬性進行分組。
public IList<object[]> Groupby()
{
return _session.CreateQuery("select c.Firstname, count(c.Firstname) from Customer c group by c.Firstname")
.List<object[]>();
}
實例分析
好的，以上基本的查詢的確非常簡單，我們還是參考一下實例，分析一下我們如何寫HQL查詢吧！
實例1：按照FirstName查詢顧客：
public IList<Customer> GetCustomersByFirstname(string firstname)
{
//寫法1
//return _session.CreateQuery("select from Customer c where c.Firstname='" + firstname + "'")
// .List<Customer>();
//寫法2:位置型參數
//return _session.CreateQuery("select from Customer c where c.Firstname=?")
// .SetString(0, firstname)
// .List<Customer>();
//寫法3:命名型參數(推薦)
return _session.CreateQuery("select from Customer c where c.Firstname=:fn")
.SetString("fn", firstname)
.List<Customer>();
}
書寫HQL參數有四種寫法：
寫法1：可能會引起SQL注入，不要使用。
寫法2：ADO.NET風格的?參數，NHibernate的參數從0開始計數。
寫法3：命名參數用:name的形式在查詢字符串中表示，這時IQuery接口把實際參數綁定到命名參數。
寫法4：命名的參數列表，把一些參數添加到一個集合列表中的形式，比如可以查詢數據是否在這個集合列表中。
使用命名參數有一些好處：命名參數不依賴於它們在查詢字符串中出現的順序；在同一個查詢中可以使用多次；它們的可讀性好。所以在書寫HQL使用參數的時候推薦命名型參數形式。
測試一下這個方法吧：看看數據庫中Firstname為“YJingLee”的記錄個數是否是1條，並可以判斷查詢出來的數據的FirstName屬性是不是“YJingLee”。
[Test]
public void GetCustomerByFirstnameTest()
{
IList<Customer> customers = _queryHQL.GetCustomersByFirstname("YJingLee");
Assert.AreEqual(1, customers.Count);
foreach (var c in customers)
{
Assert.AreEqual("YJingLee", c.Firstname);
}
}
實例2：獲取顧客ID大於CustomerId的顧客：
public IList<Customer> GetCustomersWithCustomerIdGreaterThan(int customerId)
{
return _session.CreateQuery("select from Customer c where c.CustomerId > :cid")
.SetInt32("cid", customerId)
.List<Customer>();
}