org.nuxeo.template.api

Interface TemplateProcessorService

All Known Implementing Classes:

TemplateProcessorComponent

public interface TemplateProcessorService

This is the service interface to manage TemplateProcessor and associated templates.

Author:

Tiry

Method Summary

Methods

Modifier and Type	Method and Description
void	addContextExtensions(DocumentModel currentDocument, DocumentWrapper wrapper, Map<String,Object> ctx)
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.
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.
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()
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	registerTypeMapping(DocumentModel doc) Update Type2Template Mapping from the data contained in the source DocumentModel.

Method Detail

findProcessorName

String findProcessorName(Blob templateBlob)

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

Parameters:

templateBlob -

Returns:

the TemplateProcessor name

findProcessor

TemplateProcessor findProcessor(Blob templateBlob)

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

Parameters:

templateBlob -

Returns:

the TemplateProcessor

getProcessor

TemplateProcessor getProcessor(String name)

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

Parameters:

name -

Returns:

the TemplateProcessor

getRegisteredTemplateProcessors

Collection<TemplateProcessorDescriptor> getRegisteredTemplateProcessors()

Returns all registered TemplateProcessors

Returns:

collection of registered TemplateProcessorDescriptor

getAvailableTemplateDocs

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

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

Parameters:

session -

targetType - the target Document Type

Returns:

List of applicable DocumentModel

Throws:

ClientException

getAvailableTemplates

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

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

Parameters:

session -

targetType - the target Document Type

Returns:

List of applicable TemplateSourceDocument

Throws:

ClientException

getAvailableOfficeTemplates

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

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)

Parameters:

session -

targetType -

Returns:

Throws:

ClientException

getLinkedTemplateBasedDocuments

List<TemplateBasedDocument> getLinkedTemplateBasedDocuments(DocumentModel source)
                                                            throws ClientException

Retrieve the DocumentModels using a given TemplateSourceDocument

Parameters:

source - the TemplateSourceDocument

Returns:

Throws:

ClientException

getTypeMapping

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

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.

Returns:

the Type2Template mapping

registerTypeMapping

void registerTypeMapping(DocumentModel doc)
                         throws ClientException

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

Parameters:

doc -

Throws:

ClientException

makeTemplateBasedDocument

DocumentModel makeTemplateBasedDocument(DocumentModel targetDoc,
                                      DocumentModel sourceTemplateDoc,
                                      boolean save)
                                        throws ClientException

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

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

Throws:

ClientException

detachTemplateBasedDocument

DocumentModel detachTemplateBasedDocument(DocumentModel targetDoc,
                                        String templateName,
                                        boolean save)
                                          throws ClientException

Detach a Template from a DocumentModel

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

Throws:

ClientException

addContextExtensions

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

getRegistredContextExtensions

Map<String,ContextExtensionFactoryDescriptor> getRegistredContextExtensions()

getReservedContextKeywords

List<String> getReservedContextKeywords()

getOutputFormats

Collection<OutputFormatDescriptor> getOutputFormats()

Returns:

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

getOutputFormatDescriptor

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.

Parameters:

outputFormatId -

Returns:

OutputFormatDescriptor