EJB3 JPA JPQL 语句 查询 使用 函数 分页 子查询（1）

[转载]EJB3 JPA JPQL 语句 查询 使用 函数 分页 子查询（1）

 

原文地址：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 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();