|
JPQL就是一種查詢語言，具有與 SQL 相類似的特征， JPQL 是完全面向對象的，具備繼承、多態和關聯等特性，和hibernate HQL很相似。
查詢語句的參數
JPQL 語句支持兩種方式的參數定義方式 : 命名參數和位置參數 。 。在同一個查詢語句中只允許使用一種參數定義方式。
命令參數的格式為：“ : + 參數名”
例：
Query query = em.createQuery("select p from Person p where p.personid=:Id ");
query.setParameter("Id",new Integer(1));
位置參數的格式為“ ?+ 位置編號”
例：
Query query = em.createQuery("select p from Person p where p.personid=?1 ");
query.setParameter(1,new Integer(1));
如果你需要傳遞 java.util.Date 或 java.util.Calendar 參數進一個參數查詢 ，你需要使用一個特殊的 setParameter() 方法 ，相關的 setParameter 方法定義如下：
public interface Query
{
// 命名參數查詢時使用，參數類型為 java.util.Date
Query setParameter(String name, java.util.Date value, TemporalType temporalType);
// 命名參數查詢時使用，參數類型為 java.util.Calendar
Query setParameter(String name, Calendar value, TemporalType temporalType);
// 位置參數查詢時使用，參數類型為 java.util.Date
Query setParameter(int position, Date value, TemporalType temporalType);
// 位置參數查詢時使用，參數類型為 java.util.Calendar
Query setParameter(int position, Calendar value, TemporalType temporalType);
}
因為一個 Date 或 Calendar 對象能夠描述一個真實的日期、時間或時間戳 . 所以我們需要告訴 Query 對象怎么使用這些參數，我們把 javax.persistence.TemporalType 作為參數傳遞進 setParameter 方法，告訴查詢接口在轉換 java.util.Date 或 java.util.Calendar 參數到本地 SQL 時使用什么數據庫類型 。
下面通過實例來學習JPQL語句，例子的entity Bean 有 Person, Order, OrderItem ， 他們之間的關系是：一個 Person 有多個 Order, 一個 Order 有多個 OrderItem 。
JPQL語句的大小寫敏感性：除了 Java 類和屬性名稱外，查詢都是大小寫不敏感的 。所以， SeLeCT 和 sELEct 以及 SELECT 相同的，但是 com.foshanshop.ejb3.bean.Person 和 com.foshanshop.ejb3.bean.PERSon 是不同的， person.name 和 person.NAME 也是不同的。
命名查詢
可以在實體 bean 上通過 @NamedQuery or @NamedQueries 預先定義一個或多個查詢語句，減少每次因書寫錯誤而引起的 BUG 。通常把經常使用的查詢語句定義成命名查詢 。
定義單個命名查詢：
@NamedQuery (name= "getPerson" , query= "FROM Person WHERE personid=?1" )
@Entity
public class Person implements Serializable{
如果要定義多個命名查詢，應在 @javax.persistence.NamedQueries里定義 @NamedQuery ：
@NamedQueries ({
@NamedQuery (name= "getPerson" , query= "FROM Person WHERE personid=?1" ),
@NamedQuery (name= "getPersonList" , query= "FROM Person WHERE age>?1" )
})
@Entity
public class Person implements Serializable{
當命名查詢定義好了之后，我們就可以通過名稱執行其查詢。代碼如下：
Query query = em . createNamedQuery("getPerson") ;
query.setParameter(1, 1);
排序 (order by)
"ASC" 和 "DESC" 分別為升序和降序， JPQL 中默認為 asc 升序
例：
// 先按年齡降序排序，然后按出生日期升序排序
Query query = em.createQuery("select p from Person p order by p.age desc, p.birthday asc ");
查詢部分屬性
通常來說，都是針對 Entity 類的查詢，返回的也是被查詢的 Entity 類的實體。J P QL 也允許我們直接查詢返回我們需要的屬性，而不是返回整個 Entity 。在一些 Entity 中屬性特別多的情況，這樣的查詢可以提高性能
例：
// 只 查詢我們感興趣的屬性 ( 列 )
Query query=em.createQuery("select p.personid, p.name from Person p order by p.personid desc ");
// 集合中的元素不再是 Person, 而是一個 Object[] 對象數組
List result = query.getResultList();
if (result!=null){
Iterator iterator = result.iterator();
while( iterator.hasNext() ){
Object[] row = ( Object[]) iterator.next();
int personid = Integer.parseInt(row[0].toString());
String PersonName = row[1].toString();
。。。。
}
}
查詢中使用構造器 (Constructor)
JPQL 支持將查詢的屬性結果直接作為一個 java class 的構造器參數，并產生實體作為結果返回 。例如上面的例子只獲取 person entity bean的name and personid屬性，我們不希望返回的集合的元素是object[]，而希望用一個類來包裝它。就要用到使用構造器 。
例：
public class SimplePerson {
private Integer personid;
private String name ;
。。。。
public SimplePerson() {
}
public SimplePerson(Integer personid, String name) {
this . name = name;
this . personid = personid;
}
}
查詢代碼為：
// 我們把需要的兩個屬性作為 SimplePerson 的構造器參數，并使用 new 函數。
Query query = em.createQuery(" select new com.foshanshop.ejb3.bean.SimplePerson(p. personid, p.name) from Person p order by p.personid desc ");
// 集合中的元素是 SimplePerson 對象
List result = query.getResultList();
if (result!=null){
Iterator iterator = result.iterator();
while( iterator.hasNext() ){
SimplePerson simpleperson = (SimplePerson) iterator.next();
。。。。
}
}
聚合查詢 (Aggregation)
JPQL 支持的聚合函數 包括：
1. AVG()
2. SUM()
3. COUNT() ，返回類型為 Long ，注意 count(*) 語法在 hibernate 中可用，但在 toplink 其它產品中并不可用
4. MAX()
5. MIN()
例：
// 獲取最大年齡
Query query = em.createQuery("select max(p.age) from Person p");
Object result = query.getSingleResult();
String maxAge = result.toString();
// 獲取平均年齡
query = em.createQuery("select avg(p.age) from Person p");
// 獲取最小年齡
query = em.createQuery("select min(p.age) from Person p");
// 獲取總人數
query = em.createQuery("select count(p) from Person p");
// 獲取年齡總和
query = em.createQuery("select sum(p.age) from Person p");
如果聚合函數不是 select...from 的唯一一個返回列，需要使用 "GROUP BY" 語句 。 "GROUP BY" 應該包含 select 語句中除了聚合函數外的所有屬性。
例：
// 返回男女生各自的總人數
Query query = em.createQuery(" select p.sex, count(p) from Person p group by p.sex ");
// 集合中的元素不再是 Person, 而是一個 Object[] 對象數組
List result = query.getResultList();
如果還需要加上查詢條件，需要使用 "HAVING" 條件語句而不是 "WHERE" 語句
例：
// 返回人數超過 1 人的性別
Query query = em.createQuery("select p.sex, count(p) from Person p group by p.sex having count(*) >?1");
// 設置查詢中的參數
query.setParameter(1, new Long(1));
// 集合中的元素不再是 Person, 而是一個 Object[] 對象數組
List result = query.getResultList();
關聯 (join)
JPQL 仍然支持和 SQL 中類似的關聯語法：
left out join/left join
inner join
left join fetch/inner join fetch
left out join/left join 等，都是允許符合條件的右邊表達式中的 Entiies 為空（ 需要顯式使用 left join/left outer join 的情況會比較少。 ）
例：
// 獲取 26 歲人的訂單 , 不管 Order 中是否有 OrderItem
select o from Order o left join o.orderItems where o.ower.age=26 order by o.orderid
inner join 要求右邊的表達式必須返回 Entities 。
例：
// 獲取 26 歲人的訂單 ,Order 中必須要有 OrderItem
select o from Order o inner join o.orderItems where o.ower.age=26 order by o.orderid
！！重要知識點 ： 在默認的查詢中， Entity 中的集合屬性默認不會被關聯，集合屬性默認是延遲加載 ( lazy-load ) 。那么， left fetch/left out fetch/inner join fetch 提供了一種靈活的查詢加載方式來提高查詢的性能。
例：
private String QueryInnerJoinLazyLoad(){
// 默認不關聯集合屬性變量 (orderItems) 對應的表
Query query = em.createQuery("select o from Order o inner join o.orderItems where o.ower.age=26 order by o.orderid");
List result = query.getResultList();
if (result!=null && result.size()>0){
// 這時獲得 Order 實體中 orderItems( 集合屬性變量 ) 為空
Order order = (Order) result.get(0);
// 當需要時， EJB3 Runtime 才會執行一條 SQL 語句來加載屬于當前 Order 的
//OrderItems
Set<OrderItem> list = order.getOrderItems ();
Iterator<OrderItem> iterator = list.iterator();
if (iterator.hasNext()){
OrderItem orderItem =iterator.next();
System.out.println (" 訂購產品名： "+ orderItem.getProductname());
}
}
上面代碼在執行 "select o from Order o inner join o.orderItems where o.ower.age=26 order by o.orderid" 時編譯成的 SQL 如下（ 他不包含集合屬性變量 (orderItems) 對應表的字段 ） ：
select order0_.orderid as orderid6_, order0_.amount as amount6_, order0_.person_id as
person4_6_, order0_.createdate as createdate6_ from Orders order0_ inner join OrderItems
orderitems1_ on order0_.orderid=orderitems1_.order_id, Person person2_ where
order0_.person_id=person2_.personid and person2_.age=26 order by order0_.orderid
上面代碼當執行到 Set<OrderItem> list = order.getOrderItems(); 時才會執行一條 SQL 語句來加載 屬于當前 Order 的 OrderItems ，編譯成的 SQL 如下 ：
select orderitems0_.order_id as order4_1_, orderitems0_.id as id1_, orderitems0_.id as id7_0_,
orderitems0_.order_id as order4_7_0_, orderitems0_.productname as productn2_7_0_,
orderitems0_.price as price7_0_ from OrderItems orderitems0_ where orderitems0_.order_id=?
order by orderitems0_.id ASC
這樣的查詢性能上有不足的地方 。為了查詢 N 個 Order ，我們需要一條 SQL 語句獲得所有的 Order 的原始對象屬性，但需要另外 N 條語句獲得每個 Order 的 orderItems 集合屬性。為了避免 N+1 的性能問題，我們可以利用 join fetch 一次過用一條 SQL 語句把 Order 的所有信息查詢出來
例子
// 獲取 26 歲人的訂單 ,Order 中必須要有 OrderItem
Query query = em.createQuery("select o from Order o inner join fetch o.orderItems where
o.ower.age=26 order by o.orderid");
上面這句HPQL編譯成以下的 SQL ：
select order0_.orderid as orderid18_0_, orderitems1_.id as id19_1_, order0_.amount as
amount18_0_,order0_.person_id as person4_18_0_, order0_.createdate as createdate18_0_,
orderitems1_.order_id as order4_19_1_, orderitems1_.productname as productn2_19_1_,
orderitems1_.price as price19_1_, orderitems1_.order_id as order4_0__, orderitems1_.id as id0__
from Orders order0_ inner join OrderItems orderitems1_ on
order0_.orderid=orderitems1_.order_id, Person person2_ where
order0_.person_id=person2_.personid and person2_.age=26 order by order0_.orderid,
orderitems1_.id ASC
上面由于使用了 fetch, 這個查詢只會產生一條 SQL 語句，比原來需要 N+1 條 SQL 語句在性能上有了極大的提升
排除相同的記錄 DISTINCT
使用關聯查詢，我們很經常得到重復的對象，如下面語句：
" select o from Order o inner join fetch o.orderItems order by o.orderid "
當有 N 個 orderItem 時就會產生 N 個 Order, 而有些 Order 對象往往是相同的，這時我們需要使用 DISTINCT 關鍵字來排除掉相同的對象 。
例：
select DISTINCT o from Order o inner join fetch o.orderItems order by o.orderid
比較 Entity
在查詢中使用參數查詢時 ，參數類型除了 String, 原始數據類型 ( int, double 等 ) 和它們的對象類型 ( Integer, Double 等 ), 也可以是 Entity 的實例 。
例：
// 查詢某人的所有訂單
Query query = em.createQuery("select o from Order o where o.ower =?1 order by o.orderid");
Person person = new Person();
person.setPersonid(new Integer(1));
// 設置查詢中的參數
query.setParameter(1,person);
批量更新 (Batch Update)
HPQL支持批量更新
例：
// 把所有訂單的金額加 10
Query query = em.createQuery(" update Order as o set o.amount=o.amount+10 ");
//update 的記錄數
int result = query. executeUpdate ();
批量刪除 (Batch Remove)
例：
// 把金額小于100的訂單刪除,先刪除訂單子項, 再刪除訂單
Query query = em .createQuery( "delete from OrderItem item where item.order in(from Order as o where o.amount<100)" );
query. executeUpdate();
query = em .createQuery( "delete from Order as o where o.amount<100" );
query.executeUpdate(); //delete 的記錄數
使用操作符 NOT
// 查詢除了指定人之外的所有訂單
Query query = em.createQuery("select o from Order o where not(o.ower =?1) order by o.orderid");
Person person = new Person();
person.setPersonid(new Integer(2));
// 設置查詢中的參數
query.setParameter(1,person);
使用操作符 BETWEEN
select o from Order as o where o.amount between 300 and 1000
使用操作符 IN
// 查找年齡為 26,21 的 Person
select p from Person as p where p.age in(26,21)
使用操作符 LIKE
// 查找以字符串 "li" 開頭的 Person
select p from Person as p where p.name like 'li%'
使用操作符 IS NULL
// 查詢含有購買者的所有 Order
select o from Order as o where o.ower is [not] null
使用操作符 IS EMPTY
IS EMPTY 是針對集合屬性 (Collection) 的操作符 。可以和 NOT 一起使用 。 注：低版權的 Mysql 不支持 IS EMPTY
// 查詢含有訂單項的所有 Order
select o from Order as o where o.orderItems is [not] empty
使用操作符 EXISTS
[NOT]EXISTS 需要和子查詢配合使用 。注：低版權的 Mysql 不支持 EXISTS
// 如果存在訂單號為 1 的訂單，就獲取所有 OrderItem
select oi from OrderItem as oi where exists (select o from Order o where o.orderid=1)
// 如果不存在訂單號為 10 的訂單，就獲取 id 為 1 的 OrderItem
select oi from OrderItem as oi where oi.id=1 and not exists (select o from Order o where o.orderid=10)
字符串函數
JPQL 定義了內置函數方便使用。這些函數的使用方法和 SQL 中相應的函數方法類似。包括：
1. CONCAT 字符串拼接
2. SUBSTRING 字符串截取
3. TRIM 去掉空格
4. LOWER 轉換成小寫
5. UPPER 裝換成大寫
6. LENGTH 字符串長度
7. LOCATE 字符串定位
例：
// 查詢所有人員，并在姓名后面加上字符串 "_foshan"
select p.personid, concat(p.name, '_foshan') from Person as p
// 查詢所有人員 , 只取姓名的前三個字符
select p.personid, substring (p.name,1,3) from Person as p
計算函數
HPQL 定義的計算函數包括：
ABS 絕對值
SQRT 平方根
MOD 取余數
SIZE 取集合的數量
例：
// 查詢所有 Order 的訂單號及其訂單項的數量
select o.orderid, size (o.orderItems) from Order as o group by o.orderid
// 查詢所有 Order 的訂單號及其總金額 /10 的余數
select o.orderid, mod (o.amount, 10) from Order as o
子查詢
子查詢可以用于 WHERE 和 HAVING 條件語句中
例：
// 查詢年齡為 26 歲的購買者的所有 Order
select o from Order as o where o.ower in(select p from Person as p where p.age =26)
結果集分頁
有些時候當執行一個查詢會返回成千上萬條記錄，事實上我們只需要顯示一部分數據。這時我們需要對結果集進行分頁 ， QueryAPI 有兩個接口方法可以解決這個問題： setMaxResults( ) 和 setFirstResult( ) 。
setMaxResults 方法設置獲取多少條記錄
setFirstResult 方法設置從結果集中的那個索引開始獲取 （假如返回的記錄有 3 條，容器會自動為記錄編上索引，索引從 0 開始，依次為 0 ， 1 ， 2 ）
例：
public List getPersonList( int max, int whichpage) {
try {
int index = (whichpage-1) * max;
Query query = em .createQuery( "from Person p order by personid asc" );
List list = query. setMaxResults(max) .
setFirstResult(index) .
getResultList();
em .clear(); // 分離內存中受EntityManager管理的實體bean，讓VM進行垃圾回收
return list;
}
|
|
|
來自： moonboat > 《hibernate》
