Primeiros passos no uso do SDK do AWS com o Java

O SDK do AWs para o Java fornece uma API para os serviços da infraestrutura do AWS. Usando o SDK, você pode construir aplicações sobre o Amazon Simple Storage Service (Amazon S3), Amazon Elastic Compute Cloud (Amazon EC2), Amazon SimpleDB, e mais.

O SDK do AWS para Java inclui:

  • Biblioteca Java para AWS—Construa aplicações Java com as APIs para tirar a complexidade do código diretamente contra a interface do serviço web. A biblioteca fornece APIs que escondem muito da infraestrutura de baixo nível, incluindo autenticação, recuperação de requisições e manipulação de erro.
  • Exemplos de código—Exemplos práticos de como usar a biblioteca para criar aplicações.
  • Suporte ao Eclipse—Use o Kit de ferramentas para o Eclipse para adicionar do SDK do AWS a projetos existentes, ou criar um novo projeto Java baseado no SDK do AWS.

Para mais informações sobre o SDK do AWs para o Java, incluindo uma lista completa de serviços suportados veja http://aws.amazon.com/sdkforjava.

Inscrevendo-se no Amazon Web Services

Antes de poder começar, precisa assinar cada serviço que quer usar.

Para assinar o serviço

  • Vá até a página do serviço. Você pode encontrar uma lista de serviços em http://aws.amazon.com/products.
  • Cliquie em Sign Up na parte superior direita da página. Se ainda não possuir uma conta AWS, será pedido para criar uma como parte do processo de assinatura.
  • Siga as instruções da tela.

O AWS envia a você um e-mail de confirmação depois que o processo de assinatura estiver completo.  A qualquer tempo, você pode visualizar a atividade de sua conta e gerenciar ela indo a http://aws.amazon.com e clicando em Your Account.

Obtendo suas credenciais de segurança do AWS

Para poder usar o SDK do AWS para o Java, você precisará das credenciais de segurança que foram criadas quando você cria sua conta AWS. As credenciais de segurança são usadas para autenticar as requisições a um serviço e identificar-se como remetente da requisição. As credenciais de segurança usadas com o SDK do AWS são um par de chaves públicas / privadas:

  • Access Key ID (for example: 022QF06E7MXBSAMPLE)
  • Secret Access Key (for example: kWcrlUX5JEDGM/SAMPLE/aVmYvHNif5zB+d9+ct)

IMPORTANTE: A sua Secret Access Key é um segredo, que apenas você e o AWS deve saber. É importante mantê-la confidencial para proteger a sua conta. Armazene-a de forma segura. Nunca inclua ela em suas requisições ao AWS, e nunca envia ela por e-mail para alguém. Não compartilhe elas fora de sua organização, mesmo se o pedido parecer vir da AWS ou da Amazon. Ninguém que represente de forma legitima a Amazon irá lhe pedir a sua Secret Access Key.

Para visualizar as suas credenciais de segurança

Obtendo as ferramentas que você vai precisar

O SDK do AWS para o Java necessita do JDK 5.0 ou superior. Você pode baixar a última versão do Java no endereço http://developers.sun.com/downloads/. O SDK também precisa dos pacotes do Apache Commons (Code, Cliente HTTP e Logging) e do Saxon HE, que são incluídos no diretório third-party do SDK.

Se você usa Eclipse, o Kit de ferramentas do AWS lhe fornece suporte ao SDK do AWS para Java assim como recursos de gerenciamento. Para mais informações sobre a instalação do Kit de ferramentas para o Eclipse, veja http://aws.amazon.com/eclipse/. Iremos ver aqui nesse artigo apenas os passos básicos para usar o Kit no Eclipse.

Usando o SDK do AWS para Java

Baixe o SDK do AWS para o Java no endereço http://aws.amazon.com/sdkforjava. Depois de ter baixado o arquivo, extraia o conteúdo em uma pasta de seu disco rígido.

A pasta /samples do SDK inclui vários exemplos de código:

  • Exemplo de linha de comando — Demonstra como criar uma requisição para múltiplos serviços.
  • Exemplo com o Amazon S3 — Demonstra como usar os recursos básicos do Amazon S3, como por e obter um objeto do Amazon S3.
  • Exemplo com o Amazon SimpleDB — Demonstra como usar os recursos básico do Amazon SimpleDB, incluindo a criação e remoção de domínios, e seleção de dados em um domínio.
  • Exemplo com o Amazon SQS — Demonstra como usar os recursos básicos do Amazon SQS, incluindo o adicionamento e a retirada de mensagens de uma fila.

Para executar em exemplo

  1. Abra o arquivo AwsCredentials.properties na pasta do exemplo. Por exemplo, o arquivo no exemplo Console está localizado no diretório aws-java-sdk/samples/AwsConsoleApp/AwsCredentials.properties.
  2. Localize a seguinte seção no arquivo e preencha com sua Access Key ID e  Secret Access Key:
    # Fill in your AWS Access Key ID and Secret Access Key
    # http://aws.amazon.com/security-credentials
    accessKey =
    secretKey =
  3. Salve o arquivo.
  4. Execute o arquivo *.java do exemplo, localizado no mesmo diretório do arquivo *.properties. Por exemplo, execute o arquivo aws-java-sdk/samples/AwsConsoleApp/AwsConsoleApp.java para o exemplo Console. O exemplo exibe informações na saída padrão, por exemplo:
    ===========================================
      Welcome to the AWS Java SDK!
    ===========================================

     

    You have access to 4 Availability  Zones.
    You have 0 Amazon EC2 instance(s)  running.
    You have 13 Amazon SimpleDB  domain(s)containing a total of 62 items.
    You have 23 Amazon S3 bucket(s),  containing 44 objects with a total size of 154767691 bytes.

NOTA: Cada exemplo também inclui um arquivo Ant build.xml para que você possa roda-lo. Para obter mais informações sobre o Ant, veja http://ant.apache.org.

Usando o SDK do AWS para Java no Eclipse

Se você estiver usando o Kit de ferramentas para Eclipse, pode também iniciar um novo projeto no Eclipse baseado no SDK do AWS para Java ou adicionar o SDK a um projeto existente

Instalação do Kit de ferramentas do AWS no Eclipse

Veja http://aws.amazon.com/eclipse para mais informações sobre a instalação do Kit de ferramentas para o Eclipse.

NOTA: Depois da instalação do Kit de ferramentas para o Eclipse, é recomendável configurar o Kit de ferramentas com suas credenciais de segurança. Pode fazer isso selecionando Preferences no menu Window do Eclipse, e em seguida selecionar a seção  AWS Toolkit.

Iniciando um novo projeto

  1. Abra o Eclipse.
  2. Crie um novo projeto Java com AWS pela seleção de File -> New -> Project. O assistente The New Project é aberto.
  3. Expanda a categoria AWS, e em seguida selecione AWS Java Project.
  4. Clique em Next. As configurações do projeto serão exibidas.
  5. Informe um nome para o projeto no campo Project Name. A seção AWS SDK for Java Samples exibe os exemplos disponíveis no SDK, como descrito acima.
  6. Selecione os exemplos que você quer incluir em seu projeto pela seleção de cada opção dispnível.
  7. Informe as suas credenciais no AWS. Se você já configurou suas credenciais no Kit de ferramentas, esses campos estarão preenchidos automaticamente.
  8. Clique em Finish. O projeto será criado e adicionado ao Project explorer.

Executando o porjeto

  1. Selecione o arquivo *.java exemplo que você quer executar. Por exemplo, oara o exemplo com o Amazon S3, selecione S3Sample.java.
  2. Selecione Run no menu Run.

Adicionar o SDK a um projeto existente

  1. Dê um clique com o botão direito no nome do projeto no Project Explorer, e em seguida Build Path -> Add Libraries….
  2. Selecione AWS Java SDK, e em seguida clique em Next e siga as instruções exibidas na tela.

Para onde ir a partir daqui?

Agora que você baixou o SDK do AWS para o Java e executou alguns exemplos, está pronto para começar a criar a sua própria aplicação. Apesar de muitas aplicações criadas para o AWS não serem tão simples quanto os exemplos desse artigo, os princípios usados no exemplo podem ser facilmente aplicados a aplicações mais complexas.

Essa seção lista alguns recursos adicionais que podem ser úteis na hora de desenvolver a sua aplicação.

Fonte: http://aws.amazon.com