Java Library for Amazon SQS

About this Library

• Based on the 2009-02-01 API version.

What's New?

• 2009-04-14:
  • Fixed issue of invalid signature when queue name specified in mixed letter case
• 2009-04-08:
  • Support for access control API
• 2009-01-29:
  • Fix signature version 2 path encoding
• 2009-01-05:
  • Url encoding fix (bug affected signature version 2 with values containing forward slash "/")
• 2008-12-17:
  • Support for signature version 2, https endpoint
• 2008-02-29:
  • Initial Release

Prerequisites

• Amazon Simple Queue Service account (http://aws.amazon.com/sqs).
• Java 1.5 (http://java.sun.com/)

Reference Documentation

• Online Java Docs

Package Content

Quick Start

1. Extract the amazon-queue-2009-02-01-java-library.zip file into a working directory.
2. Add all sources under "src" directory to your compilation path.
3. Add all jars files under "third-party/*" directory to your classpath
4. Edit desired sample. For example: CreateQueueSample.java



• Set AWS Access Key ID and AWS Secret Access Key

String accessKeyId = "Your Access Key ID";
String secretAccessKey = "Your Secret Access Key";
                




• Set request parameters. For example, find following pre-generated snippet:

CreateQueueRequest request = new CreateQueueRequest();
// @TODO: set request parameters here
// invokeCreateQueue(service, request);
                




• And uncomment third line and add queue name to request:

CreateQueueRequest request = new CreateQueueRequest();
request.setQueueName("MyQueue");
invokeCreateQueue(service, request);
                



5. Compile and run CreateQueue. You should see the output similar to the following:




    CreateQueueResponse
        CreateQueueResult
            QueueUrl
                http://queue.amazonaws.com/MyQueue
        ResponseMetadata
            RequestId
                95cdcb68-f46c-400b-8265-8c2de2a5c475
            



Note, you may also see additional debugging output. To adjust level of debugging, modify log4j.properties available in the root of the source tree.


6. Experiment with samples. When ready, add library binary distribution to your application classpath, and use it.

Comments, Questions or Feedback