shiwf — Sun, 24 Jan 2010 05:55:00 GMT

��h��看此blog: http://conkeyn.javaeye.com/category/35770

HQL: Hibernate查询语言

Hibernate配备了一�U�非常强大的查询语言�Q�这�U�语�a�看上��d��像SQL。但是不要被语法�l�构上的�怼�所�q�h��Q�HQL是非常有意识的被设计为完全面向对象的查询�Q�它可以理解如��ѝ��多�?和关联之�cȝ��概念�?/span>

1.大小写敏感性问�?/span>

除了Java�c�M��属性的名称外，查询语句对大��写�q�不敏感�?所�?SeLeCT �?sELEct 以及 SELECT 是相同的�Q�但�?org.hibernate.eg.FOO �q�不�{��h�?org.hibernate.eg.Foo �q�且 foo.barSet 也不�{��h�?foo.BARSET �?/span>

本手册中的HQL关键字将使用��写字母. 很多用户发现使用完全大写的关键字会��查询语句的可��L��更�? 但我们发玎ͼ�当把查询语句嵌入到Java语句中的时候��用大写关键字比较隄��?/span>

2.from子句

Hibernate中最��单的查询语句的�Ş式如下：

from eg.Cat

该子句简单的�q�回eg.Cat �cȝ��所有实例。通常我们不需要��用类的全限定�? 因�ؓ auto-import �Q�自动引入）是缺省的情况。所以我们几乎只使用如下的简单写法：

from Cat

大多数情况下, 你需要指定一�?span>别名 , 原因是你可能需�?在查询语句的其它部分引用�?tt>Cat

from Cat as cat

�q�个语句把别�?tt>cat 指定�l�类Cat 的实�? �q�样我们��可以在随后的查询中使用此别名了。关键字as 是可选的�Q�我们也可以�q�样�?

from Cat cat

子句中可以同时出现多个类, 其查询结果是产生一个笛卡儿�U�或产生跨表的连接�?/span>

from Formula, Parameter

from Formula as form, Parameter as param

查询语句中别名的开头部分小写被认�ؓ是实践中的好习惯�Q?�q�样做与Java变量的命名标准保持了一�?(比如�Q?tt>domesticCat )�?/span>

3.兌��(Association)与连�?Join)

我们也可以�ؓ相关联的实体甚至是对一个集合中的全部元素指定一个别�? �q�时要��用关键字join �?/span>

from Cat as cat
inner join cat.mate as mate
left outer join cat.kittens as kitten

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

from Formula form full join form.parameter param

受支持的�q�接�c�d��是从ANSI SQL中借鉴来的�?/span>

inner join �Q�内�q�接�Q?/span>
left outer join �Q�左外连接）
right outer join �Q�右外连接）
full join (全连接，�q�不常用)

语句inner join , left outer join 以及 right outer join 可以��写�?/span>

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

�q�有�Q�一�?fetch"�q�接允许仅仅使用一个选择语句��将相关联的对象或一�l�值的集合随着他们的父对象的初始化而被初始化，�q�种�Ҏ��在��用到集合的情况下��其有用�Q�对于关联和集合来说�Q�它有效的代替了映射文�g中的外联接与延迟声明�Q�lazy declarations�Q? 查看 �W?0.1�?“ 抓取�{�略(Fetching strategies) ” 以获得等多的信息�?/span>

from Cat as cat
inner join fetch cat.mate
left join fetch cat.kittens

一个fetch�q�接通常不需要被指定别名, 因�ؓ相关联的对象不应当被用在 where 子句 (或其它�Q何子�?中。同�Ӟ��相关联的对象�q�不在查询的�l�果中直接返回，但可以通过他们的父对象来访问到他们�?/span>

注意fetch 构造变量在使用�?tt>scroll() �?iterate() 函数的查询中是不能��用的。最后注意，使用full join fetch �?right join fetch 是没有意义的�?/span>

如果你��用属性��别的延迟获取�Q�lazy fetching�Q�（�q�是通过重新�~�写字节码实现的�Q�，可以使用 fetch all properties 来强制Hibernate立即取得那些原本需要�g�q�加载的属性（在第一个查询中�Q��?/span>

from Document fetch all properties order by name

from Document doc fetch all properties where lower(doc.name) like '%cats%'

4.select子句

select 子句选择��哪些对象与属性返回到查询�l�果集中. 考虑如下情况:

select mate
from Cat as cat
inner join cat.mate as mate

该语句将选择mate s of other Cat s。（其他猫的配偶�Q?实际�? 你可以更��z�的用以下的查询语句表达相同的含�?

select cat.mate from Cat cat

查询语句可以�q�回��gؓ��M��c�d��的属性，包括�q�回�c�d��为某�U�组�?Component)的属�?

select cat.name from DomesticCat cat
where cat.name like 'fri%'

select cust.name.firstName from Customer as cust

查询语句可以�q�回多个对象和（或）属性，存放�?Object[] 队列�?

select mother, offspr, mate.name
from DomesticCat as mother
inner join mother.mate as mate
left outer join mother.kittens as offspr

或存攑֜�一�?tt>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

也可能直接返回一个实际的�c�d��安全的Java对象,

select new Family(mother, mate, offspr)
from DomesticCat as mother
join mother.mate as mate
left join mother.kittens as offspr

假设�c?tt>Family 有一个合适的构造函�?

你可以��用关键字as �l?#8220;被选择了的表达�?#8221;指派别名:

select max(bodyWeight) as max, min(bodyWeight) as min, count(*) as n
from Cat cat

�q�种做法在与子句select new map 一起��用时最有用:

select new map( max(bodyWeight) as max, min(bodyWeight) as min, count(*) as n )
from Cat cat

该查询返回了一�?tt>Map 的对象，内容是别名与被选择的值组成的�?值映��?/span>

5.聚集函数

HQL查询甚至可以�q�回作用于属性之上的聚集函数的计��结�?

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

受支持的聚集函数如下�Q?/span>

avg(...), sum(...), min(...), max(...)
count(*)
count(...), count(distinct ...), count(all...)

你可以在选择子句中��用数学操作符、连接以及经�q�验证的SQL函数�Q?/span>

select cat.weight + sum(kitten.weight)
from Cat cat
join cat.kittens kitten
group by cat.id, cat.weight

select firstName||' '||initial||' '||upper(lastName) from Person

关键�?tt>distinct �?tt>all 也可以��用，它们��h��与SQL相同的语�?

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

6.多态查�?/span>

一个如下的查询语句:

from Cat as cat

不仅�q�回Cat �cȝ��实例, 也同时返回子�c?DomesticCat 的实�? Hibernate 可以�?tt>from 子句中指�?span>��M�� Java �c�L��接口. 查询会返回��承了该类的所有持久化子类的实例或�q�回声明了该接口的所有持久化�cȝ��实例。下面的查询语句�q�回所有的被持久化的对象：

from java.lang.Object o

接口Named 可能被各�U�各��L��持久化类声明�Q?/span>

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

注意�Q�最后的两个查询��需要超�q�一个的SQL SELECT .�q�表�?tt>order by 子句没有�Ҏ��个结果集�q�行正确的排�? (�q�也说明你不能对�q�样的查询��?tt>Query.scroll() �Ҏ��.)

7.where子句

where 子句允许你将�q�回的实例列表的范围�~�小. 如果没有指定别名�Q�你可以使用属性名来直接引用属�?

from Cat where name='Fritz'

如果指派了别名，需要��用完整的属性名:

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

�q�回名�ؓ�Q�属性name�{�于�Q?Fritz'�?tt>Cat �cȝ��实例�?/span>

select foo
from Foo foo, Bar bar
where foo.startDate = bar.date

��返回所有满��下面条件的Foo �cȝ��实例�Q�存在如下的bar 的一个实例，�?tt>date 属性等�?Foo �?tt>startDate 属性�?复合路径表达式��?tt>where 子句非常的强大，考虑如下情况�Q?/span>

from Cat cat where cat.mate.name is not null

该查询将被翻译成��Z��个含有表�q�接�Q�内�q�接�Q�的SQL查询。如果你打算写像�q�样的查询语�?/span>

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

在SQL中，你�ؓ达此目的��需要进行一个四表连接的查询�?/span>

= �q�算�W�不仅可以被用来比较属性的��|��也可以用来比较实例：

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

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

�Ҏ��属性（��写�Q?tt>id 可以用来表示一个对象的唯一的标识符。（你也可以使用该对象的属性名。）

from Cat as cat where cat.id = 123
from Cat as cat where cat.mate.id = 69

�W�二个查询是有效的。此时不需要进行表�q�接�Q?/span>

同样也可以��用复合标识符。比�?tt>Person �c�L��一个复合标识符�Q�它�?tt>country 属�?�?tt>medicareNumber 属性组成�?/span>

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

�W�二个查询也不需要进行表�q�接�?/span>

同样的，�Ҏ��属�?tt>class 在进行多态持久化的情况下被用来存取一个实例的鉴别��|��discriminator value�Q��?一个嵌入到where子句中的Java�cȝ��名字��被转换��cȝ��鉴别倹{�?/span>

from Cat cat where cat.class = DomesticCat

你也可以声明一个属性的�c�d��是组件或者复合用��L��型（以及��q��件构成的�l��g�{�等�Q�。永�q�不要尝试��用以�l��g�c�d��来结��路径表达式（path-expression_r�Q�（与此相反�Q�你应当使用�l��g的一个属性来�l�尾�Q��?举例来说�Q�如�?tt>store.owner 含有一个包含了�l��g的实�?tt>address

store.owner.address.city    // 正确
store.owner.address         // 错误!

一�?#8220;��L��”�c�d��有两个特�D�的属�?tt>id �?tt>class , 来允许我们按照下面的方式表达一个连接（AuditLog.item 是一个属性，该属性被映射�?tt> �Q��?/span>

from AuditLog log, Payment payment
where log.item.class = 'Payment' and log.item.id = payment.id

注意�Q�在上面的查询与句中�Q?tt>log.item.class �?payment.class ��涉及到完全不同的数据库中的列�?/span>

8.表达�?/span>

�?tt>where 子句中允�怋�用的表达式包括大多数你可以在SQL使用的表辑ּ��U�类:

数学�q�算�W?tt>+, -, *, /
二进制比较运��符=, >=, <=, <>, !=, like
逻辑�q�算�W?tt>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定义的�Q何函数或操作�Q?tt>substring(), trim(), lower(), upper(), length(), locate(), abs(), sqrt(), bit_length()
coalesce() �?nullif()
cast(... as ...) , 其第二个参数是某Hibernate�c�d��的名字，以及extract(... from ...) �Q�只要ANSI cast() �?extract() 被底层数据库支持
��M��数据库支持的SQL标量函数�Q�比�?tt>sign() , trunc() , rtrim() , sin()
JDBC参数传入 ?
命名参数:name , :start_date , :x1
SQL 直接帔R�� 'foo' , 69 , '1970-01-01 10:00:01.0'
Java public static final �c�d��的常�?eg.Color.TABBY

关键�?tt>in �?tt>between 可按如下�Ҏ��使用:

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

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

而且否定的格式也可以如下书写�Q?/span>

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

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

同样, 子句is null �?tt>is not null 可以被用来测试空�?null).

在Hibernate配置文�g中声明HQL“查询替代�Q�query substitutions�Q?#8221;之后�Q�布��表辑ּ��Q�Booleans�Q�可以在其他表达式中��L��的��?

true 1, false 0

�pȝ��该HQL转换为SQL语句�Ӟ��该设�|�表明将用字�W?1 �?0 �?取代关键�?tt>true �?false :

from Cat cat where cat.alive = true

你可以用�Ҏ��属�?tt>size , 或是�Ҏ��函数size() ��试一个集合的大小�?/span>

from Cat cat where cat.kittens.size > 0

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

对于索引了（有序�Q�的集合�Q�你可以使用minindex �?maxindex 函数来引用到最��与最大的索引序数。同理，你可以��?tt>minelement �?maxelement 函数来引用到一个基本数据类型的集合中最��与最大的元素�?/span>

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

在传递一个集合的索引集或者是元素�?elements �?tt>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)

注意�Q�在Hibernate3�U�，�q�些�l�构变量- size , elements , indices , minindex , maxindex , minelement , maxelement - 只能在where子句中��用�?/span>

一个被索引�q�的�Q�有序的�Q�集合的元素(arrays, lists, maps)可以在其他烦引中被引用（只能在where子句中）�Q?/span>

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

�?tt>[] 中的表达式甚臛_��以是一个算数表辑ּ��?/span>

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

对于一个一对多的关联（one-to-many association�Q�或是值的集合中的元素�Q?HQL也提供内建的index() 函数�Q?/span>

select item, index(item) from Order order
join order.items item
where index(item) < 5

如果底层数据库支持标量的SQL函数�Q�它们也可以被��?/span>

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

如果你还不能�Ҏ��有的�q�些�׃��不疑�Q�想想下面的查询。如果��用SQL�Q�语句长度会增长多少�Q�可��L��会下降多少�Q?/span>

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)

提示: 会像如下的语�?/span>

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
)

9.order by子句

查询�q�回的列�?list)可以按照一个返回的�c�L��l��g�Q�components)中的��M��属性（property�Q�进行排序：

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

可选的asc �?tt>desc 关键字指明了按照升序或降序进行排�?

10.group by子句

一个返回聚集�?aggregate values)的查询可以按照一个返回的�c�L��l��g�Q�components)中的��M��属性（property�Q�进行分�l�：

select cat.color, sum(cat.weight), count(cat)
from Cat cat
group by cat.color

select foo.id, avg(name), max(name)
from Foo foo join foo.names name
group by foo.id

having 子句在这里也允许使用.

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中��?�Q�SQL的一般函��C��聚集函数也可以出�?�?tt>having �?tt>order by 子句中�?/span>

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 子句中都不能包含��术表达式（arithmetic expression_rs�Q?

shiwf 2010-01-24 13:55 发表评论

99视频在线观看地址,欧美一区二区三区不卡,天堂精品中文字幕在线