一、什么是JPQL
在 Java EE 中，JPQL（ Java 持久性查询语言）是专门为Java 应用程序访问和导航实体实例设计的。JPQL是EJB2使用的查询语言EJB QL的扩展，它继承了EJB QL并对其做了一些改变。
二、JPQL与SQL
JPQL 和 SQL 有很多相似之处。归根结底，它们都用于访问和操作数据库数据。而且，二者都使用非过程语句 — 通过特殊解释程序识别的命令。此外，JPQL 在语法上与 SQL 也相似。
JPQL 和 SQL 的主要区别在于，前者处理 JPA 实体，后者直接在数据库空间内对表、列、行等关系数据进行处理。
三、使用JPQL
要从 Java 代码内发出 JPQL 查询，您需要利用 EntityManager API 和 Query API 的相应方法，执行以下一般步骤：
1. 使用注入或通过 EntityManagerFactory 实例获取一个 EntityManager 实例。
2. 通过调用相应 EntityManager 的方法（如 createQuery），创建一个 Query 实例。
3. 如果有查询参数，使用相应 Query 的 setParameter 方法进行设置。
4. 如果需要，使用 setMaxResults 和/或 setFirstResult Query 的方法设置要检索的实例的最大数量和/或指定检索的起始实例位置。
5. 如果需要，使用 setHint Query 的方法设置供应商特定的提示。
6. 如果需要，使用 setFlushMode Query 的方法设置查询执行的刷新模式，覆盖实体管理器的刷新模式。
7. 使用相应 Query 的方法 getSingleResult 或 getResultList 执行查询。如果进行更新或删除操作，您必须使用 executeUpdate 方法，它返回已更新或删除的实体实例的数量。
JPQL的查询可以分为命名查询和动态查询。
动态查询
可 以使用EntityManager.createQuery方法创建动态查询，唯一的要求是把合法的JPQL语句传递给此方法。如下：
Query query = em.createQuery(“select p from Person p where p.id=1033”);
其 中where语句可是可选的。在这里JPQL看上去和SQL语句很像,但应当注意到的是from后边的Person是实体Bean而不是数据表。
在所写的JPQL语句中你可以像示例中那样的直接将查询条件写在语句中。但是还有更好的方法。在这里你可以使用设置查询参数的方式，其中又有位置 参数和命名参数的分别。
使用位置参数如下所示：
Query query = em.createQuery(“select p from Person p where p.id=?1”);
Query.setParameter(1, 1033);//第一个参数是位置，第二个参数查询条件
使用命名参数如下所示：
Query query = em.createQuery(“select p from Person p where p.id=:id”);
Query.setParameter(“id”, 1033);//第一个参数是参数名称，第二个参数查询条件
需要注意的是位置参数的是位置前加符号”?”，命名参数是名称前是加符 号”:”。
如果你需要传递java.util.Date或java.util.Calendar参数进一个参数查询，你需要使用一个特殊 的setParameter()方法。因为一个Date或Calendar对象能够描述一个真实的日期、时间或时间戳.所以我们需要告诉Query对象怎 么使用这些参数，我们把javax.persistence.TemporalType作为参数传递进setParameter方法，告诉查询接口在转换 java.util.Date或java.util.Calendar参数到本地SQL时使用什么数据库类型。
查询结果
使 用Query. getSingleResult方法得到查询的单个实例,返回Object。要确保使用此方法时查询只检索到一个实体。
使 用Query. getResultList方法得到查询的实例集合,返回List。
通常的，我们会如示例中所示的是获取查询返回的是实 体，但是在JPQL里我们也可以得到实体的部分属性，就如同使用SQL得到表中的部分列一样。如果是获取部分属性的 话，Query.getResultList方法返回的会是Object数组的List每个Object数组项相当于是一条结果，数组的成员是属性值，顺 序和所写的JPQL中的SELECT中所写顺序一致。
查询中使用构造器(Constructor)
可以在SELECT子 句中使用构造器返回一个或多个java实例。如下所示：
Query query = em.createQuery("select new com.demo.bean.Person(p.id, p.name) from Person p order by p.id desc");
查询分页
JPA提供了在结果集合中使用分页的功能，使用这个功能我们可以轻松的达到对 查询结果分页的目的。如下
Query.setMaxResults(10);//设置分页大小，在这里为每页10条记录
Query.setFirstResult(10);// 指定第一个结果的位置。这里是指定第11条作为起始结果。
这里只要在setFirstResult中使用动态参数即可方便的对结果进行分 页了。
使用操作符
在where子句中我们可以使用一些操作符来进行条件的选择。
NOT操作符
select p from Person p where not(p.id = 1036)
//查询id不是1036的所有人
BETWEEN 操作符
select p from Person p where p.age between 20 and 26
// 查询年龄在20到26的所有人;上限和下限必须是相同的数据类型
IS NULL操作符
select p from Person p where p.name is not null
//查询名字不为NULL的所有人
IS EMPTY操作符
IS EMPTY是针对集合属性(Collection)的操作符。可以和NOT 一起使用。注：低版权的Mysql 不支持IS EMPTY
select p from Person p where p.interest is empty
// 查询兴趣（是集合）是空的所有人
IN 操作符
select p from Person p where p.id in (101,102)
//查询id是101和102的人
EXISTS 操作符
[NOT]EXISTS 需要和子查询配合使用。注：低版权的Mysql 不支持EXISTS
select p from Person p where exists (select b from Book b where b.name like ‘%EJB%’ )
//如果书籍名字 中包含有EJB字样，则得到所有人
MEMBER OF操作符
可以使用MEMBER OF操作符检查集合－值路径表达式中是否存在标识符变量、单一值表达式或是输入参数。
select p from Person p where :interest member of p.interest
//查询兴趣（是集合）是中包含所输入的兴趣实体实例 （:interest）的所有人
使用字符串函数
JPQL定义了内置函数方便使用。这些函数的使用方法和SQL中相应的函 数方法类似。包括：
1. CONCAT 字符串拼接
2. SUBSTRING 字符串截取
3. TRIM 去掉空格
4. LOWER 转换成小写
5. UPPER 装换成大写
6. LENGTH 字符串长度
7. LOCATE 字符串定位
使用算术函数
JPQL仅仅支持了最低限度的算术函数集合，可 以在JPQL的where和having子句中使用算术函数。JPQL定义的算术函数包括：
ABS 绝对值
SQRT 平方根
MOD 取余数
SIZE 取集合的数量
使用时间函数
JPQL像大多数语言一样提 供了获得当前日期、时间或是时间标记的函数。这些函数转换为数据库专有的SQL函数，从数据库检索当前日期、时间或时间标记。包含的时间函数如下：
CURRENT_DATE 返回当前日期
CURRENT_TIME 返回当前时间
CURRENT_TIMESTAMP 返回当前时间标记
联结（连接/关联）
JPQL仍然支持和SQL中类似的关联语法:
left out join/left join
left out join/left join等，都是允许符合条件的右边表达式中的Entities 为空（需要显式使用left join/left outer join 的情况会比较少。）
inner join
inner join 要求右边的表达式必须返回Entities。
left join fetch/inner join fetch
在默认的查询中，Entity中的集合属性默认不会被关联，集合属性默认是延迟加载( lazy-load )。那么，left fetch/left out fetch/inner join fetch提供了一种灵活的查询加载方式来提高查询的性能(集合属性被关联，同Entity同时加载而不是在需要时再加载，这样就转换为SQL语句时为一 条SQL语句，而不是加载Entity时一条语句，加载集合属性时有N（等于Entity数量）条语句，避免了N+1问题，提高了查询性能)。
使 用聚合函数
JPQL提供的聚合函数有AVG、COUNT、MAX、MIN、SUM。在AVG、MAX、MIN、SUM函数中只能使用持久 化字段，而在COUNT中可以使用任何类型的路径表达式或标识符。
COUNT返回的类型是Long，AVG是Double，SUM可能返 回Long或Double。
分组
如果聚合函数不是select...from的唯一一个返回列，需要使用"GROUP BY"语句。"GROUP BY"应该包含select 语句中除了聚合函数外的所有属性。如果还需要加上查询条件，需要使用"HAVING"条件语句而不是"WHERE"语句
select p.grade, count(p) from Person p where p.age > 20 group by p.grade having count(*)>120
//返回年龄大于20的各年级的总人数（人数大于120）
排序
在 JPQL中像SQL一样使用order by 来进行排序。"ASC"和"DESC"分别为升序和降序，JPQL中默认为ASC升序。
批 删除和批更新
JPQL支持批量删除和批量更新的操作。和查询相同的是也是要使用EntityManager.createQuery方法 来创建一个Query实例，不同的是在这里要使用Query.executeUpdate方法来直行删除和更新，该方法返回的值是操作的记录数。
命名查询
可以在实体bean上通过@NamedQuery or @NamedQueries预先定义一个或多个查询语句，减少每次因书写错误而引起的BUG。通常把经常使用的查询语句定义成命名查询。
定义单个命名查询：
@NamedQuery(name="getPerson", query= "select p from Person p where p.id=?1")
@Entity
public class Person implements Serializable{
如果要定义多个命名查询，应在 @javax.persistence.NamedQueries里定义@NamedQuery：
@NamedQueries({
@NamedQuery(name="getPerson", query= "select p from Person p where p.id=?1"),
@NamedQuery(name="getPersonList", query= "select p from Person as p where p.age>?1")
})
@Entity
public class Person implements Serializable{
当命名查询定义好了之后，我们就可以 通过名称执行其查询。代码如下：
Query query = em.createNamedQuery("getPerson");
query.setParameter(1, 1);
四、注意
1. JPQL语句的大小写敏感性：除了Java 类和属性名称外，查询都是大小写不敏感的。
2. 使用参数查询的时候除了基本类型的参数还可以使用实体参数。
//只查询我们感兴趣的属性(列)
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();
。。。。
}
}