org.alfresco.service.cmr.rendition
Interface RenditionService

All Superinterfaces:
RenditionDefinitionPersister
All Known Implementing Classes:
RenditionServiceImpl

public interface RenditionService
extends RenditionDefinitionPersister

The Rendition service.


Field Summary
static java.lang.String PARAM_DESTINATION_NODE
          This optional NodeRef parameter specifies an existing NodeRef to use as the rendition node.
static java.lang.String PARAM_DESTINATION_PATH_TEMPLATE
          This optional String parameter indicates where the rendition will be created.
static java.lang.String PARAM_IS_COMPONENT_RENDITION
          This optional boolean parameter specified whether the rendition is a component within a composite rendition.
static java.lang.String PARAM_ORPHAN_EXISTING_RENDITION
          This optional Boolean flag parameter determines whether an existing rendition is moved or orphaned.
static java.lang.String PARAM_RENDITION_NODETYPE
          This optional QName parameter specifies what the node type of the created rendition will be.
 
Method Summary
 CompositeRenditionDefinition createCompositeRenditionDefinition(org.alfresco.service.namespace.QName renditionName)
          Creates a new CompositeRenditionDefinition and sets the rendition name and the rendering engine name to the specified values.
 RenditionDefinition createRenditionDefinition(org.alfresco.service.namespace.QName renditionName, java.lang.String renderingEngineName)
          Creates a new RenditionDefinition and sets the rendition name and the rendering engine name to the specified values.
 RenderingEngineDefinition getRenderingEngineDefinition(java.lang.String name)
          Returns the RenderingEngineDefinition associated with the specified rendering engine name.
 java.util.List getRenderingEngineDefinitions()
           
 org.alfresco.service.cmr.repository.ChildAssociationRef getRenditionByName(org.alfresco.service.cmr.repository.NodeRef node, org.alfresco.service.namespace.QName renditionName)
          This method gets the rendition of the specified node identified by the provided rendition name.
 java.util.List getRenditions(org.alfresco.service.cmr.repository.NodeRef node)
          This method gets all the renditions of the specified node.
 java.util.List getRenditions(org.alfresco.service.cmr.repository.NodeRef node, java.lang.String mimeTypePrefix)
          This method gets all the renditions of the specified node filtered by MIME-type prefix.
 org.alfresco.service.cmr.repository.ChildAssociationRef getSourceNode(org.alfresco.service.cmr.repository.NodeRef renditionNode)
          This method gets the source node for the specified rendition node.
 boolean isRendition(org.alfresco.service.cmr.repository.NodeRef node)
          This method returns true if the specified NodeRef is a valid rendition node, else false.
 org.alfresco.service.cmr.repository.ChildAssociationRef render(org.alfresco.service.cmr.repository.NodeRef sourceNode, org.alfresco.service.namespace.QName renditionDefinitionQName)
          This method synchronously renders content as specified by the given rendition name.
 void render(org.alfresco.service.cmr.repository.NodeRef sourceNode, org.alfresco.service.namespace.QName renditionDefinitionQName, RenderCallback callback)
          This method asynchronously renders content as specified by the given rendition definition name.
 org.alfresco.service.cmr.repository.ChildAssociationRef render(org.alfresco.service.cmr.repository.NodeRef sourceNode, RenditionDefinition renditionDefinition)
          This method synchronously renders content as specified by the given RenditionDefinition.
 void render(org.alfresco.service.cmr.repository.NodeRef sourceNode, RenditionDefinition renditionDefinition, RenderCallback callback)
          This method asynchronously renders content as specified by the given RenditionDefinition.
 
Methods inherited from interface org.alfresco.repo.rendition.RenditionDefinitionPersister
loadRenditionDefinition, loadRenditionDefinitions, loadRenditionDefinitions, saveRenditionDefinition
 

Field Detail

PARAM_DESTINATION_NODE

static final java.lang.String PARAM_DESTINATION_NODE
This optional NodeRef parameter specifies an existing NodeRef to use as the rendition node. Properties on this node (including the content property cm:content) will be updated as required but the location and name of the node will not change. This parameter takes precedence over PARAM_DESTINATION_PATH_TEMPLATE.

See Also:
Constant Field Values

PARAM_DESTINATION_PATH_TEMPLATE

static final java.lang.String PARAM_DESTINATION_PATH_TEMPLATE
This optional String parameter indicates where the rendition will be created. The parameter may specify either the actual file path to the rendition or it may specify a Freemarker template which can be resolved to a file path. In either case the path is relative to the root node of the store in which the source node exists. If the parameter PARAM_DESTINATION_NODE has been set then this parameter will be ignored.

See Also:
Constant Field Values

PARAM_RENDITION_NODETYPE

static final java.lang.String PARAM_RENDITION_NODETYPE
This optional QName parameter specifies what the node type of the created rendition will be. If no type is specified then this defaults to cm:content.

See Also:
Constant Field Values

PARAM_ORPHAN_EXISTING_RENDITION

static final java.lang.String PARAM_ORPHAN_EXISTING_RENDITION
This optional Boolean flag parameter determines whether an existing rendition is moved or orphaned. If the source node already has a rendition and this parameter is false the old rendition will be moved to the new destination location and updated appropriately. If this parameter is set to true then the old rendition will be left in its current location and the rold rendition association from the source node to the old rendition will be deleted.

See Also:
Constant Field Values

PARAM_IS_COMPONENT_RENDITION

static final java.lang.String PARAM_IS_COMPONENT_RENDITION
This optional boolean parameter specified whether the rendition is a component within a composite rendition. Such component renditions should not execute the standard pre- and post-rendition behaviour as it will be taken care of by the CompositeRenderingEngine's execution.

See Also:
Constant Field Values
Method Detail

getRenderingEngineDefinition

@NotAuditable
RenderingEngineDefinition getRenderingEngineDefinition(java.lang.String name)
Returns the RenderingEngineDefinition associated with the specified rendering engine name.

Parameters:
name - The rendering engine name.
Returns:
The RenderingEngineDefinition or null.

getRenderingEngineDefinitions

@NotAuditable
java.util.List getRenderingEngineDefinitions()
Returns:
A List of all available RenderingEngineDefinition s.

createRenditionDefinition

@NotAuditable
RenditionDefinition createRenditionDefinition(org.alfresco.service.namespace.QName renditionName,
                                                           java.lang.String renderingEngineName)
Creates a new RenditionDefinition and sets the rendition name and the rendering engine name to the specified values.

Parameters:
renditionName - A unique identifier used to specify the created RenditionDefinition.
renderingEngineName - The name of the rendering engine associated with this RenditionDefinition.
Returns:
the created RenditionDefinition.

createCompositeRenditionDefinition

@NotAuditable
CompositeRenditionDefinition createCompositeRenditionDefinition(org.alfresco.service.namespace.QName renditionName)
Creates a new CompositeRenditionDefinition and sets the rendition name and the rendering engine name to the specified values.

Parameters:
renditionName - A unique identifier used to specify the created RenditionDefinition.
Returns:
the created CompositeRenditionDefinition.

getRenditions

@NotAuditable
java.util.List getRenditions(org.alfresco.service.cmr.repository.NodeRef node)
This method gets all the renditions of the specified node.

Returns:
a list of ChildAssociationRefs which link the source node to the renditions.

getRenditions

@NotAuditable
java.util.List getRenditions(org.alfresco.service.cmr.repository.NodeRef node,
                                          java.lang.String mimeTypePrefix)
This method gets all the renditions of the specified node filtered by MIME-type prefix. Renditions whose MIME-type string startsWith the prefix will be returned.

Parameters:
node - the source node for the renditions
mimeTypePrefix - a prefix to check against the rendition MIME-types. This must not be null and must not be an empty String
Returns:
a list of ChildAssociationRefs which link the source node to the filtered renditions.

getRenditionByName

@NotAuditable
org.alfresco.service.cmr.repository.ChildAssociationRef getRenditionByName(org.alfresco.service.cmr.repository.NodeRef node,
                                                                                        org.alfresco.service.namespace.QName renditionName)
This method gets the rendition of the specified node identified by the provided rendition name.

Parameters:
node - the source node for the renditions
renditionName - the renditionName used to identify a rendition.
Returns:
the ChildAssociationRef which links the source node to the rendition or null if there is no such rendition.

isRendition

@NotAuditable
boolean isRendition(org.alfresco.service.cmr.repository.NodeRef node)
This method returns true if the specified NodeRef is a valid rendition node, else false. A nodeRef is a rendition node if it has the rn:rendition aspect (or sub-aspect) applied.

Parameters:
node -
Returns:
true if a rendition, else false

getSourceNode

@NotAuditable
org.alfresco.service.cmr.repository.ChildAssociationRef getSourceNode(org.alfresco.service.cmr.repository.NodeRef renditionNode)
This method gets the source node for the specified rendition node. There should only be one source node for any given rendition node.

Parameters:
renditionNode - the nodeRef holding the rendition.
Returns:
the ChildAssociationRef whose parentNodeRef is the source node, or null if there is no source node.
See Also:
RenditionService.isRendition(NodeRef)

render

@NotAuditable
org.alfresco.service.cmr.repository.ChildAssociationRef render(org.alfresco.service.cmr.repository.NodeRef sourceNode,
                                                                            RenditionDefinition renditionDefinition)
This method synchronously renders content as specified by the given RenditionDefinition. The content to be rendered is provided by the specified source node.

Parameters:
sourceNode - the node from which the content is retrieved.
renditionDefinition - this fully specifies the rendition which is to be performed.
Returns:
a child association reference which is the link from the source node to the newly rendered content.
Throws:
RenditionServiceException - if there is a problem in rendering the given sourceNode

render

@NotAuditable
void render(org.alfresco.service.cmr.repository.NodeRef sourceNode,
                         RenditionDefinition renditionDefinition,
                         RenderCallback callback)
This method asynchronously renders content as specified by the given RenditionDefinition. The content to be rendered is provided by the specified source node.

Parameters:
sourceNode - the node from which the content is retrieved.
renditionDefinition - this fully specifies the rendition which is to be performed.
callback - a callback object to handle the ultimate result of the rendition.

render

@NotAuditable
org.alfresco.service.cmr.repository.ChildAssociationRef render(org.alfresco.service.cmr.repository.NodeRef sourceNode,
                                                                            org.alfresco.service.namespace.QName renditionDefinitionQName)
This method synchronously renders content as specified by the given rendition name. The content to be rendered is provided by the specified source node.

The Rendition Definition will be loaded from the standard location as system thus allowing rendition definitions to be used even when the Data Dictionary has restricted read access.

Parameters:
sourceNode - the node from which the content is retrieved.
renditionDefinitionQName - the rendition definition which is to be performed.
Returns:
a child association reference which is the link from the source node to the newly rendered content.
Throws:
RenditionServiceException - if there is a problem in rendering the given sourceNode
Since:
3.4.2

render

@NotAuditable
void render(org.alfresco.service.cmr.repository.NodeRef sourceNode,
                         org.alfresco.service.namespace.QName renditionDefinitionQName,
                         RenderCallback callback)
This method asynchronously renders content as specified by the given rendition definition name. The content to be rendered is provided by the specified source node.

The Rendition Definition will be loaded from the standard location as system thus allowing rendition definitions to be used even when the Data Dictionary has restricted read access.

Parameters:
sourceNode - the node from which the content is retrieved.
renditionDefinitionQName - the rendition definition which is to be performed.
callback - a callback object to handle the ultimate result of the rendition.
Since:
3.4.2


Copyright © 2005 - 2010 Alfresco Software, Inc. All Rights Reserved.