JPQL 设计器

JPQL 设计器是一种简化 Jmix 中创建和修改 JPQL 查询语句的可视化工具。其目的是对手工编写 JPQL 的工作进行抽象，使所有的开发者都能处理数据的访问。

JPQL 设计器提供了用于构建 JPQL 查询语句的界面。可以在不直接编写 JPQL 代码的情况下定义目标表，数据选择条件，排序和其他参数。该工具输出正确格式的 JPQL 查询字符串。

此功能可在最多 10 个实体和角色的小项目中免费使用。在大项目中，需要快速开发版或企业版订阅^。

核心功能包括：

启动 JPQL 设计器

JPQL 设计器可以通过以下方式启动：

JPQL 设计器提供了一个对话框，显示查询语句的结构，用户可以编辑并添加查询语句的功能。

JPQL 设计器会显示生成的 JPQL 语句，以进行审查。

JPQL 设计器在保存前会执行检查，以确保语句的结构正确，具体会检查：

当保存 JPQL 查询语句结构时，设计器会生成一个 JPQL 字符串，并根据设计器打开的方式将语句保存在原来的 Java 或 XML 文件中。

如果打开设计器修改已有的语句，则会在加载时解析该语句。但是，如果已有语句使用了设计器不支持的结构（例如嵌套的子查询），则不会打开设计器并弹出消息告知开发者。

创建新查询语句时，设计器会提示用户选择一个查询的根实体（即 "from E" 子句）。

当编辑已有的查询语句时，除非完全清空已有的查询语句结构，否则不允许修改查询的根实体。

Result type 字段用于指定查询的输出参数类型。

输出参数可以是：

可以指定多个输出参数。以及，还可以使用 Distinct 选项。

JPQL 设计器提供了几种方式用于设置查询条件，可以对数据进行过滤或排序。本小节将介绍在 JPQL 设计器使用 WHERE、HAVING、ORDER BY 的详细内容。

WHERE 子句可以根据 JPQL 中的一个或多个条件对数据进行过滤。

在 JPQL 设计器中，可以使用实体属性和值的相关可视化控件定义 WHERE 条件。包含：

JPQL 设计器提供了下列功能：

子条件的构造：
- 选择操作符：=、<>、>、<、>=、<=、IN、NOT IN、LIKE、NOT LIKE、IS NULL、IS NOT NULL。
- LIKE 中支持修饰符：%、_。
- 字符串函数：LOWER、UPPER、TRIM 等。
- 支持日期时间函数：CURRENT_DATE、CURRENT_TIME、CURRENT_TIMESTAMP 等。
条件组合：
- AND：两个条件需都为 true。
- OR：至少一个条件为 true。
带参数的条件：

还可以定义带参数的条件。可用于动态查询语句的构建。在设计器中定义参数，执行查询时传入参数。