org.xwiki.rendering.macro.script
Class AbstractJSR223ScriptMacro<P extends JSR223ScriptMacroParameters>

java.lang.Object
  org.xwiki.rendering.macro.AbstractMacro<P>
      org.xwiki.rendering.macro.script.AbstractScriptMacro<P>
          org.xwiki.rendering.macro.script.AbstractJSR223ScriptMacro<P>

Type Parameters:

P - the type of macro parameters bean.

All Implemented Interfaces:

java.lang.Comparable<org.xwiki.rendering.macro.Macro<?>>, org.xwiki.component.phase.Initializable, org.xwiki.rendering.macro.Macro<P>, PrivilegedScriptMacro, ScriptMacro

Direct Known Subclasses:

DefaultScriptMacro

public abstract class AbstractJSR223ScriptMacro<P extends JSR223ScriptMacroParameters>
extends AbstractScriptMacro<P>
implements PrivilegedScriptMacro

Base Class for script evaluation macros based on JSR223.

Since:

1.7M3

Version:

$Id$

Field Summary

Fields inherited from class org.xwiki.rendering.macro.script.AbstractScriptMacro

CONTENT_DESCRIPTION, documentAccessBridge, execution

Fields inherited from class org.xwiki.rendering.macro.AbstractMacro

beanManager, DEFAULT_CATEGORY_CONTENT, DEFAULT_CATEGORY_DEVELOPMENT, DEFAULT_CATEGORY_FORMATTING, DEFAULT_CATEGORY_NAVIGATION

Constructor Summary

AbstractJSR223ScriptMacro(java.lang.String macroName)

AbstractJSR223ScriptMacro(java.lang.String macroName, java.lang.String macroDescription)

AbstractJSR223ScriptMacro(java.lang.String macroName, java.lang.String macroDescription, java.lang.Class<? extends JSR223ScriptMacroParameters> parametersBeanClass)

AbstractJSR223ScriptMacro(java.lang.String macroName, java.lang.String macroDescription, org.xwiki.rendering.macro.descriptor.ContentDescriptor contentDescriptor)

AbstractJSR223ScriptMacro(java.lang.String macroName, java.lang.String macroDescription, org.xwiki.rendering.macro.descriptor.ContentDescriptor contentDescriptor, java.lang.Class<? extends JSR223ScriptMacroParameters> parametersBeanClass)

Method Summary

protected java.lang.Object	eval(java.lang.String content, javax.script.ScriptEngine engine, javax.script.ScriptContext scriptContext) Execute the script.
protected java.util.List<org.xwiki.rendering.block.Block>	evaluateBlock(P parameters, java.lang.String content, org.xwiki.rendering.transformation.MacroTransformationContext context) Execute provided script and return Block based result.
protected java.util.List<org.xwiki.rendering.block.Block>	evaluateBlock(javax.script.ScriptEngine engine, P parameters, java.lang.String content, org.xwiki.rendering.transformation.MacroTransformationContext context) Execute provided script and return Block based result.
protected javax.script.CompiledScript	getCompiledScript(java.lang.String content, javax.script.Compilable engine) Return a compiled version of the provided script.
protected javax.script.ScriptContext	getScriptContext() Get the current ScriptContext and refresh it.
protected java.lang.String	getScriptEngineName(P parameters, org.xwiki.rendering.transformation.MacroTransformationContext context) Method to overwrite to indicate the script engine name.
boolean	supportsInlineMode()

Methods inherited from class org.xwiki.rendering.macro.script.AbstractScriptMacro

evaluate, evaluateString, execute, getComponentManager, parseScriptResult, parseSourceSyntax

Methods inherited from class org.xwiki.rendering.macro.AbstractMacro

compareTo, getDescriptor, getPriority, initialize, setDefaultCategory, setDescriptor, setPriority

Methods inherited from class java.lang.Object

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

Constructor Detail

AbstractJSR223ScriptMacro

public AbstractJSR223ScriptMacro(java.lang.String macroName)

Parameters:

macroName - the name of the macro (eg "groovy")

AbstractJSR223ScriptMacro

public AbstractJSR223ScriptMacro(java.lang.String macroName,
                                 java.lang.String macroDescription)

Parameters:

macroName - the name of the macro (eg "groovy")

macroDescription - the text description of the macro.

AbstractJSR223ScriptMacro

public AbstractJSR223ScriptMacro(java.lang.String macroName,
                                 java.lang.String macroDescription,
                                 org.xwiki.rendering.macro.descriptor.ContentDescriptor contentDescriptor)

Parameters:

macroName - the name of the macro (eg "groovy")

macroDescription - the text description of the macro.

contentDescriptor - the description of the macro content.

AbstractJSR223ScriptMacro

public AbstractJSR223ScriptMacro(java.lang.String macroName,
                                 java.lang.String macroDescription,
                                 java.lang.Class<? extends JSR223ScriptMacroParameters> parametersBeanClass)

Parameters:

macroName - the name of the macro (eg "groovy")

macroDescription - the text description of the macro.

parametersBeanClass - class of the parameters bean for this macro.

AbstractJSR223ScriptMacro

public AbstractJSR223ScriptMacro(java.lang.String macroName,
                                 java.lang.String macroDescription,
                                 org.xwiki.rendering.macro.descriptor.ContentDescriptor contentDescriptor,
                                 java.lang.Class<? extends JSR223ScriptMacroParameters> parametersBeanClass)

Parameters:

macroName - the name of the macro (eg "groovy")

macroDescription - the text description of the macro.

contentDescriptor - the description of the macro content.

parametersBeanClass - class of the parameters bean for this macro.

Method Detail

supportsInlineMode

public boolean supportsInlineMode()

Specified by:

supportsInlineMode in interface org.xwiki.rendering.macro.Macro<P extends JSR223ScriptMacroParameters>

See Also:

Macro.supportsInlineMode()

getScriptEngineName

protected java.lang.String getScriptEngineName(P parameters,
                                               org.xwiki.rendering.transformation.MacroTransformationContext context)

Method to overwrite to indicate the script engine name.

Parameters:

parameters - the macro parameters.

context - the context of the macro transformation.

Returns:

the name of the script engine to use.

getScriptContext

protected javax.script.ScriptContext getScriptContext()

Get the current ScriptContext and refresh it.

Returns:

the script context.

evaluateBlock

protected java.util.List<org.xwiki.rendering.block.Block> evaluateBlock(P parameters,
                                                                        java.lang.String content,
                                                                        org.xwiki.rendering.transformation.MacroTransformationContext context)
                                                                 throws org.xwiki.rendering.macro.MacroExecutionException

Execute provided script and return Block based result.

Overrides:

evaluateBlock in class AbstractScriptMacro<P extends JSR223ScriptMacroParameters>

Parameters:

parameters - the macro parameters.

content - the script to execute.

context - the context of the macro transformation.

Returns:

the result of script execution.

Throws:

org.xwiki.rendering.macro.MacroExecutionException - failed to evaluate provided content.

See Also:

AbstractScriptMacro.evaluate(ScriptMacroParameters, String, MacroTransformationContext)

evaluateBlock

protected java.util.List<org.xwiki.rendering.block.Block> evaluateBlock(javax.script.ScriptEngine engine,
                                                                        P parameters,
                                                                        java.lang.String content,
                                                                        org.xwiki.rendering.transformation.MacroTransformationContext context)
                                                                 throws javax.script.ScriptException,
                                                                        org.xwiki.rendering.macro.MacroExecutionException

Execute provided script and return Block based result.

Parameters:

engine - the script engine to use to evaluate the script.

parameters - the macro parameters.

content - the script to execute.

context - the context of the macro transformation.

Returns:

the result of script execution.

Throws:

javax.script.ScriptException - failed to evaluate script

org.xwiki.rendering.macro.MacroExecutionException - failed to evaluate provided content.

eval

protected java.lang.Object eval(java.lang.String content,
                                javax.script.ScriptEngine engine,
                                javax.script.ScriptContext scriptContext)
                         throws javax.script.ScriptException

Execute the script.

Parameters:

content - the script to be executed by the script engine

engine - the script engine

scriptContext - the script context

Returns:

The value returned from the execution of the script.

Throws:

javax.script.ScriptException - if an error occurrs in script. ScriptEngines should create and throw ScriptException wrappers for checked Exceptions thrown by underlying scripting implementations.

getCompiledScript

protected javax.script.CompiledScript getCompiledScript(java.lang.String content,
                                                        javax.script.Compilable engine)
                                                 throws javax.script.ScriptException

Return a compiled version of the provided script.

Parameters:

content - the script to compile.

engine - the script engine.

Returns:

the compiled version of the script.

Throws:

javax.script.ScriptException - failed to compile the script.