1 JPQL就是一种查询语言，具有与 SQL 相类似的特征， JPQL 是完全面向对象的，具备继承、多态和关联等特性，和hibernate HQL很相似。  2    3 查询语句的参数  4 JPQL 语句支持两种方式的参数定义方式 : 命名参数和位置参数 。 。在同一个查询语句中只允许使用一种参数定义方式。  5    6 命令参数的格式为：“ : + 参数名”  7 例：  8 Query query = em.createQuery("select p from Person p where p.personid=:Id ");  9 query.setParameter("Id",new Integer(1)); 10   11 位置参数的格式为“ ?+ 位置编号” 12 例： 13 Query query = em.createQuery("select p from Person p where p.personid=?1 "); 14 query.setParameter(1,new Integer(1)); 15   16   17 如果你需要传递 java.util.Date 或 java.util.Calendar 参数进一个参数查询 ，你需要使用一个特殊的 setParameter() 方法 ，相关的 setParameter 方法定义如下： 18   19 public interface Query 20 { 21 // 命名参数查询时使用，参数类型为 java.util.Date 22 Query setParameter(String name, java.util.Date value, TemporalType temporalType); 23 // 命名参数查询时使用，参数类型为 java.util.Calendar 24 Query setParameter(String name, Calendar value, TemporalType temporalType); 25 // 位置参数查询时使用，参数类型为 java.util.Date 26 Query setParameter(int position, Date value, TemporalType temporalType); 27 // 位置参数查询时使用，参数类型为 java.util.Calendar 28 Query setParameter(int position, Calendar value, TemporalType temporalType); 29 } 30   31 因为一个 Date 或 Calendar 对象能够描述一个真实的日期、时间或时间戳 . 所以我们需要告诉 Query 对象怎么使用这些参数，我们把 javax.persistence.TemporalType 作为参数传递进 setParameter 方法，告诉查询接口在转换 java.util.Date 或 java.util.Calendar 参数到本地 SQL 时使用什么数据库类型 。 32   33 下面通过实例来学习JPQL语句，例子的entity Bean 有 Person, Order, OrderItem ， 他们之间的关系是：一个 Person 有多个 Order, 一个 Order 有多个 OrderItem 。 34   35 JPQL语句的大小写敏感性：除了 Java 类和属性名称外，查询都是大小写不敏感的 。所以， SeLeCT 和 sELEct 以及 SELECT 相同的，但是 com.foshanshop.ejb3.bean.Person 和 com.foshanshop.ejb3.bean.PERSon 是不同的， person.name 和 person.NAME 也是不同的。 36   37   38 命名查询 39 可以在实体 bean 上通过 @NamedQuery or @NamedQueries 预先定义一个或多个查询语句，减少每次因书写错误而引起的 BUG 。通常把经常使用的查询语句定义成命名查询 。 40   41 定义单个命名查询： 42 @NamedQuery (name= "getPerson" , query= "FROM Person WHERE personid=?1" ) 43 @Entity 44 public class Person implements Serializable{ 45   46 如果要定义多个命名查询，应在 @javax.persistence.NamedQueries里定义 @NamedQuery ： 47 @NamedQueries ({ 48 @NamedQuery (name= "getPerson" , query= "FROM Person WHERE personid=?1" ), 49 @NamedQuery (name= "getPersonList" , query= "FROM Person WHERE age>?1" ) 50 }) 51 @Entity 52 public class Person implements Serializable{ 53   54 当命名查询定义好了之后，我们就可以通过名称执行其查询。代码如下： 55 Query query = em . createNamedQuery("getPerson") ; 56 query.setParameter(1, 1); 57   58   59 排序 (order by) 60 "ASC" 和 "DESC" 分别为升序和降序， JPQL 中默认为 asc 升序 61 例： 62 // 先按年龄降序排序，然后按出生日期升序排序 63 Query query = em.createQuery("select p from Person p order by p.age desc, p.birthday asc "); 64   65 查询部分属性 66 通常来说，都是针对 Entity 类的查询，返回的也是被查询的 Entity 类的实体。J P QL 也允许我们直接查询返回我们需要的属性，而不是返回整个 Entity 。在一些 Entity 中属性特别多的情况，这样的查询可以提高性能 67 例： 68 // 只 查询我们感兴趣的属性 ( 列 ) 69 Query query=em.createQuery("select p.personid, p.name from Person p order by p.personid desc "); 70 // 集合中的元素不再是 Person, 而是一个 Object[] 对象数组 71 List result = query.getResultList(); 72 if (result!=null){ 73 Iterator iterator = result.iterator(); 74 while( iterator.hasNext() ){ 75 Object[] row = ( Object[]) iterator.next(); 76 int personid = Integer.parseInt(row[0].toString()); 77 String PersonName = row[1].toString(); 78 。。。。 79 } 80 } 81   82 查询中使用构造器 (Constructor) 83 JPQL 支持将查询的属性结果直接作为一个 java class 的构造器参数，并产生实体作为结果返回 。例如上面的例子只获取 person entity bean的name and personid属性，我们不希望返回的集合的元素是object[]，而希望用一个类来包装它。就要用到使用构造器 。 84 例： 85 public class SimplePerson { 86  private Integer personid; 87 private String name ; 88    。。。。 89 public SimplePerson() { 90 } 91 public SimplePerson(Integer personid, String name) { 92 this . name = name; 93 this . personid = personid; 94 } 95 } 96   97 查询代码为： 98 // 我们把需要的两个属性作为 SimplePerson 的构造器参数，并使用 new 函数。 99 Query query = em.createQuery(" select new com.foshanshop.ejb3.bean.SimplePerson(p. personid, p.name) from Person p order by p.personid desc ");100 // 集合中的元素是 SimplePerson 对象101 List result = query.getResultList();102 if (result!=null){103 Iterator iterator = result.iterator();104 while( iterator.hasNext() ){105 SimplePerson simpleperson = (SimplePerson) iterator.next();106 。。。。107 }108 }109  110 聚合查询 (Aggregation)111 JPQL 支持的聚合函数 包括：112 1. AVG()113 2. SUM()114 3. COUNT() ，返回类型为 Long ，注意 count(*) 语法在 hibernate 中可用，但在 toplink 其它产品中并不可用115 4. MAX()116 5. MIN()117  118 例：119 // 获取最大年龄120 Query query = em.createQuery("select max(p.age) from Person p");121 Object result = query.getSingleResult();122 String maxAge = result.toString();123 // 获取平均年龄124 query = em.createQuery("select avg(p.age) from Person p");125 // 获取最小年龄126 query = em.createQuery("select min(p.age) from Person p");127 // 获取总人数128 query = em.createQuery("select count(p) from Person p");129 // 获取年龄总和130 query = em.createQuery("select sum(p.age) from Person p");131  132 如果聚合函数不是 select...from 的唯一一个返回列，需要使用 "GROUP BY" 语句 。 "GROUP BY" 应该包含 select 语句中除了聚合函数外的所有属性。133 例：134 // 返回男女生各自的总人数135 Query query = em.createQuery(" select p.sex, count(p) from Person p group by p.sex ");136 // 集合中的元素不再是 Person, 而是一个 Object[] 对象数组137 List result = query.getResultList();138  139 如果还需要加上查询条件，需要使用 "HAVING" 条件语句而不是 "WHERE" 语句140 例：141 // 返回人数超过 1 人的性别142 Query query = em.createQuery("select p.sex, count(p) from Person p group by p.sex having count(*) >?1");143 // 设置查询中的参数144 query.setParameter(1, new Long(1));145 // 集合中的元素不再是 Person, 而是一个 Object[] 对象数组146 List result = query.getResultList();147 关联 (join)148 JPQL 仍然支持和 SQL 中类似的关联语法：149 left out join/left join150 inner join151 left join fetch/inner join fetch152  153  154 left out join/left join 等，都是允许符合条件的右边表达式中的 Entiies 为空（ 需要显式使用 left join/left outer join 的情况会比较少。 ）155 例：156 // 获取 26 岁人的订单 , 不管 Order 中是否有 OrderItem157 select o from Order o left join o.orderItems where o.ower.age=26 order by o.orderid158  159  160 inner join 要求右边的表达式必须返回 Entities 。161 例：162 // 获取 26 岁人的订单 ,Order 中必须要有 OrderItem163 select o from Order o inner join o.orderItems where o.ower.age=26 order by o.orderid164  165  166 ！！重要知识点 ： 在默认的查询中， Entity 中的集合属性默认不会被关联，集合属性默认是延迟加载 ( lazy-load ) 。那么， left fetch/left out fetch/inner join fetch 提供了一种灵活的查询加载方式来提高查询的性能。167 例：168 private String QueryInnerJoinLazyLoad(){169 // 默认不关联集合属性变量 (orderItems) 对应的表170 Query query = em.createQuery("select o from Order o inner join o.orderItems where o.ower.age=26 order by o.orderid");171 List result = query.getResultList();172 if (result!=null && result.size()>0){173 // 这时获得 Order 实体中 orderItems( 集合属性变量 ) 为空174 Order order = (Order) result.get(0);175 // 当需要时， EJB3 Runtime 才会执行一条 SQL 语句来加载属于当前 Order 的176 //OrderItems177 Set<OrderItem> list = order.getOrderItems ();178 Iterator<OrderItem> iterator = list.iterator();179 if (iterator.hasNext()){180 OrderItem orderItem =iterator.next();181 System.out.println (" 订购产品名： "+ orderItem.getProductname());182 }183 }184  185 上面代码在执行 "select o from Order o inner join o.orderItems where o.ower.age=26 order by o.orderid" 时编译成的 SQL 如下（ 他不包含集合属性变量 (orderItems) 对应表的字段 ） ：186 select order0_.orderid as orderid6_, order0_.amount as amount6_, order0_.person_id as187 person4_6_, order0_.createdate as createdate6_ from Orders order0_ inner join OrderItems188 orderitems1_ on order0_.orderid=orderitems1_.order_id, Person person2_ where189 order0_.person_id=person2_.personid and person2_.age=26 order by order0_.orderid190  191  192 上面代码当执行到 Set<OrderItem> list = order.getOrderItems(); 时才会执行一条 SQL 语句来加载 属于当前 Order 的 OrderItems ，编译成的 SQL 如下 ：193 select orderitems0_.order_id as order4_1_, orderitems0_.id as id1_, orderitems0_.id as id7_0_,194 orderitems0_.order_id as order4_7_0_, orderitems0_.productname as productn2_7_0_,195 orderitems0_.price as price7_0_ from OrderItems orderitems0_ where orderitems0_.order_id=?196 order by orderitems0_.id ASC197  198 这样的查询性能上有不足的地方 。为了查询 N 个 Order ，我们需要一条 SQL 语句获得所有的 Order 的原始对象属性，但需要另外 N 条语句获得每个 Order 的 orderItems 集合属性。为了避免 N+1 的性能问题，我们可以利用 join fetch 一次过用一条 SQL 语句把 Order 的所有信息查询出来199  200 例子201 // 获取 26 岁人的订单 ,Order 中必须要有 OrderItem202 Query query = em.createQuery("select o from Order o inner join fetch o.orderItems where203 o.ower.age=26 order by o.orderid");204  205 上面这句HPQL编译成以下的 SQL ：206 select order0_.orderid as orderid18_0_, orderitems1_.id as id19_1_, order0_.amount as207 amount18_0_,order0_.person_id as person4_18_0_, order0_.createdate as createdate18_0_,208 orderitems1_.order_id as order4_19_1_, orderitems1_.productname as productn2_19_1_,209 orderitems1_.price as price19_1_, orderitems1_.order_id as order4_0__, orderitems1_.id as id0__210 from Orders order0_ inner join OrderItems orderitems1_ on211 order0_.orderid=orderitems1_.order_id, Person person2_ where212 order0_.person_id=person2_.personid and person2_.age=26 order by order0_.orderid,213 orderitems1_.id ASC214  215 上面由于使用了 fetch, 这个查询只会产生一条 SQL 语句，比原来需要 N+1 条 SQL 语句在性能上有了极大的提升216  217  218 排除相同的记录 DISTINCT219 使用关联查询，我们很经常得到重复的对象，如下面语句：220 " select o from Order o inner join fetch o.orderItems order by o.orderid "221 当有 N 个 orderItem 时就会产生 N 个 Order, 而有些 Order 对象往往是相同的，这时我们需要使用 DISTINCT 关键字来排除掉相同的对象 。222 例：223 select DISTINCT o from Order o inner join fetch o.orderItems order by o.orderid224  225  226  227 比较 Entity228 在查询中使用参数查询时 ，参数类型除了 String, 原始数据类型 ( int, double 等 ) 和它们的对象类型 ( Integer, Double 等 ), 也可以是 Entity 的实例 。229 例：230 // 查询某人的所有订单231 Query query = em.createQuery("select o from Order o where o.ower =?1 order by o.orderid");232 Person person = new Person();233 person.setPersonid(new Integer(1));234 // 设置查询中的参数235 query.setParameter(1,person);236  237  238 批量更新 (Batch Update)239 HPQL支持批量更新240 例：241 // 把所有订单的金额加 10242 Query query = em.createQuery(" update Order as o set o.amount=o.amount+10 ");243 //update 的记录数244 int result = query. executeUpdate ();245  246  247 批量删除 (Batch Remove)248 例：249 // 把金额小于100的订单删除,先删除订单子项, 再删除订单250 Query query = em .createQuery( "delete from OrderItem item where item.order in(from Order as o where o.amount<100)" );251 query. executeUpdate();252 query = em .createQuery( "delete from Order as o where o.amount<100" );253 query.executeUpdate(); //delete 的记录数254  255  256 使用操作符 NOT257 // 查询除了指定人之外的所有订单258 Query query = em.createQuery("select o from Order o where not(o.ower =?1) order by o.orderid");259 Person person = new Person();260 person.setPersonid(new Integer(2));261 // 设置查询中的参数262 query.setParameter(1,person);263  264  265 使用操作符 BETWEEN266 select o from Order as o where o.amount between 300 and 1000267  268 使用操作符 IN269 // 查找年龄为 26,21 的 Person270 select p from Person as p where p.age in(26,21)271  272 使用操作符 LIKE273 // 查找以字符串 "li" 开头的 Person274 select p from Person as p where p.name like ‘li%‘275  276 使用操作符 IS NULL277 // 查询含有购买者的所有 Order278 select o from Order as o where o.ower is [not] null279  280 使用操作符 IS EMPTY281 IS EMPTY 是针对集合属性 (Collection) 的操作符 。可以和 NOT 一起使用 。 注：低版权的 Mysql 不支持 IS EMPTY282 // 查询含有订单项的所有 Order283 select o from Order as o where o.orderItems is [not] empty284  285 使用操作符 EXISTS286 [NOT]EXISTS 需要和子查询配合使用 。注：低版权的 Mysql 不支持 EXISTS287 // 如果存在订单号为 1 的订单，就获取所有 OrderItem288 select oi from OrderItem as oi where exists (select o from Order o where o.orderid=1)289 // 如果不存在订单号为 10 的订单，就获取 id 为 1 的 OrderItem290 select oi from OrderItem as oi where oi.id=1 and not exists (select o from Order o where o.orderid=10)291  292  293 字符串函数294 JPQL 定义了内置函数方便使用。这些函数的使用方法和 SQL 中相应的函数方法类似。包括：295 1. CONCAT 字符串拼接296 2. SUBSTRING 字符串截取297 3. TRIM 去掉空格298 4. LOWER 转换成小写299 5. UPPER 装换成大写300 6. LENGTH 字符串长度301 7. LOCATE 字符串定位302  303 例：304 // 查询所有人员，并在姓名后面加上字符串 "_foshan"305 select p.personid, concat(p.name, ‘_foshan‘) from Person as p306 // 查询所有人员 , 只取姓名的前三个字符307 select p.personid, substring (p.name,1,3) from Person as p308  309 计算函数310 HPQL 定义的计算函数包括：311 ABS 绝对值312 SQRT 平方根313 MOD 取余数314 SIZE 取集合的数量315  316 例：317 // 查询所有 Order 的订单号及其订单项的数量318 select o.orderid, size (o.orderItems) from Order as o group by o.orderid319 // 查询所有 Order 的订单号及其总金额 /10 的余数320 select o.orderid, mod (o.amount, 10) from Order as o321  322  323 子查询324 子查询可以用于 WHERE 和 HAVING 条件语句中325 例：326 // 查询年龄为 26 岁的购买者的所有 Order327 select o from Order as o where o.ower in(select p from Person as p where p.age =26)328  329  330 结果集分页331 有些时候当执行一个查询会返回成千上万条记录，事实上我们只需要显示一部分数据。这时我们需要对结果集进行分页 ， QueryAPI 有两个接口方法可以解决这个问题： setMaxResults( ) 和 setFirstResult( ) 。332  333 setMaxResults 方法设置获取多少条记录334 setFirstResult 方法设置从结果集中的那个索引开始获取 （假如返回的记录有 3 条，容器会自动为记录编上索引，索引从 0 开始，依次为 0 ， 1 ， 2 ）335  336 例：337 public List getPersonList( int max, int whichpage) {338 try {339 int index = (whichpage-1) * max;340 Query query = em .createQuery( "from Person p order by personid asc" );341 List list = query. setMaxResults(max) .342 setFirstResult(index) .343 getResultList();344 em .clear(); // 分离内存中受EntityManager管理的实体bean，让VM进行垃圾回收345 return list;346 }