Ejemplos de código Java - Amazon DynamoDB
Java: configuración de las credenciales de AWSJava: configuración de la región y del punto de conexión de AWS

Ejemplos de código Java

Esta Guía para desarrolladores contiene fragmentos de código Java y programas listos para ejecutarlos. Encontrará estos ejemplos de código en las secciones siguientes:

Puede comenzar rápidamente a trabajar con Eclipse y AWS Toolkit for Eclipse. Además de un IDE completo, obtendrá AWS SDK for Java con actualizaciones automáticas y plantillas preconfiguradas para crear aplicaciones de AWS.

Para ejecutar los ejemplos de código Java (con Eclipse)

  1. Descargue e instale el IDE de Eclipse.

  2. Descargue e instale AWS Toolkit for Eclipse.

  3. Inicie Eclipse y, en el menú Eclipse, elija File (Archivo), New (Nuevo) y después Other (Otro).

  4. En Seleccionar un asistente, elija AWS, Proyecto de Java de AWS y, después, Siguiente.

  5. En Crear una instancia de Java de AWS, haga lo siguiente:

    1. En Nombre del proyecto, introduzca un nombre para el proyecto.

    2. En Select Account (Seleccionar cuenta), elija su perfil de credenciales en la lista.

      Si es la primera vez que utiliza AWS Toolkit for Eclipse, elija Configurar cuentas de AWS para configurar las credenciales de AWS.

  6. Elija Finish (Finalizar) para crear el proyecto.

  7. En el menú Eclipse, elija File (Archivo), New (Nuevo) y después Class (Clase).

  8. En Java Class (Clase Java), introduzca un nombre para la clase en Name (Nombre) (use el mismo nombre que en el ejemplo de código que desea ejecutar) y, a continuación, elija Finish (Finalizar) para crear la clase.

  9. Copie el ejemplo de código de la página de documentación en el editor de Eclipse.

  10. Para ejecutar el código, elija Run (Ejecutar) en el menú Eclipse.

El SDK para Java proporciona clientes seguros para subprocesos con el fin de trabajar con DynamoDB. Como práctica recomendada, sus aplicaciones deben crear un cliente y reutilizar el cliente entre subprocesos.

Para obtener más información, consulte AWS SDK for Java.

nota

Los ejemplos de código de esta guía se han diseñado para utilizarlos con la última versión del AWS SDK for Java.

Si utiliza AWS Toolkit for Eclipse, puede configurar las actualizaciones automáticas para el SDK para Java. Para hacer esto en Eclipse, vaya a Preferences (Preferencias) y elija AWS Toolkit, AWS SDK for Java, Download new SDKs automatically (Descargar nuevos SDK automáticamente).

Java: configuración de las credenciales de AWS

El SDK para Java requiere que proporcione las credenciales de AWS a su aplicación en tiempo de ejecución. En los ejemplos de código de esta guía se supone que se usa un archivo de credenciales de AWS, tal como se describe en Configuración de las credenciales de AWS en la Guía para desarrolladores de AWS SDK for Java.

A continuación se muestra un ejemplo de archivo de credenciales de AWS denominado ~/.aws/credentials, donde el carácter de tilde (~) representa su directorio de inicio.

[default]
aws_access_key_id = AWS access key ID goes here
aws_secret_access_key = Secret key goes here

Java: configuración de la región y del punto de conexión de AWS

De forma predeterminada, los ejemplos de código acceden a DynamoDB en la región EE. UU. Oeste (Oregón). Puede cambiar la región modificando las propiedades de AmazonDynamoDB.

En el siguiente ejemplo de código se crea una nueva instancia de AmazonDynamoDB.

import com.amazonaws.services.dynamodbv2.AmazonDynamoDBClientBuilder;
import com.amazonaws.regions.Regions;
...
// This client will default to US West (Oregon)
AmazonDynamoDB client = AmazonDynamoDBClientBuilder.standard()
.withRegion(Regions.US_WEST_2)
.build();

Puede usar el método withRegion para ejecutar el código en DynamoDB en cualquier región donde se encuentre disponible. Para obtener una lista completa, consulte Regiones de AWS y puntos de conexión en la Referencia general de Amazon Web Services.

Si desea ejecutar los ejemplos de código en DynamoDB localmente en su ordenador, configure el punto de enlace como se indica a continuación.

SDK de AWS V1

AmazonDynamoDB client = AmazonDynamoDBClientBuilder.standard().withEndpointConfiguration(
new AwsClientBuilder.EndpointConfiguration("http://localhost:8000", "us-west-2"))
.build();

SDK de AWS V2

DynamoDbClient client = DynamoDbClient.builder()
    .endpointOverride(URI.create("http://localhost:8000"))
    // The region is meaningless for local DynamoDb but required for client builder validation
    .region(Region.US_EAST_1)
    .credentialsProvider(StaticCredentialsProvider.create(
    AwsBasicCredentials.create("dummy-key", "dummy-secret")))
    .build();