EJB3.0 JPQL

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 PQL 也容許咱們直接查詢返回咱們須要的屬性，而不是返回整個 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;

} catch (Exception e) {

e.printStackTrace();

return null ;

}

}