JarCasting
JarCasting JarCasting

io.bpic.aws:aws-sqs-jca-api

Amazon SQS JMS Resource Adapter

License

License
Categories

Categories

AWS Container PaaS Providers
GroupId

GroupId

io.bpic.aws
ArtifactId

ArtifactId

aws-sqs-jca-api
Last Version

Last Version

1.0.3
Release Date

Release Date
Type

Type

jar
Description

Description

Amazon SQS JMS Resource Adapter
Source Code Management

Source Code Management

http://github.com/bpicio/aws-sqs-ra/tree/master/aws-sqs-jca-api

Download aws-sqs-jca-api

Filename Size
aws-sqs-jca-api-1.0.3.pom
aws-sqs-jca-api-1.0.3.jar 12 KB
aws-sqs-jca-api-1.0.3-sources.jar 6 KB
aws-sqs-jca-api-1.0.3-javadoc.jar 47 KB
Browse

How to add to project

<!-- https://jarcasting.com/artifacts/io.bpic.aws/aws-sqs-jca-api/ -->
<dependency>
    <groupId>io.bpic.aws</groupId>
    <artifactId>aws-sqs-jca-api</artifactId>
    <version>1.0.3</version>
</dependency>
// https://jarcasting.com/artifacts/io.bpic.aws/aws-sqs-jca-api/
implementation 'io.bpic.aws:aws-sqs-jca-api:1.0.3'
// https://jarcasting.com/artifacts/io.bpic.aws/aws-sqs-jca-api/
implementation ("io.bpic.aws:aws-sqs-jca-api:1.0.3")
'io.bpic.aws:aws-sqs-jca-api:jar:1.0.3'
<dependency org="io.bpic.aws" name="aws-sqs-jca-api" rev="1.0.3">
  <artifact name="aws-sqs-jca-api" type="jar" />
</dependency>
@Grapes(
@Grab(group='io.bpic.aws', module='aws-sqs-jca-api', version='1.0.3')
)
libraryDependencies += "io.bpic.aws" % "aws-sqs-jca-api" % "1.0.3"
[io.bpic.aws/aws-sqs-jca-api "1.0.3"]

Dependencies

compile (1)

Group / Artifact Type Version
com.amazonaws : amazon-sqs-java-messaging-lib jar 1.0.8

provided (1)

Group / Artifact Type Version
javax : javaee-api jar 7.0

Project Modules

There are no modules declared in this project.

Amazon SQS JMS Resource Adapter

Maven Central

Getting Started

Installation

For Wildfly, copy aws-sqs-rar-[VERSION HERE].rar to your application server deployment folder. In standalone it should be:

$WILDFLY_HOME/standalone/deployments

Either reference the resource adapter on your MDB using:

@ResourceAdapter("aws-sqs-rar-[VERSION HERE].rar")

Or by setting as the default adapter on standalone-full.xml:

<subsystem xmlns="urn:jboss:domain:ejb3:6.0">
    ...
    <mdb>
        <resource-adapter-ref resource-adapter-name="${ejb.resource-adapter-name:activemq-ra.rar}"/>
        ...
    </mdb>
    ...
</subsystem>

Then create a queue:

<subsystem xmlns="urn:jboss:domain:resource-adapters:5.0">
    <resource-adapters>
        <resource-adapter id="aws-sqs-rar-[VERSION HERE].rar">
            <archive>
                aws-sqs-rar-${project.version}.rar
            </archive>
            <transaction-support>NoTransaction</transaction-support>
            <admin-objects>
                <admin-object class-name="io.bpic.aws.sqs.ra.SQSJMSQueue" jndi-name="java:jboss/sqs/queue/QueueName" pool-name="QueuePool">
                    <config-property name="queueName">[QUEUE NAME]</config-property>
                </admin-object>
            </admin-objects>
        </resource-adapter>
    </resource-adapters>
</subsystem>

Inbound MDB

To receive messages you must implement the MessageListener interface.

public class ReceiveSQSMDB implements MessageListener {
   
}

Also you must set the ActivationConfigProperty values suitable for your MDB.

Valid properties are below.

Config Property Name Type Default Notes
awsAccessKeyId String None Must be set to the access key of your AWS account (Optional)
awsSecretKey String None Must be set to the secret key of your AWS account (Optional)
destination String None JNDI queue name
region String None Must be set to the AWS region name of your queue. (Optional)

Your MDB should contain one method annotated with @OnMessage

A full skeleton MDB is shown below

@MessageDriven(activationConfig = {
    @ActivationConfigProperty(propertyName = "awsAccessKeyId", propertyValue = "${ENV=accessKey}"),
    @ActivationConfigProperty(propertyName = "awsSecretKey", propertyValue = "${ENV=secretKey}"),
    @ActivationConfigProperty(propertyName = "destination", propertyValue = "${ENV=destination}"),   
    @ActivationConfigProperty(propertyName = "region", propertyValue = "eu-west-2")    
})
@ResourceAdapter("aws-sqs-rar-[VERSION HERE].rar")
public class ReceiveSQSMDB implements MessageListener {

    @OnMessage
    public void receiveMessage(Message message) {
        System.out.println("Got message " + message.getBody());
    }
}

License

This project is licensed under the GNU AGPLv3 License - see the LICENSE.md file for details

io.bpic.aws

BP Internet

Versions

Version
1.0.3
1.0.2
1.0.1
1.0.0