JSON路径工具类`JsonPathUtil`的实现与应用

訾博ZiBo

发布于 2025-01-06 20:57:31

6800

代码可运行

文章被收录于专栏：全栈开发工程师全栈开发工程师

运行总次数：0

代码可运行

JSON路径工具类`JsonPathUtil`的实现与应用

作者：zibo 日期：2024/11/25 口号：慢慢学，不要停。

〇、完整代码

package com.kumy.requrchase.treasure.service.letusign.impl;

import com.fasterxml.jackson.core.type.TypeReference;
import com.fasterxml.jackson.databind.ObjectMapper;

import java.lang.reflect.Field;
import java.util.List;
import java.util.Map;
import java.util.Objects;

/**
 * JSON路径工具类
 * 用于根据表达式获取JSON字符串中的值
 * 支持以下功能:
 * 1. 获取普通属性值，如: user.name
 * 2. 获取数组元素，如: users[0].name
 * 3. 支持多层嵌套，如: company.department.employees[0].name
 * 
 * @author zibo
 * @date 2024/11/25
 * @slogan 慢慢学，不要停。
 */
public class JsonPathUtil {

    // 定义常量,提高代码可维护性
    private static final String DOT_SEPARATOR = "\\.";
    private static final String LEFT_BRACKET = "[";
    private static final String RIGHT_BRACKET = "]";
    private static final ObjectMapper OBJECT_MAPPER = new ObjectMapper();

    private JsonPathUtil() {
        throw new IllegalStateException("工具类不允许实例化");
    }

    /**
     * 根据表达式获取对象的值
     *
     * @param jsonString JSON字符串,不能为空
     * @param expression 表达式,不能为空
     * @return 表达式对应的值
     * @throws IllegalArgumentException 参数校验异常
     * @throws Exception 解析异常
     */
    public static Object getValue(String jsonString, String expression) throws Exception {
        // 参数校验
        if (Objects.isNull(jsonString) || Objects.isNull(expression)) {
            throw new IllegalArgumentException("参数不能为空");
        }

        // 将 JSON 字符串转换为 Map 对象
        Map<String, Object> rootObject = OBJECT_MAPPER.readValue(jsonString, new TypeReference<Map<String, Object>>() {});

        // 分割表达式并处理
        String[] parts = expression.split(DOT_SEPARATOR);
        Object currentObject = rootObject;

        for (String part : parts) {
            currentObject = processPart(currentObject, part);
            if (Objects.isNull(currentObject)) {
                return null;
            }
        }

        return currentObject;
    }

    /**
     * 处理表达式片段
     * 
     * @param currentObject 当前对象
     * @param part 表达式片段
     * @return 处理后的对象
     * @throws Exception 处理异常
     */
    private static Object processPart(Object currentObject, String part) throws Exception {
        if (part.contains(LEFT_BRACKET)) {
            return processArrayPart(currentObject, part);
        }
        return getFieldValue(currentObject, part);
    }

    /**
     * 处理数组类型的表达式片段
     * 
     * @param currentObject 当前对象
     * @param part 表达式片段
     * @return 处理后的对象
     * @throws Exception 处理异常
     */
    private static Object processArrayPart(Object currentObject, String part) throws Exception {
        String fieldName = part.substring(0, part.indexOf(LEFT_BRACKET));
        int index = Integer.parseInt(part.substring(part.indexOf(LEFT_BRACKET) + 1, part.indexOf(RIGHT_BRACKET)));
        Object arrayObject = getFieldValue(currentObject, fieldName);
        return arrayObject instanceof List ? ((List<?>) arrayObject).get(index) : null;
    }

    /**
     * 获取对象的字段值
     *
     * @param object 对象,不能为空
     * @param fieldName 字段名,不能为空
     * @return 字段值
     * @throws Exception 反射异常
     */
    @SuppressWarnings("all")
    private static Object getFieldValue(Object object, String fieldName) throws Exception {
        if (Objects.isNull(object) || Objects.isNull(fieldName)) {
            return null;
        }

        if (object instanceof Map) {
            return ((Map<?, ?>) object).get(fieldName);
        }
        
        Field field = object.getClass().getDeclaredField(fieldName);
        field.setAccessible(true);
        return field.get(object);
    }

    public static void main(String[] args) {
        try {
            // 测试JSON字符串
            String jsonString = "{"
                    + "\"userInfo\": {"
                    + "\"id\": 1,"
                    + "\"photoPath\": \"yx.mm.com\","
                    + "\"realName\": \"张三\","
                    + "\"examInfoDict\": ["
                    + "{\"id\": 1, \"examType\": 0, \"answerIs\": 1},"
                    + "{\"id\": 2, \"examType\": 0, \"answerIs\": 0}"
                    + "]"
                    + "},"
                    + "\"flag\": 1"
                    + "}";

            // 测试不同场景
            System.out.println("测试普通属性: " + getValue(jsonString, "userInfo.realName")); // 输出张三
            System.out.println("测试数组访问: " + getValue(jsonString, "userInfo.examInfoDict[0].id")); // 输出1
            System.out.println("测试空值处理: " + getValue(jsonString, "userInfo.notExist")); // 输出null
            
        } catch (Exception e) {
            System.err.println("处理异常: " + e.getMessage());
            e.printStackTrace();
        }
    }
}

一、引言

在日常的Java开发中，经常需要根据特定的路径或表达式，从JSON字符串中提取所需的数据。虽然市场上有诸如JsonPath等强大的工具可以实现这一需求，但有时候我们需要一个轻量级、可自定义的解决方案。本文将介绍一个自定义实现的JSON路径工具类JsonPathUtil，它可以根据表达式从JSON字符串中获取对应的值，支持获取普通属性、数组元素以及多层嵌套的属性值。

二、功能概述

JsonPathUtil工具类的主要功能包括：

获取普通属性值：如user.name，获取user对象的name属性值。
获取数组元素：如users[0].name，获取users数组中第一个元素的name属性值。
支持多层嵌套：如company.department.employees[0].name，获取嵌套结构中指定员工的姓名。

三、代码实现详解

1. 工具类基础结构

首先，定义了JsonPathUtil工具类，并声明了一些常量：

package com.kumy.requrchase.treasure.service.letusign.impl;

import com.fasterxml.jackson.core.type.TypeReference;
import com.fasterxml.jackson.databind.ObjectMapper;

import java.lang.reflect.Field;
import java.util.List;
import java.util.Map;
import java.util.Objects;

public class JsonPathUtil {

    private static final String DOT_SEPARATOR = "\\.";
    private static final String LEFT_BRACKET = "[";
    private static final String RIGHT_BRACKET = "]";
    private static final ObjectMapper OBJECT_MAPPER = new ObjectMapper();

    private JsonPathUtil() {
        throw new IllegalStateException("工具类不允许实例化");
    }

    // 其他方法...
}

解析：

使用了ObjectMapper来处理JSON字符串的解析。
工具类的构造方法被私有化，防止实例化。

2. 核心方法`getValue`

getValue方法是工具类的核心，用于根据表达式从JSON字符串中获取对应的值。

public static Object getValue(String jsonString, String expression) throws Exception {
    // 参数校验
    if (Objects.isNull(jsonString) || Objects.isNull(expression)) {
        throw new IllegalArgumentException("参数不能为空");
    }

    // 将 JSON 字符串转换为 Map 对象
    Map<String, Object> rootObject = OBJECT_MAPPER.readValue(jsonString, new TypeReference<Map<String, Object>>() {});

    // 分割表达式并处理
    String[] parts = expression.split(DOT_SEPARATOR);
    Object currentObject = rootObject;

    for (String part : parts) {
        currentObject = processPart(currentObject, part);
        if (Objects.isNull(currentObject)) {
            return null;
        }
    }

    return currentObject;
}

解析：

参数校验：确保jsonString和expression不为空，否则抛出IllegalArgumentException。
JSON解析：使用ObjectMapper将JSON字符串解析为Map<String, Object>类型的rootObject。
表达式解析：根据.分隔符，将表达式拆分为多个部分parts，然后逐一处理每个部分。
逐层解析：通过循环，每次处理表达式的一部分，并不断更新currentObject，直到获取最终的值。

3. 处理表达式片段`processPart`

该方法用于处理表达式中的每一部分，判断是普通属性还是数组访问。

private static Object processPart(Object currentObject, String part) throws Exception {
    if (part.contains(LEFT_BRACKET)) {
        return processArrayPart(currentObject, part);
    }
    return getFieldValue(currentObject, part);
}

解析：

如果表达式部分包含[，说明需要处理数组，调用processArrayPart方法。
否则，直接调用getFieldValue获取属性值。

4. 处理数组类型的表达式片段`processArrayPart`

该方法用于解析数组元素的访问。

private static Object processArrayPart(Object currentObject, String part) throws Exception {
    String fieldName = part.substring(0, part.indexOf(LEFT_BRACKET));
    int index = Integer.parseInt(part.substring(part.indexOf(LEFT_BRACKET) + 1, part.indexOf(RIGHT_BRACKET)));
    Object arrayObject = getFieldValue(currentObject, fieldName);
    return arrayObject instanceof List ? ((List<?>) arrayObject).get(index) : null;
}

解析：

获取字段名和索引：通过字符串操作，提取数组字段名fieldName和索引index。
获取数组对象：使用getFieldValue方法获取对应的数组对象arrayObject。
获取数组元素：检查arrayObject是否为List的实例，如果是，则返回对应索引的元素。

5. 获取对象的字段值`getFieldValue`

该方法用于获取当前对象中指定字段的值。

@SuppressWarnings("all")
private static Object getFieldValue(Object object, String fieldName) throws Exception {
    if (Objects.isNull(object) || Objects.isNull(fieldName)) {
        return null;
    }

    if (object instanceof Map) {
        return ((Map<?, ?>) object).get(fieldName);
    }
    
    Field field = object.getClass().getDeclaredField(fieldName);
    field.setAccessible(true);
    return field.get(object);
}

解析：

空值检查：如果object或fieldName为null，直接返回null。
处理Map类型：如果当前对象是Map，直接获取对应键的值。
处理普通对象：使用反射获取对象的字段值，即使字段是私有的（通过setAccessible(true)）。

6. 测试主方法`main`

编写了一个main方法用于测试工具类的功能。

public static void main(String[] args) {
    try {
        // 测试JSON字符串
        String jsonString = "{"
                + "\"userInfo\": {"
                + "\"id\": 1,"
                + "\"photoPath\": \"yx.mm.com\","
                + "\"realName\": \"张三\","
                + "\"examInfoDict\": ["
                + "{\"id\": 1, \"examType\": 0, \"answerIs\": 1},"
                + "{\"id\": 2, \"examType\": 0, \"answerIs\": 0}"
                + "]"
                + "},"
                + "\"flag\": 1"
                + "}";

        // 测试不同场景
        System.out.println("测试普通属性: " + getValue(jsonString, "userInfo.realName")); // 输出张三
        System.out.println("测试数组访问: " + getValue(jsonString, "userInfo.examInfoDict[0].id")); // 输出1
        System.out.println("测试空值处理: " + getValue(jsonString, "userInfo.notExist")); // 输出null
        
    } catch (Exception e) {
        System.err.println("处理异常: " + e.getMessage());
        e.printStackTrace();
    }
}

解析：

构造了一个包含嵌套对象和数组的JSON字符串。
测试了获取普通属性、数组元素以及处理不存在的属性的情况。
输出结果验证了工具类的功能。

四、应用示例

为了更清晰地展示JsonPathUtil的应用，下面提供一个实际例子。

示例JSON字符串：

{
    "employee": {
        "name": "李华",
        "age": 30,
        "department": {
            "name": "研发部",
            "location": "北京"
        },
        "skills": [
            {"name": "Java", "level": "高级"},
            {"name": "Python", "level": "中级"}
        ]
    }
}

示例代码：

String jsonString = "{...}"; // 如上所示的JSON字符串

// 获取员工姓名
String name = (String) JsonPathUtil.getValue(jsonString, "employee.name");
System.out.println("员工姓名：" + name); // 输出：员工姓名：李华

// 获取部门名称
String departmentName = (String) JsonPathUtil.getValue(jsonString, "employee.department.name");
System.out.println("部门名称：" + departmentName); // 输出：部门名称：研发部

// 获取第一项技能的名称
String firstSkill = (String) JsonPathUtil.getValue(jsonString, "employee.skills[0].name");
System.out.println("第一项技能：" + firstSkill); // 输出：第一项技能：Java

// 尝试获取不存在的属性
Object nonExistent = JsonPathUtil.getValue(jsonString, "employee.address");
System.out.println("不存在的属性：" + nonExistent); // 输出：不存在的属性：null

解析：

使用JsonPathUtil.getValue方法，根据不同的表达式，成功获取了嵌套对象和数组中的值。
当尝试获取不存在的属性时，方法返回null，程序没有抛出异常，这体现了对异常情况的良好处理。

五、总结

本文详细介绍了JsonPathUtil工具类的实现原理和应用。通过逐步解析代码，我们了解到：

如何解析复杂的JSON路径表达式，包括嵌套属性和数组元素。
使用ObjectMapper将JSON字符串转换为可操作的Java对象。
通过反射和类型检查，实现了对Map和普通Java对象的字段访问。

优点：

轻量级：不依赖于第三方库，适合对JSON路径解析需求不复杂的场景。
易于理解和扩展：代码简洁明了，方便根据需求进行定制。

不足：

功能有限：不支持复杂的表达式，如过滤条件、通配符等。
性能考虑：对于大规模的JSON数据和高并发场景，可能需要优化或选择性能更优的方案。

建议：

对于简单的JSON解析需求，可以直接使用JsonPathUtil工具类。
如果需要更高级的JSON路径功能，建议使用专业的JSON路径解析库，如Jayway的JsonPath。
- JsonPath 开源地址：https://github.com/json-path/JsonPath
- 在线语法检查：https://jsonpath.com/

六、后记

“慢慢学，不要停。”在编程的道路上，理解每一段代码背后的原理，都能让我们走得更远。希望通过本文的讲解，能帮助到有需要的读者，加深对JSON解析和Java反射的理解。

感谢阅读！

本文参与腾讯云自媒体同步曝光计划，分享自作者个人站点/博客。

原始发表：2024-11-25，如有侵权请联系 cloudcommunity@tencent.com 删除

字符串

本文分享自作者个人站点/博客前往查看

如有侵权，请联系 cloudcommunity@tencent.com 删除。

本文参与腾讯云自媒体同步曝光计划，欢迎热爱写作的你一起参与！

登录后参与评论

0 条评论

热度

JSON路径工具类`JsonPathUtil`的实现与应用

JSON路径工具类`JsonPathUtil`的实现与应用

JSON路径工具类`JsonPathUtil`的实现与应用

〇、完整代码

一、引言

二、功能概述

三、代码实现详解

1. 工具类基础结构

2. 核心方法`getValue`

3. 处理表达式片段`processPart`

4. 处理数组类型的表达式片段`processArrayPart`

5. 获取对象的字段值`getFieldValue`

6. 测试主方法`main`

四、应用示例

五、总结

六、后记

社区

活动

资源

关于

腾讯云开发者

热门产品

热门推荐

更多推荐

JSON路径工具类`JsonPathUtil`的实现与应用

JSON路径工具类`JsonPathUtil`的实现与应用

JSON路径工具类JsonPathUtil的实现与应用

〇、完整代码

一、引言

二、功能概述

三、代码实现详解

1. 工具类基础结构

2. 核心方法getValue

3. 处理表达式片段processPart

4. 处理数组类型的表达式片段processArrayPart

5. 获取对象的字段值getFieldValue

6. 测试主方法main

四、应用示例

五、总结

六、后记

社区

活动

资源

关于

腾讯云开发者

热门产品

热门推荐

更多推荐

JSON路径工具类`JsonPathUtil`的实现与应用

2. 核心方法`getValue`

3. 处理表达式片段`processPart`

4. 处理数组类型的表达式片段`processArrayPart`

5. 获取对象的字段值`getFieldValue`

6. 测试主方法`main`