Login

    Register

PROJECT CATEGORIES

 

Amazon S3 REST Wrapper
Project Home Blog Forums Known Issues External Project Link Contact Project

Author: Joe Danziger (All RIAForge projects by this author)
Last Updated: December 15, 2008 3:11 AM
Version: 1.7
Views: 22,764
Downloads: 1,781
License: Apache License, Version 2

Description:

A CFC for managing all aspects of Amazon's Simple Storage Service, including file and directory (bucket) operations. Uses a REST interface to perform all operations. Meant to be integrated into existing applications.

The CFC has the following methods:
* init(accessKeyID, secretAccessKey) - initialize CFC (both parameters required).
* getBuckets() - List all buckets.
* putBucket(bucketName, acl, storageLocation) - create a new bucket (acl is optional and defaults to public-read, storageLocation is optional and defaults to non-EU. Use 'EU' for the European location contraint).
* getBucket(bucketName, prefix, marker, maxKeys) - get contents of a bucket (prefix
is optional and matches on the beginning of a key, marker is optional and results
start from there, maxKeys is optional and restricts the number of objects returned).
* deleteBucket(bucketName) - delete a bucket (bucket must be empty).
* putObject(bucketName, fileKey, contentType, HTTPtimeout, cacheControl, cacheDays) - puts an object into a bucket (HTTPtimeout is in seconds - default is 300; cacheControl tells browser to cache object - default is true; cacheDays default is 30).
* getObject(bucketName, fileKey, minutesValid) - get link to an object (minutesValid
is optional and defaults to 60).
* copyObject(oldBucketName, oldFileKey, newBucketName, newFileKey) - copies an object.
* renameObject(oldBucketName, oldFileKey, newBucketName, newFileKey) - renames an object.
* deleteObject(bucketName, fileKey) - delete an object from a bucket.


NOTE: You may also access your objects via:
http://bucketname.s3.amazonaws.com/name-of-the-object

Recent Blog Entries:

Issue Tracker:

ID ISSUE STATUS UPDATED
4 Prefix must resolve to a namespace: Open 01/22/10 10:38 AM
3 putObject shouldn't assume file key is the same as the real path Open 11/11/09 4:24 PM
2 Feature Request: add metadata info to 'putObject' so you can add cache-control/expires info to S3 files Fixed 12/15/08 3:12 AM
1 getObject() Fixed 06/13/08 12:31 AM

View All Issues

To enter issues for this (or any other) project, you must be logged in.

Subversion Access:

You may access this project's Subversion repository with your client here: http://svn.riaforge.org/amazons3.

To view files and changelists associated with this repository, go here: http://amazons3.riaforge.org/index.cfm?event=page.svnbrowse.

You may download the latest set of files from Subversion as a zip file.

Anonymous users have read access to the repository while the administrator has write access.

This project is sharing its code via Subversion. Subversion is an open source source control method. You may find more information about Subversion here: http://subversion.tigris.org/