HQL查询示例

HQL语法
HQL查询：

　　Criteria查询对查询条件进行了面向对象封装，符合编程人员的思维方式，不过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查询在整个Hibernate实体操作体系中的核心地位，这一节我将专门围绕HQL操作的具体技术细节进行讲解。

　　1、 实体查询：

　　有关实体查询技术，其实我们在先前已经有多次涉及，比如下面的例子：

　　String hql=”from User user ”;

　　List list=session.CreateQuery(hql).list();

　　上面的代码执行结果是，查询出User实体对象所对应的所有数据，而且将数据封装成User实体对象，并且放入List中返回。这里需要注意的是，Hibernate的实体查询存在着对继承关系的判定，比如我们前面讨论映射实体继承关系中的Employee实体对象，它有两个子类分别是HourlyEmployee，SalariedEmployee,如果有这样的HQL语句：“from Employee”,当执行检索时Hibernate会检索出所有Employee类型实体对象所对应的数据（包括它的子类HourlyEmployee，SalariedEmployee对应的数据）。

　　因为HQL语句与标准SQL语句相似，所以我们也可以在HQL语句中使用where字句，并且可以在where字句中使用各种表达式，比较操作符以及使用“and”,”or”连接不同的查询条件的组合。看下面的一些简单的例子：

　　from User user where user.age=20;

　　from User user where user.age between 20 and 30;

　　from User user where user.age in(20,30);

　　from User user where user.name is null;

　　from User user where user.name like ‘%zx%’;

　　from User user where (user.age%2)=1;

　　from User user where user.age=20 and user.name like ‘%zx%’;

　　2、 实体的更新和删除：

　　在继续讲解HQL其他更为强大的查询功能前，我们先来讲解以下利用HQL进行实体更新和删除的技术。这项技术功能是Hibernate3的新加入的功能，在Hibernate2中是不具备的。比如在Hibernate2中，如果我们想将数据库中所有18岁的用户的年龄全部改为20岁，那么我们要首先将年龄在18岁的用户检索出来，然后将他们的年龄修改为20岁，最后调用Session.update()语句进行更新。在Hibernate3中对这个问题提供了更加灵活和更具效率的解决办法，如下面的代码：

　　Transaction trans=session.beginTransaction();

　　String hql=”update User user set user.age=20 where user.age=18”;

　　Query queryupdate=session.createQuery(hql);

　　int ret=queryupdate.executeUpdate();

　　trans.commit();

　　通过这种方式我们可以在Hibernate3中，一次性完成批量数据的更新，对性能的提高是相当的可观。同样也可以通过类似的方式来完成delete操作，如下面的代码：

　　Transaction trans=session.beginTransaction();

　　String hql=”delete from User user where user.age=18”;

　　Query queryupdate=session.createQuery(hql);

　　int ret=queryupdate.executeUpdate();

　　trans.commit();

　　如果你是逐个章节阅读的化，那么你一定会记起我在第二部分中有关批量数据操作的相关论述中，讨论过这种操作方式，这种操作方式在Hibernate3中称为bulk delete/update，这种方式能够在很大程度上提高操作的灵活性和运行效率，但是采用这种方式极有可能引起缓存同步上的问题(请参考相关论述)。

　　3、 属性查询：

　　很多时候我们在检索数据时，并不需要获得实体对象所对应的全部数据，而只需要检索实体对象的部分属性所对应的数据。这时候就可以利用HQL属性查询技术，如下面程序示例：

　　List list=session.createQuery(“select user.name from User user ”).list();

　　for(int i=0;i<list.size();i++){

　　System.out.println(list.get(i));

　　}

　　我们只检索了User实体的name属性对应的数据，此时返回的包含结果集的list中每个条目都是String类型的name属性对应的数据。我们也可以一次检索多个属性，如下面程序：

　　List list=session.createQuery(“select user.name,user.age from User user ”).list();

　　for(int i=0;i<list.size();i++){

　　Object[] obj=(Object[])list.get(i);

　　System.out.println(obj[0]);

　　System.out.println(obj[1]);

　　}

　　此时返回的结果集list中，所包含的每个条目都是一个Object[]类型，其中包含对应的属性数据值。作为当今我们这一代深受面向对象思想影响的开发人员，可能会觉得上面返回Object[]不够符合面向对象风格，这时我们可以利用HQL提供的动态构造实例的功能对这些平面数据进行封装，如下面的程序代码：

　　List list=session.createQuery(“select new User(user.name,user.age) from User user ”).list();

　　for(int i=0;i

　　User user=(User)list.get(i);

　　System.out.println(user.getName());

　　System.out.println(user.getAge());

　　}

　　这里我们通过动态构造实例对象，对返回结果进行了封装，使我们的程序更加符合面向对象风格，但是这里有一个问题必须注意，那就是这时所返回的User对象，仅仅只是一个普通的Java对象而以，除了查询结果值之外，其它的属性值都为null（包括主键值id），也就是说不能通过Session对象对此对象执行持久化的更新操作。如下面的代码：

　　List list=session.createQuery(“select new User(user.name,user.age) from User user ”).list();

　　for(int i=0;i

　　User user=(User)list.get(i);

　　user.setName(“gam”);

　　session.saveOrUpdate(user);//这里将会实际执行一个save操作，而不会执行update操作，因为这个User对象的id属性为null，Hibernate会把它作为一个自由对象（请参考持久化对象状态部分的论述），因此会对它执行save操作。

　　}

　　4、 分组与排序

　　A、Order by子句：

　　与SQL语句相似，HQL查询也可以通过order by子句对查询结果集进行排序，并且可以通过asc或者desc关键字指定排序方式，如下面的代码：

　　from User user order by user.name asc,user.age desc;

　　上面HQL查询语句，会以name属性进行升序排序，以age属性进行降序排序，而且与SQL语句一样，默认的排序方式为asc,即升序排序。

　　B、Group by子句与统计查询：

　　在HQL语句中同样支持使用group by子句分组查询，还支持group by子句结合聚集函数的分组统计查询，大部分标准的SQL聚集函数都可以在HQL语句中使用，比如：count(),sum(),max(),min(),avg()等。如下面的程序代码：

　　String hql=”select count(user),user.age from User user group by user.age having count(user)>10 ”;

　　List list=session.createQuery(hql).list();

　　C、优化统计查询：

　　假设我们现在有两张数据库表，分别是customer表和order表，它们的结构如下：

　　customer

　　ID varchar2(14)

　　age number(10)

　　name varchar2(20)

　　order

　　ID varchar2(14)

　　order_number number(10)

　　customer_ID varchar2(14)

　　现在有两条HQL查询语句，分别如下：

　　from Customer c inner join c.orders o group by c.age;(1)

　　select c.ID,c.name,c.age,o.ID,o.order_number,o.customer_ID

　　from Customer c inner join c.orders c group by c.age;(2)

　　这两条语句使用了HQL语句的内连接查询（我们将在HQL语句的连接查询部分专门讨论），现在我们可以看出这两条查询语句最后所返回的结果是一样的，但是它们其实是有明显区别的，语句（1）检索的结果会返回Customer与Order持久化对象，而且它们会被置于Hibernate的Session缓存之中，并且Session会负责它们在缓存中的唯一性以及与后台数据库数据的同步，只有事务提交后它们才会从缓存中被清除；而语句（2）返回的是关系数据而并非是持久化对象，因此它们不会占用Hibernate的Session缓存，只要在检索之后应用程序不在访问它们，它们所占用的内存就有可能被JVM的垃圾回收器回收，而且Hibernate不会同步对它们的修改。

　　在我们的系统开发中，尤其是Mis系统，不可避免的要进行统计查询的开发，这类功能有两个特点：第一数据量大；第二一般情况下都是只读操作而不会涉及到对统计数据进行修改，那么如果采用第一种查询方式，必然会导致大量持久化对象位于Hibernate的Session缓存中，而且Hibernate的Session缓存还要负责它们与数据库数据的同步。而如果采用第二种查询方式，显然就会提高查询性能，因为不需要Hibernate的Session缓存的管理开销，而且只要应用程序不在使用这些数据，它们所占用的内存空间就会被回收释放。

　　因此在开发统计查询系统时，尽量使用通过select语句写出需要查询的属性的方式来返回关系数据，而避免使用第一种查询方式返回持久化对象（这种方式是在有修改需求时使用比较适合），这样可以提高运行效率并且减少内存消耗。㊣真正的高手并不是精通一切，而是精通在合适的场合使用合适的手段。

　　5、 参数绑定：

　　Hibernate中对动态查询参数绑定提供了丰富的支持，那么什么是查询参数动态绑定呢？其实如果我们熟悉传统JDBC编程的话，我们就不难理解查询参数动态绑定，如下代码传统JDBC的参数绑定：

　　PrepareStatement pre=connection.prepare(“select * from User where user.name=?”);

　　pre.setString(1,”zhaoxin”);

　　ResultSet rs=pre.executeQuery();

　　在Hibernate中也提供了类似这种的查询参数绑定功能，而且在Hibernate中对这个功能还提供了比传统JDBC操作丰富的多的特性，在Hibernate中共存在4种参数绑定的方式，下面我们将分别介绍：

　　A、 按参数名称绑定：

　　在HQL语句中定义命名参数要用”:”开头，形式如下：

　　Query query=session.createQuery(“from User user where user.name=:customername and user:customerage=:age ”);

　　query.setString(“customername”,name);

　　query.setInteger(“customerage”,age);

　　上面代码中用:customername和:customerage分别定义了命名参数customername和customerage，然后用Query接口的setXXX()方法设定名参数值，setXXX()方法包含两个参数，分别是命名参数名称和命名参数实际值。

　　B、 按参数位置邦定：

　　在HQL查询语句中用”?”来定义参数位置，形式如下：

　　Query query=session.createQuery(“from User user where user.name=? and user.age =? ”);

　　query.setString(0,name);

　　query.setInteger(1,age);

　　同样使用setXXX()方法设定绑定参数，只不过这时setXXX()方法的第一个参数代表邦定参数在HQL语句中出现的位置编号（由0开始编号），第二个参数仍然代表参数实际值。

　　注：在实际开发中，提倡使用按名称邦定命名参数，因为这不但可以提供非常好的程序可读性，而且也提高了程序的易维护性，因为当查询参数的位置发生改变时，按名称邦定名参数的方式中是不需要调整程序代码的。

　　C、 setParameter()方法：

　　在Hibernate的HQL查询中可以通过setParameter()方法邦定任意类型的参数，如下代码：

　　String hql=”from User user where user.name=:customername ”;

　　Query query=session.createQuery(hql);

　　query.setParameter(“customername”,name,Hibernate.STRING);

　　如上面代码所示，setParameter()方法包含三个参数，分别是命名参数名称，命名参数实际值，以及命名参数映射类型。对于某些参数类型setParameter()方法可以根据参数值的Java类型，猜测出对应的映射类型，因此这时不需要显示写出映射类型，像上面的例子，可以直接这样写：

　　query.setParameter(“customername”,name);但是对于一些类型就必须写明映射类型，比如java.util.Date类型，因为它会对应Hibernate的多种映射类型，比如Hibernate.DATA或者Hibernate.TIMESTAMP。

　　D、 setProperties()方法：

　　在Hibernate中可以使用setProperties()方法，将命名参数与一个对象的属性值绑定在一起，如下程序代码：

　　Customer customer=new Customer();

　　customer.setName(“pansl”);

　　customer.setAge(80);

　　Query query=session.createQuery(“from Customer c where c.name=:name and c.age=:age ”);

　　query.setProperties(customer);

　　setProperties()方法会自动将customer对象实例的属性值匹配到命名参数上，但是要求命名参数名称必须要与实体对象相应的属性同名。

　　这里还有一个特殊的setEntity()方法，它会把命名参数与一个持久化对象相关联，如下面代码所示：

　　Customer customer=(Customer)session.load(Customer.class,”1”);

　　Query query=session.createQuery(“from Order order where order.customer=:customer ”);

　　query. setProperties(“customer”,customer);

　　List list=query.list();

　　上面的代码会生成类似如下的SQL语句：

　　Select * from order where customer_ID=’1’;

　　E、 使用绑定参数的优势：

　　我们为什么要使用绑定命名参数？任何一个事物的存在都是有其价值的，具体到绑定参数对于HQL查询来说，主要有以下两个主要优势：

　　①、 可以利用数据库实施性能优化，因为对Hibernate来说在底层使用的是PrepareStatement来完成查询，因此对于语法相同参数不同的SQL语句，可以充分利用预编译SQL语句缓存，从而提升查询效率。

　　②、 可以防止SQL Injection安全漏洞的产生：

　　SQL Injection是一种专门针对SQL语句拼装的攻击方式，比如对于我们常见的用户登录，在登录界面上，用户输入用户名和口令，这时登录验证程序可能会生成如下的HQL语句：

　　“from User user where user.name=’”+name+”’ and user.password=’”+password+”’ ”

　　这个HQL语句从逻辑上来说是没有任何问题的，这个登录验证功能在一般情况下也是会正确完成的，但是如果在登录时在用户名中输入”zhaoxin or ‘x’=’x”,这时如果使用简单的HQL语句的字符串拼装，就会生成如下的HQL语句：

　　“from User user where user.name=’zhaoxin’ or ‘x’=’x’ and user.password=’admin’ ”;

　　显然这条HQL语句的where字句将会永远为真，而使用户口令的作用失去意义，这就是SQL Injection攻击的基本原理。

　　而使用绑定参数方式，就可以妥善处理这问题,当使用绑定参数时，会得到下面的HQL语句：

　　from User user where user.name=’’zhaoxin’’ or ‘’x=’’x’’ ‘ and user.password=’admin’;由此可见使用绑定参数会将用户名中输入的单引号解析成字符串（如果想在字符串中包含单引号，应使用重复单引号形式），所以参数绑定能够有效防止SQL Injection安全漏洞。

HQL是完全面向对象的查询语言，因此可以支持继承和多态等特征。 
HQL查询依赖于Query类，每个Query实例对应一个查询对象，使用HQL查询按 
如下步骤进行： 
(1)获取Hibernate Session对象； 
(2)编写HQL语句； 
(3)以HQL语句作为参数，调用Session的createQuery方法创建查询对象； 
(4)如果HQL语句包含参数，调用Query的setXxx方法为参数赋值； 
(5)调用Query对象的list等方法遍历查询结果。 
查询示例： 
public class HqlQuery 
{ 
      public static void main(String[] args) throws Exception { 
         HqlQuery mgr = new HqlQuery(); 
         //调用查询方法 
         mgr.findPersons(); 
         //调用第二个查询方法 
         mgr.findPersonByHappenDate(); 
         HibernateUtil.sessionFactory.close(); 
     } 
     //第一个查询方法 
      private void findPersons() { 
         //获得Hibernate Session 
         Session sess = HibernateUtil.currentSession(); 
         //开始事务 
         Transaction tx = sess.beginTransaction(); 
         //以HQL语句创建Query对象 
         //执行setString方法为HQL语句的参数赋值 
         //Query调用list方法访问查询的全部实例 
         List p1 = sess.createQuery("from Person p where o.myEvents.title = : 
             eventTitle").setString("eventTitle", "很普通事情").list(); 
         //遍历查询的全部结果 
         for (Iterator pit = p1.iterator(); pit.haxNext(); ) 
          { 
             Person p = (Person)pit.next(); 
             System.out.println(p.getName()); 
         } 
         //提交事务 
         tx.commit(); 
         HibernateUtil.closeSession(); 
     } 
     //第二个查询方法 
      private void findPersonByHappenDate() throws Exception { 
         Session sess = HibernateUtil.currentSession(); 
         Transaction tx = sess.beginTransaction(); 
         //解析出Date对象 
         SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd"); 
         Date start = sdf.parse("2007-11-27"); 
         System.out.println("系统开始通过日期查找人" + start); 
         //通过Session的createQuery方法创建Query对象 
         //设置参数 
         //返回结果集 
         List pl = sess.createQuery( 
             "from Person p where p.myEvents.happenDate between :firstDate 
             and :endDate") 
                         .setDate("firstDate", start) 
                         .setDate("endDate", new Date()) 
                         .list(); 
         //遍历结果集 
         for (Iterator pit = pl.iterator(); pit.hasNext(); ) 
          { 
             Person p = (Person)pit.next(); 
             System.out.println(p.getName()); 
         } 
         tx.commit(); 
         HibernateUtil.closeSession(); 
     } 
}

$下面介绍HQL语句的语法 
1.from子句 
from Person 
表明从Person持久化类中选出全部的实例。 
推荐：from Person as p

2.select子句 
select p.name from Person as p 
select p.name.firstName from Person as p 
select new list(p.name, p.address) from Person as p 
select new ClassTest(p.name, p.address) from Person as p (有前提) 
select p.name as personName from Person as p 
select new map(p.name as personName) from Person as p (与new map()结合更普遍)

3.聚集函数 
avg,count,max,min,sum 
select count(*) from Person 
select max(p.age) from Person as p 
select p.name || "" || p.address from Person as p

4.多态查询 
from Person as p 
from java.lang.Object o 
from Named as n

5.where子句 
from Person where name like "tom%" 
from Person as p where p.name like "tom%" 
from Cat cat where cat.mate.name like "kit%" 
     select * from cat_table as table1 cat_table as table2 where table1.mate = 
     table2.id and table1.name like "kit%" 
from Foo foo where foo.bar.baz.customer.address.city like "fuzhou%" 
from Cat cat, Cat rival where cat.mate = rival.mate 
select cat, mate 
from Cat cat, Cat mate 
where cat.mate = mate 
from Cat as cat where cat.id = 123 
from Cat as cat where cat.mate.id = 69 
from Person as person 
where person.id.country = 'AU' 
     and person.id.medicareNumber = 123456 
from Account as account 
where account.owner.id.country = 'AU' 
     and account.owner.id.medicareNumber = 123456 
from Cat cat where cat.class = DomesticCat 
from Account as a where a.person.name.firstName like "dd%" // 正确 
from Account as a where a.person.name like "dd%" // 错误

6.表达式 
from DomesticCat cat where cat.name between 'A' and 'B' 
from DomesticCat cat where cat.name in ('Foo', 'Bar', 'Baz') 
from DomesticCat cat where cat.name not between 'A' and 'B' 
from DomesticCat cat where cat.name not in ('Foo', 'Bar', 'Baz') 
from DomesticCat cat where cat.name is null 
from Person as p where p.address is not null 
<property name="hibernate.query.substitutions">true 1, false 0</property> 
from Cat cat where cat.alive = true 
from Cat cat where cat.kittens.size > 0 
from Cat cat where size(cat.kittens) > 0 
from Calendar cal where maxelement(cal.holidays) > current date 
from Order order where maxindex(order.items) > 100 
from Order order where minelement(order.items) > 10000 
//操作集合元素 
select mother from Cat as mother, Cat as kit 
where kit in elements(foo.kittens) 
//p的name属性等于集合中某个元素的name属性 
select p from NameList list, Person p 
where p.name = some elements(list.names) 
//操作集合元素 
from Cat cat where exists elements(cat.kittens) 
from Player p where 3 > all elements(p.scores) 
from Show show where 'fizard' in indices(show.acts) 
//items是有序集合属性，items[0]代表第一个元素 
from Order order where order.items[0].id = 1234 
//holidays是map集合属性，holidays[national day]是代表其中第一个元素 
select person from Person person, Calendar calendar 
where calendar.holidays['national day'] = person.birthDay 
     and person.nationality.calendar = calendar 
//下面同时使用list集合和map集合属性 
select item from Item item, Order order 
where order.items[order.deliveredItemIndices[0]] = item and order.id = 11 
select item from Item item, Order order 
where order.items[maxindex(order.items)] = item and order.id = 11

select item from Item item, Order order 
where order.items[size(order.items) - 1] = item

select cust 
from Product prod, 
     Store store 
     inner join store.customers cust 
where prod.name = 'widget' 
     and store.location.name in ['Melbourne', 'Sydney'] 
     and prod = all elements(cust.currentOrder.lineItems)

SELECT cust.name, cust.address, cust.phone, cust.id, cust.current_order 
FROM customers cust, 
     stores store, 
     locations loc, 
     store_customers sc, 
     product prod 
WHERE prod.name = 'widget' 
     AND store.loc_id = loc.id 
     AND loc.name IN ('Melbourne', 'Sydney') 
     AND sc.store_id = store.id 
     AND sc.cust_id = cust.id 
     AND prod.id = ALL( 
         SELECT item.prod_id 
         FROM line_items item, orders o 
         WHERE item.order_id = o.id 
             AND cust.current_order = o.id 
     )

7.order by子句 
from Person as p 
order by p.name, p.age 
from Person as p 
order by p.name asc, p.age desc

8.group by子句 
select cat.color, sum(cat.weight), count(cat) 
from Cat cat 
group by cat.color 
//select后出现的id处出现在group by之后，而name属性则出现在聚集函数中 
select foo.id, avg(name), max(name) 
from Foo foo join foo.names name 
group by foo.id

select cat.color, sum(cat.weight), count(cat) 
from Cat cat 
group by cat.color 
having cat.color in (eg.Color.TABBY, eg.Color.BLACK)

select cat 
from Cat cat 
join cat.kittens kitten 
group by cat 
having avg(kitten.weight) > 100 
order by count(kitten) asc, sum(kitten.weight) desc

9.子查询 
from Cat as fatcat 
where fatcat.weight > (select avg(cat.weight) from DomesticCat cat)

from Cat as cat 
where not (cat.name, cat.color) in ( 
     select cat.name, cat.color from DomesticCat cat 
)

10.fetch关键字 
from Person as p join p.scores

from Document fetch all properties order by name 
from Document doc fetch all properties where lower(doc.name) like '%cat%'

11.命名查询 
<!--定义命名查询--> 
<query name="myNamedQuery"> 
     <!--此处确定命名查询的HQL语句--> 
     from Person as p where p.age > ? 
</query>

调用命名查询的示例代码如下： 
private void findByNamedQuery() throws Exception { 
     Session session = HibernateUtil.currentSession(); 
     Transaction tx = session.beginTransaction(); 
     System.out.println("执行命名查询"); 
     //调用命名查询 
     List pl = sess.getNamedQuery("myNamedQuery") 
                                     //为参数赋值 
                                     .setInteger(0, 20) 
                                     //返回全部结果 
                                     .list(); 
     //遍历结果集 
     for (Integer pit = pl.iterator(); pit.hasNext(); ) 
      { 
         Person p = (Person)pit.next(); 
         System.out.println(p.getName()); 
     } 
     tx.commit(); 
     HibernateUtil.closeSession(); 
}