XML Tag Library - Tag Documentation

Tag Documentation

The following document contains a summary of all theJellytag libraries.

Tag Libraries

Library	Description
jelly:xml	The XML Tags from the JSTL

jelly:xml

The XML Tags from the JSTL

Tag Name	Description
attribute	Adds an XML attribute to the parent element tag likethe `<xsl:attribute>` tag.
comment	A tag which outputs a comment to the underlying XMLOutput based on thecontents of its body.
copy	A tag which performs a copy operation like the XSLT tag,performing a shallow copy of the element and its attributes but no content.
copyOf	A tag which performs a copy-of operation like the XSLT tag
doctype	A tag which outputs a DOCTYPE declaration to the current XML output pipe.Note that there should only be a single DOCTYPE declaration in any XML stream andit should occur before any element content.
element	A tag to produce an XML element which can contain other attributesor elements like the `<xsl:element>` tag.
expr	A tag which performs a string XPath expression; similar to <xsl:value-of>in XSLT
forEach	A tag which performs an iteration over the results of an XPath expression
if	Evaluates the XPath expression to be a boolean and only evaluates the bodyif the expression is true.
param	Sets a parameter in the parent transform tag
parse	A tag which parses some XML and defines a variable with the parsed Document.The XML can either be specified as its body or can be passed in via thexml property which can be a Reader, InputStream, URL or String URI.
replaceNamespace	Replace namespace is a filter to change the namespace of anyelemement attribute passing through it.
set	A tag which defines a variable from an XPath expression.This function creates a variable of type java.util.Listor org.dom4j.Node(for example org.dom4j.Elementor org.dom4j.Attribute).Thus, the variable created from xml:set can beused from the other xml library functions.
sort	A tag that can sort a list of xml nodes via an xpath expression.
transform	A tag which parses some XML, applies an xslt transform to itand defines a variable with the transformed Document.The XML can either be specified as its body or can be passed in via thexml property which can be a Reader, InputStream, URL or String URI.The XSL can be passed in via thexslt property which can be a Reader, InputStream, URL or String URI.

Tags

[tag libraries] [tags]

xml:attribute

Adds an XML attribute to the parent element tag likethe <xsl:attribute> tag.

Attribute Name	Type	Description
URI	java.lang.String	Sets the namespace URI of the element
escapeText	boolean
name	java.lang.String	Sets the name of the attribute.
trim	boolean

xml:comment

A tag which outputs a comment to the underlying XMLOutput based on thecontents of its body.

Attribute Name	Type	Description
escapeText	boolean
text	java.lang.String	Sets the comment text. If no text is specified then the body of the tagis used instead.
trim	boolean

xml:copy

A tag which performs a copy operation like the XSLT tag,performing a shallow copy of the element and its attributes but no content.

Attribute Name	Type	Description
escapeText	boolean
lexical	boolean
select	org.jaxen.XPath	Sets the XPath expression to evaluate.
trim	boolean

xml:copyOf

A tag which performs a copy-of operation like the XSLT tag

Attribute Name	Type	Description
escapeText	boolean
lexical	boolean
select	org.jaxen.XPath	Sets the XPath expression to evaluate.
trim	boolean

xml:doctype

A tag which outputs a DOCTYPE declaration to the current XML output pipe.Note that there should only be a single DOCTYPE declaration in any XML stream andit should occur before any element content.

Attribute Name	Type	Description
escapeText	boolean
name	java.lang.String	Sets the document type name of the DOCTYPE
publicId	java.lang.String	Sets the declared public identifier for DTD
systemId	java.lang.String	Sets the declared system identifier for the DTD
trim	boolean

xml:element

A tag to produce an XML element which can contain other attributesor elements like the <xsl:element> tag.

Attribute Name	Type	Description
URI	java.lang.String	Sets the namespace URI of the element
escapeText	boolean
name	java.lang.String	Sets the qualified name of the element
trim	boolean

xml:expr

A tag which performs a string XPath expression; similar to <xsl:value-of>in XSLT

Attribute Name	Type	Description
escapeText	boolean
select	org.jaxen.XPath	Sets the XPath expression to evaluate.
trim	boolean

xml:forEach

A tag which performs an iteration over the results of an XPath expression

Attribute Name	Type	Description
descending	boolean	Set whether to sort ascending or descending.
escapeText	boolean
select	org.jaxen.XPath	Sets the XPath selection expression
sort	org.jaxen.XPath	Sets the xpath expression to use to sort selected nodes.
trim	boolean
var	java.lang.String	Sets the variable name to export for the item being iterated over

xml:if

Evaluates the XPath expression to be a boolean and only evaluates the bodyif the expression is true.

Attribute Name	Type	Description
escapeText	boolean
select	org.jaxen.XPath	Sets the XPath expression to evaluate.
trim	boolean

xml:param

Sets a parameter in the parent transform tag

Attribute Name	Type	Description
escapeText	boolean
name	java.lang.String	Sets the name of the attribute
trim	boolean
value	java.lang.Object	Sets the value of the attribute

A tag which parses some XML and defines a variable with the parsed Document.The XML can either be specified as its body or can be passed in via thexml property which can be a Reader, InputStream, URL or String URI.

Attribute Name	Type	Description
SAXReader	org.dom4j.io.SAXReader	Sets the SAXReader used for parsing
escapeText	boolean
text	java.lang.String	Sets the text to be parsed by this parser
trim	boolean
validate	boolean	Sets whether XML validation is enabled or disabled
var	java.lang.String	Sets the variable name that will be used for the Document variable created
xml	java.lang.Object	Sets the source of the XML which is either a String URI, a File, Reader or InputStream

xml:replaceNamespace

Replace namespace is a filter to change the namespace of anyelemement attribute passing through it.

Attribute Name	Type	Description
escapeText	boolean
fromURI	java.lang.String	Sets the source namespace URI to replace.
toURI	java.lang.String	Sets the destination namespace URI to replace.
trim	boolean

xml:set

A tag which defines a variable from an XPath expression.This function creates a variable of type java.util.Listor org.dom4j.Node(for example org.dom4j.Elementor org.dom4j.Attribute).Thus, the variable created from xml:set can beused from the other xml library functions.

Attribute Name	Type	Description
asString	boolean	If set to true, will ensure that the (XPath) text-valueof the selected node is taken instead of the nodeitself.This ensures that, thereafter, string manipulationscan be performed on the result.
delim	java.lang.String	If set, returns a string delimited by this delimiter.Implies `asString` to be true.
descending	boolean	Set whether to sort ascending or descending.
escapeText	boolean
select	org.jaxen.XPath	Sets the XPath expression to evaluate.
single	boolean	If set to true will only take the first element matching.It then guarantees that the result is of type org.dom4j.Nodethereby making sure that, for example,when an element is selected, one can directly call such methodsas setAttribute. If set to false, guarantees that a list is returned.If set to false, guarantees that a list is returned.
sort	org.jaxen.XPath	Sets the xpath expression to use to sort selected nodes.Ignored if single is true.
trim	boolean
var	java.lang.String	Sets the variable name to define for this expression

xml:sort

A tag that can sort a list of xml nodes via an xpath expression.

Attribute Name	Type	Description
descending	boolean	Set whether to sort ascending or descending.
escapeText	boolean
list	java.util.List	Set the list to sort.
sort	org.jaxen.XPath	Sets the xpath expression to use to sort selected nodes.
trim	boolean

xml:transform

A tag which parses some XML, applies an xslt transform to itand defines a variable with the transformed Document.The XML can either be specified as its body or can be passed in via thexml property which can be a Reader, InputStream, URL or String URI.The XSL can be passed in via thexslt property which can be a Reader, InputStream, URL or String URI.

Attribute Name	Type	Description
SAXReader	org.dom4j.io.SAXReader	Sets the SAXReader used for parsing
escapeText	boolean
text	java.lang.String	Sets the text to be parsed by this parser
trim	boolean
validate	boolean	Sets whether XML validation is enabled or disabled
var	java.lang.String	Sets the variable name that will be used for the Document variable created
xml	java.lang.Object	Sets the source of the XML which is either a String URI, a File, Reader or InputStream
xslt	java.lang.Object	Sets the source of the XSL which is either a String URI, Reader orInputStream