@AlfrescoPublicApi
public interface ContentService
Implementations of this service are primarily responsible for ensuring that the correct store is used to access content, and that reads and writes for the same node reference are routed to the same store instance.
The mechanism for selecting an appropriate store is not prescribed by the interface, but typically the decision will be made on the grounds of content type.
Whereas the content stores have no knowledge of nodes other than their
references, the ContentService
is responsible for
ensuring that all the relevant node-content relationships are maintained.
ContentStore
,
ContentReader
,
ContentWriter
Modifier and Type | Method and Description |
---|---|
List<ContentTransformer> |
getActiveTransformers(String sourceMimetype,
long sourceSize,
String targetMimetype,
TransformationOptions options)
Deprecated.
|
List<ContentTransformer> |
getActiveTransformers(String sourceMimetype,
String targetMimetype,
TransformationOptions options)
Deprecated.
|
ContentTransformer |
getImageTransformer()
Fetch the transformer that is capable of transforming image content.
|
long |
getMaxSourceSizeBytes(String sourceMimetype,
String targetMimetype,
TransformationOptions options)
Returns the maximum source size of any content that may transformed between the supplied
mimetypes using the supplied options.
|
org.alfresco.service.cmr.repository.ContentReader |
getRawReader(String contentUrl)
Fetch content from the low-level stores using a content URL.
|
org.alfresco.service.cmr.repository.ContentReader |
getReader(org.alfresco.service.cmr.repository.NodeRef nodeRef,
org.alfresco.service.namespace.QName propertyQName)
Gets a reader for the content associated with the given node property.
|
long |
getStoreFreeSpace()
Gets the remaing available space in the underlying content store.
|
long |
getStoreTotalSpace()
Gets the total space of the underlying content store (not exclusively Alfresco-controlled binaries).
|
org.alfresco.service.cmr.repository.ContentWriter |
getTempWriter()
Gets a writer to a temporary location.
|
ContentTransformer |
getTransformer(String sourceMimetype,
String targetMimetype)
Fetch the transformer that is capable of transforming the content in the
given source mimetype to the given target mimetype.
|
ContentTransformer |
getTransformer(String sourceUrl,
String sourceMimetype,
long sourceSize,
String targetMimetype,
TransformationOptions options)
Fetch the transformer that is capable of transforming the content in the
given source mimetype to the given target mimetype with the provided transformation
options.
|
ContentTransformer |
getTransformer(String sourceMimetype,
String targetMimetype,
TransformationOptions options)
Deprecated.
use overloaded method with sourceSize parameter.
|
List<ContentTransformer> |
getTransformers(String sourceUrl,
String sourceMimetype,
long sourceSize,
String targetMimetype,
TransformationOptions options)
Fetch the transformers that are capable of transforming the content in the
given source mimetype to the given target mimetype with the provided transformation
options.
|
org.alfresco.service.cmr.repository.ContentWriter |
getWriter(org.alfresco.service.cmr.repository.NodeRef nodeRef,
org.alfresco.service.namespace.QName propertyQName,
boolean update)
Get a content writer for the given node property, choosing to optionally have
the node property updated automatically when the content stream closes.
|
boolean |
isTransformable(org.alfresco.service.cmr.repository.ContentReader reader,
org.alfresco.service.cmr.repository.ContentWriter writer)
Deprecated.
|
boolean |
isTransformable(org.alfresco.service.cmr.repository.ContentReader reader,
org.alfresco.service.cmr.repository.ContentWriter writer,
TransformationOptions options)
Returns whether a transformer exists that can read the content from
the reader and write the content back out to the writer with the
provided tranformation options.
|
void |
transform(org.alfresco.service.cmr.repository.ContentReader reader,
org.alfresco.service.cmr.repository.ContentWriter writer)
Transforms the content from the reader and writes the content
back out to the writer.
|
void |
transform(org.alfresco.service.cmr.repository.ContentReader reader,
org.alfresco.service.cmr.repository.ContentWriter writer,
Map<String,Object> options)
Deprecated.
As of release 3.0 the TransformOptions class should be used to pass transformation options
to a transformation execution.
|
void |
transform(org.alfresco.service.cmr.repository.ContentReader reader,
org.alfresco.service.cmr.repository.ContentWriter writer,
TransformationOptions options) |
long getStoreTotalSpace()
long getStoreFreeSpace()
@Auditable(parameters="contentUrl") org.alfresco.service.cmr.repository.ContentReader getRawReader(String contentUrl)
null is never returned, but the reader should always be checked for
existence
.
contentUrl
- a content store URL@Auditable(parameters={"nodeRef","propertyQName"}) org.alfresco.service.cmr.repository.ContentReader getReader(org.alfresco.service.cmr.repository.NodeRef nodeRef, org.alfresco.service.namespace.QName propertyQName) throws org.alfresco.service.cmr.repository.InvalidNodeRefException, org.alfresco.service.cmr.dictionary.InvalidTypeException
If a content URL is present for the given node then a reader must
be returned. The exists
method should then
be used to detect 'missing' content.
nodeRef
- a reference to a node having a content propertypropertyQName
- the name of the property, which must be of type contentInvalidNodeRefException
- if the node doesn't existorg.alfresco.service.cmr.dictionary.InvalidTypeException
- if the node is not of type contentFileContentReader.getSafeContentReader(ContentReader, String, Object[])
@Auditable(parameters={"nodeRef","propertyQName","update"}) org.alfresco.service.cmr.repository.ContentWriter getWriter(org.alfresco.service.cmr.repository.NodeRef nodeRef, org.alfresco.service.namespace.QName propertyQName, boolean update) throws org.alfresco.service.cmr.repository.InvalidNodeRefException, org.alfresco.service.cmr.dictionary.InvalidTypeException
If the update flag is off, then the state of the node property will remain unchanged regardless of the state of the written binary data. If the flag is on, then the node property will be updated on the same thread as the code that closed the write channel.
If no node is supplied, then the writer will provide a stream into the backing content store, but will not be associated with any new or previous content.
NOTE: The content URL provided will be registered for automatic cleanup in the event that the transaction, in which this method was called, rolls back. If the transaction is successful, the writer may still be open and available for use but the underlying binary will not be cleaned up subsequently. The recommended pattern is to group calls to retrieve the writer in the same transaction as the calls to subsequently update and close the write stream - including setting of the related content properties.nodeRef
- a reference to a node having a content property, or null
to just get a valid writer into a backing content store.propertyQName
- the name of the property, which must be of type contentupdate
- true if the property must be updated atomically when the content write
stream is closed (attaches a listener to the stream); false if the client code
will perform the updates itself.InvalidNodeRefException
- if the node doesn't existorg.alfresco.service.cmr.dictionary.InvalidTypeException
- if the node property is not of type content@Auditable org.alfresco.service.cmr.repository.ContentWriter getTempWriter()
@Auditable(parameters={"reader","writer"}) void transform(org.alfresco.service.cmr.repository.ContentReader reader, org.alfresco.service.cmr.repository.ContentWriter writer) throws NoTransformerException, org.alfresco.service.cmr.repository.ContentIOException
The mimetypes used for the transformation must be set both on
the reader
and on the
writer
.
reader
- the source content location and mimetypewriter
- the target content location and mimetypeNoTransformerException
- if no transformer exists for the
given source and target mimetypes of the reader and writerContentIOException
- if the transformation fails@Auditable(parameters={"reader","writer","options"}) @Deprecated void transform(org.alfresco.service.cmr.repository.ContentReader reader, org.alfresco.service.cmr.repository.ContentWriter writer, Map<String,Object> options) throws NoTransformerException, org.alfresco.service.cmr.repository.ContentIOException
reader
- the source content location and mimetypewriter
- the target content location and mimetypeoptions
- the options for the transformationNoTransformerException
- if no transformer exists for the
given source and target mimetypes of the reader and writerContentIOException
- if the transformation failstransform(ContentReader, ContentWriter)
,
A map of transform options can be provided.
@Auditable(parameters={"reader","writer","options"}) void transform(org.alfresco.service.cmr.repository.ContentReader reader, org.alfresco.service.cmr.repository.ContentWriter writer, TransformationOptions options) throws NoTransformerException, org.alfresco.service.cmr.repository.ContentIOException
reader
- the source content location and mimetypewriter
- the target content location and mimetypeoptions
- the options for the transformationNoTransformerException
- if no transformer exists for the
given source and target mimetypes of the reader and writerContentIOException
- if the transformation failsA transformation options can be provided.
@Auditable(parameters={"sourceMimetype","targetMimetype"}) ContentTransformer getTransformer(String sourceMimetype, String targetMimetype)
Since no transformation options are provided only the source and destination mimetypes are considered when getting the correct transformer.
sourceMimetype
- the source mimetypetargetMimetype
- the target mimetypegetTransformer(String, String, long, String, TransformationOptions)
,
ContentAccessor.getMimetype()
@Auditable(parameters={"sourceMimetype","sourceSize","targetMimetype","options"}) List<ContentTransformer> getTransformers(String sourceUrl, String sourceMimetype, long sourceSize, String targetMimetype, TransformationOptions options)
sourceUrl
- TODOsourceMimetype
- the source mimetypesourceSize
- the source size (bytes). Ignored if negative.targetMimetype
- the target mimetypeoptions
- the transformation options@Auditable(parameters={"sourceMimetype","sourceSize","targetMimetype","options"}) ContentTransformer getTransformer(String sourceUrl, String sourceMimetype, long sourceSize, String targetMimetype, TransformationOptions options)
sourceUrl
- TODOsourceMimetype
- the source mimetypesourceSize
- the source size (bytes). Ignored if negative.targetMimetype
- the target mimetypeoptions
- the transformation optionsContentAccessor.getMimetype()
ContentTransformer getTransformer(String sourceMimetype, String targetMimetype, TransformationOptions options)
@Auditable(parameters={"sourceMimetype","targetMimetype","options"}) long getMaxSourceSizeBytes(String sourceMimetype, String targetMimetype, TransformationOptions options)
sourceMimetype
- source mime typetargetMimetype
- target mime typeoptions
- transformation options@Auditable(parameters={"sourceMimetype","sourceSize","targetMimetype","options"}) List<ContentTransformer> getActiveTransformers(String sourceMimetype, long sourceSize, String targetMimetype, TransformationOptions options)
getTransformers(String, String, long, String, TransformationOptions)
.List<ContentTransformer> getActiveTransformers(String sourceMimetype, String targetMimetype, TransformationOptions options)
getTransformers(String, String, long, String, TransformationOptions)
.@Auditable ContentTransformer getImageTransformer()
@Auditable(parameters={"reader","writer"}) boolean isTransformable(org.alfresco.service.cmr.repository.ContentReader reader, org.alfresco.service.cmr.repository.ContentWriter writer)
isTransformable(ContentReader, ContentWriter, TransformationOptions)
.@Auditable(parameters={"reader","writer","options"}) boolean isTransformable(org.alfresco.service.cmr.repository.ContentReader reader, org.alfresco.service.cmr.repository.ContentWriter writer, TransformationOptions options)
If you are about to call transform(ContentReader, ContentWriter, TransformationOptions)
it is best NOT to call this method first as it must perform the same steps and will throw
NoTransformerException if there are no transformers.
The mimetypes used for the transformation must be set both on
the reader
and on the
writer
.
reader
- the source content location and mimetypewriter
- the target content location and mimetypeoptions
- the transformation optionsCopyright © 2005–2017 Alfresco Software. All rights reserved.