Class AsyncUpdateBuilder<T>

java.lang.Object

dev.hogwai.dynamodb.simplified.builder.base.AbstractUpdateBuilder<T, AsyncUpdateBuilder<T>>

dev.hogwai.dynamodb.simplified.async.AsyncUpdateBuilder<T>

Type Parameters:

T - the type of the item

public class AsyncUpdateBuilder<T>
extends AbstractUpdateBuilder<T, AsyncUpdateBuilder<T>>

Async fluent builder for updating an item in a DynamoDB table. Supports both full-item replacement and partial updates via an UpdateExpression. Part of the DynamoDB Simplified library.

Field Summary

Fields inherited from class AbstractUpdateBuilder

conditionExpression, ignoreNulls, item, keyMap, LOG, optimisticLocking, returnValues, updateExpression

Method Summary

Modifier and Type	Method	Description
@NonNull CompletableFuture<Optional<T>>	execute()	Executes the update operation.
protected @NonNull software.amazon.awssdk.enhanced.dynamodb.Key	getKeyFromItem()	Returns a Key built from the current item.
protected @NonNull software.amazon.awssdk.enhanced.dynamodb.TableSchema<T>	getTableSchema()	Returns the table schema for the item type.
protected @NonNull AsyncUpdateBuilder<T>	self()	Returns this typed as S for fluent chaining.
protected @NonNull String	tableName()	Returns the DynamoDB table name.

Methods inherited from class AbstractUpdateBuilder

applyOptimisticLocking, buildKeyMap, buildKeyMapFromValues, condition, condition, ignoreNulls, incrementVersion, returnValues, update, withOptimisticLocking

Methods inherited from class Object

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

Method Details

self

protected @NonNull AsyncUpdateBuilder<T> self()

Description copied from class: AbstractUpdateBuilder

Returns this typed as S for fluent chaining.

Specified by:

self in class AbstractUpdateBuilder<T, AsyncUpdateBuilder<T>>

Returns:

this builder

tableName

protected @NonNull String tableName()

Description copied from class: AbstractUpdateBuilder

Returns the DynamoDB table name.

Specified by:

tableName in class AbstractUpdateBuilder<T, AsyncUpdateBuilder<T>>

Returns:

the DynamoDB table name

getKeyFromItem

protected @NonNull software.amazon.awssdk.enhanced.dynamodb.Key getKeyFromItem()

Description copied from class: AbstractUpdateBuilder

Returns a Key built from the current item. Used internally to build key maps for partial update requests.

Specified by:

getKeyFromItem in class AbstractUpdateBuilder<T, AsyncUpdateBuilder<T>>

Returns:

the key derived from the item

getTableSchema

protected @NonNull software.amazon.awssdk.enhanced.dynamodb.TableSchema<T> getTableSchema()

Description copied from class: AbstractUpdateBuilder

Returns the table schema for the item type. Used internally for key and attribute conversion.

Specified by:

getTableSchema in class AbstractUpdateBuilder<T, AsyncUpdateBuilder<T>>

Returns:

the table schema

execute

public @NonNull CompletableFuture<Optional<T>> execute()

Executes the update operation. If a partial update expression was configured via AbstractUpdateBuilder.update(java.util.function.Consumer), a targeted partial update is performed via the low-level async DynamoDB client. Otherwise, the full item is replaced.

Returns:

a CompletableFuture containing the updated item, or empty if not found