org.noear.solon.configurationprocessor.json

类 JSONTokener

java.lang.Object

org.noear.solon.configurationprocessor.json.JSONTokener

public class JSONTokener
extends java.lang.Object

Parses a JSON (RFC 4627) encoded string into the corresponding object. Most clients of this class will use only need the constructor and nextValue() method. Example usage:

 String json = "{"
         + "  \"query\": \"Pizza\", "
         + "  \"locations\": [ 94043, 90210 ] "
         + "}";

 JSONObject object = (JSONObject) new JSONTokener(json).nextValue();
 String query = object.getString("query");
 JSONArray locations = object.getJSONArray("locations");

For best interoperability and performance use JSON that complies with RFC 4627, such as that generated by JSONStringer. For legacy reasons this parser is lenient, so a successful parse does not indicate that the input string was valid JSON. All the following syntax errors will be ignored:

• End of line comments starting with // or # and ending with a newline character.
• C-style comments starting with /* and ending with */. Such comments may not be nested.
• Strings that are unquoted or 'single quoted'.
• Hexadecimal integers prefixed with 0x or 0X.
• Octal integers prefixed with 0.
• Array elements separated by ;.
• Unnecessary array separators. These are interpreted as if null was the omitted value.
• Key-value pairs separated by = or =>.
• Key-value pairs separated by ;.

Each tokener may be used to parse a single JSON string. Instances of this class are not thread safe. Although this class is nonfinal, it was not designed for inheritance and should not be subclassed. In particular, self-use by overrideable methods is not specified. See Effective Java Item 17, "Design and Document or inheritance or else prohibit it" for further information.

构造器概要

构造器

构造器和说明
JSONTokener(java.lang.String in)

方法概要

限定符和类型	方法和说明
void	back()
static int	dehexchar(char hex)
boolean	more()
char	next()
char	next(char c)
java.lang.String	next(int length)
char	nextClean()
java.lang.String	nextString(char quote) Returns the string up to but not including quote, unescaping any character escape sequences encountered along the way.
java.lang.String	nextTo(char excluded)
java.lang.String	nextTo(java.lang.String excluded)
java.lang.Object	nextValue() Returns the next value from the input.
void	skipPast(java.lang.String thru)
char	skipTo(char to)
JSONException	syntaxError(java.lang.String message) Returns an exception containing the given message plus the current position and the entire input string.
java.lang.String	toString() Returns the current position and the entire input string.

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

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

构造器详细资料

JSONTokener

public JSONTokener(java.lang.String in)

参数:

in - JSON encoded string. Null is not permitted and will yield a tokener that throws NullPointerExceptions when methods are called.

方法详细资料

nextValue

public java.lang.Object nextValue()
                           throws JSONException

Returns the next value from the input.

返回:

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

抛出:

JSONException - if the input is malformed.

nextString

public java.lang.String nextString(char quote)
                            throws JSONException

Returns the string up to but not including quote, unescaping any character escape sequences encountered along the way. The opening quote should have already been read. This consumes the closing quote, but does not include it in the returned string.

参数:

quote - either ' or ".

返回:

the string up to but not including quote

抛出:

java.lang.NumberFormatException - if any unicode escape sequences are malformed.

JSONException - if processing of json failed

syntaxError

public JSONException syntaxError(java.lang.String message)

Returns an exception containing the given message plus the current position and the entire input string.

参数:

message - the message

返回:

an exception

toString

public java.lang.String toString()

Returns the current position and the entire input string.

覆盖:

toString 在类中 java.lang.Object

返回:

the current position and the entire input string.

more

public boolean more()

next

public char next()

next

public char next(char c)
          throws JSONException

抛出:

JSONException

nextClean

public char nextClean()
               throws JSONException

抛出:

JSONException

next

public java.lang.String next(int length)
                      throws JSONException

抛出:

JSONException

nextTo

public java.lang.String nextTo(java.lang.String excluded)

nextTo

public java.lang.String nextTo(char excluded)

skipPast

public void skipPast(java.lang.String thru)

skipTo

public char skipTo(char to)

back

public void back()

dehexchar

public static int dehexchar(char hex)