如何使用EclipseLink解析并修改JPQL实现数据权限控制？

1. 用EclipseLink解析修改JPQL的方向完全正确 #

自己从零开发JPQL解析器的成本极高，还要处理各种JPQL语法规则（比如不同JPA版本的特性、复杂的关联查询、子查询等），而EclipseLink作为成熟的JPA实现，其自带的JPQL解析器是经过充分测试的，完全适配JPA规范，用来做动态权限过滤这类场景非常合适。你的现有代码已经正确识别了SELECT/UPDATE/DELETE语句，这是很好的起点。

2. 优先操作解析后的AST对象，而非拼接字符串 #

EclipseLink的JPQL解析器生成的是抽象语法树（AST），你可以直接修改这些AST节点，而不需要手动拼接JPQL字符串——这是更可靠的方式，能避免手动拼接带来的语法错误（比如遗漏括号、关键字冲突等）。

举个添加权限条件的示例：

SelectStatement st = (SelectStatement) jpql.getQueryStatement();
WhereClause whereClause = st.getWhereClause();

// 构建权限条件表达式：c.reader = :user
SimpleConditionalExpression permissionCondition = new SimpleConditionalExpression(
    new StateFieldPathExpression("c.reader"),
    EqualExpression.EQUAL,
    new InputParameter(":user")
);

if (whereClause == null) {
    // 原查询没有WHERE子句，直接创建新的WHERE子句
    whereClause = new WhereClause();
    whereClause.setConditionalExpression(permissionCondition);
    st.setWhereClause(whereClause);
} else {
    // 原查询已有WHERE子句，用AND合并原有条件和权限条件
    ConditionalExpression originalCondition = whereClause.getConditionalExpression();
    ConditionalExpression combinedCondition = new AndExpression(originalCondition, permissionCondition);
    whereClause.setConditionalExpression(combinedCondition);
}

// 生成修改后的JPQL字符串
String modifiedJpql = st.toString();

这种方式能自动处理复杂场景，比如原有WHERE子句包含括号、逻辑运算符的情况，保证最终JPQL的语法正确性。

3. 避免使用内部包，Hermes是EclipseLink的JPQL解析器代号 #

• 关于内部包：org.eclipse.persistence.internal.jpa.jpql属于EclipseLink的内部实现包，这类包的API没有向后兼容承诺，版本升级时可能会被修改或移除，所以绝对应该避免直接使用。你当前使用的org.eclipse.persistence.jpa.jpql.parser是公开的官方API，完全可以放心使用。
• 关于Hermes：Hermes就是EclipseLink JPQL解析器的内部项目代号，package-info里的标注只是说明这个包是解析器的核心实现部分，你使用这个公开包的类是完全合规的，不需要担心。

宏观指导与实践建议 #

• 坚持使用公开API：始终基于org.eclipse.persistence.jpa.jpql.parser包下的类进行开发，不要依赖任何internal包的内容。
• 覆盖多场景测试：测试不同类型的JPQL查询，比如带JOIN的查询、子查询、聚合查询、已有复杂WHERE条件的查询，确保权限条件能正确插入且不破坏原有逻辑。
• 参考EclipseLink源码测试：如果需要更多AST操作的示例，可以查看EclipseLink源码中的JPQL解析测试类（比如JPQLExpressionTest），里面有很多操作AST的场景案例。
• 考虑性能：如果你的系统有大量动态查询修改需求，可以考虑缓存解析后的AST或修改后的JPQL字符串，减少重复解析的开销。

内容的提问来源于stack exchange，提问作者Reed Elliott