cn.hutool.json

接口 JSON

所有超级接口:

Cloneable, Serializable

所有已知实现类:

JSONArray, JSONObject

public interface JSON
extends Cloneable, Serializable

JSON接口

作者:

Looly

方法概要

方法

限定符和类型	方法和说明
Object	getByPath(String expression) 通过表达式获取JSON中嵌套的对象 .表达式，可以获取Bean对象中的属性（字段）值或者Map中key对应的值 []表达式，可以获取集合等对象中对应index的值 表达式栗子： persion persion.name persons[3] person.friends[5].name
<T> T	getByPath(String expression, Class<T> resultType) 通过表达式获取JSON中嵌套的对象 .表达式，可以获取Bean对象中的属性（字段）值或者Map中key对应的值 []表达式，可以获取集合等对象中对应index的值 表达式栗子： persion persion.name persons[3] person.friends[5].name 获取表达式对应值后转换为对应类型的值
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
String	toJSONString(int indentFactor) 转换为JSON字符串
String	toStringPretty() 格式化打印JSON，缩进为4个空格
Writer	write(Writer writer) 将JSON内容写入Writer，无缩进 Warning: This method assumes that the data structure is acyclical.
Writer	write(Writer writer, int indentFactor, int indent) 将JSON内容写入Writer Warning: This method assumes that the data structure is acyclical.

方法详细资料

getByPath

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.get(Object)

putByPath

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

<T> T getByPath(String expression,
              Class<T> resultType)

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

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

表达式栗子：

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

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

类型参数:

T - 返回值类型

参数:

expression - 表达式

resultType - 返回值类型

返回:

对象

从以下版本开始:

4.0.6

另请参阅:

BeanPath.get(Object)

write

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)
             throws JSONException

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

参数:

writer - writer

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

indent - 本级别缩进量

返回:

Writer

抛出:

JSONException - JSON相关异常

toJSONString

String toJSONString(int indentFactor)
                    throws JSONException

转换为JSON字符串

参数:

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

返回:

JSON字符串

抛出:

JSONException - JSON相关异常

toStringPretty

String toStringPretty()
                      throws JSONException

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

返回:

格式化后的JSON字符串

抛出:

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

从以下版本开始:

3.0.9