JsonParser (Jodd API Documentation)

java.lang.Object
- jodd.json.JsonParserBase
- - jodd.json.JsonParser

```
public class JsonParser
extends JsonParserBase
```
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

Field Summary

Fields
Modifier and Type	Field and Description
`protected java.lang.String`	`classMetadataName`
`protected java.util.Map<Path,ValueConverter>`	`convs`
`protected char[]`	`input`
`static java.lang.String`	`KEYS` Map keys.
`protected boolean`	`looseMode`
`protected java.util.Map<Path,java.lang.Class>`	`mappings`
`protected MapToBean`	`mapToBean`
`protected int`	`ndx`
`protected Path`	`path`
`protected java.lang.Class`	`rootType`
`protected char[]`	`text`
`protected int`	`textLen`
`protected int`	`total`
`protected boolean`	`useAltPaths`
`static java.lang.String`	`VALUES` Array or map values.

Constructor Summary

Constructors
Constructor and Description

JsonParser()

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 char`	`consumeOneOf(char c1, char c2)` Consumes one of the allowed char at current position.
`static JsonParser`	`create()` Static ctor.
`protected void`	`growAndCopy()` Grows text array when `text.length == textLen`.
`protected void`	`growEmpty()` Grows empty text array.
`protected boolean`	`isEOF()` Returns `true` if scanning is at the end.
`protected ValueConverter`	`lookupValueConverter()` Lookups for value converter for current path.
`JsonParser`	`looseMode(boolean looseMode)` Enables 'loose' mode for parsing.
`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.
`<T> T`	`parse(char[] input)` Parses input JSON char array.
`<T> T`	`parse(char[] input, java.lang.Class<?> targetType)` Parses input JSON as given type.
`<T> T`	`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 valueKeyType, 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(char quote)` Parses string content, once when starting quote has been consumer.
`protected char`	`parseUnicode()` Parses 4 characters and returns unicode character.
`protected java.lang.String`	`parseUnquotedStringContent()` Parses un-quoted string content.
`protected java.lang.Object`	`parseValue(java.lang.Class targetType, java.lang.Class keyType, 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.
`JsonParser`	`setClassMetadataName(java.lang.String name)` Sets local class meta-data name.
`protected void`	`skipWhiteSpaces()` Skips whitespaces.
`protected void`	`syntaxError(java.lang.String message)` Throws `JsonException` indicating a syntax error.
`JsonParser`	`useAltPaths()` Enables usage of additional paths.
`JsonParser`	`withValueConverter(java.lang.String path, ValueConverter valueConverter)` Defines `ValueConverter` to use on given path.

Methods inherited from class jodd.json.JsonParserBase
convertType, createMapToBean, injectValueIntoObject, newArrayInstance, newObjectInstance

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

KEYS
```
public static final java.lang.String KEYS
```
Map keys.

See Also:
Constant Field Values

VALUES
```
public static final java.lang.String VALUES
```
Array or map values.

See Also:
Constant Field Values

ndx
```
protected int ndx
```

input
```
protected char[] input
```

total
```
protected int total
```

path
```
protected Path path
```

useAltPaths
```
protected boolean useAltPaths
```

rootType
```
protected java.lang.Class rootType
```

mapToBean
```
protected MapToBean mapToBean
```

looseMode
```
protected boolean looseMode
```

mappings

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

convs

protected java.util.Map<Path,ValueConverter> convs

classMetadataName

protected java.lang.String classMetadataName

text
```
protected char[] text
```

textLen
```
protected int textLen
```

Constructor Detail
- JsonParser
```
public JsonParser()
```

Method Detail
- create
```
public static JsonParser create()
```
  Static ctor.
- reset
```
protected void reset()
```
  Resets JSON parser, so it can be reused.
- useAltPaths
```
public JsonParser useAltPaths()
```
  Enables usage of additional paths.
- looseMode
```
public JsonParser looseMode(boolean looseMode)
```
  Enables 'loose' mode for parsing. When 'loose' mode is enabled, JSON parsers swallows also invalid JSONs:
  - invalid escape character sequence is simply added to the output
  - strings can be quoted with single-quotes
  - strings can be unquoted, but may not contain escapes
- 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.
- withValueConverter
```
public JsonParser withValueConverter(java.lang.String path,
                            ValueConverter valueConverter)
```
  Defines ValueConverter to use on given path.
- lookupValueConverter
```
protected ValueConverter lookupValueConverter()
```
  Lookups for value converter for current path.
- setClassMetadataName
```
public JsonParser setClassMetadataName(java.lang.String name)
```
  Sets local class meta-data name.
- parse
```
public <T> T parse(java.lang.String input,
          java.lang.Class<T> targetType)
```
  Parses input JSON as given type.
- parse
```
public <T> T parse(java.lang.String input)
```
  Parses input JSON string.
- parse
```
public <T> T parse(char[] input,
          java.lang.Class<?> targetType)
```
  Parses input JSON as given type.
- parse
```
public <T> T parse(char[] input)
```
  Parses input JSON char array.
- parseValue
```
protected java.lang.Object parseValue(java.lang.Class targetType,
                          java.lang.Class keyType,
                          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(char quote)
```
  Parses string content, once when starting quote has been consumer.
- growEmpty
```
protected void growEmpty()
```
  Grows empty text array.
- growAndCopy
```
protected void growAndCopy()
```
  Grows text array when text.length == textLen.
- parseUnicode
```
protected char parseUnicode()
```
  Parses 4 characters and returns unicode character.
- parseUnquotedStringContent
```
protected java.lang.String parseUnquotedStringContent()
```
  Parses un-quoted string content.
- 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 valueKeyType,
                                  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.
- consumeOneOf
```
protected char consumeOneOf(char c1,
                char c2)
```
  Consumes one of the allowed char at current position. If char is different, return 0. If matched, returns matched char.
- 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.
- syntaxError
```
protected void syntaxError(java.lang.String message)
```
  Throws JsonException indicating a syntax error.

Class JsonParser

Field Summary

Constructor Summary

Method Summary

Methods inherited from class jodd.json.JsonParserBase

Methods inherited from class java.lang.Object

Field Detail

KEYS

VALUES

ndx

input

total

path

useAltPaths

rootType

mapToBean

looseMode

mappings

convs

classMetadataName

text

textLen

Constructor Detail

JsonParser

Method Detail

create

reset

useAltPaths

looseMode

map

map

replaceWithMappedTypeForPath

withValueConverter

lookupValueConverter

setClassMetadataName

parse

parse

parse

parse

parseValue

parseString

parseStringContent

growEmpty

growAndCopy

parseUnicode

parseUnquotedStringContent

parseNumber

parseArrayContent

parseObjectContent

consume

consumeOneOf

isEOF

skipWhiteSpaces

match

syntaxError