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
上通过@NamedQueryor@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 porder 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();
。。。。
}
}