AWS SDK para Java 1.x ha entrado en modo de mantenimiento el 31 de julio de 2024 y llegará al final de soporte el 31 de diciembre de 2025. Le recomendamos que migre a AWS SDK for Java 2.x para seguir recibiendo nuevas características, mejoras de disponibilidad y actualizaciones de seguridad.

Usar el SDK con Apache Maven

Puede utilizar Apache Maven para configurar y compilar proyectos de AWS SDK para Java o para compilar el propio SDK.

Creación de un nuevo paquete de Maven

Para crear un paquete de Maven básico, abra un ventana de terminal (línea de comandos) y ejecute:

mvn -B archetype:generate \
  -DarchetypeGroupId=org.apache.maven.archetypes \
  -DgroupId=org.example.basicapp \
  -DartifactId=myapp

Sustituya org.example.basicapp por el espacio de nombres del paquete completo de su aplicación y myapp por el nombre del proyecto (este será el nombre del directorio de su proyecto).

De forma predeterminada, crea una plantilla de proyecto que utiliza el arquetipo de inicio rápido, lo que constituye un buen punto de partida para muchos proyectos. Hay más arquetipos disponibles; visite la página Arquetipos de Maven para obtener una lista de arquetipos del paquete. Puede elegir un determinado arquetipo añadiendo el argumento -DarchetypeArtifactId al comando archetype:generate. Por ejemplo:

mvn archetype:generate \
  -DarchetypeGroupId=org.apache.maven.archetypes \
  -DarchetypeArtifactId=maven-archetype-webapp \
  -DgroupId=org.example.webapp \
  -DartifactId=mywebapp

Configuración del SDK como una dependencia de Maven

Para utilizar AWS SDK para Java en el proyecto, tendrá que declararlo como una dependencia en el archivo pom.xml del proyecto. A partir de la versión 1.9.0, puede importar componentes individuales o todo el SDK.

Especificación de módulos del SDK individuales

Para seleccionar módulos individuales del SDK, utilice la lista de materiales (BOM) de AWS SDK para Java para Maven, con lo que se asegurará de que los módulos que especifique utilicen la misma versión del SDK y que sean compatibles entre sí.

Para utilizar la lista de materiales, añada una sección <dependencyManagement> al archivo pom.xml de su aplicación, añadiendo aws-java-sdk-bom como una dependencia y especificando la versión del SDK que desee utilizar:

<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>com.amazonaws</groupId>
      <artifactId>aws-java-sdk-bom</artifactId>
      <version>1.11.1000</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

Para ver la última versión de la lista de materiales de AWS SDK para Java disponible en Maven Central, visite: https://mvnrepository.com/artifact/com.amazonaws/aws-java-sdk-bom. También puede utilizar esta página para ver qué módulos (dependencias) administrados por la lista de materiales puede incluir en la sección <dependencies> del archivo pom.xml de su proyecto.

Ahora puede seleccionar los módulos individuales del SDK que desea usar en su aplicación. Como ya ha declarado la versión del SDK en la lista de materiales, no necesita especificar el número de versión de cada componente.

<dependencies>
  <dependency>
    <groupId>com.amazonaws</groupId>
    <artifactId>aws-java-sdk-s3</artifactId>
  </dependency>
  <dependency>
    <groupId>com.amazonaws</groupId>
    <artifactId>aws-java-sdk-dynamodb</artifactId>
  </dependency>
</dependencies>

También puede consultar el AWS Code Sample Catalog para saber qué dependencias utilizar para un servicio de Servicio de AWS determinado. Consulte el archivo POM en un ejemplo de servicio específico. Por ejemplo, si está interesado en las dependencias del servicio AWS S3, consulte el ejemplo completo en GitHub. (Vea el pom en /java/example_code/s3).

Importación de todos los módulos del SDK

Si desea incluir todo el SDK como una dependencia, no utilice el método de lista de materiales; simplemente declárelo en su archivo pom.xml de la manera siguiente:

<dependencies>
  <dependency>
    <groupId>com.amazonaws</groupId>
    <artifactId>aws-java-sdk</artifactId>
    <version>1.11.1000</version>
  </dependency>
</dependencies>

Compilación del proyecto

Una vez que haya configurado su proyecto, puede compilarlo mediante el comando package de Maven:

mvn package

Esto creará el archivo –0—jar en el directorio target.

Compilación del SDK con Maven

Puede utilizar Apache Maven para compilar el SDK desde el origen. Para ello, descargue el código del SDK de GitHub, desempaquételo localmente y, a continuación, ejecute el siguiente comando de Maven:

mvn clean install