Package org.elasticsearch.common.xcontent

Interface XContentParser

All Superinterfaces:

java.lang.AutoCloseable, java.io.Closeable

All Known Implementing Classes:

AbstractXContentParser, CborXContentParser, JsonXContentParser, MapXContentParser, SmileXContentParser, XContentSubParser, YamlXContentParser

public interface XContentParser
extends java.io.Closeable

Interface for pull - parsing XContent see XContentType for supported types. To obtain an instance of this class use the following pattern:

     XContentType xContentType = XContentType.JSON;
     XContentParser parser = xContentType.xContent().createParser(
          NamedXContentRegistry.EMPTY, ParserField."{\"key\" : \"value\"}");
 

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static class	XContentParser.NumberType
static class	XContentParser.Token

Method Summary

Modifier and Type	Method	Description
byte[]	binaryValue()	Reads a plain binary value that was written via one of the following methods: XContentBuilder.field(String, byte[], int, int)} XContentBuilder.field(String, byte[])} as well as via their String variants of the separated value methods.
boolean	booleanValue()
java.nio.CharBuffer	charBuffer()	Returns a CharBuffer holding UTF-8 bytes.
java.nio.CharBuffer	charBufferOrNull()
XContentType	contentType()
java.lang.String	currentName()
XContentParser.Token	currentToken()
double	doubleValue()
double	doubleValue(boolean coerce)
float	floatValue()
float	floatValue(boolean coerce)
DeprecationHandler	getDeprecationHandler()	The callback to notify when parsing encounters a deprecated field.
XContentLocation	getTokenLocation()	Used for error reporting to highlight where syntax errors occur in content being parsed.
NamedXContentRegistry	getXContentRegistry()	The registry used to resolve namedObject(Class, String, Object).
boolean	hasTextCharacters()	Method that can be used to determine whether calling of textCharacters() would be the most efficient way to access textual content for the event parser currently points to.
int	intValue()
int	intValue(boolean coerce)
boolean	isBooleanValue()
boolean	isClosed()
java.util.List<java.lang.Object>	list()
java.util.List<java.lang.Object>	listOrderedMap()
long	longValue()
long	longValue(boolean coerce)
java.util.Map<java.lang.String,java.lang.Object>	map()
<T> java.util.Map<java.lang.String,T>	map(java.util.function.Supplier<java.util.Map<java.lang.String,T>> mapFactory, CheckedFunction<XContentParser,T,java.io.IOException> mapValueParser)	Returns an instance of Map holding parsed map.
java.util.Map<java.lang.String,java.lang.Object>	mapOrdered()
java.util.Map<java.lang.String,java.lang.String>	mapStrings()
<T> T	namedObject(java.lang.Class<T> categoryClass, java.lang.String name, java.lang.Object context)	Parse an object by name.
XContentParser.Token	nextToken()
XContentParser.NumberType	numberType()
java.lang.Number	numberValue()
java.lang.Object	objectBytes()
java.lang.Object	objectText()
short	shortValue()
short	shortValue(boolean coerce)
void	skipChildren()
java.lang.String	text()
char[]	textCharacters()
int	textLength()
int	textOffset()
java.lang.String	textOrNull()

Methods inherited from interface java.io.Closeable

close

Method Details

contentType

XContentType contentType()

nextToken

XContentParser.Token nextToken() throws java.io.IOException

Throws:

java.io.IOException

skipChildren

void skipChildren() throws java.io.IOException

Throws:

java.io.IOException

currentToken

XContentParser.Token currentToken()

currentName

java.lang.String currentName() throws java.io.IOException

Throws:

java.io.IOException

map

java.util.Map<java.lang.String,java.lang.Object> map() throws java.io.IOException

Throws:

java.io.IOException

mapOrdered

java.util.Map<java.lang.String,java.lang.Object> mapOrdered() throws java.io.IOException

Throws:

java.io.IOException

mapStrings

java.util.Map<java.lang.String,java.lang.String> mapStrings() throws java.io.IOException

Throws:

java.io.IOException

map

<T> java.util.Map<java.lang.String,T> map(java.util.function.Supplier<java.util.Map<java.lang.String,T>> mapFactory, CheckedFunction<XContentParser,T,java.io.IOException> mapValueParser) throws java.io.IOException

Returns an instance of Map holding parsed map. Serves as a replacement for the "map", "mapOrdered" and "mapStrings" methods above.

Type Parameters:

T - map value type

Parameters:

mapFactory - factory for creating new Map objects

mapValueParser - parser for parsing a single map value

Returns:

Map object

Throws:

java.io.IOException

list

java.util.List<java.lang.Object> list() throws java.io.IOException

Throws:

java.io.IOException

listOrderedMap

java.util.List<java.lang.Object> listOrderedMap() throws java.io.IOException

Throws:

java.io.IOException

text

java.lang.String text() throws java.io.IOException

Throws:

java.io.IOException

textOrNull

java.lang.String textOrNull() throws java.io.IOException

Throws:

java.io.IOException

charBufferOrNull

java.nio.CharBuffer charBufferOrNull() throws java.io.IOException

Throws:

java.io.IOException

charBuffer

java.nio.CharBuffer charBuffer() throws java.io.IOException

Returns a CharBuffer holding UTF-8 bytes. This method should be used to read text only binary content should be read through binaryValue()

Throws:

java.io.IOException

objectText

java.lang.Object objectText() throws java.io.IOException

Throws:

java.io.IOException

objectBytes

java.lang.Object objectBytes() throws java.io.IOException

Throws:

java.io.IOException

hasTextCharacters

boolean hasTextCharacters()

Method that can be used to determine whether calling of textCharacters() would be the most efficient way to access textual content for the event parser currently points to. Default implementation simply returns false since only actual implementation class has knowledge of its internal buffering state. This method shouldn't be used to check if the token contains text or not.

textCharacters

char[] textCharacters() throws java.io.IOException

Throws:

java.io.IOException

textLength

int textLength() throws java.io.IOException

Throws:

java.io.IOException

textOffset

int textOffset() throws java.io.IOException

Throws:

java.io.IOException

numberValue

java.lang.Number numberValue() throws java.io.IOException

Throws:

java.io.IOException

numberType

XContentParser.NumberType numberType() throws java.io.IOException

Throws:

java.io.IOException

shortValue

short shortValue(boolean coerce) throws java.io.IOException

Throws:

java.io.IOException

intValue

int intValue(boolean coerce) throws java.io.IOException

Throws:

java.io.IOException

longValue

long longValue(boolean coerce) throws java.io.IOException

Throws:

java.io.IOException

floatValue

float floatValue(boolean coerce) throws java.io.IOException

Throws:

java.io.IOException

doubleValue

double doubleValue(boolean coerce) throws java.io.IOException

Throws:

java.io.IOException

shortValue

short shortValue() throws java.io.IOException

Throws:

java.io.IOException

intValue

int intValue() throws java.io.IOException

Throws:

java.io.IOException

longValue

long longValue() throws java.io.IOException

Throws:

java.io.IOException

floatValue

float floatValue() throws java.io.IOException

Throws:

java.io.IOException

doubleValue

double doubleValue() throws java.io.IOException

Throws:

java.io.IOException

isBooleanValue

boolean isBooleanValue() throws java.io.IOException

Returns:

true iff the current value is either boolean (true or false) or one of "false", "true".

Throws:

java.io.IOException

booleanValue

boolean booleanValue() throws java.io.IOException

Throws:

java.io.IOException

binaryValue

byte[] binaryValue() throws java.io.IOException

Reads a plain binary value that was written via one of the following methods:

• XContentBuilder.field(String, byte[], int, int)}
• XContentBuilder.field(String, byte[])}

as well as via their String variants of the separated value methods. Note: Do not use this method to read values written with:

• XContentBuilder.utf8Value(byte[], int, int)

these methods write UTF-8 encoded strings and must be read through:

• text() ()}
• textOrNull() ()}
• textCharacters() ()}}

Throws:

java.io.IOException

getTokenLocation

XContentLocation getTokenLocation()

Used for error reporting to highlight where syntax errors occur in content being parsed.

Returns:

last token's location or null if cannot be determined

namedObject

<T> T namedObject(java.lang.Class<T> categoryClass, java.lang.String name, java.lang.Object context) throws java.io.IOException

Parse an object by name.

Throws:

java.io.IOException

getXContentRegistry

NamedXContentRegistry getXContentRegistry()

The registry used to resolve namedObject(Class, String, Object). Use this when building a sub-parser from this parser.

isClosed

boolean isClosed()

getDeprecationHandler

DeprecationHandler getDeprecationHandler()

The callback to notify when parsing encounters a deprecated field.