Class UpdateRequest<TDocument,TPartialDocument>
java.lang.Object
co.elastic.clients.elasticsearch._types.RequestBase
co.elastic.clients.elasticsearch.core.UpdateRequest<TDocument,TPartialDocument>
- All Implemented Interfaces:
JsonpSerializable
@JsonpDeserializable public class UpdateRequest<TDocument,TPartialDocument> extends RequestBase implements JsonpSerializable
Updates a document with a script or partial document.
- See Also:
- API specification
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static classUpdateRequest.Builder<TDocument,TPartialDocument>Builder forUpdateRequest.Nested classes/interfaces inherited from class co.elastic.clients.elasticsearch._types.RequestBase
RequestBase.AbstractBuilder<BuilderT extends RequestBase.AbstractBuilder<BuilderT>> -
Field Summary
Fields Modifier and Type Field Description static JsonpDeserializer<UpdateRequest<java.lang.Object,java.lang.Object>>_DESERIALIZERJson deserializer forUpdateRequestbased on named deserializers provided by the callingJsonMapper.static SimpleEndpoint<UpdateRequest<?,?>,?>_ENDPOINTEndpoint "update". -
Method Summary
Modifier and Type Method Description static <TDocument>
Endpoint<UpdateRequest<?,?>,UpdateResponse<TDocument>,ErrorResponse>createUpdateEndpoint(JsonpDeserializer<TDocument> tDocumentDeserializer)Create an "update" endpoint.static <TDocument, TPartialDocument>
JsonpDeserializer<UpdateRequest<TDocument,TPartialDocument>>createUpdateRequestDeserializer(JsonpDeserializer<TDocument> tDocumentDeserializer, JsonpDeserializer<TPartialDocument> tPartialDocumentDeserializer)Create a JSON deserializer for UpdateRequestjava.lang.BooleandetectNoop()Set to false to disable setting 'result' in the response to 'noop' if no change to the document occurred.TPartialDocumentdoc()A partial update to an existing document.java.lang.BooleandocAsUpsert()Set to true to use the contents of 'doc' as the value of 'upsert'java.lang.Stringid()Required - Document IDjava.lang.LongifPrimaryTerm()Only perform the operation if the document has this primary term.java.lang.LongifSeqNo()Only perform the operation if the document has this sequence number.java.lang.Stringindex()Required - The name of the indexjava.lang.Stringlang()The script language.static <TDocument, TPartialDocument>
UpdateRequest<TDocument,TPartialDocument>of(java.util.function.Function<UpdateRequest.Builder<TDocument,TPartialDocument>,ObjectBuilder<UpdateRequest<TDocument,TPartialDocument>>> fn)Refreshrefresh()If 'true', Elasticsearch refreshes the affected shards to make this operation visible to search, if 'wait_for' then wait for a refresh to make this operation visible to search, if 'false' do nothing with refreshes.java.lang.BooleanrequireAlias()If true, the destination must be an index alias.java.lang.IntegerretryOnConflict()Specify how many times should the operation be retried when a conflict occurs.java.lang.Stringrouting()Custom value used to route operations to a specific shard.Scriptscript()Script to execute to update the document.java.lang.BooleanscriptedUpsert()Set to true to execute the script whether or not the document exists.voidserialize(jakarta.json.stream.JsonGenerator generator, JsonpMapper mapper)Serialize this object to JSON.protected voidserializeInternal(jakarta.json.stream.JsonGenerator generator, JsonpMapper mapper)protected static <TDocument, TPartialDocument>
voidsetupUpdateRequestDeserializer(ObjectDeserializer<UpdateRequest.Builder<TDocument,TPartialDocument>> op, JsonpDeserializer<TDocument> tDocumentDeserializer, JsonpDeserializer<TPartialDocument> tPartialDocumentDeserializer)SourceConfigsource()Set to false to disable source retrieval.Timetimeout()Period to wait for dynamic mapping updates and active shards.java.lang.Stringtype()The type of the documentTDocumentupsert()If the document does not already exist, the contents of 'upsert' are inserted as a new document.WaitForActiveShardswaitForActiveShards()The number of shard copies that must be active before proceeding with the operations.Methods inherited from class co.elastic.clients.elasticsearch._types.RequestBase
toStringMethods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
-
Field Details
-
_DESERIALIZER
public static final JsonpDeserializer<UpdateRequest<java.lang.Object,java.lang.Object>> _DESERIALIZERJson deserializer forUpdateRequestbased on named deserializers provided by the callingJsonMapper. -
_ENDPOINT
Endpoint "update".
-
-
Method Details
-
of
public static <TDocument, TPartialDocument> UpdateRequest<TDocument,TPartialDocument> of(java.util.function.Function<UpdateRequest.Builder<TDocument,TPartialDocument>,ObjectBuilder<UpdateRequest<TDocument,TPartialDocument>>> fn) -
source
Set to false to disable source retrieval. You can also specify a comma-separated list of the fields you want to retrieve.API name:
_source -
detectNoop
@Nullable public final java.lang.Boolean detectNoop()Set to false to disable setting 'result' in the response to 'noop' if no change to the document occurred.API name:
detect_noop -
doc
A partial update to an existing document.API name:
doc -
docAsUpsert
@Nullable public final java.lang.Boolean docAsUpsert()Set to true to use the contents of 'doc' as the value of 'upsert'API name:
doc_as_upsert -
id
public final java.lang.String id()Required - Document IDAPI name:
id -
ifPrimaryTerm
@Nullable public final java.lang.Long ifPrimaryTerm()Only perform the operation if the document has this primary term.API name:
if_primary_term -
ifSeqNo
@Nullable public final java.lang.Long ifSeqNo()Only perform the operation if the document has this sequence number.API name:
if_seq_no -
index
public final java.lang.String index()Required - The name of the indexAPI name:
index -
lang
@Nullable public final java.lang.String lang()The script language.API name:
lang -
refresh
If 'true', Elasticsearch refreshes the affected shards to make this operation visible to search, if 'wait_for' then wait for a refresh to make this operation visible to search, if 'false' do nothing with refreshes.API name:
refresh -
requireAlias
@Nullable public final java.lang.Boolean requireAlias()If true, the destination must be an index alias.API name:
require_alias -
retryOnConflict
@Nullable public final java.lang.Integer retryOnConflict()Specify how many times should the operation be retried when a conflict occurs.API name:
retry_on_conflict -
routing
@Nullable public final java.lang.String routing()Custom value used to route operations to a specific shard.API name:
routing -
script
Script to execute to update the document.API name:
script -
scriptedUpsert
@Nullable public final java.lang.Boolean scriptedUpsert()Set to true to execute the script whether or not the document exists.API name:
scripted_upsert -
timeout
Period to wait for dynamic mapping updates and active shards. This guarantees Elasticsearch waits for at least the timeout before failing. The actual wait time could be longer, particularly when multiple waits occur.API name:
timeout -
type
@Nullable public final java.lang.String type()The type of the documentAPI name:
type -
upsert
If the document does not already exist, the contents of 'upsert' are inserted as a new document. If the document exists, the 'script' is executed.API name:
upsert -
waitForActiveShards
The number of shard copies that must be active before proceeding with the operations. Set to 'all' or any positive integer up to the total number of shards in the index (number_of_replicas+1). Defaults to 1 meaning the primary shard.API name:
wait_for_active_shards -
serialize
Serialize this object to JSON.- Specified by:
serializein interfaceJsonpSerializable
-
serializeInternal
-
createUpdateRequestDeserializer
public static <TDocument, TPartialDocument> JsonpDeserializer<UpdateRequest<TDocument,TPartialDocument>> createUpdateRequestDeserializer(JsonpDeserializer<TDocument> tDocumentDeserializer, JsonpDeserializer<TPartialDocument> tPartialDocumentDeserializer)Create a JSON deserializer for UpdateRequest -
setupUpdateRequestDeserializer
protected static <TDocument, TPartialDocument> void setupUpdateRequestDeserializer(ObjectDeserializer<UpdateRequest.Builder<TDocument,TPartialDocument>> op, JsonpDeserializer<TDocument> tDocumentDeserializer, JsonpDeserializer<TPartialDocument> tPartialDocumentDeserializer) -
createUpdateEndpoint
public static <TDocument> Endpoint<UpdateRequest<?,?>,UpdateResponse<TDocument>,ErrorResponse> createUpdateEndpoint(JsonpDeserializer<TDocument> tDocumentDeserializer)Create an "update" endpoint.
-