HQL: Hibernate查询语言
Hibernate配备了一种非常强大的查询语言，这种语言看上去很像SQL。但是不要被语法结构 上的相似所迷惑，HQL是非常有意识的被设计为完全面向对象的查询，它可以理解如继承、多态 和关联之类的概念。
除了Java类与属性的名称外，查询语句对大小写并不敏感。 所以 SeLeCT 与 sELEct 以及 SELECT 是相同的，但是 org.hibernate.eg.FOO 并不等价于 org.hibernate.eg.Foo 并且 foo.barSet 也不等价于 foo.BARSET
本手册中的HQL关键字将使用小写字母. 很多用户发现使用完全大写的关键字会使查询语句 的可读性更强, 但我们发现，当把查询语句嵌入到Java语句中的时候使用大写关键字比较难看。
Hibernate中最简单的查询语句的形式如下：
from eg.Cat该子句简单的返回eg.Cat 类的所有实例。 通常我们不需要使用类的全限定名, 因为 auto-import
from Cat大多数情况下, 你需要指定一个别名 , 原因是你可能需要 在查询语句的其它部分引用到Cat
from Cat as cat这个语句把别名cat 指定给类Cat 的实例, 这样我们就可以在随后的查询中使用此别名了。 关键字as
from Cat cat子句中可以同时出现多个类, 其查询结果是产生一个笛卡儿积或产生跨表的连接。
from Formula, Parameterfrom Formula as form, Parameter as param查询语句中别名的开头部分小写被认为是实践中的好习惯， 这样做与Java变量的命名标准保持了一致 (比如，domesticCat
我们也可以为相关联的实体甚至是对一个集合中的全部元素指定一个别名, 这时要使用关键字join
from Cat as cat
inner join cat.mate as mate
left outer join cat.kittens as kittenfrom Cat as cat left join cat.mate.kittens as kittensfrom Formula form full join form.parameter param受支持的连接类型是从ANSI SQL中借鉴来的。
- inner join
- left outer join
- right outer join
- full join
语句inner join , left outer join 以及 right outer join
from Cat as cat
join cat.mate as mate
left join cat.kittens as kitten还有，一个"fetch"连接允许仅仅使用一个选择语句就将相关联的对象或一组值的集合随着他们的父对象的初始化而被初始化，这种方法在使用到集合的情况下尤其有用，对于关联和集合来说，它有效的代替了映射文件中的外联接 与延迟声明（lazy declarations）. 查看 第20.1节 “ 抓取策略(Fetching strategies) ” 以获得等多的信息。
from Cat as cat
inner join fetch cat.mate
left join fetch cat.kittens一个fetch连接通常不需要被指定别名, 因为相关联的对象不应当被用在 where
注意fetch 构造变量在使用了scroll() 或 iterate() 函数 的查询中是不能使用的。最后注意，使用full join fetch 与 right join fetch
如果你使用属性级别的延迟获取（lazy fetching）（这是通过重新编写字节码实现的），可以使用 fetch all properties
from Document fetch all properties order by namefrom Document doc fetch all properties where lower(doc.name) like '%cats%'
select
select mate
from Cat as cat
inner join cat.mate as mate该语句将选择mate s of other Cat
select cat.mate from Cat cat查询语句可以返回值为任何类型的属性，包括返回类型为某种组件(Component)的属性:
select cat.name from DomesticCat cat
where cat.name like 'fri%'select cust.name.firstName from Customer as cust查询语句可以返回多个对象和（或）属性，存放在 Object[]
select mother, offspr, mate.name
from DomesticCat as mother
inner join mother.mate as mate
left outer join mother.kittens as offspr或存放在一个List
select new list(mother, offspr, mate.name)
from DomesticCat as mother
inner join mother.mate as mate
left outer join mother.kittens as offspr也可能直接返回一个实际的类型安全的Java对象,
select new Family(mother, mate, offspr)
from DomesticCat as mother
join mother.mate as mate
left join mother.kittens as offspr假设类Family
你可以使用关键字as
select max(bodyWeight) as max, min(bodyWeight) as min, count(*) as n
from Cat cat这种做法在与子句select new map
select new map( max(bodyWeight) as max, min(bodyWeight) as min, count(*) as n )
from Cat cat该查询返回了一个Map
HQL查询甚至可以返回作用于属性之上的聚集函数的计算结果:
select avg(cat.weight), sum(cat.weight), max(cat.weight), count(cat)
from Cat cat受支持的聚集函数如下：
- avg(...), sum(...), min(...), max(...)
- count(*)
- count(...), count(distinct ...), count(all...)
你可以在选择子句中使用数学操作符、连接以及经过验证的SQL函数：
select cat.weight + sum(kitten.weight)
from Cat cat
join cat.kittens kitten
group by cat.id, cat.weightselect firstName||' '||initial||' '||upper(lastName) from Person关键字distinct 与all
select distinct cat.name from Cat cat
select count(distinct cat.name), count(cat) from Cat cat
一个如下的查询语句:
from Cat as cat不仅返回Cat 类的实例, 也同时返回子类 DomesticCat 的实例. Hibernate 可以在from 子句中指定任何 Java 类或接口. 查询会返回继承了该类的所有持久化子类 的实例或返回声明了该接口的所有持久化类的实例。下面的查询语句返回所有的被持久化的对象：
from java.lang.Object o接口Named
from Named n, Named m where n.name = m.name注意，最后的两个查询将需要超过一个的SQL SELECT .这表明order by 子句 没有对整个结果集进行正确的排序. (这也说明你不能对这样的查询使用Query.scroll()
where
from Cat where name='Fritz'如果指派了别名，需要使用完整的属性名:
from Cat as cat where cat.name='Fritz'返回名为（属性name等于）'Fritz'的Cat
select foo
from Foo foo, Bar bar
where foo.startDate = bar.date将返回所有满足下面条件的Foo 类的实例： 存在如下的bar 的一个实例，其date 属性等于 Foo 的startDate 属性。 复合路径表达式使得where
from Cat cat where cat.mate.name is not null该查询将被翻译成为一个含有表连接（内连接）的SQL查询。如果你打算写像这样的查询语句
from Foo foo
where foo.bar.baz.customer.address.city is not null在SQL中，你为达此目的将需要进行一个四表连接的查询。
=
from Cat cat, Cat rival where cat.mate = rival.mateselect cat, mate
from Cat cat, Cat mate
where cat.mate = mate特殊属性（小写）id
from Cat as cat where cat.id = 123
from Cat as cat where cat.mate.id = 69第二个查询是有效的。此时不需要进行表连接！
同样也可以使用复合标识符。比如Person 类有一个复合标识符，它由country 属性 与medicareNumber
from bank.Person person
where person.id.country = 'AU'
and person.id.medicareNumber = 123456from bank.Account account
where account.owner.id.country = 'AU'
and account.owner.id.medicareNumber = 123456第二个查询也不需要进行表连接。
同样的，特殊属性class
from Cat cat where cat.class = DomesticCatstore.owner 含有一个包含了组件的实体address
store.owner.address.city // 正确
store.owner.address // 错误!一个“任意”类型有两个特殊的属性id 和class , 来允许我们按照下面的方式表达一个连接（AuditLog.item 是一个属性，该属性被映射为<any>
from AuditLog log, Payment payment
where log.item.class = 'Payment' and log.item.id = payment.id注意，在上面的查询与句中，log.item.class 和 payment.class
在where
• 数学运算符+, -, *, /
• 二进制比较运算符=, >=, <=, <>, !=, like
• 逻辑运算符and, or, not
• in , not in , between , is null , is not null , is empty , is not empty , member of and not member of
• "简单的" case, case ... when ... then ... else ... end ,和 "搜索" case, case when ... then ... else ... end
• 字符串连接符...||... or concat(...,...)
• current_date() , current_time() , current_timestamp()
• second(...) , minute(...) , hour(...) , day(...) , month(...) , year(...)
• EJB-QL 3.0定义的任何函数或操作：substring(), trim(), lower(), upper(), length(), locate(), abs(), sqrt(), bit_length()
• coalesce() 和 nullif()
• cast(... as ...) , 其第二个参数是某Hibernate类型的名字，以及extract(... from ...) ，只要ANSI cast() 和 extract()
• 任何数据库支持的SQL标量函数，比如sign() , trunc() , rtrim() , sin()
• JDBC参数传入 ?
• 命名参数:name , :start_date , :x1
• SQL 直接常量 'foo' , 69 , '1970-01-01 10:00:01.0'
• Java public static final 类型的常量 eg.Color.TABBY
关键字in 与between
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' )同样, 子句is null 与is not null
在Hibernate配置文件中声明HQL“查询替代（query substitutions）”之后， 布尔表达式（Booleans）可以在其他表达式中轻松的使用:
<property name="hibernate.query.substitutions">true 1, false 0</property>系统将该HQL转换为SQL语句时，该设置表明将用字符 1 和 0 来 取代关键字true 和 false
from Cat cat where cat.alive = true你可以用特殊属性size , 或是特殊函数size()
from Cat cat where cat.kittens.size > 0from Cat cat where size(cat.kittens) > 0对于索引了（有序）的集合，你可以使用minindex 与 maxindex 函数来引用到最小与最大的索引序数。 同理，你可以使用minelement 与 maxelement
from Calendar cal where maxelement(cal.holidays) > current datefrom Order order where maxindex(order.items) > 100from Order order where minelement(order.items) > 10000在传递一个集合的索引集或者是元素集(elements 与indices 函数) 或者传递一个子查询的结果的时候，可以使用SQL函数any, some, all, exists, in
select mother from Cat as mother, Cat as kit
where kit in elements(foo.kittens)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)注意，在Hibernate3种，这些结构变量- size , elements , indices , minindex , maxindex , minelement , maxelement
一个被索引过的（有序的）集合的元素(arrays, lists, maps)可以在其他索引中被引用（只能在where子句中）：
from Order order where order.items[0].id = 1234select person from Person person, Calendar calendar
where calendar.holidays['national day'] = person.birthDay
and person.nationality.calendar = calendarselect item from Item item, Order order
where order.items[ order.deliveredItemIndices[0] ] = item and order.id = 11select 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对于一个一对多的关联（one-to-many association）或是值的集合中的元素， HQL也提供内建的index()
select item, index(item) from Order order
join order.items item
where index(item) < 5如果底层数据库支持标量的SQL函数，它们也可以被使用
from DomesticCat cat where upper(cat.name) like 'FRI%'如果你还不能对所有的这些深信不疑，想想下面的查询。如果使用SQL，语句长度会增长多少，可读性会下降多少：
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
)
查询返回的列表(list)可以按照一个返回的类或组件（components)中的任何属性（property）进行排序：
from DomesticCat cat
order by cat.name asc, cat.weight desc, cat.birthdate可选的asc 或desc
一个返回聚集值(aggregate values)的查询可以按照一个返回的类或组件（components)中的任何属性（property）进行分组：
select cat.color, sum(cat.weight), count(cat)
from Cat cat
group by cat.colorselect foo.id, avg(name), max(name)
from Foo foo join foo.names name
group by foo.idhaving
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)如果底层的数据库支持的话(例如不能在MySQL中使用)，SQL的一般函数与聚集函数也可以出现 在having 与order by
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注意group by 子句与 order by
