jpql 语法+实力（hibernate+sprin boot jpa @Query都可以使用jpql）
JPQL就是一种查询语言，具有与SQL相类似的特征，JPQL是完全面向对象的，具备继承，多态和关联等特性，和hibernate HQL很相似
.1，动态传入参数，查询语句的参数
JPQL语句支持两种方式的参数定义方式：命名参数和位置参数。在同一个查询语句中只允许使用一种参数定义方式。
命令参数的格式为：“：+参数名”
例：
查询查询= em .createQuery（“从Person p中选择p，其中p.personid =：Id”）;
query.setParameter（“Id”，new Integer（1））;
位置参数的格式为“？+位置编号”
例：
查询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
查询setParameter（String name，Calendar value，TemporalType temporalType）;
//位置参数查询时使用，参数类型为java.util.Date
查询setParameter（int position，Date value，TemporalType temporalType）;
//位置参数查询时使用，参数类型为java.util.Calendar
查询setParameter（int position，Calendar value，TemporalType temporalType）;
}
因为一个日期或日历对象能够描述一个真实的日期，时间或时间戳。所以我们需要告诉查询对象怎么使用这些参数，我们把javax.persistence.TemporalType作为参数传递进setParameter方法，告诉查询接口在转换java.util.Date或java.util.Calendar参数到本地SQL时间使用什么数据库类型。
下面通过实例来学习JPQL语句，例子的实体Bean有人，Order，OrderItem，他们之间的关系是：一个人有多个订单，一个订单有多个OrderItem.JPQL
语句的大小写敏感性：除了Java类和属性名称外，查询都是大小写不敏感的。所以，SeLeCT和sELEct以及SELECT相同的，但是com.foshanshop.ejb3.bean.Person和com.foshanshop.ejb3.bean.PERSon是不同的，人.name和person.NAME也是不同的
.2，命名查询
可以在实体bean上通过@NamedQuery或@NamedQueries预先定义一个或多个查询语句，减少每次因书写错误而引起的BUG。通常把经常使用的查询语句定义成命名查询。
定义单个命名查询：
@NamedQuery（NAME = “getPerson”，查询= “？从一个人WHERE PERSONID = 1”）
@实体
公共类Person实现Serializable {
如果要定义多个命名查询，应在@javax.persistence.NamedQueries里定义@NamedQuery：
@NamedQueries（{ @
NamedQuery（nam）e =“getPerson”，query =“
@NamedQuery（name =“getPersonList”，query =“FROM Person WHERE age>？1”）
}）@
Entity
public class Person实现Serializable {
当命名查询定义好了之后，我们就可以通过名称执行其查询。代码如下：
查询查询= em。createNamedQuery（“getPerson”）;
query.setParameter（1,1）;
3，排序（order by）
“ASC”和“DESC”分别为升序和降序，JPQL中默认为asc升序
例：
//先按年龄降序排序，然后按出生日期升序排序
查询查询= em.createQuery（“通过p.age desc，p.birthday asc“）从Person p order中选择p;
4，查询部分属性
通常来说，都是针对实体类的查询，返回的也是被查询的实体类的实体.JP QL也允许我们直接查询返回我们需要的属性，而不是返回整个实体。在一些实体中属性特别多的情况，这样的查询可以提高性能
例：
//只查询我们感兴趣的属性（列）
查询查询= em.createQuery（“通过p.personid desc从Person p order中选择p.personid，p.name”）;
//集合中的元素不再是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（）;
....
}
}
查询中使用构造器（构造函数）
JPQL支持将查询的属性结果直接作为一个java类的构造器参数，并产生实体作为结果返回。例如上面的例子只获取人类实体bean的名称和personid属性，我们不希望返回的集合的元素是object []，而希望用一个类来包装它。就要用到使用构造器。例如
：
public class SimplePerson {
private Integer personid;
私有字符串名称;
....
public SimplePerson（）{
}
public SimplePerson（Integer personid，String name）{
this。name = name;
这个 。personid = personid;
}
}
查询代码为：
//我们把需要的两个属性作为SimplePerson的构造器参数，并使用新的函数
。查询的查询= em.createQuery（”选择新com.foshanshop.ejb3.bean.SimplePerson（对PERSONID ，p.name）来自p.personid desc的Person p order“）;
//集合中的元素是SimplePerson对象
List result = query.getResultList（）;
if（result！= null）{
Iterator iterator = result.iterator（）;
while（iterator.hasNext（））{
SimplePerson simpleperson =（SimplePerson）iterator.next（）;
....
}
}
5，聚合查询（聚合）
JPQL支持的聚合函数包括：
1，AVG（）
2. SUM（）
3. COUNT（），返回类型为龙，注意COUNT（*）语法在休眠中可用，但在排名靠前的其它产品中并不可用
4。MAX（）
5 MIN（）
例：
//获取最大年龄
查询查询= em.createQuery（“从Person p中选择max（p.age）”）;
Object result = query.getSingleResult（）;
String maxAge = result.toString（）;
//获取平均年龄
query = em.createQuery（“从Person p中选择avg（p.age）”）;
//获取最小年龄
query = em.createQuery（“select p（p.age）from Person p”）;
//获取总
人数query = em.createQuery（“从Person p中选择count（p）”）;
//获取年龄
总和query = em.createQuery（“从Person p中选择sum（p.age）”）;
如果聚合函数不是select ... from的唯一一个返回列，需要使用“GROUP BY”语句。“GROUP BY”应该包含select语句中除了聚合函数外的所有属性。
例：
//返回男女生各自的总人数
查询的查询= em.createQuery（ “选择p.sex，通过p.sex计数（p）从Person p基团”）;
//集合中的元素不再是Person，而是一个Object []对象
数组列表结果= query.getResultList（）;
如果还需要加上查询条件，需要使用“HAVING”条件语句而不是“WHERE”语句
例：
//返回人数超过1人的性别
查询查询= em.createQuery（“选择p.sex，计数（p）来自Person p group by p.sex having count（*）>？1”）;
//设置查询中的参数
query.setParameter（1，new Long（1））;
//集合中的元素不再是Person，而是一个Object []对象
数组List result = query.getResultList（）;
内连接
左连接提取/内连接提取
6，多表查询，关联查询
省略连接/左连接等，都是允许符合条件的右边表达式中的Entiies为空（需要显式使用左连接/左外连接的情况会比较少。）
例：
//获取26岁人的订单，不管订单中是否有
订单选择o来自订单o左加入o.orderItems其中o.ower.age = 26订单由o.orderid
内连接要求右边的表达式必须返回实体。
例：
//获取26岁人的订单，订单中必须要有OrderItem
从订单o内部加入o.orderItems选择o其中o.ower.age = 26订购o.orderid
!!重要知识点：在默认的查询中，Entity中的集合属性默认不会被关联，集合属性默认是延迟加载（lazy-load）。那么，left fetch / left out fetch / inner join fetch提供了一种灵活的查询加载方式来提高查询的性能。例如
：
private String QueryInnerJoinLazyLoad（）{
//默认不关联集合属性变量（orderItems）对应的表
查询查询= em.createQuery（“从订单o内部加入o.orderItems中选择o，其中o.ower.age = 26 by o.orderid”）;
List result = query.getResultList（）;
if（result！= null && result.size（）> 0）{
//这时获得Order实体中orderItems（集合属性变量）为空
Order Order =（Order）result.get（0）;
//当需要时，EJB3 Runtime才会执行一条SQL语句来加载属于当前Order的
// OrderItems
Set
Iterator
if（iterator.hasNext（））{
OrderItem orderItem = iterator.next（）;
System.out.println（“订购产品名：”+ orderItem.getProductname（））;
}
}
上面代码在执行“从订单o内部加入o.orderItems中选择o其中o.ower.age = 26 by o.orderid”时编译成的SQL如下（他不包含集合属性变量（orderItems）对应表的字段） ：
选择order0_.orderid作为orderid6_，order0_.amount作为amount6_，order0_.person_id作为
person4_6_，order0_.created作为createdate6_从Orders order0_ inner join OrderItems
orderitems1_ on order0_.orderid = orderitems1_.order_id，Person person2_ where
order0_.person_id = person2_。 personid和person2_.age = 26 order by order0_.orderid
上面代码当执行到Set
选择orderitems0_.order_id为order4_1_，orderitems0_.id为id1_，orderitems0_.id为id7_0_，
orderitems0_.order_id as order4_7_0_，orderitems0_.productname as productn2_7_0_，
orderitems0_.price as price7_0_ from OrderItems orderitems0_ where orderitems0_.order_id =？
order by orderitems0_.id ASC
这样的查询性能上有不足的地方。为了查询N个订单，我们需要一条SQL语句获得所有的Order的原始对象属性，但需要另外N条语句获得每个订单的orderItems集合属性。为了避免N + 1的性能问题，我们可以利用join fetch一次过用一条SQL语句把订单的所有信息查询出来
例子
//获取26岁人的订单，订购中必须要有OrderItem
查询查询= em.createQuery （“从订单o内部联接获取o.orderItems中选择o，其中
o.ower.age = 26 by
o.orderid ”）; 上面这句HPQL编译成以下的SQL：
选择order0_.orderid作为orderid18_0_，orderitems1_.id as id19_1_，order0_.amount as
amount18_0_，order0_.person_id as person4_18_0_，order0_.createdate as createdate18_0_，
orderitems1_.order_id as order4_19_1_，orderitems1_.productname as productn2_19_1_，
orderitems1_.price as price19_1_，orderitems1_.order_id as order4_0__，orderitems1_.id as id0__
from Orders order0_ inner join OrderItems orderitems1_在
order0_.orderid = orderitems1_.order_id，Person person2_，其中
order0_.person_id = person2_.personid和person2_.age = 26 order by Order0_.orderid，
orderitems1_.id ASC
上面由于使用了获取，这个查询只会产生一条SQL语句，比原来需要N + 1条SQL语句在性能上有了极大的提升
7，排除相同的记录DISTINCT
使用关联查询，我们很经常得到重复的对象，如下面语句：
“从订单o内部联接 获取中选择o o.orderItems由o.orderid命令“
当有N个orderItem时就会产生N个订单，而有些订单对象往往是相同的，这时我们需要使用DISTINCT关键字来排除掉相同的对象。例如
：
从订单o内部联接获取o选择DISTINCT o。 orderItems按o.orderid排序
DISTINCT后边还可以跟属性例如o.name
比较实体
在查询中使用参数查询时，参数类型除了String，原始数据类型（int，double等）和它们的对象类型（整数，双等），也可以是实体的查询查询= em.createQuery（“从订单o中选择o，其中o.ower =？1订单由o.orderid”） 的实际。
例：
//查询某人的所有订单 人人=新人（）; person.setPersonid（new Integer（1））; //设置查询中的参数 query.setParameter（1，person）; 8，批量更新（批量更新） HPQL支持批量更新 例：//把所有订单的金额加10 查询查询= em.createQuery（“更新订单为o set o.amount = o.amount + 10”）; // update的记录数 int result = query。executeUpdate（）; 9，批量删除（Batch Remove） 例：//把金额小于100的订单删除，先删除订单子项，再删除订单
查询查询= em .createQuery（“从OrderItem项目中删除item.order in（从订单为o，其中o.amount <100）”）;
查询。的executeUpdate（）;
query = em .createQuery（“从订单中删除为o，其中o.amount <100”）;
query.executeUpdate（）; // delete的记录数
10，使用操作
符号//查询除了指定人之外的所有订单
查询查询= em.createQuery（“从订单o中选择o其中不是（o.ower =？1）按o排序。订单ID“）;
人人=新人（）;
person.setPersonid（new Integer（2））;
//设置查询中的参数
query.setParameter（1，person）;
操作符BETWEEN
从订单中选择o为o其中o.amount介于300和1000之间
使用操作符IN
//查找年龄为26,21的人
从中选择p作为p的人在（26,21）
使用操作符LIKE
//查找以字符串“li”开头的人
从p选择p作为p，其中p.name如'li％'
使用操作符IS NULL
//查询含有购买者的所有
从订单选择o o其中o.ower是[not] null
使用操作符IS EMPTY
IS EMPTY是针对集合属性（Collection）的操作符。可以和NOT一起使用。注：低版权的Mysql不支持IS EMPTY
//查询含有订单项的所有订单
从订单中 选择o其中o.orderItems是[not]空
使用操作符EXISTS
[NOT] EXISTS需要和子查询配合使用。注：低版权的Mysql不支持EXISTS
//如果存在订单号为1的订单，就获取所有OrderItem
从OrderItem中 选择oi作为oi存在（从订单o中选择o，其中o.orderid = 1）
//如果不存在订单号为10的订单，就获取id为1的OrderItem
从OrderItem中选择oi为oi，其中oi.id = 1且不存在（从订单o中选择o，其中o.orderid = 10）
字符串函数
JPQL定义了内置函数方便使用。这些函数的使用方法和SQL中相应的函数方法类似。包括：
1。CONCAT字符串拼接
2。SUBSTRING字符串截取
3。TRIM去掉空格
4。LOWER转换成小写
5。UPPER装换成大写
6。LENGTH字符串长度
7。LOCATE字符串定位
例：
//查询所有人员，并在姓名后面加上字符串“_foshan”
从人员中选择p.personid，concat（p.name，'_ foshan'）作为p
//查询所有人员，只取姓名的前三个
字符从Person选择p.personid，substring（p.name，1,3）作为p
计算函数
HPQL定义的计算函数包括：
ABS绝对值
SQRT平方根
MOD取余数
SIZE取集合的数量
例：
/ /查询所有订单的订单号及其订单项的数量
选择o.orderid，size（o.orderItems）从Order as o group by o.orderid
//查询所有Order的订单号及其总金额/ 10的余数
select o.orderid，mod（o.amount，10）from订购为o
子查询
子查询可以用于WHERE和HAVING条件语句中
例：
//查询年龄为26岁的购买者的所有订单
从订单中选择o o其中o.ower in（从Person选择p作为p其中p.age = 26）
结果集分页
有些时候当执行一个查询会返回成千上万条记录，事实上我们只需要显示一部分数据。这时我们需要对结果集进行分页，QueryAPI有两个接口方法可以解决这个问题：setMaxResults（）和setFirstResult（）。
setMaxResults方法设置获取多少条记录
setFirstResult方法设置从结果集中的那个索引开始获取（假如返回的记录有3条，容器会自动为记录编索索引，索引从0开始，依次为0,1,2）
例：
public List getPersonList（int max，int whichpage）{
try {
int index =（whichpage-）1）* max;
查询查询= em .createQuery（“来自person p order by personid asc”）;
列表列表=查询。setMaxResults（max）。
setFirstResult（index）。
getResultList（）;
em .clear（）; //分离内存中受EntityManager管理的实体bean，让VM进行垃圾回收
返回列表;
}
查询部分字段
package com.jxwy.tagmanagement.repository.tag;
import com.jxwy.tagmanagement.model.tag.TagInfo;
import com.jxwy.tagmanagement.utils.CommonConstant;
import com.jxwy.tagmanagement.vo.tag.ITagInfoForDataColVo;
import org.springframework.data.domain.Page;
import org.springframework.data.domain.Pageable;
import org.springframework.data.jpa.repository.JpaRepository;
import org.springframework.data.jpa.repository.Modifying;
import org.springframework.data.jpa.repository.Query;
import org.springframework.data.repository.query.Param;
import org.springframework.stereotype.Repository;
import java.util.List;
@Repository
public interface ITagInfoRepository extends JpaRepository {
/**
* 返回模型标签，规则不为空的，标签规则经过测试的
* 返回部分字段
* @param categoryId
* @return
*/
@Query(value = "select new com.jxwy.tagmanagement.vo.tag.ITagInfoForDataColVo( T.id , T.name ) from TagInfo T where T.tagCategory.id= :categoryId and T.tagType = 0 and T.tagRule is not null and T.tagRule.approve = 1")
List findModelTagInfo(@Param(value = "categoryId") Integer categoryId);
}
package com.jxwy.tagmanagement.vo.tag;
import lombok.Data;
import java.io.Serializable;
import java.util.Date;
@Data
public class ITagInfoForDataColVo implements Serializable {
private static final long serialVersionUID = 3352308001656988484L;
private Integer id;
private String name;
public ITagInfoForDataColVo (Integer id,String name){
this.id = id;
this.name = name;
}
}