JPQL

http://www.bonashen.com/archives/268
JPQL就是一种查询语言，具有与SQL 相类似的特征，JPQL是完全面向对象的，具备继承、多态和关联等特性，和hibernate HQL很相似。
查询语句的参数
JPQL语句支持两种方式的参数定义方式: 命名参数和位置参数。在同一个查询语句中只允许使用一种参数定义方式。
命令参数的格式为：": +参数名"
Query query = em.createQuery("select p from Person p where p.personid=:Id"); 
query.setParameter("Id",1);

位置参数的格式为"?+位置编号"
Query query = em.createQuery("select p from Person p where p.personid=?1");
query.setParameter(1,1); 

Query query = em.createQuery("select p from Person p where p.personid=?");
query.setParameter(1,1); 
默认从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语句的大小写敏感性：除了Java 类和属性名称外，查询都是大小写不敏感的。

命名查询
可以在实体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类的实体。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 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(); 
//获取总人数 
query = em.createQuery("select count(p) 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"); 
如果还需要加上查询条件，需要使用"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)); 

关联(join)
left out join/left join
inner join
left join fetch/inner join fetch
left out join/left join等，都是允许符合条件的右边表达式中的Entiies 为空（需要显式使用left join/left outer join 的情况会比较少。）

//获取26岁人的订单,不管Order中是否有OrderItem
select o from Order o left join o.orderItems where o.ower.age=26 order by o.orderid 

inner join 要求右边的表达式必须返回Entities。
//获取26 岁人的订单,Order 中必须要有OrderItem 
select o from Order o inner join o.orderItems where o.ower.age=26 order by o.orderid

使用操作符 NOT
使用操作符 BETWEEN
使用操作符 IN
使用操作符 LIKE
使用操作符 IS NULL
使用操作符 IS EMPTY
使用操作符 EXISTS
排除相同记录 DISTINCT

批量更新(Batch Update)
Query query = em.createQuery("update Order as o set o.amount=o.amount+10");
//update 的记录数
int result = query.executeUpdate();

批量删除(Batch Remove)
Query query = em.createQuery("delete from OrderItem item where item.order in(from Order as
o where o.amount<100)");

子查询可以用于 WHERE和 HAVING 条件语句中
结果集分页setMaxResults( ) 和 setFirstResult( )

调用存储过程
要调用存储过程，我们可以通过 EntityManager 对象的 createNativeQuery()方法执行 SQL 语句，调用存储过程的 SQL格式如下：{call 存储过程名称(参数 1, 参数 2, … )}
在 EJB3 中你可以调用的存储过程有两种
1．无返回值的存储过程。
2．返回值为 ResultSet（以 select形式返回的值）的存储过程，EJB3 不能调用以 OUT 参数返回值的存储过程。
CREATE PROCEDURE GetPersonList()
NOT DETERMINISTIC
SQL SECURITY DEFINER
COMMENT ''
BEGIN
select * from person;
END;
Query query = em.createNativeQuery("{call GetPersonList()}", Person.class);
List result = query.getResultList();

在默认的查询中，一的一端采用立即加载，多的一端采用懒加载