添加链接 注册    登录
link管理
链接快照平台
  • 输入网页链接，自动生成快照
  • 标签化管理网页链接
相关文章推荐
刀枪不入的感冒药  ·  Azure AI Speech | ...·  1 年前    · 
玩命的豌豆  ·  [SOLVED]mongodb won't ...·  1 年前    · 
安静的黄豆  ·  淄博市卫生和计划生育委员会 健康资讯 ...·  2 年前    · 
从容的沙滩裤  ·  Spring Cloud ...·  2 年前    · 
无邪的小蝌蚪  ·  如何从一个表中选择一个字段，该表是另一个表的 ...·  2 年前    · 
link管理  ›  JSONObject (hutool 5.8.47 API)
https://plus.hutool.cn/apidocs/cn/hutool/json/JSONObject.html
严肃的煎饼
1 周前 
public class JSONObject




    

extends MapWrapper<String,Object>
implements JSON, JSONGetter<String>
JSON对象
json = new JSONObject().put("JSON", "Hello, World!").toString();
Author:
looly
See Also:
Serialized Form
JSONObject ( Object source, JSONConfig config, Filter < MutablePair < String , Object >> filter)
构建JSONObject，规则如下： value为Map，将键值对加入JSON对象 value为JSON字符串（CharSequence），使用JSONTokener解析 value为JSONTokener，直接解析 value为普通JavaBean，如果为普通的JavaBean，调用其getters方法（getXXX或者isXXX）获得值，加入到JSON对象。
JSONObject ( Object source, String ... names)
构建指定name列表对应的键值对为新的JSONObject，情况如下： Object value)
设置表达式指定位置（或field对应）的值
若表达式指向一个JSONArray则设置其坐标对应位置的值，若指向JSONObject则put对应key的值
注意：如果为JSONArray，设置值下标小于其长度，将替换原有值，否则追加新值
.表达式，可以获取Bean对象中的属性（字段）值或者Map中key对应的值 []表达式，可以获取集合等对象中对应index的值 表达式栗子： persion persion.name persons[3] person.friends[5].name
  • value为JSON字符串（CharSequence），使用JSONTokener解析
  • value为JSONTokener，直接解析
  • value为普通JavaBean，如果为普通的JavaBean，调用其getters方法（getXXX或者isXXX）获得值，加入到JSON对象。 例如：如果JavaBean对象中有个方法getName()，值为"张三"，获得的键值对为：name: "张三"
    • Parameters:
    source - JavaBean或者Map对象或者String
  • value为JSON字符串（CharSequence），使用JSONTokener解析
  • value为JSONTokener，直接解析
  • value为普通JavaBean，如果为普通的JavaBean，调用其getters方法（getXXX或者isXXX）获得值，加入到JSON对象。例如：如果JavaBean对象中有个方法getName()，值为"张三"，获得的键值对为：name: "张三"
    • Parameters:
    source - JavaBean或者Map对象或者String
    ignoreNullValue - 是否忽略空值
    Since:
    3.0.9
  • value为JSON字符串（CharSequence），使用JSONTokener解析
  • value为JSONTokener，直接解析
  • value为普通JavaBean，如果为普通的JavaBean，调用其getters方法（getXXX或者isXXX）获得值，加入到JSON对象。例如：如果JavaBean对象中有个方法getName()，值为"张三"，获得的键值对为：name: "张三"
    • Parameters:
    source - JavaBean或者Map对象或者String
    ignoreNullValue - 是否忽略空值，如果source为JSON字符串，不忽略空值
    isOrder - 是否有序
    Since:
    4.2.2
  • value为JSON字符串（CharSequence），使用JSONTokener解析
  • value为JSONTokener，直接解析
  • value为普通JavaBean，如果为普通的JavaBean，调用其getters方法（getXXX或者isXXX）获得值，加入到JSON对象。例如：如果JavaBean对象中有个方法getName()，值为"张三"，获得的键值对为：name: "张三"
    • 如果给定值为Map，将键值对加入JSON对象;
    如果为普通的JavaBean，调用其getters方法（getXXX或者isXXX）获得值，加入到JSON对象
    例如：如果JavaBean对象中有个方法getName()，值为"张三"，获得的键值对为：name: "张三"

    Parameters:
    source - JavaBean或者Map对象或者String
    config - JSON配置文件， null 则使用默认配置
    Since:
    4.2.2 
    public JSONObject(Object source,
                  JSONConfig config,
                  Filter<MutablePair<String,Object>> filter)
    构建JSONObject，规则如下：
  • value为Map，将键值对加入JSON对象
  • value为JSON字符串（CharSequence），使用JSONTokener解析
  • value为JSONTokener，直接解析
  • value为普通JavaBean，如果为普通的JavaBean，调用其getters方法（getXXX或者isXXX）获得值，加入到JSON对象。例如：如果JavaBean对象中有个方法getName()，值为"张三"，获得的键值对为：name: "张三"
    • 如果给定值为Map，将键值对加入JSON对象;
    如果为普通的JavaBean，调用其getters方法（getXXX或者isXXX）获得值，加入到JSON对象
    例如：如果JavaBean对象中有个方法getName()，值为"张三"，获得的键值对为：name: "张三"

    Parameters:
    source - JavaBean或者Map对象或者String
    config - JSON配置文件， null 则使用默认配置
    filter - 键值对过滤编辑器，可以通过实现此接口，完成解析前对键值对的过滤和修改操作， null 表示不过滤
    Since:
    5.8.0

    setDateFormat 

    public JSONObject setDateFormat(String format)
    设置转为字符串时的日期格式，默认为时间戳（null值）
    此方法设置的日期格式仅对转换为JSON字符串有效，对解析JSON为bean无效。
    Parameters:
    format - 格式，null表示使用时间戳
    Returns:
    Since:
    4.1.19 
    public JSONArray toJSONArray(Collection<String> names)
                      throws JSONException
    将指定KEY列表的值组成新的JSONArray
    Parameters:
    names - KEY列表
    Returns:
    A JSONArray of values.
    Throws:
    JSONException - If any of the values are non-finite numbers. 
    public Object getObj(String key,
                     Object defaultValue)
    Description copied from interface: OptBasicTypeGetter
    获取Object属性值
    Specified by:
    getObj in interface OptBasicTypeGetter < String >
    Parameters:
    key - 属性名
    defaultValue - 默认值
    Returns:
    属性值，无对应值返回defaultValue

    getByPath 

    public Object getByPath(String expression)
    Description copied from interface: JSON
    通过表达式获取JSON中嵌套的对象
  • .表达式，可以获取Bean对象中的属性（字段）值或者Map中key对应的值
  • []表达式，可以获取集合等对象中对应index的值
    • 表达式栗子： persion persion.name persons[3] person.friends[5].name
    Specified by:
    getByPath in interface JSON
    Parameters:
    expression - 表达式
    Returns:
    See Also:
    BeanPath.get(Object) 
    public <T> T getByPath(String expression,
                       Class<T> resultType)
    Description copied from interface: JSON
    通过表达式获取JSON中嵌套的对象
  • .表达式，可以获取Bean对象中的属性（字段）值或者Map中key对应的值
  • []表达式，可以获取集合等对象中对应index的值
    • 表达式栗子： persion persion.name persons[3] person.friends[5].name 获取表达式对应值后转换为对应类型的值

    Specified by:
    getByPath in interface JSON
    Type Parameters:
    T - 返回值类型
    Parameters:
    expression - 表达式
    resultType - 返回值类型
    Returns:
    See Also:
    BeanPath.get(Object) 
    public <T> T getByPath(String expression,
                       TypeReference<T> targetType)
    Description copied from interface: JSON
    通过表达式获取JSON中嵌套的对象
  • .表达式，可以获取Bean对象中的属性（字段）值或者Map中key对应的值
  • []表达式，可以获取集合等对象中对应index的值
    • 表达式栗子： persion persion.name persons[3] person.friends[5].name 获取表达式对应值后转换为对应类型的值

    Specified by:
    getByPath in interface JSON
    Type Parameters:
    T - 获取对象类型
    Parameters:
    expression - 表达式
    targetType - 返回值类型
    Returns:
    See Also:
    BeanPath.get(Object) 
    public void putByPath(String expression,
                      Object value)
    Description copied from interface: JSON
    设置表达式指定位置（或field对应）的值
    若表达式指向一个JSONArray则设置其坐标对应位置的值，若指向JSONObject则put对应key的值
    注意：如果为JSONArray，设置值下标小于其长度，将替换原有值，否则追加新值
  • .表达式，可以获取Bean对象中的属性（字段）值或者Map中key对应的值
  • []表达式，可以获取集合等对象中对应index的值
    • 表达式栗子： persion persion.name persons[3] person.friends[5].name
    Specified by:
    putByPath in interface JSON
    Parameters:
    expression - 表达式
    value - 值
    Object value) throws JSONException
    Deprecated. 此方法存在歧义，原Map接口返回的是之前的值，重写后返回this了，未来版本此方法会修改，请使用 set(String, Object)
    PUT 键值对到JSONObject中，在忽略null模式下，如果值为 null ，将此键移除
    Specified by:
    put in interface Map < String , Object >
    Overrides:
    put in class MapWrapper < String , Object >
    Parameters:
    key - 键
    value - 值对象. 可以是以下类型: Boolean, Double, Integer, JSONArray, JSONObject, Long, String, or the JSONNull.NULL.
    Returns:
    this.
    Throws:
    JSONException - 值是无穷数字抛出此异常
    Parameters:
    key - 键
    value - 值对象. 可以是以下类型: Boolean, Double, Integer, JSONArray, JSONObject, Long, String, or the JSONNull.NULL.
    Returns:
    this.
    Throws:
    JSONException - 值是无穷数字抛出此异常 
    public JSONObject set(String key,
                      Object value,
                      Filter<MutablePair<String,Object>> filter,
                      boolean checkDuplicate)
               throws JSONException
    设置键值对到JSONObject中，在忽略null模式下，如果值为 null ，将此键移除
    Parameters:
    key - 键
    value - 值对象. 可以是以下类型: Boolean, Double, Integer, JSONArray, JSONObject, Long, String, or the JSONNull.NULL.
    filter - 键值对过滤编辑器，可以通过实现此接口，完成解析前对键值对的过滤和修改操作， null 表示不过滤
    checkDuplicate - 是否检查重复键，如果为 true ，则出现重复键时抛出 JSONException 异常
    Returns:
    this.
    Throws:
    JSONException - 值是无穷数字抛出此异常
    Since:
    5.8.0
    Parameters:
    key - 键
    value - 值对象，可以是以下类型: Boolean, Double, Integer, JSONArray, JSONObject, Long, String, or the JSONNull.NULL.
    Returns:
    this.
    Throws:
    JSONException - 值是无穷数字、键重复抛出异常 
    public JSONObject setOnce(String key,
                          Object value,
                          Filter<MutablePair<String,Object>> filter)
                   throws JSONException
    一次性Put 键值对，如果key已经存在抛出异常，如果键值中有null值，忽略
    Parameters:
    key - 键
    value - 值对象，可以是以下类型: Boolean, Double, Integer, JSONArray, JSONObject, Long, String, or the JSONNull.NULL.
    filter - 键值对过滤编辑器，可以通过实现此接口，完成解析前对键值对的过滤和修改操作， null 表示不过滤
    Returns:
    Throws:
    JSONException - 值是无穷数字、键重复抛出异常
    Since:
    5.8.0
    Parameters:
    key - 键
    value - 值对象，可以是以下类型: Boolean, Double, Integer, JSONArray, JSONObject, Long, String, or the JSONNull.NULL.
    Returns:
    this.
    Throws:
    JSONException - 值是无穷数字
    throws JSONException
    积累值。类似于set，当key对应value已经存在时，与value组成新的JSONArray.
    如果只有一个值，此值就是value，如果多个值，则是添加到新的JSONArray中
    Parameters:
    key - 键
    value - 被积累的值
    Returns:
    this.
    Throws:
    JSONException - 如果给定键为 null 或者键对应的值存在且为非JSONArray
    Object value) throws JSONException
    追加值，如果key无对应值，就添加一个JSONArray，其元素只有value，如果值已经是一个JSONArray，则添加到值JSONArray中。
    Parameters:
    key - 键
    value - 值
    Returns:
    this.
    Throws:
    JSONException - 如果给定键为 null 或者键对应的值存在且为非JSONArray 
    public JSONObject increment(String key)
                     throws JSONException
    对值加一，如果值不存在，赋值1，如果为数字类型，做加一操作
    Parameters:
    key - A key string.
    Returns:
    this.
    Throws:
    JSONException - 如果存在值非Integer, Long, Double, 或 Float.

    toJSONString 

    public String toJSONString(int indentFactor,
                           Filter<MutablePair<Object,Object>> filter)
    返回JSON字符串
    支持过滤器，即选择哪些字段或值不写出
    Parameters:
    indentFactor - 每层缩进空格数
    filter - 过滤器，同时可以修改编辑键和值
    Returns:
    JSON字符串
    Since:
    5.7.15
    Description copied from interface: JSON
    将JSON内容写入Writer
    Warning: This method assumes that the data structure is acyclical.
    Specified by:
    write in interface JSON
    Parameters:
    writer - writer
    indentFactor - 缩进因子，定义每一级别增加的缩进量
    indent - 本级别缩进量
    Returns:
    Writer
    Throws:
    JSONException - JSON相关异常
     
    推荐文章
    刀枪不入的感冒药  ·  Azure AI Speech | Microsoft Azure
    1 年前
    玩命的豌豆  ·  [SOLVED]mongodb won't start on localhost / Networking, Server, and Protection / Arch Linux Forums
    1 年前
    安静的黄豆  ·  淄博市卫生和计划生育委员会 健康资讯 凭蛋壳颜色挑鸡蛋没道理
    2 年前
    从容的沙滩裤  ·  Spring Cloud Gateway入坑记 - throwable - 博客园
    2 年前
    无邪的小蝌蚪  ·  如何从一个表中选择一个字段，该表是另一个表的一个字段中包含的字符串的一部分？-腾讯云开发者社区-腾讯云
    2 年前
    Link管理   ·   Sov5搜索   ·   小百科
    link管理 - 链接快照平台