org.nuxeo.ecm.core.blob

Class DocumentBlobManagerComponent

java.lang.Object

org.nuxeo.runtime.model.DefaultComponent

org.nuxeo.ecm.core.blob.DocumentBlobManagerComponent

All Implemented Interfaces:

DocumentBlobManager, Adaptable, Component, Extensible, TimestampedService

public class DocumentBlobManagerComponent
extends DefaultComponent
implements DocumentBlobManager

Implementation of the service managing Blobs associated to a Document or a repository.

Since:

9.2

Field Summary

Fields

Modifier and Type	Field and Description
protected Deque<BlobDispatcherDescriptor>	blobDispatcherDescriptorsRegistry
protected static BlobDispatcher	DEFAULT_BLOB_DISPATCHER
protected static String	XP

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

lastModified, name

Constructor Summary

Constructors

Constructor and Description
DocumentBlobManagerComponent()

Method Summary

Modifier and Type	Method and Description
void	deactivate(ComponentContext context) Deactivates the component.
protected void	freezeVersion(Document.BlobAccessor accessor, Document doc)
void	freezeVersion(Document doc) Freezes the blobs' versions on a document version when it is created via a check in.
BinaryManagerStatus	garbageCollectBinaries(boolean delete) Garbage collect the unused binaries.
protected BlobDispatcher	getBlobDispatcher()
protected BlobProvider	getBlobProvider(String providerId)
protected BlobProvider	getBlobProvider(String key, String repositoryName)
InputStream	getConvertedStream(Blob blob, String mimeType, DocumentModel doc) Gets an InputStream for a conversion to the given MIME type.
protected DocumentBlobProvider	getDocumentBlobProvider(Blob blob)
protected List<BinaryGarbageCollector>	getGarbageCollectors()
boolean	isBinariesGarbageCollectionInProgress() Checks if a garbage collection of the binaries in progress.
void	markReferencedBinary(String key, String repositoryName) INTERNAL.
void	notifyChanges(Document doc, Set<String> xpaths) Notifies the blob manager that a set of xpaths have changed on a document.
Blob	readBlob(BlobInfo blobInfo, String repositoryName) Reads a Blob from storage.
protected void	registerBlobDispatcher(BlobDispatcherDescriptor descr)
void	registerContribution(Object contribution, String extensionPoint, ComponentInstance contributor)
protected void	unregisterBlobDispatcher(BlobDispatcherDescriptor descr)
void	unregisterContribution(Object contribution, String extensionPoint, ComponentInstance contributor)
String	writeBlob(Blob blob, Document doc, String xpath) Writes a Blob to storage and returns its key.

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

activate, getAdapter, getDescriptor, getDescriptors, getLastModified, getRegistry, register, registerExtension, setLastModified, setModifiedNow, setName, start, stop, unregister, 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

DEFAULT_BLOB_DISPATCHER

protected static BlobDispatcher DEFAULT_BLOB_DISPATCHER

blobDispatcherDescriptorsRegistry

protected Deque<BlobDispatcherDescriptor> blobDispatcherDescriptorsRegistry

Constructor Detail

DocumentBlobManagerComponent

public DocumentBlobManagerComponent()

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

registerBlobDispatcher

protected void registerBlobDispatcher(BlobDispatcherDescriptor descr)

unregisterBlobDispatcher

protected void unregisterBlobDispatcher(BlobDispatcherDescriptor descr)

getBlobDispatcher

protected BlobDispatcher getBlobDispatcher()

getBlobProvider

protected BlobProvider getBlobProvider(String providerId)

getDocumentBlobProvider

protected DocumentBlobProvider getDocumentBlobProvider(Blob blob)

readBlob

public Blob readBlob(BlobInfo blobInfo,
                     String repositoryName)
              throws IOException

Reads a Blob from storage.

The BlobInfo (coming from the database) contains the blob key, which may or may not be prefixed by a blob provider id.

Specified by:

readBlob in interface DocumentBlobManager

Parameters:

blobInfo - the blob information

repositoryName - the repository to which this blob belongs

Returns:

a managed blob

Throws:

IOException

getBlobProvider

protected BlobProvider getBlobProvider(String key,
                                       String repositoryName)

writeBlob

public String writeBlob(Blob blob,
                        Document doc,
                        String xpath)
                 throws IOException

Writes a Blob to storage and returns its key.

If the blob is managed and already uses the provider that's expected for this blob and document, there is no need to recompute a key. Otherwise, go through the blob provider.

Specified by:

writeBlob in interface DocumentBlobManager

Parameters:

blob - the blob

doc - the document to which this blob belongs

xpath - the xpath of blob in doc

Returns:

the blob key

Throws:

IOException

getConvertedStream

public InputStream getConvertedStream(Blob blob,
                                      String mimeType,
                                      DocumentModel doc)
                               throws IOException

Description copied from interface: DocumentBlobManager

Gets an InputStream for a conversion to the given MIME type.

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

Specified by:

getConvertedStream in interface DocumentBlobManager

Parameters:

blob - the blob

mimeType - the MIME type to convert to

doc - the document that holds the blob

Returns:

the stream, or null if no conversion is available for the given MIME type

Throws:

IOException

freezeVersion

protected void freezeVersion(Document.BlobAccessor accessor,
                             Document doc)

freezeVersion

public void freezeVersion(Document doc)

Description copied from interface: DocumentBlobManager

Freezes the blobs' versions on a document version when it is created via a check in.

Specified by:

freezeVersion in interface DocumentBlobManager

Parameters:

doc - the new document version

notifyChanges

public void notifyChanges(Document doc,
                          Set<String> xpaths)

Description copied from interface: DocumentBlobManager

Notifies the blob manager that a set of xpaths have changed on a document.

Specified by:

notifyChanges in interface DocumentBlobManager

Parameters:

doc - the document

xpaths - the set of changed xpaths

getGarbageCollectors

protected List<BinaryGarbageCollector> getGarbageCollectors()

garbageCollectBinaries

public BinaryManagerStatus garbageCollectBinaries(boolean delete)

Description copied from interface: DocumentBlobManager

Garbage collect the unused binaries.

Specified by:

garbageCollectBinaries in interface DocumentBlobManager

Parameters:

delete - if false don't actually delete the garbage collected binaries (but still return statistics about them), if true delete them

Returns:

a status about the number of garbage collected binaries

markReferencedBinary

public void markReferencedBinary(String key,
                                 String repositoryName)

Description copied from interface: DocumentBlobManager

INTERNAL. Marks a binary as referenced during garbage collection. Called back by repository implementations during DocumentBlobManager.garbageCollectBinaries(boolean).

Specified by:

markReferencedBinary in interface DocumentBlobManager

Parameters:

key - the binary key

repositoryName - the repository name

isBinariesGarbageCollectionInProgress

public boolean isBinariesGarbageCollectionInProgress()

Description copied from interface: DocumentBlobManager

Checks if a garbage collection of the binaries in progress.

Specified by:

isBinariesGarbageCollectionInProgress in interface DocumentBlobManager

Returns:

true if a garbage collection of the binaries is in progress