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
- Para visualizar as suas credencias de segurança, vá para a página http://aws.amazon.com/security-credentials.
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
- 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
. - 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 =
- Salve o arquivo.
- 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.xm
l 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
- Abra o Eclipse.
- Crie um novo projeto Java com AWS pela seleção de File -> New -> Project. O assistente The New Project é aberto.
- Expanda a categoria AWS, e em seguida selecione AWS Java Project.
- Clique em Next. As configurações do projeto serão exibidas.
- 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.
- Selecione os exemplos que você quer incluir em seu projeto pela seleção de cada opção dispnível.
- Informe as suas credenciais no AWS. Se você já configurou suas credenciais no Kit de ferramentas, esses campos estarão preenchidos automaticamente.
- Clique em Finish. O projeto será criado e adicionado ao Project explorer.
Executando o porjeto
- Selecione o arquivo *.java exemplo que você quer executar. Por exemplo, oara o exemplo com o Amazon S3, selecione
S3Sample.java
. - Selecione Run no menu Run.
Adicionar o SDK a um projeto existente
- Dê um clique com o botão direito no nome do projeto no Project Explorer, e em seguida Build Path -> Add Libraries….
- 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