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 and Description
XContentHelper()

Method Summary

Modifier and Type	Method and Description
static java.lang.String	convertToJson(BytesReference bytes, boolean reformatJson)
static java.lang.String	convertToJson(BytesReference bytes, boolean reformatJson, boolean prettyPrint)
static Tuple<XContentType,java.util.Map<java.lang.String,java.lang.Object>>	convertToMap(BytesReference bytes, boolean 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 void	copyCurrentEvent(XContentGenerator generator, XContentParser parser)
static void	copyCurrentStructure(XContentGenerator destination, XContentParser parser) Low level implementation detail of XContentGenerator.copyCurrentStructure(XContentParser).
static XContentParser	createParser(NamedXContentRegistry xContentRegistry, BytesReference bytes)
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	toString(ToXContent toXContent) Writes serialized toXContent to pretty-printed JSON string.
static java.lang.String	toString(ToXContent toXContent, ToXContent.Params params) Writes serialized toXContent to pretty-printed JSON string.
static BytesReference	toXContent(ToXContent toXContent, XContentType xContentType, boolean wrapInObject) 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) Writes a "raw" (bytes) field, handling cases where the bytes are compressed, and tries to optimize writing using XContentBuilder.rawField(String, org.elasticsearch.common.bytes.BytesReference).

Methods inherited from class java.lang.Object

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

Constructor Detail

XContentHelper

public XContentHelper()

Method Detail

createParser

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

Throws:

java.io.IOException

convertToMap

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

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

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

Throws:

java.io.IOException

convertToJson

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

Throws:

java.io.IOException

toString

public static java.lang.String toString(ToXContent toXContent)

Writes serialized toXContent to pretty-printed JSON string.

Parameters:

toXContent - object to be pretty printed

Returns:

pretty-printed JSON serialization

toString

public static java.lang.String toString(ToXContent toXContent,
                                        ToXContent.Params params)

Writes serialized toXContent to pretty-printed JSON string.

Parameters:

toXContent - object to be pretty printed

params - serialization parameters

Returns:

pretty-printed JSON serialization

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 recuersively 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.

copyCurrentStructure

public static void copyCurrentStructure(XContentGenerator destination,
                                        XContentParser parser)
                                 throws java.io.IOException

Low level implementation detail of XContentGenerator.copyCurrentStructure(XContentParser).

Throws:

java.io.IOException

copyCurrentEvent

public static void copyCurrentEvent(XContentGenerator generator,
                                    XContentParser parser)
                             throws java.io.IOException

Throws:

java.io.IOException

writeRawField

public static void writeRawField(java.lang.String field,
                                 BytesReference source,
                                 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, org.elasticsearch.common.bytes.BytesReference).

Throws:

java.io.IOException

toXContent

public static BytesReference toXContent(ToXContent toXContent,
                                        XContentType xContentType,
                                        boolean wrapInObject)
                                 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 depending on the value of the wrapInObject argument.

Throws:

java.io.IOException