Usar el SDK con Apache Maven - AWS SDK for Java 1.x

La AWS SDK for Java versión 1.x entró en modo de mantenimiento el 31 de julio de 2024 y estará disponible el 31 de end-of-supportdiciembre de 2025. Le recomendamos que migre al para AWS SDK for Java 2.xseguir recibiendo nuevas funciones, mejoras de disponibilidad y actualizaciones de seguridad.

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Usar el SDK con Apache Maven

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

nota

Debe tener Maven instalado para utilizar las instrucciones de este tema. Si aún no está instalado, visite http://maven.apache.org/ para descargarlo e instalarlo.

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
nota

Encontrará mucha más información sobre la creación y configuración de proyectos en la Guía de introducción a Maven.

Configuración del SDK como una dependencia de Maven

Para utilizar AWS SDK for 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 for 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 for 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