Parses an XML document and transforms it into a DOM document.

Class Name

atg.droplet.xml.XMLToDOM

Component

/atg/dynamo/droplet/xml/XMLToDOM

Required Input Parameters

None

Optional Input Parameters

input

The XML document to parse. This can be either the absolute or relative URL for an XML document. If omitted, the open parameter unset executes.

validate

Determines whether the parser should validate this document against the DTD specified in the input parameter. Options include:

If the XML document lacks a DTD, you must omit this parameter.

Output Parameters

document

Set to a DOM document if the XML document is successfully retrieved and parsed.

errors

Set to an enumeration of Exceptions if failures occurred when parsing or retrieving the XML document.

Open Parameters

unset

Rendered if the input parameter is not set.

output

Rendered if the XML document is retrieved and parsed.

failure

Rendered when the XML document cannot be parsed or retrieved.

Usage Notes

XMLToDOM parses an XML document that is specified by the input parameter. The result of the parse is bound to the document parameter, which can then be manipulated inside the output open parameter.

XMLToDOM does not have any inherent way to output its results. You typically nest within its output parameter a servlet bean or code that can handle the resulting Data Object Model (DOM) component.

Example

See Processing XML in a JSP.

 
loading table of contents...