Class AsyncExceptionMapper

java.lang.Object

dev.hogwai.dynamodb.simplified.internal.AsyncExceptionMapper

public final class AsyncExceptionMapper
extends Object

Centralized utility for consistent async exception mapping across all async builders.

Usage: All async builder CompletableFuture chains MUST use .exceptionally(AsyncExceptionMapper.handler("Operation", tableName)) instead of inline .handle() or .exceptionally() with instanceof checks. The centralized handler correctly unwraps CompletionException, routes DynamoDbException → OperationFailedException, ConditionalCheckFailedException → ConditionFailedException, and wraps other throwables as DynamoSimplifiedException.

Ensures every async builder wraps exceptions with the same semantics:

• ConditionalCheckFailedException → ConditionFailedException
• DynamoDbException → OperationFailedException
• All other RuntimeException → rethrown as-is
• Checked exceptions → wrapped in DynamoSimplifiedException

Method Summary

Modifier and Type	Method	Description
static <T> @NonNull Function<Throwable, T>	handler(@NonNull String operation, @Nullable String tableName)	Creates a Function suitable for passing to CompletableFuture.exceptionally(Function).
static @NonNull RuntimeException	mapException(@NonNull String operation, @Nullable String tableName, @NonNull Throwable cause)	Wraps a Throwable from a CompletableFuture.exceptionally(Function) handler into the appropriate DynamoSimplifiedException subtype.

Methods inherited from class Object

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

Method Details

mapException

public static @NonNull RuntimeException mapException(@NonNull String operation,
 @Nullable String tableName,
 @NonNull Throwable cause)

Wraps a Throwable from a CompletableFuture.exceptionally(Function) handler into the appropriate DynamoSimplifiedException subtype.

Parameters:

operation - the DynamoDB operation name (e.g., "Query", "UpdateItem")

tableName - the table name (nullable for cross-table operations)

cause - the throwable from the exceptionally handler

Returns:

never returns: always throws

handler

public static <T> @NonNull Function<Throwable, T> handler(@NonNull String operation,
 @Nullable String tableName)

Creates a Function suitable for passing to CompletableFuture.exceptionally(Function).

Type Parameters:

T - the future result type

Parameters:

operation - the DynamoDB operation name

tableName - the table name (nullable)

Returns:

a function that re-throws the wrapped exception