org.nuxeo.ecm.core.blob

Interface BlobManager

All Known Implementing Classes:

BlobManagerComponent

public interface BlobManager

Service managing the storage and retrieval of Blobs, through internally-registered BlobProviders.

Since:

7.2

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	BlobManager.UsageHint Hints for returning URIs appropriate for the expected usage.

Method Summary

Modifier and Type	Method and Description
Map<String,URI>	getAvailableConversions(Blob blob, BlobManager.UsageHint hint) Gets a map of available MIME type conversions and corresponding URI for a blob.
BlobProvider	getBlobProvider(Blob blob) Gets the blob provider for the given blob.
BlobProvider	getBlobProvider(String id) Gets the blob provider with the given id.
Map<String,BlobProvider>	getBlobProviders() Get the map of blob providers
BlobProvider	getBlobProviderWithNamespace(String id) Gets the blob provider with the given id, or, if none has been registered, a namespaced version of the default blob provider.
InputStream	getStream(Blob blob) INTERNAL - Gets an InputStream for the data of a managed blob.
InputStream	getThumbnail(Blob blob) Gets an InputStream for a thumbnail of a blob.
URI	getURI(Blob blob, BlobManager.UsageHint hint, javax.servlet.http.HttpServletRequest servletRequest) Gets an URI for the content of a blob.

Method Detail

getBlobProvider

BlobProvider getBlobProvider(String id)

Gets the blob provider with the given id.

Parameters:

id - the blob provider id

Returns:

the blob provider

getBlobProviderWithNamespace

BlobProvider getBlobProviderWithNamespace(String id)

Gets the blob provider with the given id, or, if none has been registered, a namespaced version of the default blob provider.

Parameters:

id - the blob provider id or namespace

Returns:

the blob provider

Since:

10.10

getBlobProvider

BlobProvider getBlobProvider(Blob blob)

Gets the blob provider for the given blob.

Returns:

the blob provider

Since:

7.4

getStream

InputStream getStream(Blob blob)
               throws IOException

INTERNAL - Gets an InputStream for the data of a managed blob. Used by internal implementations, regular callers should call Blob.getStream().

Parameters:

blob - the blob

Returns:

the stream

Throws:

IOException

getThumbnail

InputStream getThumbnail(Blob blob)
                  throws IOException

Gets an InputStream for a thumbnail of a blob.

Like all InputStream, the result must be closed when done with it to avoid resource leaks.

Parameters:

blob - the blob

Returns:

the thumbnail stream

Throws:

IOException

getURI

URI getURI(Blob blob,
           BlobManager.UsageHint hint,
           javax.servlet.http.HttpServletRequest servletRequest)
    throws IOException

Gets an URI for the content of a blob.

Parameters:

blob - the blob

hint - BlobManager.UsageHint

servletRequest - the servlet request, or null

Returns:

the URI, or null if none available

Throws:

IOException

getAvailableConversions

Map<String,URI> getAvailableConversions(Blob blob,
                                        BlobManager.UsageHint hint)
                                 throws IOException

Gets a map of available MIME type conversions and corresponding URI for a blob.

Returns:

a map of MIME types and URI, which may be empty

Throws:

IOException

getBlobProviders

Map<String,BlobProvider> getBlobProviders()

Get the map of blob providers

Returns:

the list of blob providers

Since:

7.3