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  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();

。。。。

}

}