Package org.apache.commons.jelly.tags.core

Class InvokeStaticTag

java.lang.Object

org.apache.commons.jelly.TagSupport

org.apache.commons.jelly.tags.core.InvokeStaticTag

All Implemented Interfaces:

Tag, ArgTagParent

public class InvokeStaticTag
extends TagSupport
implements ArgTagParent

A Tag which can invoke a static method on a class, without an instance of the class being needed.

Like the InvokeTag, this tag can take a set of arguments using the ArgTag.

The following attributes are required:

• var - The variable to assign the return of the method call to
• method - The name of the static method to invoke
• className - The name of the class containing the static method

Version:

$Revision: 155420 $

Author:

Robert McIntosh

Field Summary

Fields inherited from class org.apache.commons.jelly.TagSupport

body, context, parent

Constructor Summary

Constructors

Constructor	Description
InvokeStaticTag()

Method Summary

Modifier and Type	Method	Description
void	addArgument(Class type, Object value)	Adds an argument to supply to the method
protected JellyTagException	createLoadClassFailedException(Exception e)	Factory method to create a new JellyTagException instance from a given failure exception
void	doTag(XMLOutput output)	Evaluates this tag after all the tags properties have been initialized.
protected Class	loadClass()	Loads the class using either the class loader which loaded me or the current threads context class loader
void	setClassName(String className)	Sets the fully qualified class name containing the static method
void	setExceptionVar(String var)	Sets the name of a variable that exports the exception thrown by the method's invocation (if any)
void	setMethod(String methodName)	Sets the name of the method to invoke
void	setVar(String var)	Sets the name of the variable exported by this tag

Methods inherited from class org.apache.commons.jelly.TagSupport

findAncestorWithClass, findAncestorWithClass, findAncestorWithClass, findAncestorWithClass, findAncestorWithClass, findAncestorWithClass, getBody, getBodyText, getBodyText, getContext, getParent, invokeBody, isEscapeText, isTrim, setBody, setContext, setEscapeText, setParent, setTrim, trimBody

Methods inherited from class java.lang.Object

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

Constructor Detail

InvokeStaticTag

public InvokeStaticTag()

Method Detail

setVar

public void setVar(String var)

Sets the name of the variable exported by this tag

Parameters:

var - The variable name

setExceptionVar

public void setExceptionVar(String var)

Sets the name of a variable that exports the exception thrown by the method's invocation (if any)

setMethod

public void setMethod(String methodName)

Sets the name of the method to invoke

Parameters:

methodName - The method name

setClassName

public void setClassName(String className)

Sets the fully qualified class name containing the static method

Parameters:

className - The name of the class

addArgument

public void addArgument(Class type,
                        Object value)

Adds an argument to supply to the method

Specified by:

addArgument in interface ArgTagParent

Parameters:

type - The Class type of the argument

value - The value of the argument

doTag

public void doTag(XMLOutput output)
           throws JellyTagException

Description copied from interface: Tag

Evaluates this tag after all the tags properties have been initialized.

Specified by:

doTag in interface Tag

Throws:

JellyTagException

loadClass

protected Class loadClass()
                   throws ClassNotFoundException

Loads the class using either the class loader which loaded me or the current threads context class loader

Throws:

ClassNotFoundException

createLoadClassFailedException

protected JellyTagException createLoadClassFailedException(Exception e)

Factory method to create a new JellyTagException instance from a given failure exception

Parameters:

e - is the exception which occurred attempting to load the class

Returns:

JellyTagException