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语句,例子的entityBean有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 classPersonimplementsSerializable{
如果要定义多个命名查询,应在 @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 classPersonimplementsSerializable{
当命名查询定义好了之后,我们就可以通过名称执行其查询。代码如下:
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类的实体。JPQL也允许我们
直接查询返回我们需要的属性,而不是返回整个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 classSimplePerson {
private Integer personid;
privateStringname;
。。。。
publicSimplePerson() {
}
publicSimplePerson(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();
。。。。
}
}