org.xwiki.template

Interface TemplateManager

@Role
public interface TemplateManager

Internal toolkit to experiment on wiki-based templates.

Since:

7.0M1

Version:

$Id: 0a9958d25bfecc166b6d36f8baee842ce10c4d9d $

Method Summary

Modifier and Type	Method and Description
default Template	createStringTemplate(String content, DocumentReference author) Create a new template using a given content and a specific author.
org.xwiki.rendering.block.XDOM	execute(String templateName) Execute and return the template as XDOM.
org.xwiki.rendering.block.XDOM	execute(Template template) Execute and return the template as XDOM.
org.xwiki.rendering.block.XDOM	executeNoException(String templateName) Execute and return the template as XDOM.
org.xwiki.rendering.block.XDOM	executeNoException(Template template) Execute and return the template as XDOM.
Template	getSkinTemplate(String templateName, Skin skin) Search the template with passed name in the passed skin.
Template	getTemplate(String templateName) Search everywhere for the template with passed name depending on the current context (current skin, etc).
Template	getTemplate(String templateName, Skin skin) Search the template with passed name in the passed skin.
org.xwiki.rendering.block.XDOM	getXDOM(String templateName) Parse the template with the provided name and return it as XDOM.
org.xwiki.rendering.block.XDOM	getXDOM(Template template) Parse the template with the provided name and return it as XDOM.
org.xwiki.rendering.block.XDOM	getXDOMNoException(String templateName) Parse the template with the provided name and return it as XDOM.
org.xwiki.rendering.block.XDOM	getXDOMNoException(Template template) Parse the template with the provided name and return it as XDOM.
String	render(String templateName) Execute and render the template in current target syntax.
void	render(String templateName, Writer writer) Execute and render the template in current target syntax.
void	render(Template template, Writer writer) Execute and render the template in current target syntax.
String	renderFromSkin(String templateName, Skin skin) Execute and render the template in current target syntax from the passed skin.
void	renderFromSkin(String templateName, Skin skin, Writer writer) Execute and render the template in current target syntax from the passed skin.
String	renderNoException(String templateName) Execute and render the template in current target syntax.
void	renderNoException(String templateName, Writer writer) Execute and render the template in current target syntax.
void	renderNoException(Template template, Writer writer) Execute and render the template in current target syntax.

Method Detail

getXDOMNoException

org.xwiki.rendering.block.XDOM getXDOMNoException(Template template)

Parse the template with the provided name and return it as XDOM.

Any failure is "printed" in the returned XDOM.

Parameters:

template - the template

Returns:

the XDOM source of the template

Since:

8.3RC1

getXDOMNoException

org.xwiki.rendering.block.XDOM getXDOMNoException(String templateName)

Parse the template with the provided name and return it as XDOM.

Any failure is "printed" in the returned XDOM.

Parameters:

templateName - the name of the template

Returns:

the XDOM source of the template

getXDOM

org.xwiki.rendering.block.XDOM getXDOM(Template template)
                                throws Exception

Parse the template with the provided name and return it as XDOM.

Parameters:

template - the template

Returns:

the XDOM source of the template

Throws:

Exception - when failing to parse the template

Since:

8.3RC1

getXDOM

org.xwiki.rendering.block.XDOM getXDOM(String templateName)
                                throws Exception

Parse the template with the provided name and return it as XDOM.

Parameters:

templateName - the name of the template

Returns:

the XDOM source of the template

Throws:

Exception - when failing to parse the template

executeNoException

org.xwiki.rendering.block.XDOM executeNoException(Template template)

Execute and return the template as XDOM.

Any failure is "printed" in the returned XDOM.

Parameters:

template - the template

Returns:

the XDOM result of the template execution

Since:

8.3RC1

executeNoException

org.xwiki.rendering.block.XDOM executeNoException(String templateName)

Execute and return the template as XDOM.

Any failure is "printed" in the returned XDOM.

Parameters:

templateName - the name of the template

Returns:

the XDOM result of the template execution

execute

org.xwiki.rendering.block.XDOM execute(Template template)
                                throws Exception

Execute and return the template as XDOM.

Parameters:

template - the template

Returns:

the XDOM result of the template execution

Throws:

Exception - when failing to parse the template

Since:

8.3RC1

execute

org.xwiki.rendering.block.XDOM execute(String templateName)
                                throws Exception

Execute and return the template as XDOM.

Parameters:

templateName - the name of the template

Returns:

the XDOM result of the template execution

Throws:

Exception - when failing to parse the template

renderNoException

String renderNoException(String templateName)

Execute and render the template in current target syntax.

Any failure is "printed" in the returned result.

Parameters:

templateName - the name of the template

Returns:

the result of the execution of the template in the current target syntax

render

String render(String templateName)
       throws Exception

Execute and render the template in current target syntax.

Parameters:

templateName - the name of the template

Returns:

the result of the execution of the template in the current target syntax

Throws:

Exception - when failing to render the template

renderNoException

void renderNoException(Template template,
                       Writer writer)

Execute and render the template in current target syntax.

Parameters:

template - the template

writer - the writer containing the result of the execution and rendering

Since:

8.3RC1

renderNoException

void renderNoException(String templateName,
                       Writer writer)

Execute and render the template in current target syntax.

Parameters:

templateName - the name of the template

writer - the writer containing the result of the execution and rendering

render

void render(Template template,
            Writer writer)
     throws Exception

Execute and render the template in current target syntax.

Parameters:

template - the name of the template

writer - the writer containing the result of the execution and rendering

Throws:

Exception - when failing to render the template

render

void render(String templateName,
            Writer writer)
     throws Exception

Execute and render the template in current target syntax.

Parameters:

templateName - the name of the template

writer - the writer containing the result of the execution and rendering

Throws:

Exception - when failing to render the template

renderFromSkin

String renderFromSkin(String templateName,
                      Skin skin)
               throws Exception

Execute and render the template in current target syntax from the passed skin. When the template is not found in the passed skin it fallback on skin parent etc.

Parameters:

templateName - the name of the template

skin - the skin

Returns:

the result of the execution of the template in the current target syntax

Throws:

Exception - when failing to render the template

renderFromSkin

void renderFromSkin(String templateName,
                    Skin skin,
                    Writer writer)
             throws Exception

Execute and render the template in current target syntax from the passed skin. When the template is not found in the passed skin it fallback on skin parent etc.

Parameters:

templateName - the name of the template

skin - the skin

writer - the writer containing the result of the execution and rendering

Throws:

Exception - when failing to render the template

getSkinTemplate

Template getSkinTemplate(String templateName,
                         Skin skin)

Search the template with passed name in the passed skin.

Does not fallback on parent skin.

Parameters:

templateName - the name of the template

skin - the skin

Returns:

the template

getTemplate

Template getTemplate(String templateName,
                     Skin skin)

Search the template with passed name in the passed skin.

Fallback on parent skin.

Parameters:

templateName - the name of the template

skin - the skin

Returns:

the template

getTemplate

Template getTemplate(String templateName)

Search everywhere for the template with passed name depending on the current context (current skin, etc).

Parameters:

templateName - the name of the template

Returns:

the template

createStringTemplate

default Template createStringTemplate(String content,
                                      DocumentReference author)
                               throws Exception

Create a new template using a given content and a specific author.

Parameters:

content - the template content

author - the template author

Returns:

the template

Throws:

Exception - if an error occurred during template instanciation

Since:

9.6RC1