org.elasticsearch.ingest.core

Class IngestDocument

java.lang.Object

org.elasticsearch.ingest.core.IngestDocument

public final class IngestDocument
extends java.lang.Object

Represents a single document being captured before indexing and holds the source and metadata (like id, type and index).

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	IngestDocument.MetaData

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	INGEST_KEY

Constructor Summary

Constructors

Constructor and Description
IngestDocument(IngestDocument other) Copy constructor that creates a new IngestDocument which has exactly the same properties as the one provided as argument
IngestDocument(java.util.Map<java.lang.String,java.lang.Object> sourceAndMetadata, java.util.Map<java.lang.String,java.lang.String> ingestMetadata) Constructor needed for testing that allows to create a new IngestDocument given the provided elasticsearch metadata, source and ingest metadata.
IngestDocument(java.lang.String index, java.lang.String type, java.lang.String id, java.lang.String routing, java.lang.String parent, java.lang.String timestamp, java.lang.String ttl, java.util.Map<java.lang.String,java.lang.Object> source)

Method Summary

Modifier and Type	Method and Description
void	appendFieldValue(java.lang.String path, java.lang.Object value) Appends the provided value to the provided path in the document.
void	appendFieldValue(TemplateService.Template fieldPathTemplate, ValueSource valueSource) Appends the provided value to the provided path in the document.
boolean	equals(java.lang.Object obj)
java.util.Map<IngestDocument.MetaData,java.lang.String>	extractMetadata() one time operation that extracts the metadata fields from the ingest document and returns them.
<T> T	getFieldValue(java.lang.String path, java.lang.Class<T> clazz) Returns the value contained in the document for the provided path
java.util.Map<java.lang.String,java.lang.String>	getIngestMetadata() Returns the available ingest metadata fields, by default only timestamp, but it is possible to set additional ones.
java.util.Map<java.lang.String,java.lang.Object>	getSourceAndMetadata() Returns the document including its metadata fields, unless extractMetadata() has been called, in which case the metadata fields will not be present anymore.
boolean	hasField(java.lang.String path) Checks whether the document contains a value for the provided path
int	hashCode()
void	removeField(java.lang.String path) Removes the field identified by the provided path.
void	removeField(TemplateService.Template fieldPathTemplate) Removes the field identified by the provided path.
java.lang.String	renderTemplate(TemplateService.Template template)
void	setFieldValue(java.lang.String path, java.lang.Object value) Sets the provided value to the provided path in the document.
void	setFieldValue(TemplateService.Template fieldPathTemplate, ValueSource valueSource) Sets the provided value to the provided path in the document.
java.lang.String	toString()

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

INGEST_KEY

public static final java.lang.String INGEST_KEY

See Also:

Constant Field Values

Constructor Detail

IngestDocument

public IngestDocument(java.lang.String index,
                      java.lang.String type,
                      java.lang.String id,
                      java.lang.String routing,
                      java.lang.String parent,
                      java.lang.String timestamp,
                      java.lang.String ttl,
                      java.util.Map<java.lang.String,java.lang.Object> source)

IngestDocument

public IngestDocument(IngestDocument other)

Copy constructor that creates a new IngestDocument which has exactly the same properties as the one provided as argument

IngestDocument

public IngestDocument(java.util.Map<java.lang.String,java.lang.Object> sourceAndMetadata,
                      java.util.Map<java.lang.String,java.lang.String> ingestMetadata)

Constructor needed for testing that allows to create a new IngestDocument given the provided elasticsearch metadata, source and ingest metadata. This is needed because the ingest metadata will be initialized with the current timestamp at init time, which makes equality comparisons impossible in tests.

Method Detail

getFieldValue

public <T> T getFieldValue(java.lang.String path,
                           java.lang.Class<T> clazz)

Returns the value contained in the document for the provided path

Parameters:

path - The path within the document in dot-notation

clazz - The expected class of the field value

Returns:

the value for the provided path if existing, null otherwise

Throws:

java.lang.IllegalArgumentException - if the path is null, empty, invalid, if the field doesn't exist or if the field that is found at the provided path is not of the expected type.

hasField

public boolean hasField(java.lang.String path)

Checks whether the document contains a value for the provided path

Parameters:

path - The path within the document in dot-notation

Returns:

true if the document contains a value for the field, false otherwise

Throws:

java.lang.IllegalArgumentException - if the path is null, empty or invalid.

removeField

public void removeField(TemplateService.Template fieldPathTemplate)

Removes the field identified by the provided path.

Parameters:

fieldPathTemplate - Resolves to the path with dot-notation within the document

Throws:

java.lang.IllegalArgumentException - if the path is null, empty, invalid or if the field doesn't exist.

removeField

public void removeField(java.lang.String path)

Removes the field identified by the provided path.

Parameters:

path - the path of the field to be removed

Throws:

java.lang.IllegalArgumentException - if the path is null, empty, invalid or if the field doesn't exist.

appendFieldValue

public void appendFieldValue(java.lang.String path,
                             java.lang.Object value)

Appends the provided value to the provided path in the document. Any non existing path element will be created. If the path identifies a list, the value will be appended to the existing list. If the path identifies a scalar, the scalar will be converted to a list and the provided value will be added to the newly created list. Supports multiple values too provided in forms of list, in that case all the values will be appended to the existing (or newly created) list.

Parameters:

path - The path within the document in dot-notation

value - The value or values to append to the existing ones

Throws:

java.lang.IllegalArgumentException - if the path is null, empty or invalid.

appendFieldValue

public void appendFieldValue(TemplateService.Template fieldPathTemplate,
                             ValueSource valueSource)

Appends the provided value to the provided path in the document. Any non existing path element will be created. If the path identifies a list, the value will be appended to the existing list. If the path identifies a scalar, the scalar will be converted to a list and the provided value will be added to the newly created list. Supports multiple values too provided in forms of list, in that case all the values will be appended to the existing (or newly created) list.

Parameters:

fieldPathTemplate - Resolves to the path with dot-notation within the document

valueSource - The value source that will produce the value or values to append to the existing ones

Throws:

java.lang.IllegalArgumentException - if the path is null, empty or invalid.

setFieldValue

public void setFieldValue(java.lang.String path,
                          java.lang.Object value)

Sets the provided value to the provided path in the document. Any non existing path element will be created. If the last item in the path is a list, the value will replace the existing list as a whole. Use appendFieldValue(String, Object) to append values to lists instead.

Parameters:

path - The path within the document in dot-notation

value - The value to put in for the path key

Throws:

java.lang.IllegalArgumentException - if the path is null, empty, invalid or if the value cannot be set to the item identified by the provided path.

setFieldValue

public void setFieldValue(TemplateService.Template fieldPathTemplate,
                          ValueSource valueSource)

Sets the provided value to the provided path in the document. Any non existing path element will be created. If the last element is a list, the value will replace the existing list.

Parameters:

fieldPathTemplate - Resolves to the path with dot-notation within the document

valueSource - The value source that will produce the value to put in for the path key

Throws:

java.lang.IllegalArgumentException - if the path is null, empty, invalid or if the value cannot be set to the item identified by the provided path.

renderTemplate

public java.lang.String renderTemplate(TemplateService.Template template)

extractMetadata

public java.util.Map<IngestDocument.MetaData,java.lang.String> extractMetadata()

one time operation that extracts the metadata fields from the ingest document and returns them. Metadata fields that used to be accessible as ordinary top level fields will be removed as part of this call.

getIngestMetadata

public java.util.Map<java.lang.String,java.lang.String> getIngestMetadata()

Returns the available ingest metadata fields, by default only timestamp, but it is possible to set additional ones. Use only for reading values, modify them instead using setFieldValue(String, Object) and removeField(String)

getSourceAndMetadata

public java.util.Map<java.lang.String,java.lang.Object> getSourceAndMetadata()

Returns the document including its metadata fields, unless extractMetadata() has been called, in which case the metadata fields will not be present anymore. Modify the document instead using setFieldValue(String, Object) and removeField(String)

equals

public boolean equals(java.lang.Object obj)

Overrides:

equals in class java.lang.Object

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object