org.xwiki.template

Interface TemplateManager

@Role
@Unstable
public interface TemplateManager

Internal toolkit to experiment on wiki bases templates.

Since:

7.0M1

Version:

$Id: 96563b252a6f893932848bf59b22662420c990ec $

Method Summary

Methods

Modifier and Type	Method and Description
org.xwiki.rendering.block.XDOM	execute(String templateName) Execute and return the template as XDOM.
org.xwiki.rendering.block.XDOM	executeNoException(String 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	getXDOMNoException(String templateName) Parse the template with the provided name and return it as XDOM.
String	render(String template) Execute and render the template in current target syntax.
void	render(String template, 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 template, 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 template) Execute and render the template in current target syntax.
void	renderNoException(String template, Writer writer) Execute and render the template in current target syntax.

Method Detail

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(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(String template)

Execute and return the template as XDOM.

Any failure is "printed" in the returned XDOM.

Parameters:

template - the name of the template

Returns:

the XDOM result of the template execution

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 template)

Execute and render the template in current target syntax.

Any failure is "printed" in the returned result.

Parameters:

template - the name of the template

Returns:

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

render

String render(String template)
              throws Exception

Execute and render the template in current target syntax.

Parameters:

template - 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(String template,
                     Writer writer)

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

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 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

renderFromSkin

String renderFromSkin(String template,
                    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:

template - 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