cn.hutool.json

Class JSONTokener

java.lang.Object

cn.hutool.json.JSONTokener

Direct Known Subclasses:

XMLTokener

public class JSONTokener
extends Object

JSON解析器，用于将JSON字符串解析为JSONObject或者JSONArray

Author:

from JSON.org

Constructor Summary

Constructors

Constructor and Description
JSONTokener(CharSequence s, JSONConfig config) 从字符串中构建
JSONTokener(InputStream inputStream, JSONConfig config) 从InputStream中构建，使用UTF-8编码
JSONTokener(Reader reader, JSONConfig config) 从Reader中构建

Method Summary

Modifier and Type	Method and Description
void	back() 将标记回退到第一个字符，重新开始解析新的JSON
boolean	end()
protected char	getPrevious() Get the last character read from the input or '\0' if nothing has been read yet.
boolean	more() 源字符串是否有更多的字符
char	next() 获得源字符串中的下一个字符
char	next(char c) 读取下一个字符，并比对是否和指定字符匹配
String	next(int n) 获得接下来的n个字符
char	nextClean() 获得下一个字符，跳过空白符
String	nextString(char quote) 返回当前位置到指定引号前的所有字符，反斜杠的转义符也会被处理。
String	nextStringValue() 获取下一个String格式的值，用户获取key
String	nextTo(char delimiter) Get the text up but not including the specified character or the end of line, whichever comes first.
String	nextTo(String delimiters) Get the text up but not including one of the specified delimiter characters or the end of line, whichever comes first.
Object	nextValue() 获得下一个值，值类型可以是Boolean, Double, Integer, JSONArray, JSONObject, Long, or String, or the JSONObject.NULL
char	skipTo(char to) Skip characters until the next character is the requested character.
JSONException	syntaxError(String message) Make a JSONException to signal a syntax error.
JSONArray	toJSONArray() 转为 JSONArray
String	toString() Make a printable string of this JSONTokener.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

JSONTokener

public JSONTokener(Reader reader,
                   JSONConfig config)

从Reader中构建

Parameters:

reader - Reader

config - JSON配置

JSONTokener

public JSONTokener(InputStream inputStream,
                   JSONConfig config)
            throws JSONException

从InputStream中构建，使用UTF-8编码

Parameters:

inputStream - InputStream

config - JSON配置

Throws:

JSONException

JSONTokener

public JSONTokener(CharSequence s,
                   JSONConfig config)

从字符串中构建

Parameters:

s - JSON字符串

config - JSON配置

Method Detail

back

public void back()
          throws JSONException

将标记回退到第一个字符，重新开始解析新的JSON

Throws:

JSONException

end

public boolean end()

Returns:

是否进入结尾

more

public boolean more()
             throws JSONException

源字符串是否有更多的字符

Returns:

如果未达到结尾返回true，否则false

Throws:

JSONException

next

public char next()
          throws JSONException

获得源字符串中的下一个字符

Returns:

下一个字符, or 0 if past the end of the source string.

Throws:

JSONException - JSON异常，包装IO异常

getPrevious

protected char getPrevious()

Get the last character read from the input or '\0' if nothing has been read yet.

Returns:

the last character read from the input.

next

public char next(char c)
          throws JSONException

读取下一个字符，并比对是否和指定字符匹配

Parameters:

c - 被匹配的字符

Returns:

The character 匹配到的字符

Throws:

JSONException - 如果不匹配抛出此异常

next

public String next(int n)
            throws JSONException

获得接下来的n个字符

Parameters:

n - 字符数

Returns:

获得的n个字符组成的字符串

Throws:

JSONException - 如果源中余下的字符数不足以提供所需的字符数，抛出此异常

nextClean

public char nextClean()
               throws JSONException

获得下一个字符，跳过空白符

Returns:

获得的字符，0表示没有更多的字符

Throws:

JSONException - 获得下一个字符时抛出的异常

nextString

public String nextString(char quote)
                  throws JSONException

返回当前位置到指定引号前的所有字符，反斜杠的转义符也会被处理。
标准的JSON是不允许使用单引号包含字符串的，但是此实现允许。

Parameters:

quote - 字符引号, 包括 "（双引号） 或 '（单引号）。

Returns:

截止到引号前的字符串

Throws:

JSONException - 出现无结束的字符串时抛出此异常

nextTo

public String nextTo(char delimiter)
              throws JSONException

Get the text up but not including the specified character or the end of line, whichever comes first.
获得从当前位置直到分隔符（不包括分隔符）或行尾的的所有字符。

Parameters:

delimiter - 分隔符

Returns:

字符串

Throws:

JSONException

nextTo

public String nextTo(String delimiters)
              throws JSONException

Get the text up but not including one of the specified delimiter characters or the end of line, whichever comes first.

Parameters:

delimiters - A set of delimiter characters.

Returns:

A string, trimmed.

Throws:

JSONException

nextStringValue

public String nextStringValue()

获取下一个String格式的值，用户获取key

Returns:

String格式的值

Since:

5.8.22

nextValue

public Object nextValue()
                 throws JSONException

获得下一个值，值类型可以是Boolean, Double, Integer, JSONArray, JSONObject, Long, or String, or the JSONObject.NULL

Returns:

Boolean, Double, Integer, JSONArray, JSONObject, Long, or String, or the JSONObject.NULL

Throws:

JSONException - 语法错误

skipTo

public char skipTo(char to)
            throws JSONException

Skip characters until the next character is the requested character. If the requested character is not found, no characters are skipped. 在遇到指定字符前，跳过其它字符。如果字符未找到，则不跳过任何字符。

Parameters:

to - 需要定位的字符

Returns:

定位的字符，如果字符未找到返回0

Throws:

JSONException

syntaxError

public JSONException syntaxError(String message)

Make a JSONException to signal a syntax error.
构建 JSONException 用于表示语法错误

Parameters:

message - 错误消息

Returns:

A JSONException object, suitable for throwing

toJSONArray

public JSONArray toJSONArray()

转为 JSONArray

Returns:

JSONArray

toString

public String toString()

Make a printable string of this JSONTokener.

Overrides:

toString in class Object

Returns:

" at {index} [character {character} line {line}]"