com.jcabi.s3

Interface Ocket

All Superinterfaces:

Comparable<Ocket>

All Known Implementing Classes:

CdOcket, MkOcket, Ocket.Text, ReOcket

@Immutable
public interface Ocket
extends Comparable<Ocket>

Amazon S3 object abstraction.

You get an instance of this interface from Bucket, for example:

 Region region = new Region.Simple(key, secret);
 Bucket bucket = region.bucket("my.example.com");
 Ocket ocket = bucket.ocket("src/main/README.txt");

In order to read and write plain text content in Unicode we recommend to use Ocket.Text decorator:

 Ocket.Text ocket = new Ocket.Smart(
   bucket.ocket("src/main/README.txt")
 );
 ocket.write("hello, world!", "text/plain");
 

Since:

0.1

Version:

$Id$

Author:

Yegor Bugayenko (yegor@tpc2.com)

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	Ocket.Text Unicode text S3 object with supplementary functions.

Method Summary

Methods

Modifier and Type	Method and Description
Bucket	bucket() Get bucket we're in.
boolean	exists() Check whether this S3 object exists.
String	key() Get object key.
com.amazonaws.services.s3.model.ObjectMetadata	meta() Object metadata.
void	read(OutputStream output) Read content.
void	write(InputStream input, com.amazonaws.services.s3.model.ObjectMetadata meta) Write new content to the object.

Methods inherited from interface java.lang.Comparable

compareTo

Method Detail

bucket

@NotNull(message="bucket is never NULL")
Bucket bucket()

Get bucket we're in.

Returns:

Bucket

key

@NotNull(message="ocket key is never NULL")
String key()

Get object key.

Returns:

Key

meta

@NotNull(message="ocket meta is never NULL")
com.amazonaws.services.s3.model.ObjectMetadata meta()
                                                    throws IOException

Object metadata.

Returns:

Metadata

Throws:

IOException - If fails

exists

boolean exists()
               throws IOException

Check whether this S3 object exists.

Returns:

TRUE if it exists in S3, FALSE otherwise

Throws:

IOException - If fails

Since:

0.4

read

void read(@NotNull(message="output stream can\'t be NULL")
        OutputStream output)
          throws IOException

Read content.

Parameters:

output - Where to write

Throws:

IOException - If fails

write

void write(@NotNull(message="input stream can\'t NULL")
         InputStream input,
         @NotNull(message="object meta can\'t be NULL")
         com.amazonaws.services.s3.model.ObjectMetadata meta)
           throws IOException

Write new content to the object.

Parameters:

input - Where to get content

meta - Metadata to save

Throws:

IOException - If fails