Hibernate Query Language

本文翻译自Hibernate的文档第10章《Hibernate Query Language》。

 

       Hibernate拥有一种功能非常强大的查询语言，这种语言被有意得与SQL非常相似，便于开发人员掌握。但不要被HQL的语法表面所迷惑，HQL完全是面向对象的，可以用来过程多态、继承、关联等关系。

 

10.1大小写敏感（Case Sensitivity）

    HQL中的使用的Java的类名和属性名是大小写敏感的，其他的关键字都是大小写不敏感的。所以“ SeLeCT ”等同与“sELEct”，也等同于“SELECT”，因为它不是Java类名，也不是Java类的属性名。但Java类net.sf.hibernate.eg.FOO不等同于net.sf.hibernate.eg.Foo，同样foo.barSet也不等同于foo.BARSET。

    在本手册中，HQL中的关键字均采用小写，一些用户可能发现HQL的关键字采用大写更易读，但我们也发现，当把这些HQL嵌入Java代码中，看起来很丑陋。

10.2from从句（The from clause）

Hibernate中最简单的 from查询可能是：

from eg.Cat

只是简单的返回eg.Cat类的所有实例。

在很多时候你可能需要为类设置别名（alias），因为你可能需要在查询的其他部分引用Cat。

from eg.Cat as cat

关键字 as是可选的，我们也可以写成：

from eg.Cat cat

可以出现多个类，然后返回一个“笛卡儿积”或交叉连接：

from Formula as form, Parameter as param

HQL中的别名用小写字母是一个好习惯，符合 Java本地变量的命名规范。

10.3关联和连接（Associations and joins）

       我们使用别名关联实体、甚至用join来关联值的集合的元素。

from eg.Cat as cat

    inner join cat.mate as mate

    left outer join cat.kittens as kitten

 

from eg.Cat as cat left join cat.mate.kittens as kittens

 

from 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 eg.Cat as cat

    join cat.mate as mate

    left join cat.kittens as kitten

另外，一个“ fetch”连接允许使用单连接来关联或值的集合，使它们可以和父对象一起来初始化。这在使用Collection的情况下特别有用。

from eg.Cat as cat

    inner join fetch cat.mate

    left join fetch cat.kittens

    fetch join通常不需要设置别名，因为被关联的对象不应该被用在 where从句中，也不能用在其他的任何从句中。

    被关联的对象不能直接在查询结果中返回，他们可以通过父对象来访问。

请注意：在目前的实现中，在查询中只能返回一个集合。另外还要注意 ,fetch可能不用在被 scroll() 和iterator()调用的查询中。最后还要注意，full join fetch和right join fetch是没有意义的。

10.4 select从句（The select clause）

select从句用来挑选在结果集中返回的对象和属性：

select cat.mate from eg.Cat cat

上面这个查询返回所有猫的配偶。

你也可以使用 elements 函数返回集合的元素。下面的查询将返回任何猫（Cat）的所有小猫（Kitten）。

select elements(cat.kittens) from eg.Cat cat

查询也可以返回任何值类型（包括Component类型的属性）的属性：

select cat.name from eg.DomesticCat cat

where cat.name like 'fri%'

select cust.name.firstName from Customer as cust

查询可以返回多个对象，也可以返回作为 Object[]类型的数组的属性。

select mother, offspr, mate.name

from eg.DomesticCat as mother

    inner join mother.mate as mate

    left outer join mother.kittens as offspr

或者作为一个实际的 Java对象：

select new Family(mother, mate, offspr)

from eg.DomesticCat as mother

    join mother.mate as mate

   left join mother.kittens as offspr

上面的这个查询语句假设 Family 类有适当的构造函数。

10.5 聚集函数（Aggregate functions）

查询可以使用属性的聚集函数：

select avg(cat.weight), sum(cat.weight), max(cat.weight), count(cat) from eg.Cat cat

select从句的聚集函数中可以出现集合：

select cat, count( elements(cat.kittens) )  from eg.Cat cat group by cat

支持的聚集函数有：

·                                  avg(...), sum(...), min(...), max(...)

·                                  count(*)

·                                  count(...), count(distinct ...), count(all...)

distinct 和 all 关键字的意义与用法和SQL中相同：

select distinct cat.name from eg.Cat cat

 

select count(distinct cat.name), count(cat) from eg.Cat cat

 

10.6 多态（polymorphism）

       一个查询： from eg.Cat as cat，它返回的不只是 Cat，也有 DomesticCat （家猫）这样的子类。 Hibernate可以在from从句中指定任何Java类和接口，查询将返回继承自该类和实现了该接口的所有的持久类的实例。下面的查询将返回所有持久的对象：

from java.lang.Object o

       指定的接口可以被多个不同的持久类实现：

from eg.Named n, eg.Named m where n.name = m.name

注意最后2个查询将需要超过1个SQL的select，这意味着不能够按照从句指定的排列次序排列整个结果集。这也意味着你不能用 Query.scroll()来调用这些查询。

10.7 where从句（The where clause）

       where从句是你可以按照自己指定的条件更精确的返回实例：

from eg.Cat as cat where cat.name='Fritz'

复合表达式使where从句功能非常强大：

from eg.Cat as cat where cat.name='Fritz' 

这个查询将被翻译成带有一个连接的SQL查询语句。

       如果你写下这句查询：

       from eg.Foo foo where foo.bar.baz.customer.address.city is not null

这个查询翻译成SQL语句需要4个表连接。

       “=”操作符不仅可以比较属性，也可以比较实例：

from eg.Cat cat, eg.Cat rival where cat.mate = rival.mate

 

select cat, mate  from eg.Cat cat, eg.Cat mate where cat.mate = mate

 

一个叫id的特殊的属性被用来引用一个对象的唯一标识符，你也可以用对象的属性名。

from eg.Cat as cat where cat.id = 123

 

from eg.Cat as cat where cat.mate.id = 69 这个查询要比上一个有效率，因为不需要表连接。

可以使用复合主键的属性。假设 person有一个由 medicareNumber和 country构成的符合主键：

from bank.Person person

where person.id.country = 'AU'

    and person.id.medicareNumber = 123456

 

from bank.Account account

where account.owner.id.country = 'AU'

    and account.owner.id.medicareNumber = 123456

再重复一次，第二个查询效率高些。

 

同样，一个指定了属性的类在多态持久（polymorphic persistence）的情况下访问实体的discriminator value。

一个被嵌入到 where从句中的Java类名将被翻译成它的discriminator value。

from eg.Cat cat where cat.class = eg.DomesticCat

你也可以指定组件（ component）的属性和用户自己定义的合成类型（及组件的组件等等）。

永远也不要使用一个以组件的属性结尾的路径表达式。举个例子，假设 store.owner 是一个带有一个叫address组件的实体：

store.owner.address.city    //正确

store.owner.address        // 错误 !

一个叫“ any”的类型有2个特别的属性，一个是id，另一个是class，它允许我们用下面的办法进行连接（join）。 AuditLog.item 是一个用<any>映射的属性：

from eg.AuditLog log, eg.Payment payment

where log.item.class = 'eg.Payment' and log.item.id = payment.id

需要注意的是：查询中的 log.item.class 和payment.class将参考完全不同的数据库列。

10.8 表达式（Expressions）

       where从句中的表达式允许你使用SQL中的很多东西：

·                                  数学运算符： +, -, *, /

·                                  二元比较运算符： =, >=, <=, <>, !=, like

·                                  逻辑操作符： and, or, not

·                                  字符串连接符： ||

·                                  SQL函数，如： upper() and lower()

·                                  圆括号： ( )  

·                                  in , between , is null

·                                  JDBC输入参数： ?

·                                 指定的参数： :name , :start_date , :x1

·                                 in 和 between ：

from eg.DomesticCat cat where cat.name between 'A' and 'B'

 

from eg.DomesticCat cat where cat.name in ( 'Foo', 'Bar', 'Baz' )

和否定形式的（negated forms）：

from eg.DomesticCat cat where cat.name not between 'A' and 'B'

 

from eg.DomesticCat cat where cat.name not in ( 'Foo', 'Bar', 'Baz' )

·                                 is null 和 is not null

·                                 也可以使用特殊的属性size或size()函数来测试集合的大小：

from eg.Cat cat where cat.kittens.size > 0

 

from eg.Cat cat where size(cat.kittens) > 0

·                                  对于有索引的集合，你可以使用特殊属性 minIndex 和maxIndex来引用最小索引和最大索引。同样，你也可以使用minElement和maxElement来引用基本类型的集合的 minimum 和maximum元素。

from Calendar cal where cal.holidays.maxElement > current date

也可以是函数的形式：

from Order order where maxindex(order.items) > 100

 

from Order order where minelement(order .items) > 10000

在传递索引和元素给集合时（elements and indices 函数）和传递子查询的结果集时，SQL函数 any, some, all, exists, in 都是被支持的：

select mother from eg.Cat as mother, eg.Cat as kit

where kit in elements(foo.kittens)

 

select p from eg.NameList list, eg.Person p

where p.name = some elements(list.names)

 

from eg.Cat cat where exists elements(cat.kittens)

 

from eg.Player p where 3 > all elements(p.scores)

 

from eg.Show show where 'fizard' in indices(show.acts)

 

请注意： size, elements, indices, minIndex, maxIndex, minElement, maxElement 在使用时有一些限制：

v       where从句中的 in只用于数据库的子查询。

v       select从句中的 in只用于 elements 和 indices 函数。

v       带有索引的元素的collection（arrays, lists, maps）只能在where从句中通过索引引用：

from Order order where order.items[0].id = 1234

 

select person from Person person, Calendar calendar

where calendar.holidays['national day'] = person.birthDay

   and person.nationality.calendar = calendar

 

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

HQL为one-to-many关联和值的集合提供了内置的index()函数：

select item, index(item) from Order order

    join order.items item

where index(item) < 5

被一些特定数据库支持的SQL函数可以被使用：

from eg.DomesticCat cat where upper(cat.name) like 'FRI%'

如果你还不相信上面的一切，那么想想更长的和更短的可读的查询吧：

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)

提示：something like

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）

 

10.9 order by从句（The order by clause）

查询返回的列表可以使用组件或类的任意属性排序：

from eg.DomesticCat cat

order by cat.name asc, cat.weight desc, cat.birthdate

关键字asc和 desc 是可选的，分别决定是按升序还是降序排列结果。

10.10 group by从句（The group by clause）

       查询返回的聚集可以按照指定的类或组件的任意属性进行分组：

select cat.color, sum(cat.weight), count(cat)

from eg.Cat cat

group by cat.color

 

select foo.id, avg( elements(foo.names) ), max( indices(foo.names) )

from eg.Foo foo

group by foo.id

注意：你可以在select从句中使用 elements和 indices 结构，即使数据库中没有子查询。

    Having 从句也允许使用：

select cat.color, sum(cat.weight), count(cat)

from eg.Cat cat

group by cat.color

having cat.color in (eg.Color.TABBY, eg.Color.BLACK)

如果你的数据库支持，则你可以在having和order by从句中使用SQL函数（ie：MySQL中不支持）：

select cat from eg.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 clause nor the order by 都不支持算术表达式。

 

10.11 子查询（Subqueries）

       Hibernate支持子查询，子查询必须用圆括号包围。子查询通常被SQL聚集函数调用。子查询中引用一个外部查询的别名也是被允许的。

from eg.Cat as fatcat

where fatcat.weight > (

    select avg(cat.weight) from eg.DomesticCat cat

)

 

from eg.DomesticCat as cat

where cat.name = some (

    select name.nickName from eg.Name as name

)

 

from eg.Cat as cat

where not exists (

    from eg.Cat as mate where mate.mate = cat

)

 

from eg.DomesticCat as cat

where cat.name not in (

    select name.nickName from eg.Name as name

       )

10.12 例子（Examples）

       Hibernate的查询功能相当强大，而且复杂。事实上，功能强大的查询语言是Hibernate的主要的卖点（selling points。原来这是一个外来词呀，今天才知道。^_^）。

       下面是一些简单的查询例子，这是从我最近的项目中挑出来的，在大多数情况下，你写的查询要比这些更简单。

       下面这个查询使用到的表： order , order_line , product , catalog 和 price 。有4个内连接和一个没有关系（ uncorrelated ）的子查询。

select order.id, sum(price.amount), count(item)

from Order as order

    join order.lineItems as item

    join item.product as product,

    Catalog as catalog

    join catalog.prices as price

where order.paid = false

    and order.customer = :customer

    and price.product = product

    and catalog.effectiveDate < sysdate

    and catalog.effectiveDate >= all (

        select cat.effectiveDate 

        from Catalog as cat

        where cat.effectiveDate < sysdate

    )

group by order

having sum(price.amount) > :minAmount

order by sum(price.amount) desc

简直是怪物！（What a monster!）。现实生活中（in real life），我们对子查询并不是很关心，我们大多数的查询更像下面这样：

select order.id, sum(price.amount), count(item)

from Order as order

    join order.lineItems as item

    join item.product as product,

    Catalog as catalog

    join catalog.prices as price

where order.paid = false

    and order.customer = :customer

    and price.product = product

    and catalog = :currentCatalog

group by order

having sum(price.amount) > :minAmount

order by sum(price.amount) desc

下面这个 查询翻译成SQL将需要2个内连接和一个相关联的子查询。它用到的表： payment , payment_status 和 payment_status_change 。

select count(payment), status.name 

from Payment as payment 

    join payment.currentStatus as status

    join payment.statusChanges as statusChange

where payment.status.name <> PaymentStatus.AWAITING_APPROVAL

    or (

        statusChange.timeStamp = ( 

            select max(change.timeStamp) 

            from PaymentStatusChange change 

            where change.payment = payment

        )

        and statusChange.user <> :currentUser

    )

group by status.name, status.sortOrder

order by status.sortOrder

       如果我映射 tatusChanges 为一个List代替set，那个我们的查询将更简单：

select count(payment), status.name 

from Payment as payment

    join payment.currentStatus as status

where payment.status.name <> PaymentStatus.AWAITING_APPROVAL

    or payment.statusChanges[ maxIndex(payment.statusChanges) ].user <> :currentUser

group by status.name, status.sortOrder

order by status.sortOrder

    下面这个查询用到MS SQL的isnull（）函数，用到3个内连接和1个外联接，用大的表： account , payment , payment_status , account_type , organization 和 org_user 。

select account, payment

from Account as account

    left outer join account.payments as payment

where :currentUser in elements(account.holder.users)

    and PaymentStatus.UNPAID = isNull(payment.currentStatus.name, PaymentStatus.UNPAID)

order by account.type.sortOrder, account.accountNumber, payment.dueDate

       对于其他的数据库，我们需要使用关联的子查询：

select account, payment

from Account as account

    join account.holder.users as user

    left outer join account.payments as payment

where :currentUser = user

    and PaymentStatus.UNPAID = isNull(payment.currentStatus.name, PaymentStatus.UNPAID)

order by account.type.sortOrder, account.accountNumber, payment.dueDate

10.13 提示和窍门

       你可以不用真正的返回查询结果，而知道查询结果的数量：

( (Integer) session.iterate("select count(*) from ....").next() ).intValue()

       按照返回的集合的大小排序，可以使用下面的语句：

select usr.id, usr.name from User as usr

left join usr.messages as msg

group by usr.id, usr.name

order by count(msg)

如果你的数据库支持子查询，那么你可以在where从句中指定一个查询返回结果尺寸的条件：

from User usr where size(usr.messages) >= 1

如果你的数据库不支持子出查询，那么你可以使用相面的查询：

select usr.id, usr.name

from User usr.name

    join usr.messages msg

group by usr.id, usr.name having count(msg) >= 1

上面这个办法因为使用了内连接不能返回拥有0个消息的用户的信息，下面这个查询是有用的：

select usr.id, usr.name

from User as usr

    left join usr.messages as msg

group by usr.id, usr.name

having count(msg) = 0

JavaBean的属性可以作为查询的指定参数被绑定：

Query q = s.createQuery("from foo in class Foo where foo.name=:name and foo.size=:size");

q.setProperties(fooBean); // fooBean has getName() and getSize()

List foos = q.list();

集合可以通过使用带有过滤器的Query接口实现分页（pageable）功能：

Query q = s.createFilter( collection, "" ); // the trivial filter

q.setMaxResults(PAGE_SIZE);

q.setFirstResult(PAGE_SIZE * pageNumber);

List page = q.list();

使用查询过滤器，可以实现集合元素的排序和分组：

Collection orderedCollection = s.filter( collection, "order by this.amount" );

Collection counts = s.filter( collection, "select this.type, count(this) group by this.type" );

你可以不用对集合进行初始化，就可以得到它的大小：

( (Integer) session.iterate("select count(*) from ....").next() ).intValue();