JSONUtil (ladsn-tool-json 4.1.15 API)

java.lang.Object
- org.ladsn.tool.json.JSONUtil

public final class JSONUtil
extends java.lang.Object

JSON工具类

作者:: Looly

构造器概要

构造器
构造器和说明

JSONUtil()

构造器
构造器和说明
`JSONUtil()`

方法概要

All Methods Static Methods Concrete Methods Deprecated Methods
限定符和类型	方法和说明
`static JSONArray`	`createArray()` 创建 JSONArray
`static JSONObject`	`createObj()` 创建JSONObject
`static java.lang.String`	`escape(java.lang.String str)` 转义显示不可见字符
`static java.lang.String`	`formatJsonStr(java.lang.String jsonStr)` 格式化JSON字符串，此方法并不严格检查JSON的格式正确与否
`static java.lang.Object`	`getByExp(JSON json, java.lang.String expression)` 已过时。请使用`getByPath(JSON, String)`
`static java.lang.Object`	`getByPath(JSON json, java.lang.String expression)` 通过表达式获取JSON中嵌套的对象 .表达式，可以获取Bean对象中的属性（字段）值或者Map中key对应的值 []表达式，可以获取集合等对象中对应index的值表达式栗子： persion persion.name persons[3] person.friends[5].name
`static boolean`	`isJson(java.lang.String str)` 是否为JSON字符串，首尾都为大括号或中括号判定为JSON字符串
`static boolean`	`isJsonArray(java.lang.String str)` 是否为JSONObject字符串，首尾都为大括号或中括号判定为JSON字符串
`static boolean`	`isJsonObj(java.lang.String str)` 是否为JSONObject字符串，首尾都为大括号或中括号判定为JSON字符串
`static JSON`	`parse(java.lang.Object obj)` 转换对象为JSON 支持的对象： String: 转换为相应的对象 Array Collection：转换为JSONArray Bean对象：转为JSONObject
`static JSONArray`	`parseArray(java.lang.Object arrayOrCollection)` JSON字符串转JSONArray
`static JSONArray`	`parseArray(java.lang.Object arrayOrCollection, boolean ignoreNullValue)` JSON字符串转JSONArray
`static JSONArray`	`parseArray(java.lang.String jsonStr)` JSON字符串转JSONArray
`static JSONObject`	`parseFromMap(java.util.Map<?,?> map)` Map转化为JSONObject
`static JSONObject`	`parseFromResourceBundle(java.util.ResourceBundle bundle)` ResourceBundle转化为JSONObject
`static JSONObject`	`parseFromXml(java.lang.String xmlStr)` XML字符串转为JSONObject
`static JSONObject`	`parseObj(java.lang.Object obj)` JSON字符串转JSONObject对象此方法会忽略空值，但是对JSON字符串不影响
`static JSONObject`	`parseObj(java.lang.Object obj, boolean ignoreNullValue)` JSON字符串转JSONObject对象
`static JSONObject`	`parseObj(java.lang.String jsonStr)` JSON字符串转JSONObject对象
`static void`	`putByPath(JSON json, java.lang.String expression, java.lang.Object value)` 设置表达式指定位置（或filed对应）的值若表达式指向一个JSONArray则设置其坐标对应位置的值，若指向JSONObject则put对应key的值注意：如果为JSONArray，则设置值得下标不能大于已有JSONArray的长度 .表达式，可以获取Bean对象中的属性（字段）值或者Map中key对应的值 []表达式，可以获取集合等对象中对应index的值表达式栗子： persion persion.name persons[3] person.friends[5].name
`static java.lang.String`	`quote(java.lang.String string)` 对所有双引号做转义处理（使用双反斜杠做转义）为了能在HTML中较好的显示，会将</转义为<\/ JSON字符串中不能包含控制字符和未经转义的引号和反斜杠
`static java.lang.String`	`quote(java.lang.String string, boolean isWrap)` 对所有双引号做转义处理（使用双反斜杠做转义）为了能在HTML中较好的显示，会将</转义为<\/ JSON字符串中不能包含控制字符和未经转义的引号和反斜杠
`static java.io.Writer`	`quote(java.lang.String str, java.io.Writer writer)` 对所有双引号做转义处理（使用双反斜杠做转义）为了能在HTML中较好的显示，会将</转义为<\/ JSON字符串中不能包含控制字符和未经转义的引号和反斜杠
`static java.io.Writer`	`quote(java.lang.String str, java.io.Writer writer, boolean isWrap)` 对所有双引号做转义处理（使用双反斜杠做转义）为了能在HTML中较好的显示，会将</转义为<\/ JSON字符串中不能包含控制字符和未经转义的引号和反斜杠
`static JSON`	`readJSON(java.io.File file, java.nio.charset.Charset charset)` 读取JSON
`static JSONArray`	`readJSONArray(java.io.File file, java.nio.charset.Charset charset)` 读取JSONArray
`static JSONObject`	`readJSONObject(java.io.File file, java.nio.charset.Charset charset)` 读取JSONObject
`static <T> T`	`toBean(JSONObject json, java.lang.Class<T> beanClass)` 转为实体类对象，转换异常将被抛出
`static <T> T`	`toBean(JSONObject json, java.lang.Class<T> beanClass, boolean ignoreError)` 转为实体类对象
`static <T> T`	`toBean(java.lang.String jsonString, java.lang.Class<T> beanClass)` JSON字符串转为实体类对象，转换异常将被抛出
`static java.lang.String`	`toJsonPrettyStr(JSON json)` 转为JSON字符串
`static java.lang.String`	`toJsonPrettyStr(java.lang.Object obj)` 转换为格式化后的JSON字符串
`static java.lang.String`	`toJsonStr(JSON json)` 转为JSON字符串
`static java.lang.String`	`toJsonStr(JSON json, int indentFactor)` 转为JSON字符串
`static java.lang.String`	`toJsonStr(java.lang.Object obj)` 转换为JSON字符串
`static <T> java.util.List<T>`	`toList(JSONArray jsonArray, java.lang.Class<T> elementType)` 将JSONArray转换为Bean的List，默认为ArrayList
`static java.lang.String`	`toXmlStr(JSON json)` 转换为XML字符串
`static java.lang.Object`	`wrap(java.lang.Object object, boolean ignoreNullValue)` 在需要的时候包装对象包装包括： `null` =》 `JSONNull.NULL` array or collection =》 JSONArray map =》 JSONObject standard property (Double, String, et al) =》原对象来自于java包 =》字符串其它 =》尝试包装为JSONObject，否则返回`null`
`static JSONObject`	`xmlToJson(java.lang.String xml)` XML转JSONObject 转换过程中一些信息可能会丢失，JSON中无法区分节点和属性，相同的节点将被处理为JSONArray。

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 构造器详细资料
  - JSONUtil
```
public JSONUtil()
```
- 方法详细资料
  - createObj
```
public static JSONObject createObj()
```
    创建JSONObject
    
    返回:
    
    JSONObject
  - createArray
```
public static JSONArray createArray()
```
    创建 JSONArray
    
    返回:
    
    JSONArray
  - parseObj
```
public static JSONObject parseObj(java.lang.String jsonStr)
```
    JSON字符串转JSONObject对象
    
    参数:
    
    jsonStr - JSON字符串
    
    返回:
    
    JSONObject
  - parseObj
```
public static JSONObject parseObj(java.lang.Object obj)
```
    JSON字符串转JSONObject对象
    此方法会忽略空值，但是对JSON字符串不影响
    
    参数:
    
    obj - Bean对象或者Map
    
    返回:
    
    JSONObject
  - parseObj
```
public static JSONObject parseObj(java.lang.Object obj,
                                  boolean ignoreNullValue)
```
    JSON字符串转JSONObject对象
    
    参数:
    
    obj - Bean对象或者Map
    
    ignoreNullValue - 是否忽略空值，如果source为JSON字符串，不忽略空值
    
    返回:
    
    JSONObject
    
    从以下版本开始:
    
    3.0.9
  - parseArray
```
public static JSONArray parseArray(java.lang.String jsonStr)
```
    JSON字符串转JSONArray
    
    参数:
    
    jsonStr - JSON字符串
    
    返回:
    
    JSONArray
  - parseArray
```
public static JSONArray parseArray(java.lang.Object arrayOrCollection)
```
    JSON字符串转JSONArray
    
    参数:
    
    arrayOrCollection - 数组或集合对象
    
    返回:
    
    JSONArray
    
    从以下版本开始:
    
    3.0.8
  - parseArray
```
public static JSONArray parseArray(java.lang.Object arrayOrCollection,
                                   boolean ignoreNullValue)
```
    JSON字符串转JSONArray
    
    参数:
    
    arrayOrCollection - 数组或集合对象
    
    ignoreNullValue - 是否忽略空值
    
    返回:
    
    JSONArray
    
    从以下版本开始:
    
    3.2.3
  - parse
```
public static JSON parse(java.lang.Object obj)
```
    转换对象为JSON
    支持的对象：
    String: 转换为相应的对象
    Array Collection：转换为JSONArray
    Bean对象：转为JSONObject
    
    参数:
    
    obj - 对象
    
    返回:
    
    JSON
  - parseFromXml
```
public static JSONObject parseFromXml(java.lang.String xmlStr)
```
    XML字符串转为JSONObject
    
    参数:
    
    xmlStr - XML字符串
    
    返回:
    
    JSONObject
  - parseFromMap
```
public static JSONObject parseFromMap(java.util.Map<?,?> map)
```
    Map转化为JSONObject
    
    参数:
    
    map - Map
    
    返回:
    
    JSONObject
  - parseFromResourceBundle
```
public static JSONObject parseFromResourceBundle(java.util.ResourceBundle bundle)
```
    ResourceBundle转化为JSONObject
    
    参数:
    
    bundle - ResourceBundle文件
    
    返回:
    
    JSONObject
  - readJSON
```
public static JSON readJSON(java.io.File file,
                            java.nio.charset.Charset charset)
                     throws IORuntimeException
```
    读取JSON
    
    参数:
    
    file - JSON文件
    
    charset - 编码
    
    返回:
    
    JSON（包括JSONObject和JSONArray）
    
    抛出:
    
    IORuntimeException - IO异常
  - readJSONObject
```
public static JSONObject readJSONObject(java.io.File file,
                                        java.nio.charset.Charset charset)
                                 throws IORuntimeException
```
    读取JSONObject
    
    参数:
    
    file - JSON文件
    
    charset - 编码
    
    返回:
    
    JSONObject
    
    抛出:
    
    IORuntimeException - IO异常
  - readJSONArray
```
public static JSONArray readJSONArray(java.io.File file,
                                      java.nio.charset.Charset charset)
                               throws IORuntimeException
```
    读取JSONArray
    
    参数:
    
    file - JSON文件
    
    charset - 编码
    
    返回:
    
    JSONArray
    
    抛出:
    
    IORuntimeException - IO异常
  - toJsonStr
```
public static java.lang.String toJsonStr(JSON json,
                                         int indentFactor)
```
    转为JSON字符串
    
    参数:
    
    json - JSON
    
    indentFactor - 每一级别的缩进
    
    返回:
    
    JSON字符串
  - toJsonStr
```
public static java.lang.String toJsonStr(JSON json)
```
    转为JSON字符串
    
    参数:
    
    json - JSON
    
    返回:
    
    JSON字符串
  - toJsonPrettyStr
```
public static java.lang.String toJsonPrettyStr(JSON json)
```
    转为JSON字符串
    
    参数:
    
    json - JSON
    
    返回:
    
    JSON字符串
  - toJsonStr
```
public static java.lang.String toJsonStr(java.lang.Object obj)
```
    转换为JSON字符串
    
    参数:
    
    obj - 被转为JSON的对象
    
    返回:
    
    JSON字符串
  - toJsonPrettyStr
```
public static java.lang.String toJsonPrettyStr(java.lang.Object obj)
```
    转换为格式化后的JSON字符串
    
    参数:
    
    obj - Bean对象
    
    返回:
    
    JSON字符串
  - toXmlStr
```
public static java.lang.String toXmlStr(JSON json)
```
    转换为XML字符串
    
    参数:
    
    json - JSON
    
    返回:
    
    XML字符串
  - toBean
```
public static <T> T toBean(java.lang.String jsonString,
                           java.lang.Class<T> beanClass)
```
    JSON字符串转为实体类对象，转换异常将被抛出
    
    类型参数:
    
    T - Bean类型
    
    参数:
    
    jsonString - JSON字符串
    
    beanClass - 实体类对象
    
    返回:
    
    实体类对象
    
    从以下版本开始:
    
    3.1.2
  - toBean
```
public static <T> T toBean(JSONObject json,
                           java.lang.Class<T> beanClass)
```
    转为实体类对象，转换异常将被抛出
    
    类型参数:
    
    T - Bean类型
    
    参数:
    
    json - JSONObject
    
    beanClass - 实体类对象
    
    返回:
    
    实体类对象
  - toBean
```
public static <T> T toBean(JSONObject json,
                           java.lang.Class<T> beanClass,
                           boolean ignoreError)
```
    转为实体类对象
    
    类型参数:
    
    T - Bean类型
    
    参数:
    
    json - JSONObject
    
    beanClass - 实体类对象
    
    ignoreError - 是否忽略转换过程中某个字段的转换异常
    
    返回:
    
    实体类对象
  - toList
```
public static <T> java.util.List<T> toList(JSONArray jsonArray,
                                           java.lang.Class<T> elementType)
```
    将JSONArray转换为Bean的List，默认为ArrayList
    
    参数:
    
    jsonArray - JSONArray
    
    elementType - List中元素类型
    
    返回:
    
    List
    
    从以下版本开始:
    
    4.0.7
  - getByExp
```
@Deprecated
public static java.lang.Object getByExp(JSON json,
                                                     java.lang.String expression)
```
    已过时。请使用getByPath(JSON, String)
    通过表达式获取JSON中嵌套的对象
    1. .表达式，可以获取Bean对象中的属性（字段）值或者Map中key对应的值
    2. []表达式，可以获取集合等对象中对应index的值
    表达式栗子：
```
 persion
 persion.name
 persons[3]
 person.friends[5].name
 
```
    参数:
    
    json - JSON
    
    expression - 表达式
    
    返回:
    
    对象
    
    另请参阅:
    
    JSON.getByExp(String)
  - getByPath
```
public static java.lang.Object getByPath(JSON json,
                                         java.lang.String expression)
```
    通过表达式获取JSON中嵌套的对象
    1. .表达式，可以获取Bean对象中的属性（字段）值或者Map中key对应的值
    2. []表达式，可以获取集合等对象中对应index的值
    表达式栗子：
```
 persion
 persion.name
 persons[3]
 person.friends[5].name
 
```
    参数:
    
    json - JSON
    
    expression - 表达式
    
    返回:
    
    对象
    
    另请参阅:
    
    JSON.getByExp(String)
  - putByPath
```
public static void putByPath(JSON json,
                             java.lang.String expression,
                             java.lang.Object value)
```
    设置表达式指定位置（或filed对应）的值
    若表达式指向一个JSONArray则设置其坐标对应位置的值，若指向JSONObject则put对应key的值
    注意：如果为JSONArray，则设置值得下标不能大于已有JSONArray的长度
    1. .表达式，可以获取Bean对象中的属性（字段）值或者Map中key对应的值
    2. []表达式，可以获取集合等对象中对应index的值
    表达式栗子：
```
 persion
 persion.name
 persons[3]
 person.friends[5].name
 
```
    参数:
    
    json - JSON，可以为JSONObject或JSONArray
    
    expression - 表达式
    
    value - 值
  - quote
```
public static java.lang.String quote(java.lang.String string)
```
    对所有双引号做转义处理（使用双反斜杠做转义）
    为了能在HTML中较好的显示，会将</转义为<\/
    JSON字符串中不能包含控制字符和未经转义的引号和反斜杠
    
    参数:
    
    string - 字符串
    
    返回:
    
    适合在JSON中显示的字符串
  - quote
```
public static java.lang.String quote(java.lang.String string,
                                     boolean isWrap)
```
    对所有双引号做转义处理（使用双反斜杠做转义）
    为了能在HTML中较好的显示，会将</转义为<\/
    JSON字符串中不能包含控制字符和未经转义的引号和反斜杠
    
    参数:
    
    string - 字符串
    
    isWrap - 是否使用双引号包装字符串
    
    返回:
    
    适合在JSON中显示的字符串
    
    从以下版本开始:
    
    3.3.1
  - quote
```
public static java.io.Writer quote(java.lang.String str,
                                   java.io.Writer writer)
                            throws java.io.IOException
```
    对所有双引号做转义处理（使用双反斜杠做转义）
    为了能在HTML中较好的显示，会将</转义为<\/
    JSON字符串中不能包含控制字符和未经转义的引号和反斜杠
    
    参数:
    
    str - 字符串
    
    writer - Writer
    
    返回:
    
    Writer
    
    抛出:
    
    java.io.IOException - IO异常
  - quote
```
public static java.io.Writer quote(java.lang.String str,
                                   java.io.Writer writer,
                                   boolean isWrap)
                            throws java.io.IOException
```
    对所有双引号做转义处理（使用双反斜杠做转义）
    为了能在HTML中较好的显示，会将</转义为<\/
    JSON字符串中不能包含控制字符和未经转义的引号和反斜杠
    
    参数:
    
    str - 字符串
    
    writer - Writer
    
    isWrap - 是否使用双引号包装字符串
    
    返回:
    
    Writer
    
    抛出:
    
    java.io.IOException - IO异常
    
    从以下版本开始:
    
    3.3.1
  - escape
```
public static java.lang.String escape(java.lang.String str)
```
    转义显示不可见字符
    
    参数:
    
    str - 字符串
    
    返回:
    
    转义后的字符串
  - wrap
```
public static java.lang.Object wrap(java.lang.Object object,
                                    boolean ignoreNullValue)
```
    在需要的时候包装对象
    包装包括：
    - null =》 JSONNull.NULL
    - array or collection =》 JSONArray
    - map =》 JSONObject
    - standard property (Double, String, et al) =》原对象
    - 来自于java包 =》字符串
    - 其它 =》尝试包装为JSONObject，否则返回null
    参数:
    
    object - 被包装的对象
    
    ignoreNullValue - 是否忽略null 值
    
    返回:
    
    包装后的值
  - formatJsonStr
```
public static java.lang.String formatJsonStr(java.lang.String jsonStr)
```
    格式化JSON字符串，此方法并不严格检查JSON的格式正确与否
    
    参数:
    
    jsonStr - JSON字符串
    
    返回:
    
    格式化后的字符串
    
    从以下版本开始:
    
    3.1.2
  - isJson
```
public static boolean isJson(java.lang.String str)
```
    是否为JSON字符串，首尾都为大括号或中括号判定为JSON字符串
    
    参数:
    
    str - 字符串
    
    返回:
    
    是否为JSON字符串
    
    从以下版本开始:
    
    3.3.0
  - isJsonObj
```
public static boolean isJsonObj(java.lang.String str)
```
    是否为JSONObject字符串，首尾都为大括号或中括号判定为JSON字符串
    
    参数:
    
    str - 字符串
    
    返回:
    
    是否为JSON字符串
    
    从以下版本开始:
    
    3.3.0
  - isJsonArray
```
public static boolean isJsonArray(java.lang.String str)
```
    是否为JSONObject字符串，首尾都为大括号或中括号判定为JSON字符串
    
    参数:
    
    str - 字符串
    
    返回:
    
    是否为JSON字符串
    
    从以下版本开始:
    
    3.3.0
  - xmlToJson
```
public static JSONObject xmlToJson(java.lang.String xml)
```
    XML转JSONObject
    转换过程中一些信息可能会丢失，JSON中无法区分节点和属性，相同的节点将被处理为JSONArray。
    
    参数:
    
    xml - XML字符串
    
    返回:
    
    JSONObject
    
    从以下版本开始:
    
    4.0.8

类 JSONUtil

构造器概要

方法概要

从类继承的方法 java.lang.Object

构造器详细资料

JSONUtil

方法详细资料

createObj

createArray

parseObj

parseObj

parseObj

parseArray

parseArray

parseArray

parse

parseFromXml

parseFromMap

parseFromResourceBundle

readJSON

readJSONObject

readJSONArray

toJsonStr

toJsonStr

toJsonPrettyStr

toJsonStr

toJsonPrettyStr

toXmlStr

toBean

toBean

toBean

toList

getByExp

getByPath

putByPath

quote

quote

quote

quote

escape

wrap

formatJsonStr

isJson

isJsonObj

isJsonArray

xmlToJson