org.ladsn.tool.json

接口 JSON

所有超级接口:

java.io.Serializable

所有已知实现类:

JSONArray, JSONObject

public interface JSON
extends java.io.Serializable

JSON接口

作者:

Looly

方法概要

限定符和类型	方法和说明
java.lang.Object	getByExp(java.lang.String expression) 已过时。 请使用getByPath(String)
<T> T	getByExp(java.lang.String expression, java.lang.Class<T> resultType) 已过时。 请使用getByPath(String, Class)
java.lang.Object	getByPath(java.lang.String expression) 通过表达式获取JSON中嵌套的对象 .表达式，可以获取Bean对象中的属性（字段）值或者Map中key对应的值 []表达式，可以获取集合等对象中对应index的值 表达式栗子： persion persion.name persons[3] person.friends[5].name
<T> T	getByPath(java.lang.String expression, java.lang.Class<T> resultType) 通过表达式获取JSON中嵌套的对象 .表达式，可以获取Bean对象中的属性（字段）值或者Map中key对应的值 []表达式，可以获取集合等对象中对应index的值 表达式栗子： persion persion.name persons[3] person.friends[5].name 获取表达式对应值后转换为对应类型的值
void	putByPath(java.lang.String expression, java.lang.Object value) 设置表达式指定位置（或filed对应）的值 若表达式指向一个JSONArray则设置其坐标对应位置的值，若指向JSONObject则put对应key的值 注意：如果为JSONArray，设置值下标小于其长度，将替换原有值，否则追加新值 .表达式，可以获取Bean对象中的属性（字段）值或者Map中key对应的值 []表达式，可以获取集合等对象中对应index的值 表达式栗子： persion persion.name persons[3] person.friends[5].name
java.lang.String	toJSONString(int indentFactor) 转换为JSON字符串
java.lang.String	toStringPretty() 格式化打印JSON，缩进为4个空格
java.io.Writer	write(java.io.Writer writer) 将JSON内容写入Writer，无缩进 Warning: This method assumes that the data structure is acyclical.
java.io.Writer	write(java.io.Writer writer, int indentFactor, int indent) 将JSON内容写入Writer Warning: This method assumes that the data structure is acyclical.

方法详细资料

getByExp

@Deprecated
java.lang.Object getByExp(java.lang.String expression)

已过时。 请使用getByPath(String)

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

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

表达式栗子：

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

参数:

expression - 表达式

返回:

对象

另请参阅:

BeanPath.get(Object)

getByExp

@Deprecated
<T> T getByExp(java.lang.String expression,
                            java.lang.Class<T> resultType)

已过时。 请使用getByPath(String, Class)

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

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

表达式栗子：

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

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

类型参数:

T - 返回值类型

参数:

expression - 表达式

resultType - 返回值类型

返回:

对象

从以下版本开始:

3.1.0

另请参阅:

BeanPath.get(Object)

getByPath

java.lang.Object getByPath(java.lang.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(java.lang.String expression,
               java.lang.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(java.lang.String expression,
                java.lang.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

java.io.Writer write(java.io.Writer writer)
              throws JSONException

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

参数:

writer - Writer

返回:

Writer

抛出:

JSONException - JSON相关异常

write

java.io.Writer write(java.io.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

java.lang.String toJSONString(int indentFactor)
                       throws JSONException

转换为JSON字符串

参数:

indentFactor - 每一级别的缩进

返回:

JSON字符串

抛出:

JSONException - JSON相关异常

toStringPretty

java.lang.String toStringPretty()
                         throws JSONException

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

返回:

格式化后的JSON字符串

抛出:

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

从以下版本开始:

3.0.9