Class JSONUtil

java.lang.Object
com.sure.tool.json.JSONUtil

public class JSONUtil extends Object
JSON 解析与序列化工具类,零第三方依赖的自研实现(RFC 8259 子集),参考 Hutool 的 JSONUtil 设计。

English: JSON parsing and serialization to and from strings, maps and POJOs.

Since:
0.1.0
Author:
suretool
  • Method Details

    • toJsonStr

      public static String toJsonStr(Object obj)
      序列化任意对象为 JSON 字符串(支持 Bean、Map、集合、数组、日期等)。
      Parameters:
      obj - 对象
      Returns:
      JSON 字符串
    • parse

      public static Object parse(String json)
      解析 JSON 字符串为 Java 对象(对象为 JSONObject,数组为 JSONArray,其余为 String/Number/Boolean/null)。
      Parameters:
      json - JSON 字符串
      Returns:
      解析结果
    • parseObj

      public static JSONObject parseObj(String json)
      解析 JSON 对象。
      Parameters:
      json - JSON 字符串
      Returns:
      JSON 对象
    • parseArray

      public static JSONArray parseArray(String json)
      解析 JSON 数组。
      Parameters:
      json - JSON 字符串
      Returns:
      JSON 数组
    • toBean

      public static <T> T toBean(String json, Class<T> beanClass)
      JSON 字符串转 Bean。
      Type Parameters:
      T - Bean 类型
      Parameters:
      json - JSON 字符串
      beanClass - Bean 类
      Returns:
      Bean 实例
    • toBean

      public static <T> T toBean(JSONObject jsonObject, Class<T> beanClass)
      JSON 对象转 Bean。
      Type Parameters:
      T - Bean 类型
      Parameters:
      jsonObject - JSON 对象
      beanClass - Bean 类
      Returns:
      Bean 实例
    • toList

      public static <T> List<T> toList(String json, Class<T> elementType)
      JSON 数组字符串转类型安全元素列表。
      Type Parameters:
      T - 元素类型
      Parameters:
      json - JSON 数组字符串
      elementType - 元素类型
      Returns:
      元素列表
    • isJson

      public static boolean isJson(String json)
      是否为 JSON 对象或数组(以 { 或 [ 开头)。
      Parameters:
      json - 字符串
      Returns:
      是否 JSON
    • toJsonPrettyStr

      public static String toJsonPrettyStr(Object obj)
      格式化为带缩进的 JSON 字符串。
      Parameters:
      obj - 任意对象(Bean/Map/集合/数组/日期等)
      Returns:
      格式化 JSON 字符串
    • isJsonObj

      public static boolean isJsonObj(String json)
      判断字符串是否为 JSON 对象(以 { 开头)。
      Parameters:
      json - 字符串
      Returns:
      是否为 JSON 对象
    • isJsonArray

      public static boolean isJsonArray(String json)
      判断字符串是否为 JSON 数组(以 [ 开头)。
      Parameters:
      json - 字符串
      Returns:
      是否为 JSON 数组
    • query

      public static JSONArray query(String json, String path)
      按 JSONPath 查询,返回所有匹配值。

      示例:JSONUtil.query(json, "$.store.book[*].title") 返回标题数组; JSONUtil.query(json, "$.store.book[?(@.price < 10)]") 返回价格小于 10 的书籍。

      Parameters:
      json - JSON 文本
      path - JSONPath 表达式(详见 JsonPath)
      Returns:
      匹配值数组(无匹配返回空数组)
    • getByPath

      public static Object getByPath(String json, String path)
      按 JSONPath 查询并取首个匹配值,无匹配返回 null。
      Parameters:
      json - JSON 文本
      path - JSONPath 表达式
      Returns:
      首个匹配值,或 null
    • parseStream

      public static void parseStream(InputStream in, JsonHandler handler) throws IOException
      流式解析 JSON(UTF-8),按事件回调消费,不将整份文档载入内存。
      Parameters:
      in - JSON 输入流
      handler - 事件回调(见 JsonHandler)
      Throws:
      IOException - IO 错误
      JSONException - JSON 语法错误
      See Also: