jsimple.json.text

Class Token

java.lang.Object

jsimple.json.text.Token

public final class Token
extends java.lang.Object

Since:

5/6/12 12:18 AM

Constructor Summary

Constructors

Constructor and Description
Token(Reader reader)

Method Summary

Modifier and Type	Method and Description
void	advance()
void	check(TokenType expectedType) Validate that the token is the expected type (throwing an exception if it isn't).
void	checkAndAdvance(TokenType expectedType) Validate that the token is the expected type (throwing an exception if it isn't), then advance to the next token.
java.lang.String	getDescription() Get a user friendly description of the token.
java.lang.Object	getPrimitiveValue()
TokenType	getType()
static boolean	isControlCharacter(char c) Return true if the particular character should be considered a control character and specified via Unicode escape sequence in JSON.

Methods inherited from class java.lang.Object

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

Constructor Detail

Token

public Token(Reader reader)

Method Detail

isControlCharacter

public static boolean isControlCharacter(char c)

Return true if the particular character should be considered a control character and specified via Unicode escape sequence in JSON. The JSON spec is a bit ambiguous (as far as I can tell) on which exact Unicode characters are "control characters" and must be escaped, so we have to make some reasonable assumption. We consider control characters to be the 65 characters in the ranges U+0000..U+001F and U+007F..U+009F, according to http://unicode.org/glossary/#control_codes. Note that this includes '\0', which is the end of string for us when parsing.

Parameters:

c - character in question

Returns:

whether specified character is a control character

getType

public TokenType getType()

getPrimitiveValue

public java.lang.Object getPrimitiveValue()

getDescription

public java.lang.String getDescription()

Get a user friendly description of the token. This is typically used for error messages, saying we encountered such & such, which isn't what we expected.

Returns:

token description phrase

advance

public void advance()

checkAndAdvance

public void checkAndAdvance(TokenType expectedType)

Validate that the token is the expected type (throwing an exception if it isn't), then advance to the next token.

Parameters:

expectedType - expected token type

check

public void check(TokenType expectedType)

Validate that the token is the expected type (throwing an exception if it isn't).

Parameters:

expectedType - expected token type