com.salesforce.cantor.s3

Interface StreamingObjects

All Superinterfaces:

com.salesforce.cantor.Namespaceable, com.salesforce.cantor.Objects

All Known Implementing Classes:

ObjectsOnS3

public interface StreamingObjects
extends com.salesforce.cantor.Objects

Extension of the Objects interface to implement storing/streaming objects that are too large to store/get as whole byte[].

Method Summary

Modifier and Type	Method and Description
void	store(String namespace, String key, InputStream stream, long length) Stores the given object by streaming the content to the underlying storage
InputStream	stream(String namespace, String key) Gets the object corresponding to the given namespace/key as an InputStream

Methods inherited from interface com.salesforce.cantor.Objects

delete, delete, get, get, keys, size, store, store

Methods inherited from interface com.salesforce.cantor.Namespaceable

create, drop, namespaces

Method Detail

store

void store(String namespace,
           String key,
           InputStream stream,
           long length)
    throws IOException

Stores the given object by streaming the content to the underlying storage

Parameters:

namespace - the namespace to store in

key - the key for the object

stream - the content of the object as an InputStream

length - the full length of the content

Throws:

IOException

stream

InputStream stream(String namespace,
                   String key)
            throws IOException

Gets the object corresponding to the given namespace/key as an InputStream

Parameters:

namespace - the namespace of the object

key - the key of the object

Returns:

an InputStream for the stored object/null if it doesn't exist

Throws:

IOException