Package org.elasticsearch.common.xcontent

Class XContentHelper

java.lang.Object

org.elasticsearch.common.xcontent.XContentHelper

public class XContentHelper
extends java.lang.Object

Constructor Summary

Constructors

Constructor	Description
XContentHelper()

Method Summary

Modifier and Type	Method	Description
static java.lang.String	convertToJson(BytesReference bytes, boolean reformatJson)	Deprecated.
static java.lang.String	convertToJson(BytesReference bytes, boolean reformatJson, boolean prettyPrint)	Deprecated.
static java.lang.String	convertToJson(BytesReference bytes, boolean reformatJson, boolean prettyPrint, XContentType xContentType)
static java.lang.String	convertToJson(BytesReference bytes, boolean reformatJson, XContentType xContentType)
static Tuple<XContentType,java.util.Map<java.lang.String,java.lang.Object>>	convertToMap(BytesReference bytes, boolean ordered)	Deprecated. this method relies on auto-detection of content type.
static Tuple<XContentType,java.util.Map<java.lang.String,java.lang.Object>>	convertToMap(BytesReference bytes, boolean ordered, XContentType xContentType)	Converts the given bytes into a map that is optionally ordered.
static java.util.Map<java.lang.String,java.lang.Object>	convertToMap(XContent xContent, java.io.InputStream input, boolean ordered)	Convert a string in some XContent format to a Map.
static java.util.Map<java.lang.String,java.lang.Object>	convertToMap(XContent xContent, java.lang.String string, boolean ordered)	Convert a string in some XContent format to a Map.
static XContentParser	createParser(NamedXContentRegistry xContentRegistry, DeprecationHandler deprecationHandler, BytesReference bytes)	Deprecated. use createParser(NamedXContentRegistry, DeprecationHandler, BytesReference, XContentType) to avoid content type auto-detection
static XContentParser	createParser(NamedXContentRegistry xContentRegistry, DeprecationHandler deprecationHandler, BytesReference bytes, XContentType xContentType)	Creates a parser for the bytes using the supplied content-type
static void	mergeDefaults(java.util.Map<java.lang.String,java.lang.Object> content, java.util.Map<java.lang.String,java.lang.Object> defaults)	Merges the defaults provided as the second parameter into the content of the first.
static java.lang.String	stripWhitespace(java.lang.String json)	Accepts a JSON string, parses it and prints it without pretty-printing it.
static BytesReference	toXContent(ToXContent toXContent, XContentType xContentType, boolean humanReadable)	Returns the bytes that represent the XContent output of the provided ToXContent object, using the provided XContentType.
static BytesReference	toXContent(ToXContent toXContent, XContentType xContentType, ToXContent.Params params, boolean humanReadable)	Returns the bytes that represent the XContent output of the provided ToXContent object, using the provided XContentType.
static boolean	update(java.util.Map<java.lang.String,java.lang.Object> source, java.util.Map<java.lang.String,java.lang.Object> changes, boolean checkUpdatesAreUnequal)	Updates the provided changes into the source.
static void	writeRawField(java.lang.String field, BytesReference source, XContentBuilder builder, ToXContent.Params params)	Deprecated. use writeRawField(String, BytesReference, XContentType, XContentBuilder, Params) to avoid content type auto-detection
static void	writeRawField(java.lang.String field, BytesReference source, XContentType xContentType, XContentBuilder builder, ToXContent.Params params)	Writes a "raw" (bytes) field, handling cases where the bytes are compressed, and tries to optimize writing using XContentBuilder.rawField(String, InputStream, XContentType).
static XContentType	xContentType(BytesReference bytes)	Deprecated. the content type should not be guessed except for few cases where we effectively don't know the content type.

Methods inherited from class java.lang.Object

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

Constructor Details

XContentHelper

public XContentHelper()

Method Details

createParser

@Deprecated public static XContentParser createParser(NamedXContentRegistry xContentRegistry, DeprecationHandler deprecationHandler, BytesReference bytes) throws java.io.IOException

Deprecated.

use createParser(NamedXContentRegistry, DeprecationHandler, BytesReference, XContentType) to avoid content type auto-detection

Creates a parser based on the bytes provided

Throws:

java.io.IOException

createParser

public static XContentParser createParser(NamedXContentRegistry xContentRegistry, DeprecationHandler deprecationHandler, BytesReference bytes, XContentType xContentType) throws java.io.IOException

Creates a parser for the bytes using the supplied content-type

Throws:

java.io.IOException

convertToMap

@Deprecated public static Tuple<XContentType,java.util.Map<java.lang.String,java.lang.Object>> convertToMap(BytesReference bytes, boolean ordered) throws ElasticsearchParseException

Deprecated.

this method relies on auto-detection of content type. Use convertToMap(BytesReference, boolean, XContentType) instead with the proper XContentType

Converts the given bytes into a map that is optionally ordered.

Throws:

ElasticsearchParseException

convertToMap

public static Tuple<XContentType,java.util.Map<java.lang.String,java.lang.Object>> convertToMap(BytesReference bytes, boolean ordered, XContentType xContentType) throws ElasticsearchParseException

Converts the given bytes into a map that is optionally ordered. The provided XContentType must be non-null.

Throws:

ElasticsearchParseException

convertToMap

public static java.util.Map<java.lang.String,java.lang.Object> convertToMap(XContent xContent, java.lang.String string, boolean ordered) throws ElasticsearchParseException

Convert a string in some XContent format to a Map. Throws an ElasticsearchParseException if there is any error.

Throws:

ElasticsearchParseException

convertToMap

public static java.util.Map<java.lang.String,java.lang.Object> convertToMap(XContent xContent, java.io.InputStream input, boolean ordered) throws ElasticsearchParseException

Convert a string in some XContent format to a Map. Throws an ElasticsearchParseException if there is any error. Note that unlike convertToMap(BytesReference, boolean), this doesn't automatically uncompress the input.

Throws:

ElasticsearchParseException

convertToJson

@Deprecated public static java.lang.String convertToJson(BytesReference bytes, boolean reformatJson) throws java.io.IOException

Deprecated.

Throws:

java.io.IOException

convertToJson

@Deprecated public static java.lang.String convertToJson(BytesReference bytes, boolean reformatJson, boolean prettyPrint) throws java.io.IOException

Deprecated.

Throws:

java.io.IOException

convertToJson

public static java.lang.String convertToJson(BytesReference bytes, boolean reformatJson, XContentType xContentType) throws java.io.IOException

Throws:

java.io.IOException

stripWhitespace

public static java.lang.String stripWhitespace(java.lang.String json) throws java.io.IOException

Accepts a JSON string, parses it and prints it without pretty-printing it. This is useful where a piece of JSON is formatted for legibility, but needs to be stripped of unnecessary whitespace e.g. for comparison in a test.

Parameters:

json - the JSON to format

Returns:

reformatted JSON

Throws:

java.io.IOException - if the reformatting fails, e.g. because the JSON is not well-formed

convertToJson

public static java.lang.String convertToJson(BytesReference bytes, boolean reformatJson, boolean prettyPrint, XContentType xContentType) throws java.io.IOException

Throws:

java.io.IOException

update

public static boolean update(java.util.Map<java.lang.String,java.lang.Object> source, java.util.Map<java.lang.String,java.lang.Object> changes, boolean checkUpdatesAreUnequal)

Updates the provided changes into the source. If the key exists in the changes, it overrides the one in source unless both are Maps, in which case it recursively updated it.

Parameters:

source - the original map to be updated

changes - the changes to update into updated

checkUpdatesAreUnequal - should this method check if updates to the same key (that are not both maps) are unequal? This is just a .equals check on the objects, but that can take some time on long strings.

Returns:

true if the source map was modified

mergeDefaults

public static void mergeDefaults(java.util.Map<java.lang.String,java.lang.Object> content, java.util.Map<java.lang.String,java.lang.Object> defaults)

Merges the defaults provided as the second parameter into the content of the first. Only does recursive merge for inner maps.

writeRawField

@Deprecated public static void writeRawField(java.lang.String field, BytesReference source, XContentBuilder builder, ToXContent.Params params) throws java.io.IOException

Deprecated.

use writeRawField(String, BytesReference, XContentType, XContentBuilder, Params) to avoid content type auto-detection

Writes a "raw" (bytes) field, handling cases where the bytes are compressed, and tries to optimize writing using XContentBuilder.rawField(String, InputStream).

Throws:

java.io.IOException

writeRawField

public static void writeRawField(java.lang.String field, BytesReference source, XContentType xContentType, XContentBuilder builder, ToXContent.Params params) throws java.io.IOException

Writes a "raw" (bytes) field, handling cases where the bytes are compressed, and tries to optimize writing using XContentBuilder.rawField(String, InputStream, XContentType).

Throws:

java.io.IOException

toXContent

public static BytesReference toXContent(ToXContent toXContent, XContentType xContentType, boolean humanReadable) throws java.io.IOException

Returns the bytes that represent the XContent output of the provided ToXContent object, using the provided XContentType. Wraps the output into a new anonymous object according to the value returned by the ToXContent.isFragment() method returns.

Throws:

java.io.IOException

toXContent

public static BytesReference toXContent(ToXContent toXContent, XContentType xContentType, ToXContent.Params params, boolean humanReadable) throws java.io.IOException

Returns the bytes that represent the XContent output of the provided ToXContent object, using the provided XContentType. Wraps the output into a new anonymous object according to the value returned by the ToXContent.isFragment() method returns.

Throws:

java.io.IOException

xContentType

@Deprecated public static XContentType xContentType(BytesReference 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.