com.lf.vfslib.s3 (API VFSLib)

Class Summary
Class	Description
S3ClientFactory	Factory for Amazon S3 clients.
S3ClientWrapper	Wraps a Amazon S3 client.
S3FileNameParser	Implementation for Amazon S3.
S3FileObject	Represents a Amazon S3 file or folder.
S3FileProvider	A provider to access the files hosted by Amazon S3.
S3FileSystem	Represents the files hosted by Amazon S3.
S3FileSystemConfigBuilder	The config builder for the various Amazon S3 configuration options.

Package com.lf.vfslib.s3 Description

Bundles the classes and resources to access Amazon® S3 via a Commons VFS 2.0 provider.

File revisions are currently not supported by Commons VFS and neither by VFSLib including the Amazon S3 provider.

Please register a valid Amazon® Web Services (AWS) account first. All necessary parameters for the Amazon S3 provider including the access token are provided by the Amazon S3 system.

To be compatible with folders created using the Amazon S3 Management Console folders must end with a slash '/'. This is the default delimeter for Amazon S3 file systems as well as it is for VFSLib. Remember that the S3 Management Console may need a refresh for new folders created by VFSLib to show up.

Renaming is not currently supported by Amazon S3, so VFSLib does the copy-and-delete thing for files. Remember that renaming folders is currently not possible for Amazon S3 at all. The S3 Management Console does not support it and neither does VFSLib. Maybe Amazon will add simple renaming/moving functions in the future.

The timestamps for folders cannot be accessed right now for Amazon S3, for files this is perfectly possible. Setting a certain timestamp works also for files only due to the folder concept of Amazon S3.

For freshly created files the Amazon S3 API sometimes does not provide the content size of regular files immediately. It may take some time for the file sizes to show up.

As required by the Amazon S3 API the content length for uploads can now be specified. Before an upload output stream is requested with getContent().getOutputStream() the length should be set with getContent().setAttribute(VFSLibConstants.ATTR_CONTENT_LENGTH, length). Remember that this attribute MUST NOT be set for SFTP connections since the driver allocates an array of the given length. Please check with code like "if (VFSUtils.isContentLengthRequired(url))" before setAttribute() is called.