Module org.elasticsearch.xcontent

Package org.elasticsearch.xcontent

Class XContentBuilder

java.lang.Object

org.elasticsearch.xcontent.XContentBuilder

All Implemented Interfaces:

Closeable, Flushable, AutoCloseable

public final class XContentBuilder
extends Object
implements Closeable, Flushable

A utility to build XContent (ie json).

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static interface	XContentBuilder.HumanReadableTransformer	Interface for transforming complex objects into their "raw" equivalents for human-readable fields
static interface	XContentBuilder.Writer

Constructor Summary

Constructors

Constructor	Description
XContentBuilder(XContent xContent, OutputStream bos)	Constructs a new builder using the provided XContent and an OutputStream.
XContentBuilder(XContent xContent, OutputStream os, Set<String> includes, Set<String> excludes, ParsedMediaType responseContentType)	Creates a new builder using the provided XContent, output stream and some inclusive and/or exclusive filters.
XContentBuilder(XContent xContent, OutputStream os, Set<String> includes, Set<String> excludes, ParsedMediaType responseContentType, RestApiVersion restApiVersion)	Creates a new builder using the provided XContent, output stream and some inclusive and/or exclusive filters.
XContentBuilder(XContentType xContentType, OutputStream bos, Set<String> includes)	Constructs a new builder using the provided XContent, an OutputStream and some filters.

Method Summary

Modifier and Type	Method	Description
XContentBuilder	array(String name, boolean[] values)
XContentBuilder	array(String name, byte[] values)
XContentBuilder	array(String name, double[] values)
XContentBuilder	array(String name, float[] values)
XContentBuilder	array(String name, int[] values)
XContentBuilder	array(String name, long[] values)
XContentBuilder	array(String name, short[] values)
XContentBuilder	array(String name, Object... values)
XContentBuilder	array(String name, String... values)
XContentBuilder	array(String name, BigDecimal[] values)
XContentBuilder	array(String name, BigInteger[] values)
XContentBuilder	array(String name, CheckedConsumer<XContentBuilder,IOException> callback)
static XContentBuilder	builder(XContent xContent)	Create a new XContentBuilder using the given XContent content.
static XContentBuilder	builder(XContent xContent, RestApiVersion restApiVersion)	Create a new XContentBuilder using the given XContent content and RestApiVersion.
static XContentBuilder	builder(XContentType xContentType, Set<String> includes, Set<String> excludes)	Create a new XContentBuilder using the given XContentType xContentType and some inclusive and/or exclusive filters.
void	close()
XContentType	contentType()
XContentBuilder	copyCurrentEvent(XContentParser parser)	Copies current event from parser into this builder.
XContentBuilder	copyCurrentStructure(XContentParser parser)
XContentBuilder	directFieldAsBase64(String name, CheckedConsumer<OutputStream,IOException> writer)	Write the content that is written to the output stream by the writer as a string encoded in Base64 format.
XContentBuilder	endArray()
XContentBuilder	endObject()
static void	ensureNameNotNull(String name)
static void	ensureNotNull(Object value, String message)
static void	ensureToXContentable(Object value)	Checks whether the given value is writeable as x-content.
XContentBuilder	enumSet(String name, EnumSet<?> values)
XContentBuilder	field(String name)
XContentBuilder	field(String name, boolean value)
XContentBuilder	field(String name, byte value)
XContentBuilder	field(String name, byte[] value)
XContentBuilder	field(String name, byte[] value, int offset, int length)
XContentBuilder	field(String name, double value)
XContentBuilder	field(String name, float value)
XContentBuilder	field(String name, int value)
XContentBuilder	field(String name, long value)
XContentBuilder	field(String name, short value)
XContentBuilder	field(String name, Boolean value)
XContentBuilder	field(String name, Byte value)
XContentBuilder	field(String name, Double value)
XContentBuilder	field(String name, Enum<?> value)
XContentBuilder	field(String name, Float value)
XContentBuilder	field(String name, Integer value)
XContentBuilder	field(String name, Iterable<?> values)
XContentBuilder	field(String name, Long value)
XContentBuilder	field(String name, Number value)
XContentBuilder	field(String name, Object value)
XContentBuilder	field(String name, Short value)
XContentBuilder	field(String name, String value)
XContentBuilder	field(String name, String[] value)
XContentBuilder	field(String name, BigDecimal value)
XContentBuilder	field(String name, BigInteger value)
XContentBuilder	field(String name, Collection<String> value)
XContentBuilder	field(String name, Map<String,?> values)
XContentBuilder	field(String name, ToXContent value)
XContentBuilder	field(String name, ToXContent value, ToXContent.Params params)
void	flush()
XContentGenerator	generator()
OutputStream	getOutputStream()
String	getResponseContentTypeString()
RestApiVersion	getRestApiVersion()	Returns a version used for serialising a response.
boolean	humanReadable()
XContentBuilder	humanReadable(boolean isHumanReadable)	Set the "human readable" flag.
XContentBuilder	humanReadableField(String rawFieldName, String readableFieldName, Object value)
boolean	isPrettyPrint()
XContentBuilder	latlon(double lat, double lon)
XContentBuilder	latlon(String name, double lat, double lon)
XContentBuilder	lfAtEnd()	Indicate that the current XContentBuilder must write a line feed ("\n") at the end of the built object.
XContentBuilder	map(Map<String,?> values)
XContentBuilder	map(Map<String,?> values, boolean ensureNoSelfReferences)
XContentBuilder	mapContents(Map<String,?> values)	writes a map without the start object and end object headers
XContentBuilder	nullField(String name)
XContentBuilder	nullValue()
XContentBuilder	object(String name, CheckedConsumer<XContentBuilder,IOException> callback)
XContentBuilder	percentageField(String rawFieldName, String readableFieldName, double percentage)
XContentBuilder	prettyPrint()
XContentBuilder	rawField(String name, InputStream value)	Deprecated. use rawField(String, InputStream, XContentType) to avoid content type auto-detection
XContentBuilder	rawField(String name, InputStream value, XContentType contentType)	Writes a raw field with the value taken from the bytes in the stream
XContentBuilder	rawValue(InputStream stream, XContentType contentType)	Writes a value with the source coming directly from the bytes in the stream
XContentBuilder	rawValue(String value)	Writes a value with the source coming directly from a pre-rendered string representation
XContentBuilder	startArray()
XContentBuilder	startArray(String name)
XContentBuilder	startObject()
XContentBuilder	startObject(String name)
XContentBuilder	stringListField(String name, Collection<String> values)
XContentBuilder	stringStringMap(String name, Map<String,String> values)
XContentBuilder	timestampField(String name, Object timestamp)	Write a field with a timestamp value: if the passed timestamp is null then writes null, otherwise looks up the date transformer for the type of timestamp and uses it to format the value.
XContentBuilder	timestampFieldsFromUnixEpochMillis(String rawFieldName, String humanReadableFieldName, long unixEpochMillis)	Writes a field containing the raw number of milliseconds since the unix epoch, and also if the humanReadable flag is set, writes a formatted representation of this value using the UNIX_EPOCH_MILLIS_FORMATTER.
XContentBuilder	timestampValue(Object timestamp)	Write a timestamp value: if the passed timestamp is null then writes null, otherwise looks up the date transformer for the type of timestamp and uses it to format the value.
XContentBuilder	utf8Value(byte[] bytes, int offset, int length)	Writes the binary content of the given byte array as UTF-8 bytes.
XContentBuilder	value(boolean value)
XContentBuilder	value(byte value)
XContentBuilder	value(byte[] value)
XContentBuilder	value(byte[] value, int offset, int length)
XContentBuilder	value(double value)
XContentBuilder	value(float value)
XContentBuilder	value(int value)
XContentBuilder	value(long value)
XContentBuilder	value(short value)
XContentBuilder	value(Boolean value)
XContentBuilder	value(Byte value)
XContentBuilder	value(Double value)
XContentBuilder	value(Float value)
XContentBuilder	value(Integer value)
XContentBuilder	value(Long value)
XContentBuilder	value(Object value)
XContentBuilder	value(Short value)
XContentBuilder	value(String value)
XContentBuilder	value(BigDecimal value)
XContentBuilder	value(BigInteger value)
XContentBuilder	value(Path value)
XContentBuilder	value(Map<String,?> map)
XContentBuilder	value(ToXContent value)
XContentBuilder	value(ToXContent value, ToXContent.Params params)
XContentBuilder	xContentList(String name, Collection<? extends ToXContent> values)
XContentBuilder	xContentList(String name, Collection<? extends ToXContent> values, ToXContent.Params params)
XContentBuilder	xContentList(String name, ToXContent... values)
XContentBuilder	xContentValuesMap(String name, Map<String,? extends ToXContent> values)

Methods inherited from class java.lang.Object

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

Constructor Details

XContentBuilder

public XContentBuilder(XContent xContent,
 OutputStream bos)
                throws IOException

Constructs a new builder using the provided XContent and an OutputStream. Make sure to call close() when the builder is done with.

Throws:

IOException

XContentBuilder

public XContentBuilder(XContentType xContentType,
 OutputStream bos,
 Set<String> includes)
                throws IOException

Constructs a new builder using the provided XContent, an OutputStream and some filters. If filters are specified, only those values matching a filter will be written to the output stream. Make sure to call close() when the builder is done with.

Throws:

IOException

XContentBuilder

public XContentBuilder(XContent xContent,
 OutputStream os,
 Set<String> includes,
 Set<String> excludes,
 ParsedMediaType responseContentType)
                throws IOException

Creates a new builder using the provided XContent, output stream and some inclusive and/or exclusive filters. When both exclusive and inclusive filters are provided, the underlying builder will first use exclusion filters to remove fields and then will check the remaining fields against the inclusive filters.

Make sure to call close() when the builder is done with.

Parameters:

os - the output stream

includes - the inclusive filters: only fields and objects that match the inclusive filters will be written to the output.

excludes - the exclusive filters: only fields and objects that don't match the exclusive filters will be written to the output.

responseContentType - a content-type header value to be sent back on a response

Throws:

IOException

XContentBuilder

public XContentBuilder(XContent xContent,
 OutputStream os,
 Set<String> includes,
 Set<String> excludes,
 ParsedMediaType responseContentType,
 RestApiVersion restApiVersion)
                throws IOException

Creates a new builder using the provided XContent, output stream and some inclusive and/or exclusive filters. When both exclusive and inclusive filters are provided, the underlying builder will first use exclusion filters to remove fields and then will check the remaining fields against the inclusive filters. Stores RestApiVersion to help steer the use of the builder depending on the version.

Parameters:

os - the output stream

includes - the inclusive filters: only fields and objects that match the inclusive filters will be written to the output.

excludes - the exclusive filters: only fields and objects that don't match the exclusive filters will be written to the output.

responseContentType - a content-type header value to be sent back on a response

restApiVersion - a rest api version indicating with which version the XContent is compatible with.

Throws:

IOException

See Also:

• Make sure to call #close() when the builder is done with.

Method Details

builder

public static XContentBuilder builder(XContent xContent)
                               throws IOException

Create a new XContentBuilder using the given XContent content.

The builder uses an internal ByteArrayOutputStream output stream to build the content.

Parameters:

xContent - the XContent

Returns:

a new XContentBuilder

Throws:

IOException - if an IOException occurs while building the content

builder

public static XContentBuilder builder(XContent xContent,
 RestApiVersion restApiVersion)
                               throws IOException

Create a new XContentBuilder using the given XContent content and RestApiVersion.

The builder uses an internal ByteArrayOutputStream output stream to build the content.

Parameters:

xContent - the XContent

Returns:

a new XContentBuilder

Throws:

IOException - if an IOException occurs while building the content

builder

public static XContentBuilder builder(XContentType xContentType,
 Set<String> includes,
 Set<String> excludes)
                               throws IOException

Create a new XContentBuilder using the given XContentType xContentType and some inclusive and/or exclusive filters.

The builder uses an internal ByteArrayOutputStream output stream to build the content. When both exclusive and inclusive filters are provided, the underlying builder will first use exclusion filters to remove fields and then will check the remaining fields against the inclusive filters.

Parameters:

xContentType - the XContentType

includes - the inclusive filters: only fields and objects that match the inclusive filters will be written to the output.

excludes - the exclusive filters: only fields and objects that don't match the exclusive filters will be written to the output.

Throws:

IOException - if an IOException occurs while building the content

getResponseContentTypeString

public String getResponseContentTypeString()

contentType

public XContentType contentType()

getOutputStream

public OutputStream getOutputStream()

Returns:

the output stream to which the built object is being written. Note that is dangerous to modify the stream.

prettyPrint

public XContentBuilder prettyPrint()

isPrettyPrint

public boolean isPrettyPrint()

lfAtEnd

public XContentBuilder lfAtEnd()

Indicate that the current XContentBuilder must write a line feed ("\n") at the end of the built object.

This only applies for JSON XContent type. It has no effect for other types.

humanReadable

public XContentBuilder humanReadable(boolean isHumanReadable)

Set the "human readable" flag. Once set, some types of values are written in a format easier to read for a human.

humanReadable

public boolean humanReadable()

Returns:

the value of the "human readable" flag. When the value is equal to true, some types of values are written in a format easier to read for a human.

object

public XContentBuilder object(String name,
 CheckedConsumer<XContentBuilder,IOException> callback)
                       throws IOException

Throws:

IOException

startObject

public XContentBuilder startObject()
                            throws IOException

Throws:

IOException

startObject

public XContentBuilder startObject(String name)
                            throws IOException

Throws:

IOException

endObject

public XContentBuilder endObject()
                          throws IOException

Throws:

IOException

array

public XContentBuilder array(String name,
 CheckedConsumer<XContentBuilder,IOException> callback)
                      throws IOException

Throws:

IOException

startArray

public XContentBuilder startArray()
                           throws IOException

Throws:

IOException

startArray

public XContentBuilder startArray(String name)
                           throws IOException

Throws:

IOException

endArray

public XContentBuilder endArray()
                         throws IOException

Throws:

IOException

field

public XContentBuilder field(String name)
                      throws IOException

Throws:

IOException

nullField

public XContentBuilder nullField(String name)
                          throws IOException

Throws:

IOException

nullValue

public XContentBuilder nullValue()
                          throws IOException

Throws:

IOException

field

public XContentBuilder field(String name,
 Boolean value)
                      throws IOException

Throws:

IOException

field

public XContentBuilder field(String name,
 boolean value)
                      throws IOException

Throws:

IOException

array

public XContentBuilder array(String name,
 boolean[] values)
                      throws IOException

Throws:

IOException

value

public XContentBuilder value(Boolean value)
                      throws IOException

Throws:

IOException

value

public XContentBuilder value(boolean value)
                      throws IOException

Throws:

IOException

field

public XContentBuilder field(String name,
 Byte value)
                      throws IOException

Throws:

IOException

field

public XContentBuilder field(String name,
 byte value)
                      throws IOException

Throws:

IOException

value

public XContentBuilder value(Byte value)
                      throws IOException

Throws:

IOException

value

public XContentBuilder value(byte value)
                      throws IOException

Throws:

IOException

array

public XContentBuilder array(String name,
 byte[] values)
                      throws IOException

Throws:

IOException

field

public XContentBuilder field(String name,
 Double value)
                      throws IOException

Throws:

IOException

field

public XContentBuilder field(String name,
 double value)
                      throws IOException

Throws:

IOException

array

public XContentBuilder array(String name,
 double[] values)
                      throws IOException

Throws:

IOException

value

public XContentBuilder value(Double value)
                      throws IOException

Throws:

IOException

value

public XContentBuilder value(double value)
                      throws IOException

Throws:

IOException

field

public XContentBuilder field(String name,
 Float value)
                      throws IOException

Throws:

IOException

field

public XContentBuilder field(String name,
 float value)
                      throws IOException

Throws:

IOException

array

public XContentBuilder array(String name,
 float[] values)
                      throws IOException

Throws:

IOException

value

public XContentBuilder value(Float value)
                      throws IOException

Throws:

IOException

value

public XContentBuilder value(float value)
                      throws IOException

Throws:

IOException

field

public XContentBuilder field(String name,
 Integer value)
                      throws IOException

Throws:

IOException

field

public XContentBuilder field(String name,
 int value)
                      throws IOException

Throws:

IOException

array

public XContentBuilder array(String name,
 int[] values)
                      throws IOException

Throws:

IOException

value

public XContentBuilder value(Integer value)
                      throws IOException

Throws:

IOException

value

public XContentBuilder value(int value)
                      throws IOException

Throws:

IOException

field

public XContentBuilder field(String name,
 Long value)
                      throws IOException

Throws:

IOException

field

public XContentBuilder field(String name,
 long value)
                      throws IOException

Throws:

IOException

array

public XContentBuilder array(String name,
 long[] values)
                      throws IOException

Throws:

IOException

value

public XContentBuilder value(Long value)
                      throws IOException

Throws:

IOException

value

public XContentBuilder value(long value)
                      throws IOException

Throws:

IOException

field

public XContentBuilder field(String name,
 Short value)
                      throws IOException

Throws:

IOException

field

public XContentBuilder field(String name,
 short value)
                      throws IOException

Throws:

IOException

array

public XContentBuilder array(String name,
 short[] values)
                      throws IOException

Throws:

IOException

value

public XContentBuilder value(Short value)
                      throws IOException

Throws:

IOException

value

public XContentBuilder value(short value)
                      throws IOException

Throws:

IOException

field

public XContentBuilder field(String name,
 BigInteger value)
                      throws IOException

Throws:

IOException

array

public XContentBuilder array(String name,
 BigInteger[] values)
                      throws IOException

Throws:

IOException

value

public XContentBuilder value(BigInteger value)
                      throws IOException

Throws:

IOException

field

public XContentBuilder field(String name,
 BigDecimal value)
                      throws IOException

Throws:

IOException

array

public XContentBuilder array(String name,
 BigDecimal[] values)
                      throws IOException

Throws:

IOException

value

public XContentBuilder value(BigDecimal value)
                      throws IOException

Throws:

IOException

field

public XContentBuilder field(String name,
 String value)
                      throws IOException

Throws:

IOException

array

public XContentBuilder array(String name,
 String... values)
                      throws IOException

Throws:

IOException

value

public XContentBuilder value(String value)
                      throws IOException

Throws:

IOException

field

public XContentBuilder field(String name,
 byte[] value)
                      throws IOException

Throws:

IOException

value

public XContentBuilder value(byte[] value)
                      throws IOException

Throws:

IOException

field

public XContentBuilder field(String name,
 byte[] value,
 int offset,
 int length)
                      throws IOException

Throws:

IOException

value

public XContentBuilder value(byte[] value,
 int offset,
 int length)
                      throws IOException

Throws:

IOException

utf8Value

public XContentBuilder utf8Value(byte[] bytes,
 int offset,
 int length)
                          throws IOException

Writes the binary content of the given byte array as UTF-8 bytes. Use XContentParser.charBuffer() to read the value back

Throws:

IOException

timestampField

public XContentBuilder timestampField(String name,
 Object timestamp)
                               throws IOException

Write a field with a timestamp value: if the passed timestamp is null then writes null, otherwise looks up the date transformer for the type of timestamp and uses it to format the value.

Throws:

IllegalArgumentException - if there is no transformer for the given value type

IOException

timestampFieldsFromUnixEpochMillis

public XContentBuilder timestampFieldsFromUnixEpochMillis(String rawFieldName,
 String humanReadableFieldName,
 long unixEpochMillis)
                                                   throws IOException

Writes a field containing the raw number of milliseconds since the unix epoch, and also if the humanReadable flag is set, writes a formatted representation of this value using the UNIX_EPOCH_MILLIS_FORMATTER.

Throws:

IOException

timestampValue

public XContentBuilder timestampValue(Object timestamp)
                               throws IOException

Write a timestamp value: if the passed timestamp is null then writes null, otherwise looks up the date transformer for the type of timestamp and uses it to format the value.

Throws:

IllegalArgumentException - if there is no transformer for the given value type

IOException

latlon

public XContentBuilder latlon(String name,
 double lat,
 double lon)
                       throws IOException

Throws:

IOException

latlon

public XContentBuilder latlon(double lat,
 double lon)
                       throws IOException

Throws:

IOException

value

public XContentBuilder value(Path value)
                      throws IOException

Throws:

IOException

field

public XContentBuilder field(String name,
 Object value)
                      throws IOException

Throws:

IOException

field

public XContentBuilder field(String name,
 Collection<String> value)
                      throws IOException

Throws:

IOException

field

public XContentBuilder field(String name,
 String[] value)
                      throws IOException

Throws:

IOException

field

public XContentBuilder field(String name,
 Number value)
                      throws IOException

Throws:

IOException

array

public XContentBuilder array(String name,
 Object... values)
                      throws IOException

Throws:

IOException

value

public XContentBuilder value(Object value)
                      throws IOException

Throws:

IOException

field

public XContentBuilder field(String name,
 ToXContent value)
                      throws IOException

Throws:

IOException

field

public XContentBuilder field(String name,
 ToXContent value,
 ToXContent.Params params)
                      throws IOException

Throws:

IOException

value

public XContentBuilder value(ToXContent value)
                      throws IOException

Throws:

IOException

value

public XContentBuilder value(Map<String,?> map)
                      throws IOException

Throws:

IOException

value

public XContentBuilder value(ToXContent value,
 ToXContent.Params params)
                      throws IOException

Throws:

IOException

stringListField

public XContentBuilder stringListField(String name,
 Collection<String> values)
                                throws IOException

Throws:

IOException

xContentList

public XContentBuilder xContentList(String name,
 Collection<? extends ToXContent> values)
                             throws IOException

Throws:

IOException

xContentList

public XContentBuilder xContentList(String name,
 Collection<? extends ToXContent> values,
 ToXContent.Params params)
                             throws IOException

Throws:

IOException

xContentList

public XContentBuilder xContentList(String name,
 ToXContent... values)
                             throws IOException

Throws:

IOException

enumSet

public XContentBuilder enumSet(String name,
 EnumSet<?> values)
                        throws IOException

Throws:

IOException

field

public XContentBuilder field(String name,
 Map<String,?> values)
                      throws IOException

Throws:

IOException

map

public XContentBuilder map(Map<String,?> values)
                    throws IOException

Throws:

IOException

map

public XContentBuilder map(Map<String,?> values,
 boolean ensureNoSelfReferences)
                    throws IOException

Throws:

IOException

stringStringMap

public XContentBuilder stringStringMap(String name,
 Map<String,String> values)
                                throws IOException

Throws:

IOException

xContentValuesMap

public XContentBuilder xContentValuesMap(String name,
 Map<String,? extends ToXContent> values)
                                  throws IOException

Throws:

IOException

mapContents

public XContentBuilder mapContents(Map<String,?> values)
                            throws IOException

writes a map without the start object and end object headers

Throws:

IOException

field

public XContentBuilder field(String name,
 Iterable<?> values)
                      throws IOException

Throws:

IOException

humanReadableField

public XContentBuilder humanReadableField(String rawFieldName,
 String readableFieldName,
 Object value)
                                   throws IOException

Throws:

IOException

percentageField

public XContentBuilder percentageField(String rawFieldName,
 String readableFieldName,
 double percentage)
                                throws IOException

Throws:

IOException

field

public XContentBuilder field(String name,
 Enum<?> value)
                      throws IOException

Throws:

IOException

rawField

@Deprecated
public XContentBuilder rawField(String name,
 InputStream value)
                         throws IOException

Deprecated.

use rawField(String, InputStream, XContentType) to avoid content type auto-detection

Writes a raw field with the value taken from the bytes in the stream

Throws:

IOException

rawField

public XContentBuilder rawField(String name,
 InputStream value,
 XContentType contentType)
                         throws IOException

Writes a raw field with the value taken from the bytes in the stream

Throws:

IOException

rawValue

public XContentBuilder rawValue(InputStream stream,
 XContentType contentType)
                         throws IOException

Writes a value with the source coming directly from the bytes in the stream

Throws:

IOException

rawValue

public XContentBuilder rawValue(String value)
                         throws IOException

Writes a value with the source coming directly from a pre-rendered string representation

Throws:

IOException

copyCurrentEvent

public XContentBuilder copyCurrentEvent(XContentParser parser)
                                 throws IOException

Copies current event from parser into this builder. The difference with copyCurrentStructure(XContentParser) is that this method does not copy sub-objects as a single entity.

Parameters:

parser -

Throws:

IOException

copyCurrentStructure

public XContentBuilder copyCurrentStructure(XContentParser parser)
                                     throws IOException

Throws:

IOException

directFieldAsBase64

public XContentBuilder directFieldAsBase64(String name,
 CheckedConsumer<OutputStream,IOException> writer)
                                    throws IOException

Write the content that is written to the output stream by the writer as a string encoded in Base64 format. This API can be used to generate XContent directly without the intermediate results to reduce memory usage. Note that this method supports only JSON.

Throws:

IOException

getRestApiVersion

public RestApiVersion getRestApiVersion()

Returns a version used for serialising a response.

Returns:

a compatible version

flush

public void flush()
           throws IOException

Specified by:

flush in interface Flushable

Throws:

IOException

close

public void close()

Specified by:

close in interface AutoCloseable

Specified by:

close in interface Closeable

generator

public XContentGenerator generator()

ensureNameNotNull

public static void ensureNameNotNull(String name)

ensureNotNull

public static void ensureNotNull(Object value,
 String message)

ensureToXContentable

public static void ensureToXContentable(@Nullable
 Object value)

Checks whether the given value is writeable as x-content. If the value cannot be passed to value(Object) without error, an error IllegalArgumentException is thrown.