org.elasticsearch.common.xcontent

Interface XContentParser

All Superinterfaces:

AutoCloseable, Releasable

All Known Implementing Classes:

AbstractXContentParser, CborXContentParser, JsonXContentParser, SmileXContentParser, YamlXContentParser

public interface XContentParser
extends Releasable

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("{\"key\" : \"value\"}");
 

Nested Class Summary

Nested Classes

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

Method Summary

Methods

Modifier and Type	Method and Description
byte[]	binaryValue() Reads a plain binary value that was written via one of the following methods: XContentBuilder.field(String, org.apache.lucene.util.BytesRef) XContentBuilder.field(String, org.elasticsearch.common.bytes.BytesReference) XContentBuilder.field(String, byte[], int, int)} XContentBuilder.field(String, byte[])} as well as via their XContentBuilderString variants of the separated value methods.
boolean	booleanValue()
XContentType	contentType()
String	currentName()
XContentParser.Token	currentToken()
double	doubleValue()
double	doubleValue(boolean coerce)
float	floatValue()
float	floatValue(boolean coerce)
XContentLocation	getTokenLocation() Used for error reporting to highlight where syntax errors occur in content being parsed.
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() returns true if the current value is boolean in nature.
boolean	isClosed()
List<Object>	list()
List<Object>	listOrderedMap()
long	longValue()
long	longValue(boolean coerce)
Map<String,Object>	map()
Map<String,Object>	mapOrdered()
XContentParser.Token	nextToken()
XContentParser.NumberType	numberType()
Number	numberValue()
Object	objectBytes()
Object	objectText()
short	shortValue()
short	shortValue(boolean coerce)
void	skipChildren()
String	text()
char[]	textCharacters()
int	textLength()
int	textOffset()
String	textOrNull()
org.apache.lucene.util.BytesRef	utf8Bytes() Returns a BytesRef holding UTF-8 bytes.
org.apache.lucene.util.BytesRef	utf8BytesOrNull() Returns a BytesRef holding UTF-8 bytes or null if a null value is XContentParser.Token.VALUE_NULL.

Methods inherited from interface org.elasticsearch.common.lease.Releasable

close

Method Detail

contentType

XContentType contentType()

nextToken

XContentParser.Token nextToken()
                               throws IOException

Throws:

IOException

skipChildren

void skipChildren()
                  throws IOException

Throws:

IOException

currentToken

XContentParser.Token currentToken()

currentName

String currentName()
                   throws IOException

Throws:

IOException

map

Map<String,Object> map()
                       throws IOException

Throws:

IOException

mapOrdered

Map<String,Object> mapOrdered()
                              throws IOException

Throws:

IOException

list

List<Object> list()
                  throws IOException

Throws:

IOException

listOrderedMap

List<Object> listOrderedMap()
                            throws IOException

Throws:

IOException

text

String text()
            throws IOException

Throws:

IOException

textOrNull

String textOrNull()
                  throws IOException

Throws:

IOException

utf8BytesOrNull

org.apache.lucene.util.BytesRef utf8BytesOrNull()
                                                throws IOException

Returns a BytesRef holding UTF-8 bytes or null if a null value is XContentParser.Token.VALUE_NULL. This method should be used to read text only binary content should be read through binaryValue()

Throws:

IOException

utf8Bytes

org.apache.lucene.util.BytesRef utf8Bytes()
                                          throws IOException

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

Throws:

IOException

objectText

Object objectText()
                  throws IOException

Throws:

IOException

objectBytes

Object objectBytes()
                   throws IOException

Throws:

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 IOException

Throws:

IOException

textLength

int textLength()
               throws IOException

Throws:

IOException

textOffset

int textOffset()
               throws IOException

Throws:

IOException

numberValue

Number numberValue()
                   throws IOException

Throws:

IOException

numberType

XContentParser.NumberType numberType()
                                     throws IOException

Throws:

IOException

shortValue

short shortValue(boolean coerce)
                 throws IOException

Throws:

IOException

intValue

int intValue(boolean coerce)
             throws IOException

Throws:

IOException

longValue

long longValue(boolean coerce)
               throws IOException

Throws:

IOException

floatValue

float floatValue(boolean coerce)
                 throws IOException

Throws:

IOException

doubleValue

double doubleValue(boolean coerce)
                   throws IOException

Throws:

IOException

shortValue

short shortValue()
                 throws IOException

Throws:

IOException

intValue

int intValue()
             throws IOException

Throws:

IOException

longValue

long longValue()
               throws IOException

Throws:

IOException

floatValue

float floatValue()
                 throws IOException

Throws:

IOException

doubleValue

double doubleValue()
                   throws IOException

Throws:

IOException

isBooleanValue

boolean isBooleanValue()
                       throws IOException

returns true if the current value is boolean in nature. values that are considered booleans: - boolean value (true/false) - numeric integers (=0 is considered as false, !=0 is true) - one of the following strings: "true","false","on","off","yes","no","1","0"

Throws:

IOException

booleanValue

boolean booleanValue()
                     throws IOException

Throws:

IOException

binaryValue

byte[] binaryValue()
                   throws IOException

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

• XContentBuilder.field(String, org.apache.lucene.util.BytesRef)
• XContentBuilder.field(String, org.elasticsearch.common.bytes.BytesReference)
• XContentBuilder.field(String, byte[], int, int)}
• XContentBuilder.field(String, byte[])}

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

• XContentBuilder.utf8Field(XContentBuilderString, org.apache.lucene.util.BytesRef)
• XContentBuilder.utf8Field(String, org.apache.lucene.util.BytesRef)

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

• utf8Bytes()
• utf8BytesOrNull()}
• text() ()}
• textOrNull() ()}
• textCharacters() ()}}

Throws:

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

isClosed

boolean isClosed()