com.attivio.sdk.api

Interface ContentStoreProvider

All Known Implementing Classes:

MockContentStoreProvider

public interface ContentStoreProvider

The ContentStoreProvider provides access to AIE's content store. Content is stored within namespaces, each identified by a unique String. Content may be any series of bytes and is identified by a String id unique within the namespace. The result of simultaneous operations (method calls) that change the state of the content (add, delete, deleteAll) is undefined.

The DEFAULT_NAMESPACE is optimized for storage of temporary files. Storage of non-ephemeral content should use a custom namespace.

Field Summary

Fields

Modifier and Type	Field and Description
static String	DEFAULT_NAMESPACE
static String	description

Method Summary

Modifier and Type	Method and Description
void	add(String namespace, String id, InputStream in) Content will be copied from the InputStream and stored within the namespace under the id.
boolean	contains(String namespace, String id)
void	delete(String namespace, String id) Deletes id from the namespace.
void	deleteAll(String namespace) Deletes all content from the store within the namespace
String	externalize(String storeName, String id) Returns an externally accessible URI for the content suitable for HTTP GET.
InputStream	get(String namespace, String id) Returns an InputStream to access the content.
long	getDiskUtilization()
long	getLastModified(String namespace, String id)
List<String>	getNamespaces()
long	getSize(String namespace, String id)
long	getTotalRecords(String namespace)

Field Detail

description

static final String description

See Also:

Constant Field Values

DEFAULT_NAMESPACE

static final String DEFAULT_NAMESPACE

See Also:

Constant Field Values

Method Detail

contains

boolean contains(String namespace,
                 String id)
          throws AttivioException

Parameters:

namespace - the namespace for the content

id - the id of the content

Returns:

true if id exists within the namespace

Throws:

AttivioException

add

void add(String namespace,
         String id,
         InputStream in)
  throws AttivioException

Content will be copied from the InputStream and stored within the namespace under the id. If the content currently exists, it will be replaced. The stream is not closed.

Parameters:

namespace - the namespace for the content

id - the id of the content

in - stream containing the content.

Throws:

AttivioException

delete

void delete(String namespace,
            String id)
     throws AttivioException

Deletes id from the namespace. The content need not be present.

Parameters:

namespace - the namespace for the content

id - the id of the content

Throws:

AttivioException

deleteAll

void deleteAll(String namespace)
        throws AttivioException

Deletes all content from the store within the namespace

Parameters:

namespace - the namespace to delete

Throws:

AttivioException

getTotalRecords

long getTotalRecords(String namespace)
              throws AttivioException

Parameters:

namespace - the namespace to query

Returns:

the number of unique content records associated with the namespace.

Throws:

AttivioException

getDiskUtilization

long getDiskUtilization()
                 throws AttivioException

Returns:

the disk space consumed by content store entries

Throws:

AttivioException

getNamespaces

List<String> getNamespaces()
                    throws AttivioException

Returns:

list of all namespaces in the content store

Throws:

AttivioException

get

InputStream get(String namespace,
                String id)
         throws AttivioException

Returns an InputStream to access the content.

Parameters:

namespace - the namespace for the content

id - the id of the content

Returns:

an InputStream for the content or null if it does not exist

Throws:

AttivioException

getSize

long getSize(String namespace,
             String id)
      throws AttivioException

Parameters:

namespace - the namespace for the content

id - the id of the content

Returns:

the number of bytes the InputStream returned by get(String, String) should provide.

Throws:

AttivioException

getLastModified

long getLastModified(String namespace,
                     String id)
              throws AttivioException

Parameters:

namespace - the namespace for the content

id - the id of the content

Returns:

the time of the last add(String, String, InputStream) for the content.

Throws:

AttivioException

externalize

String externalize(String storeName,
                   String id)
            throws AttivioException

Returns an externally accessible URI for the content suitable for HTTP GET.

Parameters:

storeName - namespace for the content

id - id for the content

Returns:

URI as a string

Throws:

AttivioException