Package org.nuxeo.ecm.blob

Class AbstractCloudBinaryManager

java.lang.Object

org.nuxeo.ecm.core.blob.binary.AbstractBinaryManager

org.nuxeo.ecm.core.blob.binary.CachingBinaryManager

org.nuxeo.ecm.blob.AbstractCloudBinaryManager

All Implemented Interfaces:

BinaryManager, BlobProvider

Direct Known Subclasses:

AzureBinaryManager, GoogleStorageBinaryManager, S3BinaryManager

@Deprecated(since="2023.9")
public abstract class AbstractCloudBinaryManager
extends CachingBinaryManager
implements BlobProvider

Deprecated.

since 2023.9, use BlobStoreBlobProvider instead

Since:

7.10

Author:

Arnaud Kervern

Field Summary

Fields

Modifier and Type	Field	Description
static final String	CACHE_COUNT_PROPERTY	Deprecated.
static final String	CACHE_MIN_AGE_PROPERTY	Deprecated.
static final String	CACHE_SIZE_PROPERTY	Deprecated.
static final String	DEFAULT_CACHE_COUNT	Deprecated.
static final String	DEFAULT_CACHE_MIN_AGE	Deprecated.
static final String	DEFAULT_CACHE_SIZE	Deprecated.
static final String	DEFAULT_DIRECTDOWNLOAD	Deprecated. since 2023.7, unused.
static final int	DEFAULT_DIRECTDOWNLOAD_EXPIRE	Deprecated.
static final String	DIGEST_ALGORITHM_PROPERTY	Deprecated.
protected boolean	directDownload	Deprecated.
static final String	DIRECTDOWNLOAD_EXPIRE_PROPERTY	Deprecated. since 2023.7, use BlobProviderDescriptor.DIRECTDOWNLOAD_EXPIRE_PROPERTY instead.
static final String	DIRECTDOWNLOAD_PROPERTY	Deprecated. since 2023.7, use BlobProviderDescriptor.DIRECTDOWNLOAD_PROPERTY instead.
protected int	directDownloadExpire	Deprecated.
protected String	namespace	Deprecated.
protected boolean	transientFlag	Deprecated.

Fields inherited from class org.nuxeo.ecm.core.blob.binary.CachingBinaryManager

cachedir, fileCache, fileStorage

Fields inherited from class org.nuxeo.ecm.core.blob.binary.AbstractBinaryManager

blobProviderId, DEFAULT_DEPTH, DEFAULT_DIGEST, descriptor, digestPattern, DIGESTS_BY_LENGTH, garbageCollector, MAX_BUF_SIZE, MD5_DIGEST, MD5_DIGEST_LENGTH, MIN_BUF_SIZE, properties, SHA1_DIGEST, SHA1_DIGEST_LENGTH, SHA256_DIGEST, SHA256_DIGEST_LENGTH

Fields inherited from interface org.nuxeo.ecm.core.blob.binary.BinaryManager

PROP_KEY, PROP_PATH

Constructor Summary

Constructors

Constructor	Description
AbstractCloudBinaryManager()	Deprecated.

Method Summary

Modifier and Type	Method	Description
BinaryManager	getBinaryManager()	Deprecated. Gets the associated binary manager, if any.
protected boolean	getBooleanProperty(String key)	Deprecated. Gets a boolean property.
protected String	getContentDispositionHeader(Blob blob, javax.servlet.http.HttpServletRequest servletRequest)	Deprecated.
protected String	getContentTypeHeader(Blob blob)	Deprecated.
protected String	getDefaultDigestAlgorithm()	Deprecated. Gets the default message digest to use to hash binaries.
protected abstract FileStorage	getFileStorage()	Deprecated.
protected int	getIntProperty(String key)	Deprecated. Gets an integer property, or -1 if undefined.
protected int	getIntProperty(String key, int defaultValue)	Deprecated. Gets an integer property, or defaultValue if undefined.
Map<String,String>	getProperties()	Deprecated. Returns the properties of the blob provider.
protected String	getProperty(String propertyName)	Deprecated.
protected String	getProperty(String propertyName, String defaultValue)	Deprecated.
protected URI	getRemoteUri(String digest, ManagedBlob blob, javax.servlet.http.HttpServletRequest servletRequest)	Deprecated.
String	getSystemPropertyName(String propertyName)	Deprecated.
protected abstract String	getSystemPropertyPrefix()	Deprecated. Gets the prefix used for configuration using system properties.
URI	getURI(ManagedBlob blob, BlobManager.UsageHint hint, javax.servlet.http.HttpServletRequest servletRequest)	Deprecated. Gets an URI for the content of a managed blob.
void	initialize(String blobProviderId, Map<String,String> properties)	Deprecated. Initializes the binary manager.
protected abstract BinaryGarbageCollector	instantiateGarbageCollector()	Deprecated.
protected boolean	isDirectDownload()	Deprecated.
boolean	isTransient()	Deprecated. Checks whether this blob provider is transient: blobs may disappear after a while, so a caller should not rely on them being available forever.
boolean	performsExternalAccessControl(BlobInfo blobInfo)	Deprecated. Checks if the blob provider performs external access control checks.
Blob	readBlob(BlobInfo blobInfo)	Deprecated. Reads a Blob from storage.
abstract void	removeBinaries(Collection<String> digests)	Deprecated. Remove definitively a set of binaries
protected abstract void	setupCloudClient()	Deprecated. Configure Cloud client using properties
boolean	supportsUserUpdate()	Deprecated. Checks if user update is supported.
protected boolean	supportsUserUpdateDefaultTrue()	Deprecated.
String	writeBlob(Blob blob)	Deprecated. Writes a Blob to storage and returns information about it.

Methods inherited from class org.nuxeo.ecm.core.blob.binary.CachingBinaryManager

close, getBinary, getBinary, getFile, initializeCache, initializeCache, initializeCache

Methods inherited from class org.nuxeo.ecm.core.blob.binary.AbstractBinaryManager

computeDigestPattern, getBinary, getDescriptor, getDigestAlgorithm, getGarbageCollector, isValidDigest, setDescriptor, storeAndDigest, toHexString

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.nuxeo.ecm.core.blob.BlobProvider

allowByteRange, allowDirectDownload, canConvert, close, deleteBlob, getAppLinks, getAvailableConversions, getBinaryGarbageCollector, getFile, getStatus, getStream, getStream, getThumbnail, hasCreateFromKeyPermission, isColdStorageMode, isRecordMode, isTransactional, isVersion, readBlob, supportsSync, updateBlob, writeBlob

Field Details

directDownload

protected boolean directDownload

Deprecated.

directDownloadExpire

protected int directDownloadExpire

Deprecated.

transientFlag

protected boolean transientFlag

Deprecated.

namespace

protected String namespace

Deprecated.

CACHE_SIZE_PROPERTY

public static final String CACHE_SIZE_PROPERTY

Deprecated.

See Also:

• Constant Field Values

CACHE_COUNT_PROPERTY

public static final String CACHE_COUNT_PROPERTY

Deprecated.

See Also:

• Constant Field Values

CACHE_MIN_AGE_PROPERTY

public static final String CACHE_MIN_AGE_PROPERTY

Deprecated.

See Also:

• Constant Field Values

DEFAULT_CACHE_SIZE

public static final String DEFAULT_CACHE_SIZE

Deprecated.

See Also:

• Constant Field Values

DEFAULT_CACHE_COUNT

public static final String DEFAULT_CACHE_COUNT

Deprecated.

See Also:

• Constant Field Values

DEFAULT_CACHE_MIN_AGE

public static final String DEFAULT_CACHE_MIN_AGE

Deprecated.

See Also:

• Constant Field Values

DIRECTDOWNLOAD_PROPERTY

@Deprecated
public static final String DIRECTDOWNLOAD_PROPERTY

Deprecated.

since 2023.7, use BlobProviderDescriptor.DIRECTDOWNLOAD_PROPERTY instead.

See Also:

• Constant Field Values

DEFAULT_DIRECTDOWNLOAD

@Deprecated
public static final String DEFAULT_DIRECTDOWNLOAD

Deprecated.

since 2023.7, unused.

See Also:

• Constant Field Values

DIRECTDOWNLOAD_EXPIRE_PROPERTY

@Deprecated
public static final String DIRECTDOWNLOAD_EXPIRE_PROPERTY

Deprecated.

since 2023.7, use BlobProviderDescriptor.DIRECTDOWNLOAD_EXPIRE_PROPERTY instead.

See Also:

• Constant Field Values

DEFAULT_DIRECTDOWNLOAD_EXPIRE

public static final int DEFAULT_DIRECTDOWNLOAD_EXPIRE

Deprecated.

See Also:

• Constant Field Values

DIGEST_ALGORITHM_PROPERTY

public static final String DIGEST_ALGORITHM_PROPERTY

Deprecated.

See Also:

• Constant Field Values

Constructor Details

AbstractCloudBinaryManager

public AbstractCloudBinaryManager()

Deprecated.

Method Details

getSystemPropertyPrefix

protected abstract String getSystemPropertyPrefix()

Deprecated.

Gets the prefix used for configuration using system properties.

getFileStorage

protected abstract FileStorage getFileStorage()

Deprecated.

instantiateGarbageCollector

protected abstract BinaryGarbageCollector instantiateGarbageCollector()

Deprecated.

removeBinaries

public abstract void removeBinaries(Collection<String> digests)

Deprecated.

Description copied from interface: BinaryManager

Remove definitively a set of binaries

Specified by:

removeBinaries in interface BinaryManager

Overrides:

removeBinaries in class AbstractBinaryManager

Parameters:

digests - a set of digests, must not be null.

setupCloudClient

protected abstract void setupCloudClient()
                                  throws IOException

Deprecated.

Configure Cloud client using properties

Throws:

IOException

initialize

public void initialize(String blobProviderId,
 Map<String,String> properties)
                throws IOException

Deprecated.

Description copied from interface: BinaryManager

Initializes the binary manager.

Specified by:

initialize in interface BinaryManager

Specified by:

initialize in interface BlobProvider

Overrides:

initialize in class CachingBinaryManager

Parameters:

blobProviderId - the blob provider id for this binary manager

properties - initialization properties

Throws:

IOException

getBinaryManager

public BinaryManager getBinaryManager()

Deprecated.

Description copied from interface: BlobProvider

Gets the associated binary manager, if any.

Specified by:

getBinaryManager in interface BlobProvider

Returns:

the binary manager, or null

readBlob

public Blob readBlob(BlobInfo blobInfo)
              throws IOException

Deprecated.

Description copied from interface: BlobProvider

Reads a Blob from storage.

Specified by:

readBlob in interface BlobProvider

Parameters:

blobInfo - the blob information

Returns:

the blob

Throws:

IOException

writeBlob

public String writeBlob(Blob blob)
                 throws IOException

Deprecated.

Description copied from interface: BlobProvider

Writes a Blob to storage and returns information about it.

Called to store a user-created blob.

Specified by:

writeBlob in interface BlobProvider

Parameters:

blob - the blob

Returns:

the blob key

Throws:

IOException

performsExternalAccessControl

public boolean performsExternalAccessControl(BlobInfo blobInfo)

Deprecated.

Description copied from interface: BlobProvider

Checks if the blob provider performs external access control checks.

Specified by:

performsExternalAccessControl in interface BlobProvider

Parameters:

blobInfo - the blob information to be read

Returns:

true if the provider performs security checks before reading a blob, false otherwise

supportsUserUpdate

public boolean supportsUserUpdate()

Deprecated.

Description copied from interface: BlobProvider

Checks if user update is supported.

A user update refers to the fact that a blob from this provider may be overwritten with another blob, wherever the original blob may occur (usually in a document property).

Specified by:

supportsUserUpdate in interface BlobProvider

Returns:

true if user update is supported

supportsUserUpdateDefaultTrue

protected boolean supportsUserUpdateDefaultTrue()

Deprecated.

getURI

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

Deprecated.

Description copied from interface: BlobProvider

Gets an URI for the content of a managed blob.

Specified by:

getURI in interface BlobProvider

Parameters:

blob - the managed blob

hint - BlobManager.UsageHint

servletRequest - the servlet request, or null

Returns:

the URI, or null if none available

Throws:

IOException

isDirectDownload

protected boolean isDirectDownload()

Deprecated.

getRemoteUri

protected URI getRemoteUri(String digest,
 ManagedBlob blob,
 javax.servlet.http.HttpServletRequest servletRequest)
                    throws IOException

Deprecated.

Throws:

IOException

getProperty

protected String getProperty(String propertyName)

Deprecated.

getProperty

protected String getProperty(String propertyName,
 String defaultValue)

Deprecated.

getIntProperty

protected int getIntProperty(String key)

Deprecated.

Gets an integer property, or -1 if undefined.

getIntProperty

protected int getIntProperty(String key,
 int defaultValue)

Deprecated.

Gets an integer property, or defaultValue if undefined.

Since:

11.4

getBooleanProperty

protected boolean getBooleanProperty(String key)

Deprecated.

Gets a boolean property.

Since:

10.3

getSystemPropertyName

public String getSystemPropertyName(String propertyName)

Deprecated.

getContentTypeHeader

protected String getContentTypeHeader(Blob blob)

Deprecated.

getContentDispositionHeader

protected String getContentDispositionHeader(Blob blob,
 javax.servlet.http.HttpServletRequest servletRequest)

Deprecated.

getDefaultDigestAlgorithm

protected String getDefaultDigestAlgorithm()

Deprecated.

Description copied from class: AbstractBinaryManager

Gets the default message digest to use to hash binaries.

Overrides:

getDefaultDigestAlgorithm in class AbstractBinaryManager

isTransient

public boolean isTransient()

Deprecated.

Description copied from interface: BlobProvider

Checks whether this blob provider is transient: blobs may disappear after a while, so a caller should not rely on them being available forever.

Specified by:

isTransient in interface BlobProvider

getProperties

public Map<String,String> getProperties()

Deprecated.

Description copied from interface: BlobProvider

Returns the properties of the blob provider.

Specified by:

getProperties in interface BlobProvider