org.dromara.hutool.json

接口 JSON

所有超级接口:

Cloneable, Converter, Serializable

所有已知实现类:

JSONArray, JSONObject

public interface JSON
extends Converter, Cloneable, Serializable

JSON接口

作者:

Looly

方法概要

限定符和类型	方法和说明
JSONConfig	config() 获取JSON配置
default Object	convert(Type targetType, Object value)
default Object	getByPath(String expression) 通过表达式获取JSON中嵌套的对象 .表达式，可以获取Bean对象中的属性（字段）值或者Map中key对应的值 []表达式，可以获取集合等对象中对应index的值 表达式栗子： persion persion.name persons[3] person.friends[5].name
default <T> T	getByPath(String expression, Type resultType) 通过表达式获取JSON中嵌套的对象 .表达式，可以获取Bean对象中的属性（字段）值或者Map中key对应的值 []表达式，可以获取集合等对象中对应index的值 表达式栗子： persion persion.name persons[3] person.friends[5].name 获取表达式对应值后转换为对应类型的值
default void	putByPath(String expression, Object value) 设置表达式指定位置（或filed对应）的值 若表达式指向一个JSONArray则设置其坐标对应位置的值，若指向JSONObject则put对应key的值 注意：如果为JSONArray，设置值下标小于其长度，将替换原有值，否则追加新值 .表达式，可以获取Bean对象中的属性（字段）值或者Map中key对应的值 []表达式，可以获取集合等对象中对应index的值 表达式栗子： persion persion.name persons[3] person.friends[5].name
int	size() JSON大小，对于JSONObject，是键值对的多少，JSONArray则是元素的个数
default <T> T	toBean(Type type) 转为实体类对象
default String	toJSONString(int indentFactor) 格式化输出JSON字符串
default String	toStringPretty() 格式化打印JSON，缩进为4个空格
default Writer	write(Writer writer) 将JSON内容写入Writer，无缩进 Warning: This method assumes that the data structure is acyclical.
Writer	write(Writer writer, int indentFactor, int indent, Predicate<MutableEntry<Object,Object>> predicate) 将JSON内容写入Writer Warning: This method assumes that the data structure is acyclical.

从接口继承的方法 org.dromara.hutool.core.convert.Converter

convert

方法详细资料

config

JSONConfig config()

获取JSON配置

返回:

JSONConfig

从以下版本开始:

5.3.0

size

int size()

JSON大小，对于JSONObject，是键值对的多少，JSONArray则是元素的个数

返回:

大小

getByPath

default Object getByPath(String expression)

通过表达式获取JSON中嵌套的对象

1. .表达式，可以获取Bean对象中的属性（字段）值或者Map中key对应的值
2. []表达式，可以获取集合等对象中对应index的值

表达式栗子：

 persion
 persion.name
 persons[3]
 person.friends[5].name
 

参数:

expression - 表达式

返回:

对象

从以下版本开始:

4.0.6

另请参阅:

BeanPath.getValue(Object)

putByPath

default void putByPath(String expression,
                       Object value)

设置表达式指定位置（或filed对应）的值
若表达式指向一个JSONArray则设置其坐标对应位置的值，若指向JSONObject则put对应key的值
注意：如果为JSONArray，设置值下标小于其长度，将替换原有值，否则追加新值

1. .表达式，可以获取Bean对象中的属性（字段）值或者Map中key对应的值
2. []表达式，可以获取集合等对象中对应index的值

表达式栗子：

 persion
 persion.name
 persons[3]
 person.friends[5].name
 

参数:

expression - 表达式

value - 值

getByPath

default <T> T getByPath(String expression,
                        Type resultType)

通过表达式获取JSON中嵌套的对象

1. .表达式，可以获取Bean对象中的属性（字段）值或者Map中key对应的值
2. []表达式，可以获取集合等对象中对应index的值

表达式栗子：

 persion
 persion.name
 persons[3]
 person.friends[5].name
 

获取表达式对应值后转换为对应类型的值

类型参数:

T - 返回值类型

参数:

expression - 表达式

resultType - 返回值类型

返回:

对象

从以下版本开始:

4.0.6

另请参阅:

BeanPath.getValue(Object)

toStringPretty

default String toStringPretty()
                       throws JSONException

格式化打印JSON，缩进为4个空格

返回:

格式化后的JSON字符串

抛出:

JSONException - 包含非法数抛出此异常

从以下版本开始:

3.0.9

toJSONString

default String toJSONString(int indentFactor)
                     throws JSONException

格式化输出JSON字符串

参数:

indentFactor - 每层缩进空格数

返回:

JSON字符串

抛出:

JSONException - 包含非法数抛出此异常

write

default Writer write(Writer writer)
              throws JSONException

将JSON内容写入Writer，无缩进
Warning: This method assumes that the data structure is acyclical.

参数:

writer - Writer

返回:

Writer

抛出:

JSONException - JSON相关异常

write

Writer write(Writer writer,
             int indentFactor,
             int indent,
             Predicate<MutableEntry<Object,Object>> predicate)
      throws JSONException

将JSON内容写入Writer
Warning: This method assumes that the data structure is acyclical.

参数:

writer - writer

indentFactor - 缩进因子，定义每一级别增加的缩进量

indent - 本级别缩进量

predicate - 过滤器，可以修改值，key（index）无法修改，Predicate.test(Object)为true保留

返回:

Writer

抛出:

JSONException - JSON相关异常

toBean

default <T> T toBean(Type type)

转为实体类对象

类型参数:

T - Bean类型

参数:

type - Type

返回:

实体类对象

从以下版本开始:

4.3.2

convert

default Object convert(Type targetType,
                       Object value)
                throws ConvertException

指定者:

convert 在接口中 Converter

抛出:

ConvertException