Package 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	Description
static final String	DEFAULT_RENDITION_EP
protected static final StoredRenditionManager	DEFAULT_STORED_RENDITION_MANAGER
protected List<DefaultRenditionDescriptor>	defaultRenditionDescriptors
static final String	RENDITION_DEFINITIONS_EP
protected Map<String,RenditionDefinitionProviderDescriptor>	renditionDefinitionProviders
protected Map<String,RenditionDefinition>	renditionDefinitions
static final String	RENDITON_DEFINION_PROVIDERS_EP
protected final ScriptEngineManager	scriptEngineManager
static final String	STORED_RENDITION_MANAGERS_EP
protected Deque<StoredRenditionManagerDescriptor>	storedRenditionManagerDescriptors

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

lastModified, name

Constructor Summary

Constructors

Constructor	Description
RenditionServiceImpl()

Method Summary

Modifier and Type	Method	Description
protected boolean	canUseRenditionDefinition(RenditionDefinition renditionDefinition, DocumentModel doc)
protected boolean	canUseRenditionDefinitionProvider(RenditionDefinitionProviderDescriptor renditionDefinitionProviderDescriptor, DocumentModel doc)
protected ActionContext	createActionContext(DocumentModel doc)
protected DocumentRef	createVersionIfNeeded(DocumentModel source, CoreSession session)
void	deleteStoredRenditions(String repositoryName)	Query and delete stored renditions where the related version or live document does not exist anymore.
RenditionDefinition	getAvailableRenditionDefinition(DocumentModel doc, String renditionName)	Returns the RenditionDefinition available on the given document for the given rendition definition name.
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()	Returns a List of registered RenditionDefinition.
Rendition	getDefaultRendition(DocumentModel doc, String reason, boolean store, Map<String,Serializable> extendedInfos)	Return the default Rendition object for the given DocumentModel.
Rendition	getDefaultRendition(DocumentModel doc, String reason, Map<String,Serializable> extendedInfos)	Same as RenditionService.getDefaultRendition(DocumentModel, String, boolean, Map) with store parameter set to false.
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.
protected Rendition	getRendition(DocumentModel doc, RenditionDefinition renditionDefinition, boolean store)
protected RenditionDefinition	getRenditionDefinitionFromDefinition(String name)
protected RenditionDefinition	getRenditionDefinitionFromProvider(String name, DocumentModel doc)
protected List<RenditionDefinition>	getRenditionDefinitionsFromDefinition(DocumentModel doc)
protected List<RenditionDefinition>	getRenditionDefinitionsFromProvider(DocumentModel doc)
protected Optional<Rendition>	getRenditionSafe(DocumentModel doc, String defaultRenditionName, boolean store)
StoredRenditionManager	getStoredRenditionManager()
DocumentModel	publishRendition(DocumentModel doc, DocumentModel target, String renditionName, boolean override)	Publish a document's rendition.
protected void	setupProvider(RenditionDefinition definition)
void	start(ComponentContext context)	Start the component.
void	stop(ComponentContext context)	Stop the component.
DocumentRef	storeRendition(DocumentModel source, String renditionDefinitionName)	Render a document based on the given rendition definition name and returns the stored Rendition DocumentRef.
protected StoredRendition	storeRendition(DocumentModel sourceDocument, Rendition rendition, RenditionDefinition renditionDefinition)

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

activate, addRuntimeMessage, addRuntimeMessage, deactivate, getAdapter, getDescriptor, getDescriptors, getLastModified, getRegistry, register, registerContribution, registerExtension, setLastModified, setModifiedNow, setName, unregister, unregisterContribution, 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

getApplicationStartedOrder

Field Details

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

renditionDefinitions

protected Map<String,RenditionDefinition> renditionDefinitions

renditionDefinitionProviders

protected Map<String,RenditionDefinitionProviderDescriptor> renditionDefinitionProviders

defaultRenditionDescriptors

protected List<DefaultRenditionDescriptor> defaultRenditionDescriptors

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 Details

RenditionServiceImpl

public RenditionServiceImpl()

Method Details

getStoredRenditionManager

public StoredRenditionManager getStoredRenditionManager()

Since:

8.1

start

public void start(ComponentContext context)

Description copied from interface: Component

Start the component. This method is called after all the components were resolved and activated

Specified by:

start in interface Component

Overrides:

start in class DefaultComponent

setupProvider

protected void setupProvider(RenditionDefinition definition)

stop

public void stop(ComponentContext context)

Description copied from interface: Component

Stop the component.

Specified by:

stop in interface Component

Overrides:

stop in class DefaultComponent

getDeclaredRenditionDefinitions

public List<RenditionDefinition> getDeclaredRenditionDefinitions()

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

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

getRenditionDefinitionsFromDefinition

protected List<RenditionDefinition> getRenditionDefinitionsFromDefinition(DocumentModel doc)

canUseRenditionDefinition

protected boolean canUseRenditionDefinition(RenditionDefinition renditionDefinition,
 DocumentModel doc)

getRenditionDefinitionsFromProvider

protected List<RenditionDefinition> getRenditionDefinitionsFromProvider(DocumentModel doc)

canUseRenditionDefinitionProvider

protected boolean canUseRenditionDefinitionProvider(RenditionDefinitionProviderDescriptor renditionDefinitionProviderDescriptor,
 DocumentModel doc)

createActionContext

protected ActionContext createActionContext(DocumentModel doc)

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

protected StoredRendition storeRendition(DocumentModel sourceDocument,
 Rendition rendition,
 RenditionDefinition renditionDefinition)

Since:

10.10

createVersionIfNeeded

protected DocumentRef createVersionIfNeeded(DocumentModel source,
 CoreSession session)

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 and returned otherwise.

If store parameter is true, the new created rendition is stored too unless it is marked as stale.

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

getRenditionSafe

protected Optional<Rendition> getRenditionSafe(DocumentModel doc,
 String defaultRenditionName,
 boolean store)

Since:

11.1

getRendition

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

getAvailableRenditionDefinition

public RenditionDefinition getAvailableRenditionDefinition(DocumentModel doc,
 String renditionName)

Description copied from interface: RenditionService

Returns the RenditionDefinition available on the given document for the given rendition definition name.

Specified by:

getAvailableRenditionDefinition in interface RenditionService

getRenditionDefinitionFromDefinition

protected RenditionDefinition getRenditionDefinitionFromDefinition(String name)

getRenditionDefinitionFromProvider

protected RenditionDefinition getRenditionDefinitionFromProvider(String name,
 DocumentModel doc)

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

Same as RenditionService.getDefaultRendition(DocumentModel, String, boolean, Map) with store parameter set to false.

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

getDefaultRendition

public Rendition getDefaultRendition(DocumentModel doc,
 String reason,
 boolean store,
 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)

store - indicates if the rendition must be stored

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

Returns:

the default Rendition object

publishRendition

public DocumentModel publishRendition(DocumentModel doc,
 DocumentModel target,
 String renditionName,
 boolean override)

Description copied from interface: RenditionService

Publish a document's rendition. If the rendition name is not given, it publishes its default rendition obtained from RenditionService.getDefaultRendition(DocumentModel, String, Map).

Specified by:

publishRendition in interface RenditionService

Parameters:

doc - the document to be published

target - the location where to publish

renditionName - the rendition to be published

override - if true, will remove existing publication of the document

Returns:

the published document