Criar um cliente aprimorado e uma DynamoDbTable

Criar um cliente aprimorado

A DynamoDbEnhancedClientclasse, ou sua contraparte assíncrona, DynamoDbEnhancedAsyncClient, é o ponto de entrada para trabalhar com a API do DynamoDB Enhanced Client.

O cliente aprimorado exige um DynamoDbClient padrão para realizar operações. A API oferece duas maneiras de criar uma instância DynamoDbEnhancedClient. A primeira opção, mostrada no trecho a seguir, cria um DynamoDbClient padrão com configurações padrão retiradas das definições de configuração.

DynamoDbEnhancedClient enhancedClient = DynamoDbEnhancedClient.create();

Se quiser configurar o cliente padrão subjacente, você poderá fornecê-lo ao método construtor do cliente aprimorado, conforme mostrado no trecho a seguir.

// 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();

Criar uma instância DynamoDbTable

Pense em uma DynamoDbTable como a representação do lado do cliente de uma tabela do DynamoDB que usa a funcionalidade de mapeamento fornecida por um TableSchema. A classe DynamoDbTable fornece métodos para operações CRUD que permitem que você interaja com uma única tabela do DynamoDB.

DynamoDbTable<T> é uma classe genérica que usa um argumento de tipo único, seja uma classe personalizada ou EnhancedDocument, ao trabalhar com itens do tipo documento. Esse tipo de argumento estabelece a relação entre a classe que você usa e a tabela única do DynamoDB.

Use o método de fábrica table() do DynamoDbEnhancedClient para criar uma instância DynamoDbTable conforme será mostrado no trecho a seguir.

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

Instâncias DynamoDbTable são candidatas a singletons porque são imutáveis e podem ser usadas em toda a sua aplicação.

Seu código agora tem uma representação na memória de uma tabela do DynamoDB que pode funcionar com instâncias. Customer A tabela do DynamoDB pode ou não existir. Se a tabela chamada Customer já existir, você poderá começar a realizar operações CRUD nela. Se ela não existir, use a instância DynamoDbTable para criar a tabela conforme será discutido na próxima seção.