org.xwiki.rendering.transformation
Class TransformationContext

java.lang.Object
  org.xwiki.rendering.transformation.TransformationContext

All Implemented Interfaces:

java.lang.Cloneable

public class TransformationContext
extends java.lang.Object
implements java.lang.Cloneable

The context of the transformation process. Contains information such as the current XWiki DOM for the parsed content.

Since:

2.4M1

Version:

$Id: TransformationContext.java 33583 2010-12-17 13:07:48Z vmassol $

Constructor Summary

TransformationContext()
Default constructor that doesn't set the XDOM or the Syntax.

TransformationContext(XDOM xdom, Syntax syntax)
Some macros require the XDOM and the Syntax to be set.

Method Summary

TransformationContext	clone()
java.lang.String	getId()
Syntax	getSyntax()
XDOM	getXDOM()
void	setId(java.lang.String id)
void	setSyntax(Syntax syntax)
void	setXDOM(XDOM xdom)

Methods inherited from class java.lang.Object

equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

TransformationContext

public TransformationContext()

Default constructor that doesn't set the XDOM or the Syntax. This is because setting the XDOM and the Syntax is optional and only required by some Macros to behave as expected.

TransformationContext

public TransformationContext(XDOM xdom,
                             Syntax syntax)

Some macros require the XDOM and the Syntax to be set.

Parameters:

xdom - see setXDOM(org.xwiki.rendering.block.XDOM)

syntax - see setSyntax(org.xwiki.rendering.syntax.Syntax)

Method Detail

getId

public java.lang.String getId()

Returns:

an id representing the transformation being evaluated. It's a free form name that Transformations can use, for example if they need to perform some caching based on a key. For example the Velocity Macro is using this id to pass it to the underlying Velocity Engine so that it caches macros using this key.

Since:

2.4M2

setId

public void setId(java.lang.String id)

Parameters:

id - see getId()

Since:

2.4M2

setXDOM

public void setXDOM(XDOM xdom)

Parameters:

xdom - the complete XDOM of the content currently being transformed.

getXDOM

public XDOM getXDOM()

Returns:

the complete XDOM of the content currently being transformed.

setSyntax

public void setSyntax(Syntax syntax)

Parameters:

syntax - the current syntax.

getSyntax

public Syntax getSyntax()

Returns:

the current syntax.

clone

public TransformationContext clone()

Overrides:

clone in class java.lang.Object

See Also:

Object.clone()