org.nuxeo.ecm.core.blob

Class BlobManagerComponent

java.lang.Object

org.nuxeo.runtime.model.DefaultComponent

org.nuxeo.ecm.core.blob.BlobManagerComponent

All Implemented Interfaces:

BlobManager, Adaptable, Component, Extensible, TimestampedService

public class BlobManagerComponent
extends DefaultComponent
implements BlobManager

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

Since:

7.2

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected static class	BlobManagerComponent.BlobProviderDescriptorRegistry

Nested classes/interfaces inherited from interface org.nuxeo.ecm.core.blob.BlobManager

BlobManager.UsageHint

Field Summary

Fields

Modifier and Type	Field and Description
protected BlobManagerComponent.BlobProviderDescriptorRegistry	blobProviderDescriptorsRegistry
protected Map<String,BlobProvider>	blobProviders
protected static String	XP

Fields inherited from class org.nuxeo.runtime.model.DefaultComponent

lastModified

Constructor Summary

Constructors

Constructor and Description
BlobManagerComponent()

Method Summary

Modifier and Type	Method and Description
protected void	closeOldBlobProvider(String id) We're about to change something about a contributed blob provider.
void	deactivate(ComponentContext context) Deactivates the component.
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 providerId) Gets the blob provider with the given id.
Map<String,BlobProvider>	getBlobProviders() Get the map of blob providers
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.
void	registerBlobProvider(BlobProviderDescriptor descr)
void	registerContribution(Object contribution, String extensionPoint, ComponentInstance contributor)
void	unregisterBlobProvider(BlobProviderDescriptor descr)
void	unregisterContribution(Object contribution, String extensionPoint, ComponentInstance contributor)

Methods inherited from class org.nuxeo.runtime.model.DefaultComponent

activate, getAdapter, getLastModified, registerExtension, setLastModified, setModifiedNow, start, stop, unregisterExtension

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.nuxeo.runtime.model.Component

applicationStarted, getApplicationStartedOrder

Field Detail

XP

protected static final String XP

See Also:

Constant Field Values

blobProviderDescriptorsRegistry

protected BlobManagerComponent.BlobProviderDescriptorRegistry blobProviderDescriptorsRegistry

blobProviders

protected Map<String,BlobProvider> blobProviders

Constructor Detail

BlobManagerComponent

public BlobManagerComponent()

Method Detail

deactivate

public void deactivate(ComponentContext context)

Description copied from interface: Component

Deactivates the component.

This method is called by the runtime when a component is deactivated.

Specified by:

deactivate in interface Component

Overrides:

deactivate in class DefaultComponent

Parameters:

context - the runtime context

registerContribution

public void registerContribution(Object contribution,
                                 String extensionPoint,
                                 ComponentInstance contributor)

Overrides:

registerContribution in class DefaultComponent

unregisterContribution

public void unregisterContribution(Object contribution,
                                   String extensionPoint,
                                   ComponentInstance contributor)

Overrides:

unregisterContribution in class DefaultComponent

registerBlobProvider

public void registerBlobProvider(BlobProviderDescriptor descr)

unregisterBlobProvider

public void unregisterBlobProvider(BlobProviderDescriptor descr)

closeOldBlobProvider

protected void closeOldBlobProvider(String id)

We're about to change something about a contributed blob provider. Close the old one.

getBlobProvider

public BlobProvider getBlobProvider(String providerId)

Description copied from interface: BlobManager

Gets the blob provider with the given id.

Specified by:

getBlobProvider in interface BlobManager

Parameters:

providerId - the blob provider id

Returns:

the blob provider

getBlobProvider

public BlobProvider getBlobProvider(Blob blob)

Description copied from interface: BlobManager

Gets the blob provider for the given blob.

Specified by:

getBlobProvider in interface BlobManager

Returns:

the blob provider

getStream

public InputStream getStream(Blob blob)
                      throws IOException

Description copied from interface: BlobManager

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

Specified by:

getStream in interface BlobManager

Parameters:

blob - the blob

Returns:

the stream

Throws:

IOException

getThumbnail

public InputStream getThumbnail(Blob blob)
                         throws IOException

Description copied from interface: BlobManager

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.

Specified by:

getThumbnail in interface BlobManager

Parameters:

blob - the blob

Returns:

the thumbnail stream

Throws:

IOException

getURI

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

Description copied from interface: BlobManager

Gets an URI for the content of a blob.

Specified by:

getURI in interface BlobManager

Parameters:

blob - the blob

hint - BlobManager.UsageHint

servletRequest - the servlet request, or null

Returns:

the URI, or null if none available

Throws:

IOException

getAvailableConversions

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

Description copied from interface: BlobManager

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

Specified by:

getAvailableConversions in interface BlobManager

Returns:

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

Throws:

IOException

getBlobProviders

public Map<String,BlobProvider> getBlobProviders()

Description copied from interface: BlobManager

Get the map of blob providers

Specified by:

getBlobProviders in interface BlobManager

Returns:

the list of blob providers