O AWS SDK for Java 1.x entrou no modo de manutenção em 31 de julho de 2024 e chegará end-of-supportem 31 de dezembro de 2025. Recomendamos que você migre para o AWS SDK for Java 2.xpara continuar recebendo novos recursos, melhorias de disponibilidade e atualizações de segurança.

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Usar o SDK com o Apache Maven

Você pode usar o Apache Maven para configurar e compilar projetos do AWS SDK for Java ou compilar o próprio SDK.

Criar um novo pacote do Maven

Para criar um pacote do Maven básico, abra uma janela de terminal (linha de comando) e execute:

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

Substitua org.example.basicapp pelo namespace do pacote completo do aplicativo e myapp pelo nome do projeto (este será o nome do diretório do projeto).

Por padrão, cria um modelo de projeto para você usando o arquétipo quickstart, que é um bom ponto de partida para muitos projetos. Existem mais arquétipos disponíveis; visite a página Arquétipos do Maven para obter uma lista de arquétipos empacotados. Você pode escolher um determinado arquétipo a ser usado adicionando o argumento -DarchetypeArtifactId ao comando archetype:generate. Por exemplo:

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

Configurar o SDK como uma dependência do Maven

Para usar o AWS SDK for Java no projeto, será necessário declará-lo como uma dependência no arquivo pom.xml do projeto. Desde a versão 1.9.0, você pode importar componentes individuais ou todo o SDK.

Especificar módulos de SDK individuais

Para selecionar módulos de SDK individuais, use a lista de materiais (BOM) do AWS SDK for Java para Maven, o que garantirá que os módulos especificados usem a mesma versão do SDK e sejam compatíveis entre si.

Para usar a BOM, adicione uma seção <dependencyManagement> ao arquivo pom.xml do aplicativo, adicionando aws-java-sdk-bom como uma dependência e especificando a versão do SDK que você deseja usar:

<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 visualizar a versão mais recente da BOM do AWS SDK for Java disponível no Maven Central, visite: https://mvnrepository.com/artifact/com.amazonaws/aws-java-sdk-bom. Também é possível usar essa página para ver quais módulos (dependências) são gerenciados pela BOM que é possível incluir na seção <dependencies> do arquivo pom.xml do projeto.

Agora você pode selecionar módulos individuais do SDK usados no aplicativo. Como já declarou a versão do SDK na BOM, você não precisa especificar o número da versão 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>

Também é possível consultar o Catálogo de exemplos de código da AWS para saber quais dependências devem ser usadas para determinado AWS service (Serviço da AWS). Consulte o arquivo POM em um exemplo de serviço específico. Por exemplo, se você estiver interessado nas dependências do serviço do AWS S3, consulte o exemplo completo no GitHub. (Examine o pom em /java/example_code/s3).

Importar todos os módulos do SDK

Se você quiser extrair todo o SDK como uma dependência, não use o método da BOM. Basta declará-lo no pom.xml da seguinte forma:

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

Compilar o projeto

Depois de configurar o projeto, será possível criá-lo usando o comando package do Maven:

mvn package

Isso criará o arquivo –0—jar no diretório target.

Compilar o SDK com o Maven

Você pode usar o Apache Maven para compilar o SDK pela origem. Para isso, faça download do código do SDK no GitHub, descompacte-o localmente e execute o seguinte comando do Maven:

mvn clean install