如何在 Java 中动态生成 JsonPath 表达式(无需硬编码)

发布时间 - 2026-01-07 00:00:00    点击率:

本文介绍如何根据运行时用户筛选条件(如国家代码、房间数等)动态构建合法、安全的 jsonpath 表达式,避免字符串拼接风险,提升可维护性与灵活性。

在实际企业级 JSON 数据处理场景中,前端常需向后端传递动态筛选条件(例如:国家代码为 "IN" 或 "ENG",且公寓房间数为 1 或 2),而后端需据此生成对应的 JsonPath 表达式对原始 JSON 进行过滤。若直接使用字符串拼接(如 "$.countries[?(@.country.countryCode=='IN')].building[?(@.floor[?(@.apartment[?(@.rooms==1)])])]")不仅易出错、难维护,还存在注入与语法错误风险。

推荐采用 语义化构建 + 第三方库辅助 的方式实现动态 JsonPath 生成。以下以主流库 Jayway JsonPath 为例(Maven 依赖:com.jayway.jsonpath:json-path:2.9.0),展示专业、可扩展的实现方案:

✅ 正确做法:基于 Criteria 构建可组合过滤器

Jayway JsonPath 提供了 Filter 和 Criteria API,支持链式构建逻辑表达式,避免手写复杂字符串:

import com.jayway.jsonpath.Configuration;
import com.jayway.jsonpath.DocumentContext;
import com.jayway.jsonpath.Filter;
import com.jayway.jsonpath.Criteria;
import com.jayway.jsonpath.JsonPath;
import com.jayway.jsonpath.Option;

import java.util.Arrays;
import java.util.List;

public class DynamicJsonPathGenerator {

    /**
     * 动态生成 JsonPath 过滤表达式
     * @param countryCodes 允许的国家代码列表(如 ["IN", "ENG"])
     * @param roomNumbers  允许的房间数列表(如 [1, 2])
     * @return 完整的 JsonPath 字符串(兼容 $.countries[*].country.* 结构)
     */
    public static String generateJsonPath(List countryCodes, List roomNumbers) {
        // Step 1: 构建国家码匹配条件(嵌套在 countries[*].country 下)
        Criteria countryCriteria = Criteria.where("country.countryCode").in(countryCodes.toArray());

        // Step 2: 构建房间数匹配条件(深层嵌套:building[*].floor[*].apartment[*].rooms)
        // 注意:JsonPath 中需用 '..' 或显式路径;此处按原始结构展开
        String roomCondition = String.format(
            "building[*].floor[*].apartment[*].rooms in %s",
            roomNumbers.toString().replace("[", "[").replace("]", "]")
        );

        // Step 3: 组合为完整 Filter(注意:Jayway 的 Filter 不直接支持多层嵌套 in,建议分步或改用 Predicate)
        // 更健壮方式:使用 DocumentContext 配合自定义 Predicate(见下方进阶示例)
        return "$.countries[?(@." + countryCriteria.toString() + ")]"
                + ".[" + roomCondition + "]";
    }

    // ✅ 推荐进阶方案:使用 Predicate 实现类型安全、可调试的动态过滤
    public static  List filterJsonByDynamicCriteria(String json, List countryCodes, List roomNumbers) {
        Configuration config = Configuration.defaultConfiguration();
        DocumentContext ctx = JsonPath.parse(json, config);

        // 自定义 Predicate —— 完全可控、可单元测试、无字符串注入风险
        Predicate predicate = item -> {
            if (!(item instanceof Map)) return false;
            Map countryMap = (Map) item;
            Object countryCodeObj = getNestedValue(countryMap, "country", "countryCode");
            if (countryCodeObj == null || !countryCodes.contains(countryCodeObj.toString())) {
                return false;
            }

            Object buildingsObj = getNestedValue(countryMap, "country", "building");
            if (!(buildingsObj instanceof List)) return false;

            for (Object building : (List) buildingsObj) {
                if (!(building instanceof Map)) continue;
                Object floorsObj = getNestedValue((Map) building, "floor");
                if (!(floorsObj instanceof List)) continue;

                for (Object floor : (List) floorsObj) {
                    if (!(floor instanceof Map)) continue;
                    Object apartmentsObj = getNestedValue((Map) floor, "apartment");
                    if (!(apartmentsObj instanceof List)) continue;

                    for (Object apt : (List) apartmentsObj) {
                        if (!(apt instanceof Map)) continue;
                        Object roomsObj = getNestedValue((Map) apt, "rooms");
                        if (roomsObj instanceof Number && roomNumbers.contains(((Number) roomsObj).intValue())) {
                            return true; // 找到匹配项
                        }
                    }
                }
            }
            return false;
        };

        return ctx.parseJson()
                .read("$.countries[?]", List.class)
                .stream()
                .filter(predicate)
                .map(Object::toString)
                .map(s -> (T) s)
                .toList();
    }

    // 辅助方法:安全获取嵌套 Map 值
    private static Object getNestedValue(Map map, String... keys) {
        Object result = map;
        for (String key : keys) {
            if (result instanceof Map && ((Map) result).containsKey(key)) {
                result = ((Map) result).get(key);
            } else {
                return null;
            }
        }
        return result;
    }
}

⚠️ 注意事项与最佳实践

  • 避免纯字符串拼接:"$.countries[" + index + "]" 类方式极易引发越界或语法错误,且无法校验 JSON 结构合法性;
  • 优先使用 Predicate + DocumentContext.read():比生成 JsonPath 字符串更灵活、更易调试,尤其适合复杂嵌套与运行时逻辑;
  • 输入校验不可少:对 countryCodes、roomNumbers 等参数做空值、非法字符(如 ', ], *)过滤,防止恶意构造;
  • 性能考量:若数据量极大,建议预编译 JsonPath(JsonPath.compile(path))并复用;
  • 替代方案参考:对简单场景,也可结合 Jackson 的 JsonNode 遍历 + 条件判断,语义更清晰。

✅ 总结

动态生成 JsonPath 的本质不是“拼字符串”,而是将业务筛选逻辑映射为可执行的、类型安全的过滤策略。借助 Jayway JsonPath 的 Predicate 或 Jackson 的树模型遍历,不仅能彻底规避硬编码,还能保障健壮性、可测性与长期可维护性。在微服务与低代码平台中,此类能力是构建动态 API 查询能力的关键基础设施。


# java  # js  # 前端  # json  # node  # 编码  # 后端  # ai  # stream  # red 


相关栏目: 【 网站优化151355 】 【 网络推广146373 】 【 网络技术251813 】 【 AI营销90571


相关推荐: Laravel怎么实现一对多关联查询_Laravel Eloquent模型关系定义与预加载【实战】  高性能网站服务器配置指南:安全稳定与高效建站核心方案  PythonWeb开发入门教程_Flask快速构建Web应用  Laravel怎么导出Excel文件_Laravel Excel插件使用教程  bootstrap日历插件datetimepicker使用方法  Laravel Eloquent关联是什么_Laravel模型一对一与一对多关系精讲  如何在浏览器中启用Flash_2025年继续使用Flash Player的方法【过时】  Laravel如何设置自定义的日志文件名_Laravel根据日期或用户ID生成动态日志【技巧】  北京专业网站制作设计师招聘,北京白云观官方网站?  javascript和jQuery中的AJAX技术详解【包含AJAX各种跨域技术】  Laravel中DTO是什么概念_在Laravel项目中使用数据传输对象(DTO)  Windows11怎样设置电源计划_Windows11电源计划调整攻略【指南】  装修招标网站设计制作流程,装修招标流程?  Win11怎么关闭透明效果_Windows11辅助功能视觉效果设置  详解免费开源的DotNet二维码操作组件ThoughtWorks.QRCode(.NET组件介绍之四)  JS去除重复并统计数量的实现方法  Android滚轮选择时间控件使用详解  JS弹性运动实现方法分析  东莞市网站制作公司有哪些,东莞找工作用什么网站好?  Laravel如何设置定时任务(Cron Job)_Laravel调度器与任务计划配置  公司门户网站制作公司有哪些,怎样使用wordpress制作一个企业网站?  如何使用 jQuery 正确渲染 Instagram 风格的标签列表  作用域操作符会触发自动加载吗_php类自动加载机制与::调用【教程】  在线ppt制作网站有哪些软件,如何把网页的内容做成ppt?  Laravel如何使用Facades(门面)及其工作原理_Laravel门面模式与底层机制  猎豹浏览器开发者工具怎么打开 猎豹浏览器F12调试工具使用【前端必备】  今日头条AI怎样推荐抢票工具_今日头条AI抢票工具推荐算法与筛选【技巧】  如何在Windows环境下新建FTP站点并设置权限?  Python高阶函数应用_函数作为参数说明【指导】  Linux虚拟化技术教程_KVMQEMU虚拟机安装与调优  laravel怎么为应用开启和关闭维护模式_laravel应用维护模式开启与关闭方法  香港服务器WordPress建站指南:SEO优化与高效部署策略  Laravel模型关联查询教程_Laravel Eloquent一对多关联写法  Laravel模型事件有哪些_Laravel Model Event生命周期详解  如何用VPS主机快速搭建个人网站?  Laravel如何配置.env文件管理环境变量_Laravel环境变量使用与安全管理  哪家制作企业网站好,开办像阿里巴巴那样的网络公司和网站要怎么做?  大连企业网站制作公司,大连2025企业社保缴费网上缴费流程?  佐糖AI抠图怎样调整抠图精度_佐糖AI精度调整与放大细化操作【攻略】  Laravel项目如何进行性能优化_Laravel应用性能分析与优化技巧大全  Laravel如何实现图片防盗链功能_Laravel中间件验证Referer来源请求【方案】  jQuery中的100个技巧汇总  使用PHP下载CSS文件中的所有图片【几行代码即可实现】  微博html5版本怎么弄发语音微博_语音录制入口及时长限制操作【教程】  如何确认建站备案号应放置的具体位置?  中国移动官方网站首页入口 中国移动官网网页登录  手机怎么制作网站教程步骤,手机怎么做自己的网页链接?  如何快速搭建支持数据库操作的智能建站平台?  Laravel如何使用Gate和Policy进行权限控制_Laravel权限判定与策略规则配置  Win11怎么开启自动HDR画质_Windows11显示设置HDR选项