风影总结NHibernate5 查询之NHibernate查询语言(HQL)

本节内容

• NHibernate中的查询方法
• NHibernate查询语言(HQL)
  • 1.from子句
  • 2.select子句
  • 3.where子句
  • 4.order by子句
  • 5.group by子句
• 实例分析
• 结语

上一节，我们初步搭建了一个NHibernate程序，这一节和下一节我们初步探讨一下在NHibernate中的查询方法。我这之前还是先回忆一下上一节完成的东西。总结一下上一节三个重要的事情：建立数据库表-----编写持久化类-----编写映射文件，然后配置使用了。

有一点我要补充一下，

就是NH的配置文件可以不再App.Configration或者web配置文件中，大大简化了配置文件的内容，从而采用强类型的方式，亲有提示哦。

 
public static Configuration ConfigureNHibernate(string assembly)
{
Configuration = new Configuration();
Configuration.DataBaseIntegration(dbi =>
{
dbi.Dialect<MsSql2008Dialect>();
dbi.Driver<SqlClientDriver>();
dbi.ConnectionProvider<DriverConnectionProvider>();
dbi.IsolationLevel = IsolationLevel.ReadCommitted;
dbi.Timeout = 15;
dbi.ConnectionStringName = "GuitarStore";
});
Configuration.AddAssembly(assembly);
 return Configuration;
}

把之前的NHibernateBase中的ConfigureNHibernate进行更改即可。

然后APP配置文件就就可以精简为

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
<configSections>
<section name="hibernate-configuration"
type="NHibernate.Cfg.ConfigurationSectionHandler, NHibernate"/>
</configSections>
<connectionStrings>
<add name="GuitarStore"
connectionString="Data Source=.;Initial Catalog=Demo;Integrated Security=True"/>
</connectionStrings>
<startup>
<supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.5" />
</startup>
</configuration>

是不是很好呢。作为类库而言可以直接分离出去了。

 

 

好了我们来看今天的HQL

NHibernate中的查询方法

在NHibernate中提供了很多查询方式给我们选择，这里仅仅列举了3种方式：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)。实际上还有Linq方式的查询和Lambda方式的查询后续补充

 

 

NHibernate查询语言(HQL)

NHibernate查询语言(HQL，NHibernate Query Language)是NHibernate特有的基于面向对象的SQL查询语言，它具有继承、多态和关联等特性。实际上是用OOP中的对象和属性映射了数据库中的表和列。

例如这一句： select g.GoodsTypeName from GoodsType g

GoodsType 是数据库表，GoodsTypeName 是列；而对于HQL：GoodsType 是一个对象，GoodsTypeName 是GoodsType 对象的属性。相比之下SQL语句非常灵活，但是没有编译时语法验证支持。

本节介绍基础语法：from子句，select子句，where子句，order by子句，group by子句并分别举出可以运行的实例。至于关联和连接，多态(polymorphism)查询，子查询在以后具体实例中学习。注意：HQL关键字不区分大小写。

注意：由于篇幅有限，我在这里仅仅贴出了数据访问层的代码，就是在业务逻辑层可以直接调用的方法。测试这些方法的代码就没有贴出来了，你可以下载本系列的源代码仔细看看测试这些方法的代码。这节，我们在上一节源代码的基础上，继续编写。

 

1.from子句

顾名思义，同SQL语句类似：

1.简单用法：返回表中所有数据。

from关键字直接跟Model名就可以获取该模型对应表中的所有数据

NHibernateBase.Session.CreateQuery这个方法是处理HQL语句的方法。返回一个IQuery对象，然后调用泛型的List方法最终获取结果集。而且是强类型的

2.使用别名：使用as来赋予表的别名，as可以省略。

public IList<Customer> FromAlias() { //返回所有Customer类的实例，Customer赋予了别名customer return _session.CreateQuery("from Customer as customer") .List<Customer>(); }

 

2.select子句

1.简单用法：在结果集中返回指定的对象和属性。

这种方式可以获取某对象的特定属性的数据。只不过这样的数据就不再和Model有关系了。

2.数组：用Object[]的数组返回多个对象和/或多个属性，或者使用特殊的elements功能，注意一般要结合group by使用。注意，这里是Object[]的数组，我们可以定义DTO对象集合返回，即使用类型安全的.NET对象。

public IList<object[]> SelectObject() { return _session.CreateQuery("select c.Firstname, count(c.Firstname) from Customer c group by c.Firstname") .List<object[]>(); }

3.统计函数：用Object[]的数组返回属性的统计函数的结果，注意统计函数的变量也可以是集合count( elements、c.CustomerId ) 。注意，这里是long集合，我们可以定义DTO对象集合返回。

4.Distinct用法：distinct和all关键字的用法和语义与SQL相同。实例：获取不同Customer的FirstName。

3.where子句

where子句让你缩小你要返回的实例的列表范围。

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降序。

5.group by子句

按照任何返回的类或者组件的属性进行分组。

实例分析

好的，以上基本的查询的确非常简单，我们还是参考一下实例，分析一下我们如何写HQL查询吧！

实例1：按照FirstName查询顾客：

public IList<Customer> GetCustomersByFirstname(string firstname) {

//写法1 

//return _session.CreateQuery("from Customer c where c.Firstname='" + firstname + "'")

// .List<Customer>();  

//写法2:位置型参数 

//return _session.CreateQuery("from Customer c where c.Firstname=?") // .SetString(0, firstname)

 // .List<Customer>();  

//写法3:命名型参数(推荐) 

return _session.CreateQuery("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使用参数的时候推荐命名型参数形式。

获取顾客ID大于CustomerId的顾客：

public IList<Customer> GetCustomersWithCustomerIdGreaterThan(int customerId) { return _session.CreateQuery("from Customer c where c.CustomerId > :cid") .SetInt32("cid", customerId) .List<Customer>(); }

结语

在这篇文章中，我们了解了NHibernate其中的一种查询语言HQL。下一节继续介绍另外一种查询语言！注意，这篇有的是返回IList<object[]>类型，在实际项目中不可能使用这个类型，我们需要使用一个对象，就是一个DTO转换返回IList<ClassDTO>类型。