[转载]EJB3 JPA JPQL 语句 查询 使用 函数 分页 子查询(1)
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
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();