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类的实体。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(); 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();