JSON (hutool 6.0.0-M20 API)

All Superinterfaces:

Serializable

All Known Implementing Classes:

JSONArray, JSONObject, JSONPrimitive
```
public interface JSON
extends Serializable
```
JSON树模型接口，表示树中的一个节点。实现包括：
- JSONObject表示键值对形式的节点
- JSONArray表示列表形式的节点
- JSONPrimitive表示数字、Boolean、字符串形式的节点
- null表示空节点
Author:

Looly

Method Summary

All Methods Instance Methods Abstract Methods Default Methods
Modifier and Type	Method and Description
`default JSONArray`	`asJSONArray()` 转为JSONArray
`default JSONObject`	`asJSONObject()` 转为JSONObject
`default JSONPrimitive`	`asJSONPrimitive()` 转为JSONPrimitive
`default JSONConfig`	`config()` 获取JSON配置
`default JSON`	`getByPath(String expression)` 通过表达式获取JSON中嵌套的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 获取表达式对应值后转换为对应类型的值
`JSONFactory`	`getFactory()` 获取JSON工厂
`default <T> T`	`getObjByPath(String expression)` 通过表达式获取JSON中嵌套的对象 .表达式，可以获取Bean对象中的属性（字段）值或者Map中key对应的值 []表达式，可以获取集合等对象中对应index的值表达式栗子： persion persion.name persons[3] person.friends[5].name 获取表达式对应值后转换为对应类型的值
`default boolean`	`isEmpty()` 判断JSON是否为空，即大小为0
`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则是元素的个数，JSON原始数据为1
`default <T> T`	`toBean(Type type)` 转为实体类对象
`default String`	`toJSONString(int indentFactor)` 格式化输出JSON字符串
`default String`	`toJSONString(int indentFactor, Predicate<MutableEntry<Object,Object>> predicate)` 格式化输出JSON字符串
`default String`	`toStringPretty()` 格式化打印JSON，缩进为4个空格
`void`	`write(JSONWriter writer)` 将JSON内容写入Writer Warning: This method assumes that the data structure is acyclical.

- Method Detail
  - getFactory
```
JSONFactory getFactory()
```
    获取JSON工厂
    
    Returns:
    
    JSON工厂
  - size
```
int size()
```
    JSON大小，对于JSONObject，是键值对的多少，JSONArray则是元素的个数，JSON原始数据为1
    
    Returns:
    
    大小
  - write
```
void write(JSONWriter writer)
    throws JSONException
```
    将JSON内容写入Writer
    Warning: This method assumes that the data structure is acyclical.
    
    Parameters:
    
    writer - writer
    
    Throws:
    
    JSONException - JSON相关异常
  - config
```
default JSONConfig config()
```
    获取JSON配置
    
    Returns:
    
    JSONConfig
    
    Since:
    
    5.3.0
  - isEmpty
```
default boolean isEmpty()
```
    判断JSON是否为空，即大小为0
    
    Returns:
    
    是否为空
  - asJSONObject
```
default JSONObject asJSONObject()
```
    转为JSONObject
    
    Returns:
    
    JSONObject
  - asJSONArray
```
default JSONArray asJSONArray()
```
    转为JSONArray
    
    Returns:
    
    JSONArray
  - asJSONPrimitive
```
default JSONPrimitive asJSONPrimitive()
```
    转为JSONPrimitive
    
    Returns:
    
    JSONPrimitive
  - getObjByPath
```
default <T> T getObjByPath(String expression)
```
    通过表达式获取JSON中嵌套的对象
    1. .表达式，可以获取Bean对象中的属性（字段）值或者Map中key对应的值
    2. []表达式，可以获取集合等对象中对应index的值
    表达式栗子：
```
 persion
 persion.name
 persons[3]
 person.friends[5].name
 
```
    获取表达式对应值后转换为对应类型的值
    Type Parameters:
    
    T - 返回值类型
    
    Parameters:
    
    expression - 表达式
    
    Returns:
    
    对象
    
    See Also:
    
    BeanPath.getValue(Object)
  - 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
 
```
    获取表达式对应值后转换为对应类型的值
    Type Parameters:
    
    T - 返回值类型
    
    Parameters:
    
    expression - 表达式
    
    resultType - 返回值类型
    
    Returns:
    
    对象
    
    See Also:
    
    BeanPath.getValue(Object)
  - getByPath
```
default JSON getByPath(String expression)
```
    通过表达式获取JSON中嵌套的JSON对象
    1. .表达式，可以获取Bean对象中的属性（字段）值或者Map中key对应的值
    2. []表达式，可以获取集合等对象中对应index的值
    表达式栗子：
```
 persion
 persion.name
 persons[3]
 person.friends[5].name
 
```
    Parameters:
    
    expression - 表达式
    
    Returns:
    
    JSON对象
    
    See Also:
    
    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
 
```
    Parameters:
    
    expression - 表达式
    
    value - 值
  - toStringPretty
```
default String toStringPretty()
                       throws JSONException
```
    格式化打印JSON，缩进为4个空格
    
    Returns:
    
    格式化后的JSON字符串
    
    Throws:
    
    JSONException - 包含非法数抛出此异常
    
    Since:
    
    3.0.9
  - toJSONString
```
default String toJSONString(int indentFactor)
                     throws JSONException
```
    格式化输出JSON字符串
    
    Parameters:
    
    indentFactor - 每层缩进空格数
    
    Returns:
    
    JSON字符串
    
    Throws:
    
    JSONException - 包含非法数抛出此异常
  - toJSONString
```
default String toJSONString(int indentFactor,
                            Predicate<MutableEntry<Object,Object>> predicate)
                     throws JSONException
```
    格式化输出JSON字符串
    
    Parameters:
    
    indentFactor - 每层缩进空格数
    
    predicate - 过滤器，用于过滤不需要的键值对
    
    Returns:
    
    JSON字符串
    
    Throws:
    
    JSONException - 包含非法数抛出此异常
  - toBean
```
default <T> T toBean(Type type)
```
    转为实体类对象
    
    Type Parameters:
    
    T - Bean类型
    
    Parameters:
    
    type - Type
    
    Returns:
    
    实体类对象

Interface JSON

Method Summary

Method Detail

getFactory

size

write

config

isEmpty

asJSONObject

asJSONArray

asJSONPrimitive

getObjByPath

getByPath

getByPath

putByPath

toStringPretty

toJSONString

toJSONString

toBean