org.nuxeo.ecm.core.blob

Interface BlobDispatcher

All Known Implementing Classes:

DefaultBlobDispatcher

public interface BlobDispatcher

Interface for a dispatcher of blobs to different blob providers according to metadata.

Since:

7.3

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	BlobDispatcher.BlobDispatch

Method Summary

Modifier and Type	Method and Description
default BlobDispatcher.BlobDispatch	getBlobProvider(Document doc, Blob blob) Deprecated. since 9.1, use getBlobProvider(Document, Blob, String) instead
BlobDispatcher.BlobDispatch	getBlobProvider(Document doc, Blob blob, String xpath) Decides which BlobProvider to use to write the given blob, and whether the provider id should be added as prefix to the managed blob key.
String	getBlobProvider(String repositoryName) Decides which BlobProvider to use to read a blob from the given repository if no prefix is specified in the blob key.
Collection<String>	getBlobProviderIds() Gets the provider ids to which this dispatcher can dispatch.
void	initialize(Map<String,String> properties) Initializes this blob dispatcher.
void	notifyChanges(Document doc, Set<String> xpaths) Notifies the blob dispatcher that a set of xpaths have changed on a document.

Method Detail

initialize

void initialize(Map<String,String> properties)

Initializes this blob dispatcher.

getBlobProviderIds

Collection<String> getBlobProviderIds()

Gets the provider ids to which this dispatcher can dispatch.

Blobs already having a provider id not listed here won't be touched on write.

Returns:

a collection containing the provider ids

getBlobProvider

String getBlobProvider(String repositoryName)

Decides which BlobProvider to use to read a blob from the given repository if no prefix is specified in the blob key.

Parameters:

repositoryName - the repository name

Returns:

the blob provider id

getBlobProvider

@Deprecated
default BlobDispatcher.BlobDispatch getBlobProvider(Document doc,
                                                                Blob blob)

Deprecated. since 9.1, use getBlobProvider(Document, Blob, String) instead

Decides which BlobProvider to use to write the given blob, and whether the provider id should be added as prefix to the managed blob key.

Parameters:

doc - the document containing the blob

blob - the blob

Returns:

the blob provider id and whether it should be added as prefix

getBlobProvider

BlobDispatcher.BlobDispatch getBlobProvider(Document doc,
                                            Blob blob,
                                            String xpath)

Decides which BlobProvider to use to write the given blob, and whether the provider id should be added as prefix to the managed blob key.

Parameters:

doc - the document containing the blob

blob - the blob

xpath - the xpath of the blob in the document

Returns:

the blob provider id and whether it should be added as prefix

Since:

9.1

notifyChanges

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

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

Parameters:

doc - the document

xpaths - the set of changed xpaths

Since:

7.3