jodd.json

Class JsonParser

java.lang.Object

jodd.json.JsonParser

public class JsonParser
extends java.lang.Object

Simple, developer-friendly JSON parser. It focuses on easy usage and type mappings. Uses Jodd's type converters, so it is natural companion for Jodd projects.

See: http://www.ietf.org/rfc/rfc4627.txt

todo: add factory for Maps and Lists

Field Summary

Fields

Modifier and Type	Field and Description
protected char[]	input
protected java.util.Map<Path,java.lang.Class>	mappings
protected int	ndx
protected Path	path
protected char[]	text
protected int	textLen
protected int	total

Constructor Summary

Constructors

Constructor and Description
JsonParser()

Method Summary

Methods

Modifier and Type	Method and Description
protected void	consume(char c) Consumes char at current position.
protected java.lang.Object	convertType(java.lang.Object value, java.lang.Class targetType) Converts type of the given value.
protected void	grow() Grows text array.
protected void	injectValueIntoObject(java.lang.Object target, jodd.introspector.PropertyDescriptor pd, java.lang.Object value) Injects value into the targets property.
protected boolean	isEOF() Returns true if scanning is at the end.
JsonParser	map(java.lang.Class target) Maps a class to JSONs root.
JsonParser	map(java.lang.String path, java.lang.Class target) Maps a class to given path.
protected boolean	match(char[] target) Matches char buffer with content on given location.
protected java.lang.Object	newArrayInstance(java.lang.Class targetType) Creates new type for JSON array objects.
protected java.lang.Object	newObjectInstance(java.lang.Class targetType) Creates new object or a HashMap if type is not specified.
java.lang.Object	parse(char[] input) Parses input JSON char array.
<T> T	parse(char[] input, java.lang.Class<T> targetType) Parses input JSON as given type.
java.lang.Object	parse(java.lang.String input) Parses input JSON string.
<T> T	parse(java.lang.String input, java.lang.Class<T> targetType) Parses input JSON as given type.
protected java.lang.Object	parseArrayContent(java.lang.Class targetType, java.lang.Class componentType) Parses arrays, once when open bracket has been consumed.
protected java.lang.Number	parseNumber() Parses JSON numbers.
protected java.lang.Object	parseObjectContent(java.lang.Class targetType, java.lang.Class valueType) Parses object, once when open bracket has been consumed.
protected java.lang.String	parseString() Parses a string.
protected java.lang.String	parseStringContent() Parses string content, once when starting quote has been consumer.
protected char	parseUnicode() Parses 4 characters and returns unicode character.
protected java.lang.Object	parseValue(java.lang.Class targetType, java.lang.Class componentType) Parses a JSON value.
protected java.lang.Class	replaceWithMappedTypeForPath(java.lang.Class target) Replaces type with mapped type for current path.
protected void	reset() Resets JSON parser, so it can be reused.
protected java.lang.Class	resolveComponentType(jodd.introspector.PropertyDescriptor pd) Resolves component type for given property descriptor.
protected jodd.introspector.PropertyDescriptor	resolveSimpleProperty(java.lang.Class type, java.lang.String key) Resolves property type for given object.
protected void	skipWhiteSpaces() Skips whitespaces.
protected void	syntaxError(java.lang.String message) Throws JsonException indicating a syntax error.

Methods inherited from class java.lang.Object

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

Field Detail

ndx

protected int ndx

input

protected char[] input

total

protected int total

path

protected Path path

mappings

protected java.util.Map<Path,java.lang.Class> mappings

text

protected char[] text

textLen

protected int textLen

Constructor Detail

JsonParser

public JsonParser()

Method Detail

reset

protected void reset()

Resets JSON parser, so it can be reused.

map

public JsonParser map(java.lang.Class target)

Maps a class to JSONs root.

map

public JsonParser map(java.lang.String path,
             java.lang.Class target)

Maps a class to given path. For arrays, append values to the path to specify component type (if not specified by generics).

replaceWithMappedTypeForPath

protected java.lang.Class replaceWithMappedTypeForPath(java.lang.Class target)

Replaces type with mapped type for current path.

parse

public <T> T parse(java.lang.String input,
          java.lang.Class<T> targetType)

Parses input JSON as given type.

parse

public java.lang.Object parse(java.lang.String input)

Parses input JSON string.

parse

public <T> T parse(char[] input,
          java.lang.Class<T> targetType)

Parses input JSON as given type.

parse

public java.lang.Object parse(char[] input)

Parses input JSON char array.

parseValue

protected java.lang.Object parseValue(java.lang.Class targetType,
                          java.lang.Class componentType)

Parses a JSON value.

Parameters:

targetType - target type to convert, may be null

componentType - component type for maps and arrays, may be null

parseString

protected java.lang.String parseString()

Parses a string.

parseStringContent

protected java.lang.String parseStringContent()

Parses string content, once when starting quote has been consumer.

grow

protected void grow()

Grows text array.

parseUnicode

protected char parseUnicode()

Parses 4 characters and returns unicode character.

parseNumber

protected java.lang.Number parseNumber()

Parses JSON numbers.

parseArrayContent

protected java.lang.Object parseArrayContent(java.lang.Class targetType,
                                 java.lang.Class componentType)

Parses arrays, once when open bracket has been consumed.

parseObjectContent

protected java.lang.Object parseObjectContent(java.lang.Class targetType,
                                  java.lang.Class valueType)

Parses object, once when open bracket has been consumed.

consume

protected void consume(char c)

Consumes char at current position. If char is different, throws the exception.

isEOF

protected boolean isEOF()

Returns true if scanning is at the end.

skipWhiteSpaces

protected final void skipWhiteSpaces()

Skips whitespaces. For the simplification, whitespaces are considered any characters less or equal to 32 (space).

match

protected final boolean match(char[] target)

Matches char buffer with content on given location.

newObjectInstance

protected java.lang.Object newObjectInstance(java.lang.Class targetType)

Creates new object or a HashMap if type is not specified.

newArrayInstance

protected java.lang.Object newArrayInstance(java.lang.Class targetType)

Creates new type for JSON array objects.

resolveSimpleProperty

protected jodd.introspector.PropertyDescriptor resolveSimpleProperty(java.lang.Class type,
                                                         java.lang.String key)

Resolves property type for given object. Returns null when property type is unknown (either property is missing or targets type is a map).

resolveComponentType

protected java.lang.Class resolveComponentType(jodd.introspector.PropertyDescriptor pd)

Resolves component type for given property descriptor.

injectValueIntoObject

protected void injectValueIntoObject(java.lang.Object target,
                         jodd.introspector.PropertyDescriptor pd,
                         java.lang.Object value)

Injects value into the targets property.

convertType

protected java.lang.Object convertType(java.lang.Object value,
                           java.lang.Class targetType)

Converts type of the given value.

syntaxError

protected void syntaxError(java.lang.String message)

Throws JsonException indicating a syntax error.