hibernate 查詢語句

第 15 章 HQL: Hibernate查詢語言 Hibernate配備了一種非常強大的查詢語言，這種語言看上去很像SQL。但是不要被語法結構上的相似所迷惑，HQL是非常有意識的被設計爲完全面向對象的查詢，它可以理解如繼承、多態和關聯之類的概念。

15.1. 大小寫敏感性問題
除了Java類與屬性的名稱外，查詢語句對大小寫並不敏感。所以 SeLeCT 與 sELEct 以及 SELECT 是相同的，但是 org.hibernate.eg.FOO 並不等價於 org.hibernate.eg.Foo 並且 foo.barSet 也不等價於 foo.BARSET。
本手冊中的HQL關鍵字將使用小寫字母. 很多用戶發現使用完全大寫的關鍵字會使查詢語句的可讀性更強, 但我們發現，當把查詢語句嵌入到Java語句中的時候使用大寫關鍵字比較難看。

15.2. from子句
Hibernate中最簡單的查詢語句的形式如下：

代碼內容
from eg.Cat
該子句簡單的返回eg.Cat類的所有實例。通常我們不需要使用類的全限定名, 因爲 auto-import（自動引入）是缺省的情況。所以我們幾乎只使用如下的簡單寫法：
代碼內容
from Cat
大多數情況下, 你需要指定一個別名, 原因是你可能需要在查詢語句的其它部分引用到Cat
代碼內容
from Cat as cat
這個語句把別名cat指定給類Cat 的實例, 這樣我們就可以在隨後的查詢中使用此別名了。關鍵字as 是可選的，我們也可以這樣寫:
代碼內容
from Cat cat
子句中可以同時出現多個類, 其查詢結果是產生一個笛卡兒積或產生跨表的連接。
from Formula, Parameter
from Formula as form, Parameter as param
查詢語句中別名的開頭部分小寫被認爲是實踐中的好習慣，這樣做與Java變量的命名標準保持了一致 (比如，domesticCat)。

15.3. 關聯(Association)與連接(Join)
我們也可以爲相關聯的實體甚至是對一個集合中的全部元素指定一個別名, 這時要使用關鍵字join。

代碼內容
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
受支持的連接類型是從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 來強制Hibernate立即取得那些原本需要延遲加載的屬性（在第一個查詢中）。
代碼內容
from Document fetch all properties order by name
from Document doc fetch all properties where lower(doc.name) like ’%cats%’
同的語義.
代碼內容
select distinct cat.name from Cat cat
select count(distinct cat.name), count(cat) from Cat cat

15.6. 多態查詢
一個如下的查詢語句:
代碼內容
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()方法.)

15.7. where子句
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子句非常的強大，考慮如下情況：
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.mate
select 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 = 123456
from bank.Account account
where account.owner.id.country = ’AU’
    and account.owner.id.medicareNumber = 123456
第二個查詢也不需要進行表連接。
同樣的，特殊屬性class在進行多態持久化的情況下被用來存取一個實例的鑑別值（discriminator value）。一個嵌入到where子句中的Java類的名字將被轉換爲該類的鑑別值。
代碼內容
from Cat cat where cat.class = DomesticCat
你也可以聲明一個屬性的類型是組件或者複合用戶類型（以及由組件構成的組件等等）。永遠不要嘗試使用以組件類型來結尾的路徑表達式（path- expression）（與此相反，你應當使用組件的一個屬性來結尾）。舉例來說，如果store.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 將涉及到完全不同的數據庫中的列。
15.8. 表達式
在where子句中允許使用的表達式包括大多數你可以在SQL使用的表達式種類:
數學運算符+, -, *, /
二進制比較運算符=, >=, <=, <>, !=, 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可以被用來測試空值(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 > 0
from Cat cat where size(cat.kittens) > 0
對於索引了（有序）的集合，你可以使用minindex 與 maxindex函數來引用到最小與最大的索引序數。同理，你可以使用minelement 與 maxelement函數來引用到一個基本數據類型的集合中最小與最大的元素。
代碼內容
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與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 - 只能在where子句中使用。
一個被索引過的（有序的）集合的元素(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
對於一個一對多的關聯（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
    )
15.9. order by子句
查詢返回的列表(list)可以按照一個返回的類或組件（components)中的任何屬性（property）進行排序：
代碼內容
from DomesticCat cat
order by cat.name asc, cat.weight desc, cat.birthdate
可選的asc或desc關鍵字指明瞭按照升序或降序進行排序.

15.10. group by子句
一個返回聚集值(aggregate values)的查詢可以按照一個返回的類或組件（components)中的任何屬性（property）進行分組：
代碼內容
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中使用)，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子句中都不能包含算術表達式（arithmetic expressions）.
15.11. 子查詢
對於支持子查詢的數據庫，Hibernate支持在查詢中使用子查詢。一個子查詢必須被圓括號包圍起來（經常是SQL聚集函數的圓括號）。甚至相互關聯的子查詢（引用到外部查詢中的別名的子查詢）也是允許的。
代碼內容
from Cat as fatcat
where fatcat.weight > (
    select avg(cat.weight) from DomesticCat cat
)
from DomesticCat as cat
where cat.name = some (
    select name.nickName from Name as name
)
from Cat as cat
where not exists (
    from Cat as mate where mate.mate = cat
)
from DomesticCat as cat
where cat.name not in (
    select name.nickName from Name as name
) 在select列表中包含一個表達式以上的子查詢，你可以使用一個元組構造符（tuple constructors）：
代碼內容
from Cat as cat
where not ( cat.name, cat.color ) in (
    select cat.name, cat.color from DomesticCat cat
) 注意在某些數據庫中（不包括Oracle與HSQL），你也可以在其他語境中使用元組構造符，比如查詢用戶類型的組件與組合：
代碼內容
from Person where name = (’Gavin’, ’A’, ’King’)
該查詢等價於更復雜的：
代碼內容
from Person where name.first = ’Gavin’ and name.initial = ’A’ and name.last = ’King’)
有兩個很好的理由使你不應當作這樣的事情：首先，它不完全適用於各個數據庫平臺；其次，查詢現在依賴於映射文件中屬性的順序。
15.12. HQL示例
Hibernate查詢可以非常的強大與複雜。實際上，Hibernate的一個主要賣點就是查詢語句的威力。這裏有一些例子，它們與我在最近的一個項目中使用的查詢非常相似。注意你能用到的大多數查詢比這些要簡單的多！
下面的查詢對於某個特定的客戶的所有未支付的賬單，在給定給最小總價值的情況下，返回訂單的id，條目的數量和總價值，返回值按照總價值的結果進行排序。爲了決定價格，查詢使用了當前目錄。作爲轉換結果的SQL查詢，使用了ORDER, ORDER_LINE, PRODUCT, CATALOG 和 PRICE 庫表。
代碼內容
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
這簡直是一個怪物！實際上，在現實生活中，我並不熱衷於子查詢，所以我的查詢語句看起來更像這個：
代碼內容
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 下面一個查詢計算每一種狀態下的支付的數目，除去所有處於AWAITING_APPROVAL狀態的支付，因爲在該狀態下當前的用戶作出了狀態的最新改變。該查詢被轉換成含有兩個內連接以及一個相關聯的子選擇的SQL查詢，該查詢使用了表 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 如果我把statusChanges實例集映射爲一個列表（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 Server的 isNull()函數用以返回當前用戶所屬組織的組織帳號及組織未支付的賬。它被轉換成一個對錶 ACCOUNT, PAYMENT, PAYMENT_STATUS, ACCOUNT_TYPE, ORGANIZATION 以及 ORG_USER 進行的三個內連接，一個外連接和一個子選擇的SQL查詢。
代碼內容
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 15.13. 批量的UPDATE & DELETE語句
HQL現在支持UPDATE與DELETE語句. 查閱第 14.3 節 “大批量更新/刪除（Bulk update/delete）” 以獲得更多信息。
15.14. 小技巧 & 小竅門
你可以統計查詢結果的數目而不必實際的返回他們：
( (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子句中爲選擇的大小（selection size）指定一個條件:
代碼內容
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 因爲內連接（inner join）的原因，這個解決方案不能返回含有零個信息的User 類的實例, 所以這種情況下使用下面的格式將是有幫助的:
代碼內容
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的屬性可以被綁定到一個命名查詢（named query）的參數上：
代碼內容
Query q = s.createQuery("from foo Foo as foo where foo.name=:name and foo.size=:size");
q.setProperties(fooBean); // fooBean包含方法getName()與getSize()
List foos = q.list();
通過將接口Query與一個過濾器（filter）一起使用，集合（Collections）是可以分頁的：
代碼內容
Query q = s.createFilter( collection, "" ); // 一個簡單的過濾器
q.setMaxResults(PAGE_SIZE);
q.setFirstResult(PAGE_SIZE * pageNumber);
List page = q.list();
通過使用查詢過濾器（query filter）可以將集合（Collection）的原素分組或排序:
代碼內容
Collection orderedCollection = s.filter( collection, "order by this.amount" );
Collection counts = s.filter( collection, "select this.type, count(this) group by this.type" ); 不用通過初始化，你就可以知道一個集合（Collection）的大小：
代碼內容
( (Integer) session.iterate("select count(*) from ....").next() ).intValue();

原文轉自：http://blog.csdn.net/LN427/archive/2008/06/03/2502367.aspx

fuyueyue

發佈了12 篇原創文章 · 獲贊 0 · 訪問量 6萬+

私信關注

hibernate 查詢語句

985 碩士程序員，空窗 4 個月沒有 Offer！

一文搞懂 Spring 循環依賴

賽博鬥地主——使用大語言模型扮演Agent智能體玩牌類遊戲。

VScode右鍵打開(添加到右鍵)

記一次 .NET某工控視覺自動化系統卡死分析

WindowsServer--SQL Server搭建主從同步實現讀寫分離 - 事務性分發

java由於越界導致的報錯

JAVA桌面程序啓動時最小化到托盤（未測試：需jdk6.0）

Project Document Standard Management_1

JAVA的容器---List,Map,Set

hibernate 查詢語句

java中堆棧(stack)和堆(heap)

Mac下配置sublime實現LaTeX

https://yachay.unat.edu.pe/blog/index.php?comment_area=format_blog&comment_component=blog&comment_co

linux以太網驅動總結