JSONPath 动态属性提取:基于事件类别的运行时字段路由设计

云伟小哥_9096

云伟小哥_9096

2026-04-11

947人浏览

原创

JSONPath 动态属性提取:基于事件类别的运行时字段路由设计

本文介绍如何在 spring/java 项目中,通过 jsonpath 实现按 json 数据中动态类别(如 finance、insurance)灵活提取不同路径字段的通用设计方案,支持配置化扩展与松耦合业务处理。

本文介绍如何在 spring/java 项目中,通过 jsonpath 实现按 json 数据中动态类别(如 finance、insurance)灵活提取不同路径字段的通用设计方案,支持配置化扩展与松耦合业务处理。

在构建面向多类型事件的 REST 微服务时,常需根据请求体中的 category 字段(如 "Finance"、"Insurance"、"Commodity")决定后续应读取并处理哪些嵌套字段——例如 Finance 类别关注 $.history.type,而 Insurance 可能需解析 $.policy.underwriter。硬编码分支逻辑不仅难以维护,也违背开闭原则。推荐采用 JSONPath + 配置驱动路由 的轻量级设计模式。

核心思路:解耦“分类识别”与“字段提取”

  1. 统一解析入口:使用 JsonPath.parse() 将原始 JSON 构建为可查询的 DocumentContext;
  2. 两级路径映射:
    • 固定路径(如 $.marketEvent.category)提取类别标识;
    • 动态映射表(Map)将类别名映射到目标 JSONPath 表达式;
  3. 运行时查表+执行:先读取 category,再查表获取对应路径,最后执行 read() 提取值。

示例实现(Spring 兼容)

// 配置类:建议注入 @ConfigurationProperties 或从数据库/配置中心加载
@Component
public class CategoryFieldMapping {
    private final Map<string string> mapping = new HashMap();

    public CategoryFieldMapping() {
        mapping.put("Finance", "$.history.type");
        mapping.put("Insurance", "$.policy.underwriter");
        mapping.put("Commodity", "$.trade.instrument");
    }

    public String getPathForCategory(String category) {
        return mapping.getOrDefault(category, null);
    }
}

// 业务处理器
@Service
public class DynamicFieldExtractor {

    private final CategoryFieldMapping fieldMapping;

    public DynamicFieldExtractor(CategoryFieldMapping fieldMapping) {
        this.fieldMapping = fieldMapping;
    }

    public <t> T extractByCategory(String jsonPayload, String categoryPath, Class<t> targetType) {
        DocumentContext context = JsonPath.parse(jsonPayload);

        // 步骤1:提取类别
        String category = context.read(categoryPath, String.class);
        if (category == null) {
            throw new IllegalArgumentException("Category not found at path: " + categoryPath);
        }

        // 步骤2:查表获取目标路径
        String targetPath = fieldMapping.getPathForCategory(category);
        if (targetPath == null) {
            throw new UnsupportedOperationException("No field mapping configured for category: " + category);
        }

        // 步骤3:执行提取(支持泛型转换)
        return context.read(targetPath, targetType);
    }
}</t></t></string>

使用示例(Controller 层)

@PostMapping("/process")
public ResponseEntity> handleEvent(@RequestBody String payload) {
    try {
        String historyType = extractor.extractByCategory(
            payload,
            "$.marketEvent.category",
            String.class
        );
        log.info("Extracted for category: {}", historyType);
        return ResponseEntity.ok(Map.of("extracted", historyType));
    } catch (Exception e) {
        return ResponseEntity.badRequest().body("Extraction failed: " + e.getMessage());
    }
}

注意事项与最佳实践

  • ✅ 路径健壮性:生产环境建议使用 read(path, configuration) 自定义 Option.DEFAULT_PATH_LEAF_TO_NULL,避免空指针;
  • ✅ 性能优化:若 JSON 规模大且高频调用,可预编译 JsonPath.compile(path) 缓存表达式;
  • ✅ 配置外置化:将 CategoryFieldMapping 改为 @ConfigurationProperties("jsonpath.mapping"),支持 YAML 动态配置;
  • ⚠️ 安全边界:禁止将用户输入直接拼接为 JSONPath 表达式,防止路径注入(本方案因查表隔离,天然免疫);
  • ? 扩展性增强:可进一步抽象为策略接口 FieldExtractionStrategy,按 category 加载不同策略 Bean,适配更复杂逻辑(如多字段聚合、条件过滤)。

该设计以极低侵入性实现“数据结构不变、业务规则可配”,完美契合云原生场景下快速迭代与多租户差异化需求。

JSON Toolkit
JSON Toolkit

JSON文件多功能工具。支持格式化、验证、压缩、键排序及点记法路径查询。零依赖。

下载

相关文章

路由优化大师
路由优化大师

路由优化大师是一款及简单的路由器设置管理软件,其主要功能是一键设置优化路由、屏广告、防蹭网、路由器全面检测及高级设置等,有需要的小伙伴快来保存下载体验吧!

下载

相关标签:

js json 路由

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
spring框架介绍
spring框架介绍

本专题整合了spring框架相关内容,想了解更多详细内容,请阅读专题下面的文章。

2025.08.06

3031

22

Java Spring Security 与认证授权
Java Spring Security 与认证授权

本专题系统讲解 Java Spring Security 框架在认证与授权中的应用,涵盖用户身份验证、权限控制、JWT与OAuth2实现、跨站请求伪造(CSRF)防护、会话管理与安全漏洞防范。通过实际项目案例,帮助学习者掌握如何 使用 Spring Security 实现高安全性认证与授权机制,提升 Web 应用的安全性与用户数据保护。

2026.01.26

537

25

json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

2023.08.07

2375

5

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.23

3942

1

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

2023.10.13

1296

3

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

2025.09.10

4579

7

string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.02

7699

3

C++ 智能指针与现代内存管理
C++ 智能指针与现代内存管理

深入讲解 C++ 现代内存管理的核心工具——智能指针,涵盖 unique_ptr 独占所有权语义、shared_ptr 引用计数机制与循环引用问题、weak_ptr 弱引用的应用场景、make_unique/make_shared 工厂函数的性能优势、自定义删除器的编写、RAII 资源管理思想的实践,以及从裸指针迁移到智能指针的重构策略,帮助开发者编写安全无泄漏的现代 C++ 代码。

2026.04.23

399

31

treenode的用法
treenode的用法

​在计算机编程领域,TreeNode是一种常见的数据结构,通常用于构建树形结构。在不同的编程语言中,TreeNode可能有不同的实现方式和用法,通常用于表示树的节点信息。更多关于treenode相关问题详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.12.01

2961

7

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WEB前端教程【HTML5+CSS3+JS】
WEB前端教程【HTML5+CSS3+JS】

共101课时 | 21.4万人学习

JS进阶与BootStrap学习
JS进阶与BootStrap学习

共39课时 | 4.9万人学习