Créez un client amélioré et DynamoDbTable

Créez un client amélioré

La DynamoDbEnhancedClientclasse, ou son équivalent asynchrone DynamoDbEnhancedAsyncClient, est le point d'entrée pour utiliser l'API DynamoDB Enhanced Client.

Le client amélioré a besoin d'une norme DynamoDbClient pour effectuer le travail. L'API propose deux méthodes pour créer une DynamoDbEnhancedClient instance. La première option, illustrée dans l'extrait suivant, crée une norme dont les paramètres DynamoDbClient par défaut sont extraits des paramètres de configuration.

DynamoDbEnhancedClient enhancedClient = DynamoDbEnhancedClient.create();

Si vous souhaitez configurer le client standard sous-jacent, vous pouvez le fournir à la méthode de création du client amélioré, comme indiqué dans l'extrait suivant.

// Configure an instance of the standard DynamoDbClient.
DynamoDbClient standardClient = DynamoDbClient.builder()
    .region(Region.US_EAST_1)
    .credentialsProvider(ProfileCredentialsProvider.create())
    .build();

// Use the configured standard client with the enhanced client.
DynamoDbEnhancedClient enhancedClient = DynamoDbEnhancedClient.builder()
    .dynamoDbClient(standardClient)
    .build();

Créer une instance DynamoDbTable

Considérez a DynamoDbTablecomme la représentation côté client d'une table DynamoDB qui utilise la fonctionnalité de mappage fournie par a. TableSchema La DynamoDbTable classe fournit des méthodes pour les opérations CRUD qui vous permettent d'interagir avec une seule table DynamoDB.

DynamoDbTable<T>est une classe générique qui prend un seul argument de type, qu'il s'agisse d'une classe personnalisée ou d'un EnhancedDocument lorsque vous travaillez avec des éléments de type document. Ce type d'argument établit la relation entre la classe que vous utilisez et l'unique table DynamoDB.

Utilisez la méthode table() factory du DynamoDbEnhancedClient pour créer une DynamoDbTable instance, comme indiqué dans l'extrait de code suivant.

static final DynamoDbTable<Customer> customerTable = 
        enhancedClient.table("Customer", TableSchema.fromBean(Customer.class));

DynamoDbTableles instances sont candidates aux singletons car elles sont immuables et peuvent être utilisées dans l'ensemble de votre application.

Votre code possède désormais une représentation en mémoire d'une table DynamoDB qui peut fonctionner avec des instances. Customer La table DynamoDB réelle peut exister ou ne pas exister. Si la table nommée existe Customer déjà, vous pouvez commencer à effectuer des opérations CRUD sur elle. Si elle n'existe pas, utilisez l'DynamoDbTableinstance pour créer la table comme indiqué dans la section suivante.