Skip to content
Lucee extension to provide simpler access to common AWS commands through the AWS SDK
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
aws-java-sdk
tests
.gitignore
.travis.yml
Dockerfile
LICENSE
README.md
aws.cfc
box.json
dynamodb.cfc
elb.cfc
lambda.cfc
opsworks.cfc
route53.cfc
s3.cfc
ses.cfc

README.md

lucee-aws

Build Status

Lucee extension to provide simpler access to common AWS commands through the AWS SDK.

Installation

The easiest way to install this at present is to use CommandBox. To install with CommandBox 2.1+ simply do the following.

box install mso-net/lucee-aws --production

The contents of /aws-java-sdk are just the jar files from http://sdk-for-java.amazonwebservices.com/latest/aws-java-sdk.zip. I am looking for a better way of handling this dependency but for now I'm concentrating on other tasks.

Important There are currently some conflicts between the AWS Java SDK and Lucee. At present I would advise replacing the Lucee/CommandBox version of joda-time.jar with the version within the AWS Java SDK. If you don't do this you will see issues especially with S3. Additionally the javax-mailer jar conflicts with the one in Lucee, in this case you can delete the one from the AWS Java SDK - I don't think I'm actually making use of that yet.

Running unit tests

The unit tests within lucee-aws may be run using Docker. To do so you will need to configure various environment variables with your own values - setting up this environment is not something I have scripts for at present though.

It can be built and run by executing the following commands.

docker build -t mso-net/lucee-aws .
docker run -e "aws_accountid=$aws_accountid" -e "aws_secretkey=$aws_secretkey" -e "dynamodb_table=$dynamodb_table" -e "elb_name=$elb_name" -e "elb_region=$elb_region" -e "lambda_method=$lambda_method" -e "route53_tld=$route53_tld" -e "s3_bucket=$s3_bucket" -e "ses_from=$ses_from" -e "ses_to=$ses_to" mso-net/lucee-aws

Usage

S3

Example for S3

s3 = new aws.s3( 
  account = 'account_id',
  secret = 'secret',
  bucket = 'bucket_name'
);

s3.getObject( 'path/to/something.ext' );
s3.putObject( 'path/to/something.ext' , 'data:image/png;base64,data_base64_encoded_here' );
s3.deleteObject( 'path/to/something.ext' );

Additional reading

You can’t perform that action at this time.