Package org.nuxeo.template.service

Class TemplateProcessorComponent

java.lang.Object

org.nuxeo.runtime.model.DefaultComponent

org.nuxeo.template.service.TemplateProcessorComponent

All Implemented Interfaces:

Adaptable, Component, Extensible, TimestampedService, TemplateProcessorService

public class TemplateProcessorComponent
extends DefaultComponent
implements TemplateProcessorService

Runtime Component used to handle Extension Points and expose the TemplateProcessorService interface

Author:

Tiry

Field Summary

Fields

Modifier and Type	Field	Description
static String	CONTEXT_EXTENSION_XP
protected ContextFactoryRegistry	contextExtensionRegistry
protected static Log	log
static String	OUTPUT_FORMAT_EXTENSION_XP
protected OutputFormatRegistry	outputFormatRegistry
static String	PROCESSOR_XP
protected TemplateProcessorRegistry	processorRegistry
protected Map<String,List<String>>	type2Template

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

lastModified, name

Constructor Summary

Constructors

Constructor	Description
TemplateProcessorComponent()

Method Summary

Modifier and Type	Method	Description
void	activate(ComponentContext context)	Activates the component.
void	addContextExtensions(DocumentModel currentDocument, DocumentWrapper wrapper, Map<String,Object> ctx)
protected String	buildTemplateSearchByNameQuery(String name)
protected String	buildTemplateSearchQuery(String targetType)
void	deactivate(ComponentContext context)	Deactivates the component.
DocumentModel	detachTemplateBasedDocument(DocumentModel targetDoc, String templateName, boolean save)	Detach a Template from a DocumentModel
TemplateProcessor	findProcessor(Blob templateBlob)	Finds the TemplateProcessor for a given Blob.
protected TemplateProcessorDescriptor	findProcessorByExtension(String extension)
protected TemplateProcessorDescriptor	findProcessorByMimeType(String mt)
TemplateProcessorDescriptor	findProcessorDescriptor(Blob templateBlob)
String	findProcessorName(Blob templateBlob)	Finds the template processor name for a given Blob.
List<TemplateSourceDocument>	getAvailableOfficeTemplates(CoreSession session, String targetType)	Retrieve the TemplateSourceDocument that can be used as an Office template (i.e that support to store the template file as main blob of target DocumentModel)
List<DocumentModel>	getAvailableTemplateDocs(CoreSession session, String targetType)	Find TemplateSourceDocuments that can be bound to a given doc type.
List<TemplateSourceDocument>	getAvailableTemplates(CoreSession session, String targetType)	Find TemplateSourceDocuments that can be bound to a given doc type.
TemplateProcessorDescriptor	getDescriptor(String name)
List<TemplateBasedDocument>	getLinkedTemplateBasedDocuments(DocumentModel source)	Retrieve the DocumentModels using a given TemplateSourceDocument
OutputFormatDescriptor	getOutputFormatDescriptor(String outputFormatId)	The returned OutputFormatDescriptor contains either an operation chain or a mime-type use to convert the output of a rendered document.
Collection<OutputFormatDescriptor>	getOutputFormats()
TemplateProcessor	getProcessor(String name)	Get a TemplateProcessor by it's name.
Collection<TemplateProcessorDescriptor>	getRegisteredTemplateProcessors()	Returns all registered TemplateProcessors
Map<String,ContextExtensionFactoryDescriptor>	getRegistredContextExtensions()
List<String>	getReservedContextKeywords()
DocumentModel	getTemplateDoc(CoreSession session, String name)	Returns a template with a given templateName.
Map<String,List<String>>	getTypeMapping()	Retrieve the Map used for mapping Document Types to Template Names.
DocumentModel	makeTemplateBasedDocument(DocumentModel targetDoc, DocumentModel sourceTemplateDoc, boolean save)	Associate a DocumentModel to a TemplateSourceDocument.
void	registerContribution(Object contribution, String extensionPoint, ComponentInstance contributor)
void	registerTypeMapping(DocumentModel doc)	Update Type2Template Mapping from the data contained in the source DocumentModel.
void	unregisterContribution(Object contribution, String extensionPoint, ComponentInstance contributor)
protected <T> List<T>	wrap(List<DocumentModel> docs, Class<T> adapter)

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

addRuntimeMessage, addRuntimeMessage, getAdapter, getDescriptor, getDescriptors, getLastModified, getRegistry, register, registerExtension, setLastModified, setModifiedNow, setName, start, stop, unregister, 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

log

protected static final Log log

PROCESSOR_XP

public static final String PROCESSOR_XP

See Also:

Constant Field Values

CONTEXT_EXTENSION_XP

public static final String CONTEXT_EXTENSION_XP

See Also:

Constant Field Values

OUTPUT_FORMAT_EXTENSION_XP

public static final String OUTPUT_FORMAT_EXTENSION_XP

See Also:

Constant Field Values

contextExtensionRegistry

protected ContextFactoryRegistry contextExtensionRegistry

processorRegistry

protected TemplateProcessorRegistry processorRegistry

outputFormatRegistry

protected OutputFormatRegistry outputFormatRegistry

type2Template

protected volatile Map<String,List<String>> type2Template

Constructor Detail

TemplateProcessorComponent

public TemplateProcessorComponent()

Method Detail

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

registerContribution

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

Overrides:

registerContribution in class DefaultComponent

unregisterContribution

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

Overrides:

unregisterContribution in class DefaultComponent

findProcessor

public TemplateProcessor findProcessor(Blob templateBlob)

Description copied from interface: TemplateProcessorService

Finds the TemplateProcessor for a given Blob. The template processor is found based on mime-types.

Specified by:

findProcessor in interface TemplateProcessorService

Returns:

the TemplateProcessor

findProcessorName

public String findProcessorName(Blob templateBlob)

Description copied from interface: TemplateProcessorService

Finds the template processor name for a given Blob. The template processor is found based on mime-types.

Specified by:

findProcessorName in interface TemplateProcessorService

Returns:

the TemplateProcessor name

findProcessorDescriptor

public TemplateProcessorDescriptor findProcessorDescriptor(Blob templateBlob)

addContextExtensions

public void addContextExtensions(DocumentModel currentDocument,
                                 DocumentWrapper wrapper,
                                 Map<String,Object> ctx)

Specified by:

addContextExtensions in interface TemplateProcessorService

getReservedContextKeywords

public List<String> getReservedContextKeywords()

Specified by:

getReservedContextKeywords in interface TemplateProcessorService

getRegistredContextExtensions

public Map<String,ContextExtensionFactoryDescriptor> getRegistredContextExtensions()

Specified by:

getRegistredContextExtensions in interface TemplateProcessorService

findProcessorByMimeType

protected TemplateProcessorDescriptor findProcessorByMimeType(String mt)

findProcessorByExtension

protected TemplateProcessorDescriptor findProcessorByExtension(String extension)

getDescriptor

public TemplateProcessorDescriptor getDescriptor(String name)

getProcessor

public TemplateProcessor getProcessor(String name)

Description copied from interface: TemplateProcessorService

Get a TemplateProcessor by it's name. Name is defined in the associated descriptor.

Specified by:

getProcessor in interface TemplateProcessorService

Returns:

the TemplateProcessor

buildTemplateSearchQuery

protected String buildTemplateSearchQuery(String targetType)

buildTemplateSearchByNameQuery

protected String buildTemplateSearchByNameQuery(String name)

getAvailableTemplateDocs

public List<DocumentModel> getAvailableTemplateDocs(CoreSession session,
                                                    String targetType)

Description copied from interface: TemplateProcessorService

Find TemplateSourceDocuments that can be bound to a given doc type.

Specified by:

getAvailableTemplateDocs in interface TemplateProcessorService

targetType - the target Document Type

Returns:

List of applicable DocumentModel

getTemplateDoc

public DocumentModel getTemplateDoc(CoreSession session,
                                    String name)

Description copied from interface: TemplateProcessorService

Returns a template with a given templateName.

Specified by:

getTemplateDoc in interface TemplateProcessorService

name - the name of the template

wrap

protected <T> List<T> wrap(List<DocumentModel> docs,
                           Class<T> adapter)

getAvailableOfficeTemplates

public List<TemplateSourceDocument> getAvailableOfficeTemplates(CoreSession session,
                                                                String targetType)

Description copied from interface: TemplateProcessorService

Retrieve the TemplateSourceDocument that can be used as an Office template (i.e that support to store the template file as main blob of target DocumentModel)

Specified by:

getAvailableOfficeTemplates in interface TemplateProcessorService

getAvailableTemplates

public List<TemplateSourceDocument> getAvailableTemplates(CoreSession session,
                                                          String targetType)

Description copied from interface: TemplateProcessorService

Find TemplateSourceDocuments that can be bound to a given doc type.

Specified by:

getAvailableTemplates in interface TemplateProcessorService

targetType - the target Document Type

Returns:

List of applicable TemplateSourceDocument

getLinkedTemplateBasedDocuments

public List<TemplateBasedDocument> getLinkedTemplateBasedDocuments(DocumentModel source)

Description copied from interface: TemplateProcessorService

Retrieve the DocumentModels using a given TemplateSourceDocument

Specified by:

getLinkedTemplateBasedDocuments in interface TemplateProcessorService

Parameters:

source - the TemplateSourceDocument

getRegisteredTemplateProcessors

public Collection<TemplateProcessorDescriptor> getRegisteredTemplateProcessors()

Description copied from interface: TemplateProcessorService

Returns all registered TemplateProcessors

Specified by:

getRegisteredTemplateProcessors in interface TemplateProcessorService

Returns:

collection of registered TemplateProcessorDescriptor

getTypeMapping

public Map<String,List<String>> getTypeMapping()

Description copied from interface: TemplateProcessorService

Retrieve the Map used for mapping Document Types to Template Names. This Map represent the Templates that must be automatically bound at creation time for each Document Type.

Specified by:

getTypeMapping in interface TemplateProcessorService

Returns:

the Type2Template mapping

registerTypeMapping

public void registerTypeMapping(DocumentModel doc)

Description copied from interface: TemplateProcessorService

Update Type2Template Mapping from the data contained in the source DocumentModel.

Specified by:

registerTypeMapping in interface TemplateProcessorService

makeTemplateBasedDocument

public DocumentModel makeTemplateBasedDocument(DocumentModel targetDoc,
                                               DocumentModel sourceTemplateDoc,
                                               boolean save)

Description copied from interface: TemplateProcessorService

Associate a DocumentModel to a TemplateSourceDocument. If the DocumentModel is not already a TemplateBasedDocument, the associated facet will be automatically added.

Specified by:

makeTemplateBasedDocument in interface TemplateProcessorService

Parameters:

targetDoc - the DocumentModel to associate to a template

sourceTemplateDoc - the DocumentModel holding the template

save - flag to indicate if target DocumentModel must be saved or not

Returns:

the updated DocumentModel

detachTemplateBasedDocument

public DocumentModel detachTemplateBasedDocument(DocumentModel targetDoc,
                                                 String templateName,
                                                 boolean save)

Description copied from interface: TemplateProcessorService

Detach a Template from a DocumentModel

Specified by:

detachTemplateBasedDocument in interface TemplateProcessorService

Parameters:

targetDoc - the DocumentModel to detach

templateName - the name of the template to detach

save - save flag to indicate if target DocumentModel must be saved or not

Returns:

the updated DocumentModel

getOutputFormats

public Collection<OutputFormatDescriptor> getOutputFormats()

Specified by:

getOutputFormats in interface TemplateProcessorService

Returns:

the list of registered Ouput formats used to convert output of a rendered document.

getOutputFormatDescriptor

public OutputFormatDescriptor getOutputFormatDescriptor(String outputFormatId)

Description copied from interface: TemplateProcessorService

The returned OutputFormatDescriptor contains either an operation chain or a mime-type use to convert the output of a rendered document.

Specified by:

getOutputFormatDescriptor in interface TemplateProcessorService

Returns:

OutputFormatDescriptor