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
default <T> T	toBean(Class<T> clazz) 转为实体类对象，转换异常将被抛出
default <T> T	toBean(Type type) 转为实体类对象
default <T> T	toBean(Type type, boolean ignoreError) 转为实体类对象
default <T> T	toBean(TypeReference<T> reference) 转为实体类对象，转换异常将被抛出
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) 将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)

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

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

参数:

writer - writer

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

indent - 本级别缩进量

返回:

Writer

抛出:

JSONException - JSON相关异常

toBean

default <T> T toBean(Class<T> clazz)

转为实体类对象，转换异常将被抛出

类型参数:

T - Bean类型

参数:

clazz - 实体类

返回:

实体类对象

toBean

default <T> T toBean(TypeReference<T> reference)

转为实体类对象，转换异常将被抛出

类型参数:

T - Bean类型

参数:

reference - TypeReference类型参考子类，可以获取其泛型参数中的Type类型

返回:

实体类对象

从以下版本开始:

4.2.2

toBean

default <T> T toBean(Type type)

转为实体类对象

类型参数:

T - Bean类型

参数:

type - Type

返回:

实体类对象

从以下版本开始:

3.0.8

toBean

default <T> T toBean(Type type,
                     boolean ignoreError)

转为实体类对象

类型参数:

T - Bean类型

参数:

type - Type

ignoreError - 是否忽略转换错误

返回:

实体类对象

从以下版本开始:

4.3.2