The following Jelly tag libraries are defined in this project.
jelly:define
Tag library which allows the creation of new tags using Jelly script itself.
This tag library is also available as an XML Schema
Tag Name | Description |
---|---|
attribute | This tag is bound onto a Java Bean class. When the tag is invoked a bean will be created using the tags attributes. The bean may also have an invoke method called invoke(), run(), execute() or some such method which will be invoked after the bean has been configured. |
bean | Binds a Java bean to the given named Jelly tag so that the attributes of the tag set the bean properties.. |
classLoader | Creates a new to dynamically load tags froms. |
dynaBean | Binds a Java bean to the given named Jelly tag so that the attributes of the tag set the bean properties.. |
extend | <extend> is used to extend a dynamic tag defined in an inherited dynamic tag library |
invoke | The <invoke> tag will invoke a given Script instance. It can be used with the <script> tag which defines scripts as variables that can later be invoked by this <invoke> tag. |
invokeBody | <invokeBody> tag is used inside a <tag> tag (i.e. the definition of a dynamic tag) to invoke the tags body when the tag is invoked. |
jellyBean | Binds a Java bean to the given named Jelly tag so that the attributes of the tag set the bean properties. After the body of this tag is invoked then the beans invoke() method will be called, if the bean has one. |
script | <script> tag is used to assign a Script object to a variable. The script can then be called whenever the user wishes maybe from inside an expression or more typically via the <invoke> tag. |
super | <super> tag is used to invoke a parent tag implementation, when a tag extends an existing tag |
tag | <tag> is used to define a new tag using a Jelly script to implement the behaviour of the tag. Parameters can be passed into the new tag using normal XML attribute notations. Inside the body of the tag definition, the attributes can be accessed as normal Jelly variables. |
taglib | The <taglib> tag is used to define a new tag library using a Jelly script. The tag library is identified by its URI. The tags for a taglib are declared using the TagTag. You can 'inherit' tags from a previously defined taglib, as well, allowing runtime extension of tag libraries |
attribute
This tag is bound onto a Java Bean class. When the tag is invoked a bean will be created using the tags attributes. The bean may also have an invoke method called invoke(), run(), execute() or some such method which will be invoked after the bean has been configured.
Attribute Name | Type | Description |
---|---|---|
defaultValue | org.apache.commons.jelly.expression.Expression | Sets the default value of this attribute |
name | java.lang.String | Sets the name of the attribute |
required | boolean | Sets whether this attribute is mandatory or not |
bean
Binds a Java bean to the given named Jelly tag so that the attributes of the tag set the bean properties..
Attribute Name | Type | Description |
---|---|---|
classLoader | java.lang.ClassLoader | Sets the ClassLoader to use to load the class. If no value is set then the current threads context class loader is used. |
className | java.lang.String | Sets the Java class name to use for the tag |
name | java.lang.String | Sets the name of the tag to create |
varAttribute | java.lang.String | Sets the name of the attribute used to define the bean variable that this dynamic tag will output its results as. This defaults to 'var' though this property can be used to change this if it conflicts with a bean property called 'var'. |
classLoader
Creates a new to dynamically load tags froms.
Attribute Name | Type | Description |
---|---|---|
classLoader | java.lang.ClassLoader | Sets the ClassLoader to use to load the class. If no value is set then the current threads context class loader is used. |
className | java.lang.String | Sets the Java class name to use for the tag |
name | java.lang.String | Sets the name of the tag to create |
url | java.lang.String | |
var | java.lang.String | |
varAttribute | java.lang.String | Sets the name of the attribute used to define the bean variable that this dynamic tag will output its results as. This defaults to 'var' though this property can be used to change this if it conflicts with a bean property called 'var'. |
dynaBean
Binds a Java bean to the given named Jelly tag so that the attributes of the tag set the bean properties..
Attribute Name | Type | Description |
---|---|---|
dynaClass | org.apache.commons.beanutils.DynaClass | Sets the DynaClass which will be bound to this dynamic tag. |
name | java.lang.String | Sets the name of the tag to create |
varAttribute | java.lang.String | Sets the name of the attribute used to define the bean variable that this dynamic tag will output its results as. This defaults to 'var' though this property can be used to change this if it conflicts with a bean property called 'var'. |
extend
<extend> is used to extend a dynamic tag defined in an inherited dynamic tag library
Attribute Name | Type | Description |
---|---|---|
name | java.lang.String | Sets the name of the tag to create |
invoke
The <invoke> tag will invoke a given Script instance. It can be used with the <script> tag which defines scripts as variables that can later be invoked by this <invoke> tag.
Attribute Name | Type | Description |
---|---|---|
script | org.apache.commons.jelly.Script | Sets the Script to be invoked by this tag, which typically has been previously defined by the use of the <script> tag. |
invokeBody
<invokeBody> tag is used inside a <tag> tag (i.e. the definition of a dynamic tag) to invoke the tags body when the tag is invoked.
jellyBean
Binds a Java bean to the given named Jelly tag so that the attributes of the tag set the bean properties. After the body of this tag is invoked then the beans invoke() method will be called, if the bean has one.
Attribute Name | Type | Description |
---|---|---|
classLoader | java.lang.ClassLoader | Sets the ClassLoader to use to load the class. If no value is set then the current threads context class loader is used. |
className | java.lang.String | Sets the Java class name to use for the tag |
method | java.lang.String | Sets the name of the method to invoke on the bean. This defaults to "run" so that Runnable objects can be invoked, but this property can be set to whatever is required, such as "execute" or "invoke" |
name | java.lang.String | Sets the name of the tag to create |
varAttribute | java.lang.String | Sets the name of the attribute used to define the bean variable that this dynamic tag will output its results as. This defaults to 'var' though this property can be used to change this if it conflicts with a bean property called 'var'. |
script
<script> tag is used to assign a Script object to a variable. The script can then be called whenever the user wishes maybe from inside an expression or more typically via the <invoke> tag.
Attribute Name | Type | Description |
---|---|---|
var | java.lang.String | Sets the variable name of the tag to create |
super
<super> tag is used to invoke a parent tag implementation, when a tag extends an existing tag
tag
<tag> is used to define a new tag using a Jelly script to implement the behaviour of the tag. Parameters can be passed into the new tag using normal XML attribute notations. Inside the body of the tag definition, the attributes can be accessed as normal Jelly variables.
Attribute Name | Type | Description |
---|---|---|
name | java.lang.String | Sets the name of the tag to create |
taglib
The <taglib> tag is used to define a new tag library using a Jelly script. The tag library is identified by its URI.
The tags for a taglib are declared using the TagTag.
You can 'inherit' tags from a previously defined taglib, as well, allowing runtime extension of tag libraries
Attribute Name | Type | Description |
---|---|---|
inherit | boolean | Sets whether this dynamic tag should inherit from the current existing tag library of the same URI. This feature is enabled by default so that tags can easily be some tags can be overridden in an existing library, such as when making Mock Tags. You can disable this option if you want to disable any tags in the base library, turning them into just normal static XML. |
uri | java.lang.String | Sets the namespace URI to register this new dynamic tag library with |