Module org.elasticsearch.xcontent

Package org.elasticsearch.xcontent

Class XContentFactory

java.lang.Object

org.elasticsearch.xcontent.XContentFactory

public class XContentFactory
extends Object

A one stop to use XContent and XContentBuilder.

Field Summary

Fields

Modifier and Type	Field	Description
static final int	GUESS_HEADER_LENGTH

Method Summary

Modifier and Type	Method	Description
static XContentBuilder	cborBuilder()	Returns a content builder using CBOR format (XContentType.CBOR.
static XContentBuilder	cborBuilder(OutputStream os)	Constructs a new cbor builder that will output the result into the provided output stream.
static XContentBuilder	contentBuilder(XContentType type)	Returns a binary content builder for the provided content type.
static XContentBuilder	contentBuilder(XContentType type, OutputStream outputStream)	Constructs a xcontent builder that will output the result into the provided output stream.
static XContentBuilder	jsonBuilder()	Returns a content builder using JSON format (XContentType.JSON.
static XContentBuilder	jsonBuilder(OutputStream os)	Constructs a new json builder that will output the result into the provided output stream.
static XContentBuilder	smileBuilder()	Returns a content builder using SMILE format (XContentType.SMILE.
static XContentBuilder	smileBuilder(OutputStream os)	Constructs a new json builder that will output the result into the provided output stream.
static XContent	xContent(byte[] data)	Deprecated. the content type should not be guessed except for few cases where we effectively don't know the content type.
static XContent	xContent(byte[] data, int offset, int length)	Deprecated. guessing the content type should not be needed ideally.
static XContent	xContent(CharSequence content)	Deprecated. the content type should not be guessed except for few cases where we effectively don't know the content type.
static XContent	xContent(XContentType type)	Returns the XContent for the provided content type.
static XContentType	xContentType(byte[] bytes)	Deprecated. the content type should not be guessed except for few cases where we effectively don't know the content type.
static XContentType	xContentType(byte[] bytes, int offset, int length)	Deprecated. the content type should not be guessed except for few cases where we effectively don't know the content type.
static XContentType	xContentType(InputStream si)	Deprecated. the content type should not be guessed except for few cases where we effectively don't know the content type.
static XContentType	xContentType(CharSequence content)	Deprecated. the content type should not be guessed except for few cases where we effectively don't know the content type.
static XContentBuilder	yamlBuilder()	Returns a content builder using YAML format (XContentType.YAML.
static XContentBuilder	yamlBuilder(OutputStream os)	Constructs a new yaml builder that will output the result into the provided output stream.

Methods inherited from class java.lang.Object

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

Field Details

GUESS_HEADER_LENGTH

public static final int GUESS_HEADER_LENGTH

See Also:

• Constant Field Values

Method Details

jsonBuilder

public static XContentBuilder jsonBuilder()
                                   throws IOException

Returns a content builder using JSON format (XContentType.JSON.

Throws:

IOException

jsonBuilder

public static XContentBuilder jsonBuilder(OutputStream os)
                                   throws IOException

Constructs a new json builder that will output the result into the provided output stream.

Throws:

IOException

smileBuilder

public static XContentBuilder smileBuilder()
                                    throws IOException

Returns a content builder using SMILE format (XContentType.SMILE.

Throws:

IOException

smileBuilder

public static XContentBuilder smileBuilder(OutputStream os)
                                    throws IOException

Constructs a new json builder that will output the result into the provided output stream.

Throws:

IOException

yamlBuilder

public static XContentBuilder yamlBuilder()
                                   throws IOException

Returns a content builder using YAML format (XContentType.YAML.

Throws:

IOException

yamlBuilder

public static XContentBuilder yamlBuilder(OutputStream os)
                                   throws IOException

Constructs a new yaml builder that will output the result into the provided output stream.

Throws:

IOException

cborBuilder

public static XContentBuilder cborBuilder()
                                   throws IOException

Returns a content builder using CBOR format (XContentType.CBOR.

Throws:

IOException

cborBuilder

public static XContentBuilder cborBuilder(OutputStream os)
                                   throws IOException

Constructs a new cbor builder that will output the result into the provided output stream.

Throws:

IOException

contentBuilder

public static XContentBuilder contentBuilder(XContentType type,
 OutputStream outputStream)
                                      throws IOException

Constructs a xcontent builder that will output the result into the provided output stream.

Throws:

IOException

contentBuilder

public static XContentBuilder contentBuilder(XContentType type)
                                      throws IOException

Returns a binary content builder for the provided content type.

Throws:

IOException

xContent

public static XContent xContent(XContentType type)

Returns the XContent for the provided content type.

xContentType

@Deprecated
public static XContentType xContentType(CharSequence content)

Deprecated.

the content type should not be guessed except for few cases where we effectively don't know the content type. The REST layer should move to reading the Content-Type header instead. There are other places where auto-detection may be needed. This method is deprecated to prevent usages of it from spreading further without specific reasons.

Guesses the content type based on the provided char sequence.

xContent

@Deprecated
public static XContent xContent(CharSequence content)

Deprecated.

the content type should not be guessed except for few cases where we effectively don't know the content type. The REST layer should move to reading the Content-Type header instead. There are other places where auto-detection may be needed. This method is deprecated to prevent usages of it from spreading further without specific reasons.

Guesses the content (type) based on the provided char sequence and returns the corresponding XContent

xContent

@Deprecated
public static XContent xContent(byte[] data)

Deprecated.

the content type should not be guessed except for few cases where we effectively don't know the content type. The REST layer should move to reading the Content-Type header instead. There are other places where auto-detection may be needed. This method is deprecated to prevent usages of it from spreading further without specific reasons.

Guesses the content type based on the provided bytes and returns the corresponding XContent

xContent

@Deprecated
public static XContent xContent(byte[] data,
 int offset,
 int length)

Deprecated.

guessing the content type should not be needed ideally. We should rather know the content type upfront or read it from headers. Till we fixed the REST layer to read the Content-Type header, that should be the only place where guessing is needed.

Guesses the content type based on the provided bytes and returns the corresponding XContent

xContentType

@Deprecated
public static XContentType xContentType(InputStream si)
                                 throws IOException

Deprecated.

the content type should not be guessed except for few cases where we effectively don't know the content type. The REST layer should move to reading the Content-Type header instead. There are other places where auto-detection may be needed. This method is deprecated to prevent usages of it from spreading further without specific reasons.

Guesses the content type based on the provided input stream without consuming it.

Throws:

IOException

xContentType

@Deprecated
public static XContentType xContentType(byte[] bytes)

Deprecated.

the content type should not be guessed except for few cases where we effectively don't know the content type. The REST layer should move to reading the Content-Type header instead. There are other places where auto-detection may be needed. This method is deprecated to prevent usages of it from spreading further without specific reasons.

Guesses the content type based on the provided bytes.

xContentType

@Deprecated
public static XContentType xContentType(byte[] bytes,
 int offset,
 int length)

Deprecated.

the content type should not be guessed except for few cases where we effectively don't know the content type. The REST layer should move to reading the Content-Type header instead. There are other places where auto-detection may be needed. This method is deprecated to prevent usages of it from spreading further without specific reasons.

Guesses the content type based on the provided bytes.