org.nuxeo.template.api.adapters

Interface TemplateBasedDocument

All Known Implementing Classes:

TemplateBasedDocumentAdapterImpl

public interface TemplateBasedDocument

Adapter interface for the DocumentModel that support rendering via a Template. This Document can be associated with a TemplateSourceDocument that provides the rendering template as well as the default inputs used for rendering.

Author:

Tiry (tdelprat@nuxeo.com)

Method Summary

Methods

Modifier and Type	Method and Description
DocumentModel	getAdaptedDoc() Return the underlying adapted DocumentModel
List<TemplateInput>	getParams(String templateName) Retrieve parameters for the associated template
TemplateSourceDocument	getSourceTemplate(String templateName) Retrieve the TemplateSourceDocument for a given template name
DocumentModel	getSourceTemplateDoc(String templateName) Retrieve the Template DocumentModel for a given template name
DocumentRef	getSourceTemplateDocRef(String templateName) Retrieve the Template DocumentRef for a given template name
List<TemplateSourceDocument>	getSourceTemplates() List all TemplateSourceDocuments that are bound to the underlying DocumentModel
Blob	getTemplateBlob(String templateName) Return the Blob of the associated template
String	getTemplateNameForRendition(String renditionName) Find the template associated to a given RenditionName
List<String>	getTemplateNames() Get the names of all the associated templates
String	getTemplateType(String templateName) Return the template type for a given template name
boolean	hasEditableParams(String templateName) Indicate of the associated Template has editable parameters or not
boolean	hasParams(String templateName) Indicate of the associated Template requires parameters or not
DocumentModel	initializeFromTemplate(String templateName, boolean save) Initialize the template parameters from the associated template
DocumentModel	removeTemplateBinding(String templateName, boolean save) Detach a template from the underlying DocumentModel
Blob	renderAndStoreAsAttachment(String templateName, boolean save) Render the named template against the underlying DocumentModel and store the result in the main Blob
Blob	renderWithTemplate(String templateName) Render the named template against the underlying DocumentModel
DocumentModel	saveParams(String templateName, List<TemplateInput> params, boolean save) Save parameters changes.
DocumentModel	setTemplate(DocumentModel template, boolean save) Associate the document to a Template.

Method Detail

setTemplate

DocumentModel setTemplate(DocumentModel template,
                        boolean save)
                          throws PropertyException,
                                 ClientException

Associate the document to a Template.

Parameters:

template - DocumentModel holding the template

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

Returns:

the updated DocumentModel

Throws:

PropertyException

ClientException

getSourceTemplate

TemplateSourceDocument getSourceTemplate(String templateName)
                                         throws Exception

Retrieve the TemplateSourceDocument for a given template name

Parameters:

templateName - name of the template

Returns:

the TemplateSourceDocument

Throws:

Exception

getSourceTemplateDocRef

DocumentRef getSourceTemplateDocRef(String templateName)
                                    throws Exception

Retrieve the Template DocumentRef for a given template name

Parameters:

templateName - name of the template

Returns:

the associated template DocumentRef

Throws:

Exception

getSourceTemplateDoc

DocumentModel getSourceTemplateDoc(String templateName)
                                   throws Exception

Retrieve the Template DocumentModel for a given template name

Parameters:

templateName - name of the template

Returns:

the associated template DocumentModel

Throws:

Exception

getSourceTemplates

List<TemplateSourceDocument> getSourceTemplates()

List all TemplateSourceDocuments that are bound to the underlying DocumentModel

Returns:

getTemplateType

String getTemplateType(String templateName)

Return the template type for a given template name

Parameters:

templateName -

Returns:

initializeFromTemplate

DocumentModel initializeFromTemplate(String templateName,
                                   boolean save)
                                     throws Exception

Initialize the template parameters from the associated template

Parameters:

templateName -

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

Returns:

the updated DocumentModel

Throws:

Exception

renderAndStoreAsAttachment

Blob renderAndStoreAsAttachment(String templateName,
                              boolean save)
                                throws Exception

Render the named template against the underlying DocumentModel and store the result in the main Blob

Parameters:

templateName -

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

Returns:

the resulting Blob

Throws:

Exception

renderWithTemplate

Blob renderWithTemplate(String templateName)
                        throws Exception

Render the named template against the underlying DocumentModel

Parameters:

templateName -

Returns:

the resulting Blob

Throws:

Exception

hasParams

boolean hasParams(String templateName)
                  throws ClientException

Indicate of the associated Template requires parameters or not

Parameters:

templateName -

Returns:

Throws:

ClientException

getParams

List<TemplateInput> getParams(String templateName)
                              throws ClientException

Retrieve parameters for the associated template

Parameters:

templateName -

Returns:

Throws:

ClientException

saveParams

DocumentModel saveParams(String templateName,
                       List<TemplateInput> params,
                       boolean save)
                         throws Exception

Save parameters changes.

Parameters:

templateName -

params - the updated list of parameters

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

Returns:

Throws:

Exception

getAdaptedDoc

DocumentModel getAdaptedDoc()

Return the underlying adapted DocumentModel

Returns:

getTemplateBlob

Blob getTemplateBlob(String templateName)
                     throws Exception

Return the Blob of the associated template

Parameters:

templateName -

Returns:

Throws:

Exception

hasEditableParams

boolean hasEditableParams(String templateName)
                          throws ClientException

Indicate of the associated Template has editable parameters or not

Parameters:

templateName -

Returns:

Throws:

ClientException

getTemplateNameForRendition

String getTemplateNameForRendition(String renditionName)

Find the template associated to a given RenditionName

Parameters:

renditionName -

Returns:

the template name if any, null otherwise

getTemplateNames

List<String> getTemplateNames()

Get the names of all the associated templates

Returns:

removeTemplateBinding

DocumentModel removeTemplateBinding(String templateName,
                                  boolean save)
                                    throws ClientException

Detach a template from the underlying DocumentModel

Parameters:

templateName -

save -

Returns:

Throws:

ClientException