Module org.elasticsearch.server

Package org.elasticsearch.action.admin.indices.mapping.put

Class PutMappingRequest

java.lang.Object

org.elasticsearch.transport.TransportMessage

org.elasticsearch.transport.TransportRequest

org.elasticsearch.action.ActionRequest

org.elasticsearch.action.support.master.MasterNodeRequest<Request>

org.elasticsearch.action.support.master.AcknowledgedRequest<PutMappingRequest>

org.elasticsearch.action.admin.indices.mapping.put.PutMappingRequest

All Implemented Interfaces:

IndicesRequest, IndicesRequest.Replaceable, AckedRequest, Writeable, RefCounted, TaskAwareRequest

public class PutMappingRequest
extends AcknowledgedRequest<PutMappingRequest>
implements IndicesRequest.Replaceable

Puts mapping definition into one or more indices. Best created with Requests.putMappingRequest(String...).

If the mappings already exists, the new mappings will be merged with the new one. If there are elements that can't be merged are detected, the request will be rejected.

See Also:

• Requests.putMappingRequest(String...)
• IndicesAdminClient.putMapping(PutMappingRequest)
• AcknowledgedResponse

Nested Class Summary

Nested classes/interfaces inherited from class org.elasticsearch.transport.TransportRequest

TransportRequest.Empty

Nested classes/interfaces inherited from interface org.elasticsearch.action.IndicesRequest

IndicesRequest.Replaceable

Nested classes/interfaces inherited from interface org.elasticsearch.common.io.stream.Writeable

Writeable.Reader<V>, Writeable.Writer<V>

Field Summary

Fields inherited from class org.elasticsearch.action.support.master.AcknowledgedRequest

DEFAULT_ACK_TIMEOUT, timeout

Fields inherited from class org.elasticsearch.action.support.master.MasterNodeRequest

DEFAULT_MASTER_NODE_TIMEOUT, masterNodeTimeout

Constructor Summary

Constructors

Constructor	Description
PutMappingRequest()
PutMappingRequest(String... indices)	Constructs a new put mapping request against one or more indices.
PutMappingRequest(StreamInput in)

Method Summary

Modifier and Type	Method	Description
Index	getConcreteIndex()	Returns a concrete index for this mapping or null if no concrete index is defined
boolean	includeDataStreams()	Determines whether the request should be applied to data streams.
String[]	indices()	The indices the mappings will be put.
PutMappingRequest	indices(String... indices)	Sets the indices this put mapping operation will execute on.
IndicesOptions	indicesOptions()	Returns the indices options used to resolve indices.
PutMappingRequest	indicesOptions(IndicesOptions indicesOptions)
String	origin()
PutMappingRequest	origin(String origin)
PutMappingRequest	setConcreteIndex(Index index)	Sets a concrete index for this put mapping request.
static XContentBuilder	simpleMapping(String... source)
String	source()	The mapping source definition.
PutMappingRequest	source(String... source)	A specialized simplified mapping source method, takes the form of simple properties definition: ("field1", "type=string,store=true").
PutMappingRequest	source(String mappingSource, XContentType xContentType)	The mapping source definition.
PutMappingRequest	source(Map<String,?> mappingSource)	The mapping source definition.
PutMappingRequest	source(BytesReference mappingSource, XContentType xContentType)	The mapping source definition.
PutMappingRequest	source(XContentBuilder mappingBuilder)	The mapping source definition.
ActionRequestValidationException	validate()
boolean	writeIndexOnly()
PutMappingRequest	writeIndexOnly(boolean writeIndexOnly)
void	writeTo(StreamOutput out)	Write this into the StreamOutput.

Methods inherited from class org.elasticsearch.action.support.master.AcknowledgedRequest

ackTimeout, timeout, timeout, timeout

Methods inherited from class org.elasticsearch.action.support.master.MasterNodeRequest

masterNodeTimeout, masterNodeTimeout, masterNodeTimeout

Methods inherited from class org.elasticsearch.action.ActionRequest

getShouldStoreResult

Methods inherited from class org.elasticsearch.transport.TransportRequest

getParentTask, setParentTask, toString

Methods inherited from class org.elasticsearch.transport.TransportMessage

decRef, hasReferences, incRef, remoteAddress, remoteAddress, tryIncRef

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.elasticsearch.cluster.ack.AckedRequest

masterNodeTimeout

Methods inherited from interface org.elasticsearch.action.IndicesRequest.Replaceable

allowsRemoteIndices

Methods inherited from interface org.elasticsearch.tasks.TaskAwareRequest

createTask, getDescription, setParentTask

Constructor Details

PutMappingRequest

public PutMappingRequest(StreamInput in)
                  throws IOException

Throws:

IOException

PutMappingRequest

public PutMappingRequest()

PutMappingRequest

public PutMappingRequest(String... indices)

Constructs a new put mapping request against one or more indices. If nothing is set then it will be executed against all indices.

Method Details

validate

public ActionRequestValidationException validate()

Specified by:

validate in class ActionRequest

indices

public PutMappingRequest indices(String... indices)

Sets the indices this put mapping operation will execute on.

Specified by:

indices in interface IndicesRequest.Replaceable

setConcreteIndex

public PutMappingRequest setConcreteIndex(Index index)

Sets a concrete index for this put mapping request.

getConcreteIndex

public Index getConcreteIndex()

Returns a concrete index for this mapping or null if no concrete index is defined

indices

public String[] indices()

The indices the mappings will be put.

Specified by:

indices in interface IndicesRequest

indicesOptions

public IndicesOptions indicesOptions()

Description copied from interface: IndicesRequest

Returns the indices options used to resolve indices. They tell for instance whether a single index is accepted, whether an empty array will be converted to _all, and how wildcards will be expanded if needed.

Specified by:

indicesOptions in interface IndicesRequest

indicesOptions

public PutMappingRequest indicesOptions(IndicesOptions indicesOptions)

includeDataStreams

public boolean includeDataStreams()

Description copied from interface: IndicesRequest

Determines whether the request should be applied to data streams. When false, none of the names or wildcard expressions in IndicesRequest.indices() should be applied to or expanded to any data streams. All layers involved in the request's fulfillment including security, name resolution, etc., should respect this flag.

Specified by:

includeDataStreams in interface IndicesRequest

source

public String source()

The mapping source definition.

source

public PutMappingRequest source(String... source)

A specialized simplified mapping source method, takes the form of simple properties definition: ("field1", "type=string,store=true"). Also supports metadata mapping fields such as `_all` and `_parent` as property definition, these metadata mapping fields will automatically be put on the top level mapping object.

origin

public String origin()

origin

public PutMappingRequest origin(String origin)

simpleMapping

public static XContentBuilder simpleMapping(String... source)

Parameters:

source - consisting of field/properties pairs (e.g. "field1", "type=string,store=true")

Returns:

the mappings definition

Throws:

IllegalArgumentException - if the number of the source arguments is not divisible by two

source

public PutMappingRequest source(XContentBuilder mappingBuilder)

The mapping source definition.

source

public PutMappingRequest source(Map<String,?> mappingSource)

The mapping source definition.

source

public PutMappingRequest source(String mappingSource,
 XContentType xContentType)

The mapping source definition.

source

public PutMappingRequest source(BytesReference mappingSource,
 XContentType xContentType)

The mapping source definition.

writeIndexOnly

public PutMappingRequest writeIndexOnly(boolean writeIndexOnly)

writeIndexOnly

public boolean writeIndexOnly()

writeTo

public void writeTo(StreamOutput out)
             throws IOException

Description copied from interface: Writeable

Write this into the StreamOutput.

Specified by:

writeTo in interface Writeable

Overrides:

writeTo in class AcknowledgedRequest<PutMappingRequest>

Throws:

IOException