Package org.elasticsearch.action.update

Class UpdateRequestBuilder

java.lang.Object

org.elasticsearch.action.ActionRequestBuilder<Request,Response,RequestBuilder>

org.elasticsearch.action.support.single.instance.InstanceShardOperationRequestBuilder<UpdateRequest,UpdateResponse,UpdateRequestBuilder>

org.elasticsearch.action.update.UpdateRequestBuilder

All Implemented Interfaces:

WriteRequestBuilder<UpdateRequestBuilder>

public class UpdateRequestBuilder
extends InstanceShardOperationRequestBuilder<UpdateRequest,UpdateResponse,UpdateRequestBuilder>
implements WriteRequestBuilder<UpdateRequestBuilder>

Field Summary

Fields inherited from class org.elasticsearch.action.ActionRequestBuilder

action, client, request

Constructor Summary

Constructors

Constructor	Description
UpdateRequestBuilder(ElasticsearchClient client, UpdateAction action)
UpdateRequestBuilder(ElasticsearchClient client, UpdateAction action, java.lang.String index, java.lang.String type, java.lang.String id)

Method Summary

Modifier and Type	Method	Description
UpdateRequestBuilder	setDetectNoop(boolean detectNoop)	Sets whether to perform extra effort to detect noop updates via docAsUpsert.
UpdateRequestBuilder	setDoc(byte[] source, int offset, int length, XContentType xContentType)	Sets the doc to use for updates when a script is not specified.
UpdateRequestBuilder	setDoc(byte[] source, XContentType xContentType)	Sets the doc to use for updates when a script is not specified.
UpdateRequestBuilder	setDoc(java.lang.Object... source)	Sets the doc to use for updates when a script is not specified, the doc provided is a field and value pairs.
UpdateRequestBuilder	setDoc(java.lang.String source, XContentType xContentType)	Sets the doc to use for updates when a script is not specified.
UpdateRequestBuilder	setDoc(java.util.Map source)	Sets the doc to use for updates when a script is not specified.
UpdateRequestBuilder	setDoc(java.util.Map source, XContentType contentType)	Sets the doc to use for updates when a script is not specified.
UpdateRequestBuilder	setDoc(IndexRequest indexRequest)	Sets the doc to use for updates when a script is not specified.
UpdateRequestBuilder	setDoc(XContentBuilder source)	Sets the doc to use for updates when a script is not specified.
UpdateRequestBuilder	setDoc(XContentType xContentType, java.lang.Object... source)	Sets the doc to use for updates when a script is not specified, the doc provided is a field and value pairs.
UpdateRequestBuilder	setDocAsUpsert(boolean shouldUpsertDoc)	Sets whether the specified doc parameter should be used as upsert document.
UpdateRequestBuilder	setFetchSource(boolean fetchSource)	Indicates whether the response should contain the updated _source.
UpdateRequestBuilder	setFetchSource(java.lang.String[] includes, java.lang.String[] excludes)	Indicate that _source should be returned, with an "include" and/or "exclude" set which can include simple wildcard elements.
UpdateRequestBuilder	setFetchSource(java.lang.String include, java.lang.String exclude)	Indicate that _source should be returned with every hit, with an "include" and/or "exclude" set which can include simple wildcard elements.
UpdateRequestBuilder	setFields(java.lang.String... fields)	Deprecated. Use setFetchSource(String[], String[]) instead
UpdateRequestBuilder	setId(java.lang.String id)	Sets the id of the indexed document.
UpdateRequestBuilder	setIfPrimaryTerm(long term)	only perform this update request if the document was last modification was assigned the given primary term.
UpdateRequestBuilder	setIfSeqNo(long seqNo)	only perform this update request if the document was last modification was assigned the given sequence number.
UpdateRequestBuilder	setParent(java.lang.String parent)
UpdateRequestBuilder	setRetryOnConflict(int retryOnConflict)	Sets the number of retries of a version conflict occurs because the document was updated between getting it and updating it.
UpdateRequestBuilder	setRouting(java.lang.String routing)	Controls the shard routing of the request.
UpdateRequestBuilder	setScript(Script script)	The script to execute.
UpdateRequestBuilder	setScriptedUpsert(boolean scriptedUpsert)	Sets whether the script should be run in the case of an insert
UpdateRequestBuilder	setType(java.lang.String type)	Sets the type of the indexed document.
UpdateRequestBuilder	setUpsert(byte[] source, int offset, int length, XContentType xContentType)	Sets the doc source of the update request to be used when the document does not exists.
UpdateRequestBuilder	setUpsert(byte[] source, XContentType xContentType)	Sets the doc source of the update request to be used when the document does not exists.
UpdateRequestBuilder	setUpsert(java.lang.Object... source)	Sets the doc source of the update request to be used when the document does not exists.
UpdateRequestBuilder	setUpsert(java.lang.String source, XContentType xContentType)	Sets the doc source of the update request to be used when the document does not exists.
UpdateRequestBuilder	setUpsert(java.util.Map source)	Sets the doc source of the update request to be used when the document does not exists.
UpdateRequestBuilder	setUpsert(java.util.Map source, XContentType contentType)	Sets the doc source of the update request to be used when the document does not exists.
UpdateRequestBuilder	setUpsert(IndexRequest indexRequest)	Sets the index request to be used if the document does not exists.
UpdateRequestBuilder	setUpsert(XContentBuilder source)	Sets the doc source of the update request to be used when the document does not exists.
UpdateRequestBuilder	setUpsert(XContentType xContentType, java.lang.Object... source)	Sets the doc source of the update request to be used when the document does not exists.
UpdateRequestBuilder	setVersion(long version)	Sets the version, which will cause the index operation to only be performed if a matching version exists and no changes happened on the doc since then.
UpdateRequestBuilder	setVersionType(VersionType versionType)	Sets the versioning type.
UpdateRequestBuilder	setWaitForActiveShards(int waitForActiveShards)	A shortcut for setWaitForActiveShards(ActiveShardCount) where the numerical shard count is passed in, instead of having to first call ActiveShardCount.from(int) to get the ActiveShardCount.
UpdateRequestBuilder	setWaitForActiveShards(ActiveShardCount waitForActiveShards)	Sets the number of shard copies that must be active before proceeding with the write.

Methods inherited from class org.elasticsearch.action.support.single.instance.InstanceShardOperationRequestBuilder

setIndex, setTimeout, setTimeout

Methods inherited from class org.elasticsearch.action.ActionRequestBuilder

execute, execute, get, get, get, request

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.elasticsearch.action.support.WriteRequestBuilder

request, setRefreshPolicy, setRefreshPolicy

Constructor Detail

UpdateRequestBuilder

public UpdateRequestBuilder(ElasticsearchClient client,
                            UpdateAction action)

UpdateRequestBuilder

public UpdateRequestBuilder(ElasticsearchClient client,
                            UpdateAction action,
                            java.lang.String index,
                            java.lang.String type,
                            java.lang.String id)

Method Detail

setType

public UpdateRequestBuilder setType(java.lang.String type)

Sets the type of the indexed document.

setId

public UpdateRequestBuilder setId(java.lang.String id)

Sets the id of the indexed document.

setRouting

public UpdateRequestBuilder setRouting(java.lang.String routing)

Controls the shard routing of the request. Using this value to hash the shard and not the id.

setParent

public UpdateRequestBuilder setParent(java.lang.String parent)

setScript

public UpdateRequestBuilder setScript(Script script)

The script to execute. Note, make sure not to send different script each times and instead use script params if possible with the same (automatically compiled) script.

The script works with the variable ctx, which is bound to the entry, e.g. ctx._source.mycounter += 1.

setFields

@Deprecated
public UpdateRequestBuilder setFields(java.lang.String... fields)

Deprecated.

Use setFetchSource(String[], String[]) instead

Explicitly specify the fields that will be returned. By default, nothing is returned.

setFetchSource

public UpdateRequestBuilder setFetchSource(@Nullable
                                           java.lang.String include,
                                           @Nullable
                                           java.lang.String exclude)

Indicate that _source should be returned with every hit, with an "include" and/or "exclude" set which can include simple wildcard elements.

Parameters:

include - An optional include (optionally wildcarded) pattern to filter the returned _source

exclude - An optional exclude (optionally wildcarded) pattern to filter the returned _source

setFetchSource

public UpdateRequestBuilder setFetchSource(@Nullable
                                           java.lang.String[] includes,
                                           @Nullable
                                           java.lang.String[] excludes)

Indicate that _source should be returned, with an "include" and/or "exclude" set which can include simple wildcard elements.

Parameters:

includes - An optional list of include (optionally wildcarded) pattern to filter the returned _source

excludes - An optional list of exclude (optionally wildcarded) pattern to filter the returned _source

setFetchSource

public UpdateRequestBuilder setFetchSource(boolean fetchSource)

Indicates whether the response should contain the updated _source.

setRetryOnConflict

public UpdateRequestBuilder setRetryOnConflict(int retryOnConflict)

Sets the number of retries of a version conflict occurs because the document was updated between getting it and updating it. Defaults to 0.

setVersion

public UpdateRequestBuilder setVersion(long version)

Sets the version, which will cause the index operation to only be performed if a matching version exists and no changes happened on the doc since then.

setVersionType

public UpdateRequestBuilder setVersionType(VersionType versionType)

Sets the versioning type. Defaults to VersionType.INTERNAL.

setIfSeqNo

public UpdateRequestBuilder setIfSeqNo(long seqNo)

only perform this update request if the document was last modification was assigned the given sequence number. Must be used in combination with setIfPrimaryTerm(long) If the document last modification was assigned a different sequence number a VersionConflictEngineException will be thrown.

setIfPrimaryTerm

public UpdateRequestBuilder setIfPrimaryTerm(long term)

only perform this update request if the document was last modification was assigned the given primary term. Must be used in combination with setIfSeqNo(long) If the document last modification was assigned a different term a VersionConflictEngineException will be thrown.

setWaitForActiveShards

public UpdateRequestBuilder setWaitForActiveShards(ActiveShardCount waitForActiveShards)

Sets the number of shard copies that must be active before proceeding with the write. See ReplicationRequest.waitForActiveShards(ActiveShardCount) for details.

setWaitForActiveShards

public UpdateRequestBuilder setWaitForActiveShards(int waitForActiveShards)

A shortcut for setWaitForActiveShards(ActiveShardCount) where the numerical shard count is passed in, instead of having to first call ActiveShardCount.from(int) to get the ActiveShardCount.

setDoc

public UpdateRequestBuilder setDoc(IndexRequest indexRequest)

Sets the doc to use for updates when a script is not specified.

setDoc

public UpdateRequestBuilder setDoc(XContentBuilder source)

Sets the doc to use for updates when a script is not specified.

setDoc

public UpdateRequestBuilder setDoc(java.util.Map source)

Sets the doc to use for updates when a script is not specified.

setDoc

public UpdateRequestBuilder setDoc(java.util.Map source,
                                   XContentType contentType)

Sets the doc to use for updates when a script is not specified.

setDoc

public UpdateRequestBuilder setDoc(java.lang.String source,
                                   XContentType xContentType)

Sets the doc to use for updates when a script is not specified.

setDoc

public UpdateRequestBuilder setDoc(byte[] source,
                                   XContentType xContentType)

Sets the doc to use for updates when a script is not specified.

setDoc

public UpdateRequestBuilder setDoc(byte[] source,
                                   int offset,
                                   int length,
                                   XContentType xContentType)

Sets the doc to use for updates when a script is not specified.

setDoc

public UpdateRequestBuilder setDoc(java.lang.Object... source)

Sets the doc to use for updates when a script is not specified, the doc provided is a field and value pairs.

setDoc

public UpdateRequestBuilder setDoc(XContentType xContentType,
                                   java.lang.Object... source)

Sets the doc to use for updates when a script is not specified, the doc provided is a field and value pairs.

setUpsert

public UpdateRequestBuilder setUpsert(IndexRequest indexRequest)

Sets the index request to be used if the document does not exists. Otherwise, a DocumentMissingException is thrown.

setUpsert

public UpdateRequestBuilder setUpsert(XContentBuilder source)

Sets the doc source of the update request to be used when the document does not exists.

setUpsert

public UpdateRequestBuilder setUpsert(java.util.Map source)

Sets the doc source of the update request to be used when the document does not exists.

setUpsert

public UpdateRequestBuilder setUpsert(java.util.Map source,
                                      XContentType contentType)

Sets the doc source of the update request to be used when the document does not exists.

setUpsert

public UpdateRequestBuilder setUpsert(java.lang.String source,
                                      XContentType xContentType)

Sets the doc source of the update request to be used when the document does not exists.

setUpsert

public UpdateRequestBuilder setUpsert(byte[] source,
                                      XContentType xContentType)

Sets the doc source of the update request to be used when the document does not exists.

setUpsert

public UpdateRequestBuilder setUpsert(byte[] source,
                                      int offset,
                                      int length,
                                      XContentType xContentType)

Sets the doc source of the update request to be used when the document does not exists.

setUpsert

public UpdateRequestBuilder setUpsert(java.lang.Object... source)

Sets the doc source of the update request to be used when the document does not exists. The doc includes field and value pairs.

setUpsert

public UpdateRequestBuilder setUpsert(XContentType xContentType,
                                      java.lang.Object... source)

Sets the doc source of the update request to be used when the document does not exists. The doc includes field and value pairs.

setDocAsUpsert

public UpdateRequestBuilder setDocAsUpsert(boolean shouldUpsertDoc)

Sets whether the specified doc parameter should be used as upsert document.

setDetectNoop

public UpdateRequestBuilder setDetectNoop(boolean detectNoop)

Sets whether to perform extra effort to detect noop updates via docAsUpsert. Defaults to true.

setScriptedUpsert

public UpdateRequestBuilder setScriptedUpsert(boolean scriptedUpsert)

Sets whether the script should be run in the case of an insert