org.nuxeo.ecm.platform.rendition.service

Class RenditionServiceImpl

java.lang.Object

org.nuxeo.runtime.model.DefaultComponent

org.nuxeo.ecm.platform.rendition.service.RenditionServiceImpl

All Implemented Interfaces:

RenditionService, Adaptable, Component, Extensible, TimestampedService

public class RenditionServiceImpl
extends DefaultComponent
implements RenditionService

Default implementation of RenditionService.

Since:

5.4.1

Author:

Thomas Roger

Field Summary

Fields

Modifier and Type	Field and Description
protected AutomationService	automationService Deprecated. since 7.2. Not used.
static String	DEFAULT_RENDITION_EP
protected static StoredRenditionManager	DEFAULT_STORED_RENDITION_MANAGER
protected DefaultRenditionDescriptor	defaultRenditionDescriptor
protected List<DefaultRenditionDescriptor>	defaultRenditionDescriptors
static String	RENDITION_DEFINITIONS_EP
protected RenditionDefinitionProviderRegistry	renditionDefinitionProviderRegistry
protected RenditionDefinitionRegistry	renditionDefinitionRegistry
protected Map<String,RenditionDefinition>	renditionDefinitions Deprecated. since 7.3.
static String	RENDITON_DEFINION_PROVIDERS_EP
protected ScriptEngineManager	scriptEngineManager
static String	STORED_RENDITION_MANAGERS_EP
protected Deque<StoredRenditionManagerDescriptor>	storedRenditionManagerDescriptors

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

lastModified

Constructor Summary

Constructors

Constructor and Description
RenditionServiceImpl()

Method Summary

Modifier and Type	Method and Description
void	activate(ComponentContext context) Activates the component.
protected DocumentRef	createVersionIfNeeded(DocumentModel source, CoreSession session)
void	deactivate(ComponentContext context) Deactivates the component.
void	deleteStoredRenditions(String repositoryName) Query and delete stored renditions where the related version or live document does not exist anymore.
protected AutomationService	getAutomationService() Deprecated. since 7.2. Not used.
protected RenditionDefinition	getAvailableRenditionDefinition(DocumentModel doc, String renditionName)
List<RenditionDefinition>	getAvailableRenditionDefinitions(DocumentModel doc) Returns a List of RenditionDefinition available on the given Document.
List<Rendition>	getAvailableRenditions(DocumentModel doc) Returns a List of Rendition available on the given Document.
List<Rendition>	getAvailableRenditions(DocumentModel doc, boolean onlyVisible) Returns a List of Rendition available on the given Document.
List<RenditionDefinition>	getDeclaredRenditionDefinitions() Deprecated. since 7.2 because unused
List<RenditionDefinition>	getDeclaredRenditionDefinitionsForProviderType(String providerType) Deprecated. since 7.2 because unused
Rendition	getDefaultRendition(DocumentModel doc, String reason, Map<String,Serializable> extendedInfos) Return the default Rendition object for the given DocumentModel.
protected Rendition	getRendition(DocumentModel doc, RenditionDefinition renditionDefinition, boolean store)
Rendition	getRendition(DocumentModel doc, String renditionName) Return the Rendition object for the given DocumentModel and a rendition definition name.
Rendition	getRendition(DocumentModel doc, String renditionName, boolean store) Return the Rendition object for the given DocumentModel and a rendition definition name.
RenditionDefinition	getRenditionDefinition(String name)
StoredRenditionManager	getStoredRenditionManager()
protected RenditionDefinition	mergeRenditions(RenditionDefinition oldRenditionDefinition, RenditionDefinition newRenditionDefinition)
void	registerContribution(Object contribution, String extensionPoint, ComponentInstance contributor)
protected void	registerRendition(RenditionDefinition renditionDefinition) Deprecated. since 7.3. RenditionDefinitions are store in renditionDefinitionRegistry.
protected void	setupProvider(RenditionDefinition definition) Deprecated. since 7.3. RenditionDefinitions are store in renditionDefinitionRegistry.
protected StoredRendition	storeRendition(DocumentModel sourceDocument, Rendition rendition)
protected DocumentModel	storeRendition(DocumentModel sourceDocument, Rendition rendition, String name) Deprecated. since 8.1
DocumentRef	storeRendition(DocumentModel source, String renditionDefinitionName) Render a document based on the given rendition definition name and returns the stored Rendition DocumentRef.
void	unregisterContribution(Object contribution, String extensionPoint, ComponentInstance contributor)
protected void	unregisterRendition(RenditionDefinition renditionDefinition) Deprecated. since 7.3. RenditionDefinitions are store in renditionDefinitionRegistry.

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

getAdapter, getLastModified, registerExtension, setLastModified, setModifiedNow, start, stop, 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

RENDITION_DEFINITIONS_EP

public static final String RENDITION_DEFINITIONS_EP

See Also:

Constant Field Values

RENDITON_DEFINION_PROVIDERS_EP

public static final String RENDITON_DEFINION_PROVIDERS_EP

See Also:

Constant Field Values

DEFAULT_RENDITION_EP

public static final String DEFAULT_RENDITION_EP

See Also:

Constant Field Values

STORED_RENDITION_MANAGERS_EP

public static final String STORED_RENDITION_MANAGERS_EP

Since:

8.1

See Also:

Constant Field Values

automationService

@Deprecated
protected AutomationService automationService

Deprecated. since 7.2. Not used.

renditionDefinitions

@Deprecated
protected Map<String,RenditionDefinition> renditionDefinitions

Deprecated. since 7.3.

renditionDefinitionRegistry

protected RenditionDefinitionRegistry renditionDefinitionRegistry

Since:

7.3. RenditionDefinitions are store in renditionDefinitionRegistry.

renditionDefinitionProviderRegistry

protected RenditionDefinitionProviderRegistry renditionDefinitionProviderRegistry

defaultRenditionDescriptors

protected List<DefaultRenditionDescriptor> defaultRenditionDescriptors

defaultRenditionDescriptor

protected DefaultRenditionDescriptor defaultRenditionDescriptor

DEFAULT_STORED_RENDITION_MANAGER

protected static final StoredRenditionManager DEFAULT_STORED_RENDITION_MANAGER

storedRenditionManagerDescriptors

protected Deque<StoredRenditionManagerDescriptor> storedRenditionManagerDescriptors

Since:

8.1

scriptEngineManager

protected final ScriptEngineManager scriptEngineManager

Constructor Detail

RenditionServiceImpl

public RenditionServiceImpl()

Method Detail

getStoredRenditionManager

public StoredRenditionManager getStoredRenditionManager()

Since:

8.1

activate

public void activate(ComponentContext context)

Description copied from interface: Component

Activates the component.

This method is called by the runtime when a component is activated.

Specified by:

activate in interface Component

Overrides:

activate in class DefaultComponent

Parameters:

context - the runtime context

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

getRenditionDefinition

public RenditionDefinition getRenditionDefinition(String name)

getDeclaredRenditionDefinitions

@Deprecated
public List<RenditionDefinition> getDeclaredRenditionDefinitions()

Deprecated. since 7.2 because unused

Description copied from interface: RenditionService

Returns a List of registered RenditionDefinition. The order of the List does not depend on the registering order.

Specified by:

getDeclaredRenditionDefinitions in interface RenditionService

getDeclaredRenditionDefinitionsForProviderType

@Deprecated
public List<RenditionDefinition> getDeclaredRenditionDefinitionsForProviderType(String providerType)

Deprecated. since 7.2 because unused

Description copied from interface: RenditionService

Returns a List of registered RenditionDefinition matching a given provider type

Specified by:

getDeclaredRenditionDefinitionsForProviderType in interface RenditionService

getAvailableRenditionDefinitions

public List<RenditionDefinition> getAvailableRenditionDefinitions(DocumentModel doc)

Description copied from interface: RenditionService

Returns a List of RenditionDefinition available on the given Document. The order of the List does not depend on the registering order.

Specified by:

getAvailableRenditionDefinitions in interface RenditionService

storeRendition

public DocumentRef storeRendition(DocumentModel source,
                                  String renditionDefinitionName)

Description copied from interface: RenditionService

Render a document based on the given rendition definition name and returns the stored Rendition DocumentRef.

Only the user launching the render operation has the Read right on the returned document.

Specified by:

storeRendition in interface RenditionService

Parameters:

source - the document to render

renditionDefinitionName - the rendition definition to use

Returns:

the DocumentRef of the newly created Rendition document.

storeRendition

@Deprecated
protected DocumentModel storeRendition(DocumentModel sourceDocument,
                                                   Rendition rendition,
                                                   String name)

Deprecated. since 8.1

storeRendition

protected StoredRendition storeRendition(DocumentModel sourceDocument,
                                         Rendition rendition)

Since:

8.1

createVersionIfNeeded

protected DocumentRef createVersionIfNeeded(DocumentModel source,
                                            CoreSession session)

getAutomationService

@Deprecated
protected AutomationService getAutomationService()

Deprecated. since 7.2. Not used.

registerContribution

public void registerContribution(Object contribution,
                                 String extensionPoint,
                                 ComponentInstance contributor)

Overrides:

registerContribution in class DefaultComponent

registerRendition

@Deprecated
protected void registerRendition(RenditionDefinition renditionDefinition)

Deprecated. since 7.3. RenditionDefinitions are store in renditionDefinitionRegistry.

setupProvider

@Deprecated
protected void setupProvider(RenditionDefinition definition)

Deprecated. since 7.3. RenditionDefinitions are store in renditionDefinitionRegistry.

mergeRenditions

protected RenditionDefinition mergeRenditions(RenditionDefinition oldRenditionDefinition,
                                              RenditionDefinition newRenditionDefinition)

unregisterContribution

public void unregisterContribution(Object contribution,
                                   String extensionPoint,
                                   ComponentInstance contributor)

Overrides:

unregisterContribution in class DefaultComponent

unregisterRendition

@Deprecated
protected void unregisterRendition(RenditionDefinition renditionDefinition)

Deprecated. since 7.3. RenditionDefinitions are store in renditionDefinitionRegistry.

getRendition

public Rendition getRendition(DocumentModel doc,
                              String renditionName)

Description copied from interface: RenditionService

Return the Rendition object for the given DocumentModel and a rendition definition name.

A stored rendition is returned if found and up to date, a new Rendition is created otherwise.

Specified by:

getRendition in interface RenditionService

Parameters:

doc - the document to render

renditionName - the name of the rendition definition

Returns:

the Rendition object

getRendition

public Rendition getRendition(DocumentModel doc,
                              String renditionName,
                              boolean store)

Description copied from interface: RenditionService

Return the Rendition object for the given DocumentModel and a rendition definition name.

A stored rendition is returned if found and up to date, a new (live) Rendition is created otherwise.

If store parameter is true, the new created rendition is stored too and returned

Specified by:

getRendition in interface RenditionService

Parameters:

doc - the document to render

renditionName - the name of the rendition definition

store - indicates if the rendition must be stored

Returns:

the Rendition object

getRendition

protected Rendition getRendition(DocumentModel doc,
                                 RenditionDefinition renditionDefinition,
                                 boolean store)

getAvailableRenditionDefinition

protected RenditionDefinition getAvailableRenditionDefinition(DocumentModel doc,
                                                              String renditionName)

getAvailableRenditions

public List<Rendition> getAvailableRenditions(DocumentModel doc)

Description copied from interface: RenditionService

Returns a List of Rendition available on the given Document.

The order of the List does not depend on the registering order.

The returned rendition may be live or stored

Specified by:

getAvailableRenditions in interface RenditionService

getAvailableRenditions

public List<Rendition> getAvailableRenditions(DocumentModel doc,
                                              boolean onlyVisible)

Description copied from interface: RenditionService

Returns a List of Rendition available on the given Document.

If onlyVisible is true, returns only the rendition marked as visible.

The order of the List does not depend on the registering order.

The returned rendition may be live or stored

Specified by:

getAvailableRenditions in interface RenditionService

deleteStoredRenditions

public void deleteStoredRenditions(String repositoryName)

Description copied from interface: RenditionService

Query and delete stored renditions where the related version or live document does not exist anymore.

Specified by:

deleteStoredRenditions in interface RenditionService

getDefaultRendition

public Rendition getDefaultRendition(DocumentModel doc,
                                     String reason,
                                     Map<String,Serializable> extendedInfos)

Description copied from interface: RenditionService

Return the default Rendition object for the given DocumentModel.

A stored rendition is returned if found and up to date, a new Rendition is created otherwise.

Specified by:

getDefaultRendition in interface RenditionService

Parameters:

doc - the document to render

reason - the reason the rendition is being rendered (optional)

extendedInfos - map of extended info added in the default rendition computation (optional)

Returns:

the default Rendition object