| java.lang.Object
 javax.xml.transform.sax.SAXResult
org.jdom.transform.JDOMResult
| JDOMResult | | public class JDOMResult extends SAXResult (Code) | | A holder for an XSL Transformation result, generally a list of nodes
although it can be a JDOM Document also. As stated by the XSLT 1.0
specification, the result tree generated by an XSL transformation is not
required to be a well-formed XML document. The result tree may have "any
sequence of nodes as children that would be possible for an
element node".
The following example shows how to apply an XSL Transformation
to a JDOM document and get the transformation result in the form
of a list of JDOM nodes:
public static List transform(Document doc, String stylesheet)
throws JDOMException {
try {
Transformer transformer = TransformerFactory.newInstance()
.newTransformer(new StreamSource(stylesheet));
JDOMSource in = new JDOMSource(doc);
JDOMResult out = new JDOMResult();
transformer.transform(in, out);
return out.getResult();
}
catch (TransformerException e) {
throw new JDOMException("XSLT Transformation failed", e);
}
}
See Also: org.jdom.transform.JDOMSource
version:
$Revision: 1.1 $, $Date: 2005/04/27 09:32:43 $
author:
Laurent Bihanic
author:
Jason Hunter |
| Constructor Summary | |
| public | JDOMResult()
Public default constructor. |
| Method Summary | |
| public Document | getDocument()
Returns the result of an XSL Transformation as a JDOM document.
If the result of the transformation is a list of nodes,
this method attempts to convert it into a JDOM document. | | public JDOMFactory | getFactory()
Returns the custom JDOMFactory used to build the transformation
result. | | public List | getResult()
Returns the result of an XSL Transformation as a list of JDOM
nodes. | | public void | setDocument(Document document)
Sets the document produced as result of an XSL Transformation.
Note: This method shall be used by the
javax.xml.transform.Transformer implementations that
natively support JDOM to directly set the transformation
result rather than considering this object as a
SAXResult . | | public void | setFactory(JDOMFactory factory)
Sets a custom JDOMFactory to use when building the
transformation result. | | public void | setHandler(ContentHandler handler)
Sets the target to be a SAX2 ContentHandler. | | public void | setLexicalHandler(LexicalHandler handler)
Sets the SAX2 LexicalHandler for the output.
This is needed to handle XML comments and the like. | | public void | setResult(List result)
Sets the object(s) produced as result of an XSL Transformation.
Note: This method shall be used by the
javax.xml.transform.Transformer implementations that
natively support JDOM to directly set the transformation
result rather than considering this object as a
SAXResult . |
| JDOM_FEATURE | | final public static String JDOM_FEATURE(Code) | | If
javax.xml.transform.TransformerFactory.getFeature returns true when passed this value as an
argument, the Transformer natively supports JDOM.
Note: This implementation does not override
the
SAXResult.FEATURE value defined by its superclass
to be considered as a SAXResult by Transformer implementations
not natively supporting JDOM.
|
| JDOMResult | | public JDOMResult()(Code) | | Public default constructor.
|
| getDocument | | public Document getDocument()(Code) | | Returns the result of an XSL Transformation as a JDOM document.
If the result of the transformation is a list of nodes,
this method attempts to convert it into a JDOM document. If
successful, any subsequent call to
JDOMResult.getResult will
return an empty list.
Warning: The XSLT 1.0 specification states that
the output of an XSL transformation is not a well-formed XML
document but a list of nodes. Applications should thus use
JDOMResult.getResult instead of this method or at least expect
null documents to be returned.
the transformation result as a JDOM document ornull if the result of the transformationcan not be converted into a well-formed document.
See Also: JDOMResult.getResult |
| getFactory | | public JDOMFactory getFactory()(Code) | | Returns the custom JDOMFactory used to build the transformation
result.
the custom JDOMFactory used to build thetransformation result or null if thedefault JDOM classes are being used.
See Also: JDOMResult.setFactory |
| getResult | | public List getResult()(Code) | | Returns the result of an XSL Transformation as a list of JDOM
nodes.
If the result of the transformation is a JDOM document,
this method converts it into a list of JDOM nodes; any
subsequent call to
JDOMResult.getDocument will return
null.
the transformation result as a (possibly empty) list ofJDOM nodes (Elements, Texts, Comments, PIs...). |
| setDocument | | public void setDocument(Document document)(Code) | | Sets the document produced as result of an XSL Transformation.
Note: This method shall be used by the
javax.xml.transform.Transformer implementations that
natively support JDOM to directly set the transformation
result rather than considering this object as a
SAXResult . Applications should not use this
method.
Parameters:
document - the JDOM document result of a transformation.
See Also: JDOMResult.setResult
See Also: JDOMResult.getDocument |
| setFactory | | public void setFactory(JDOMFactory factory)(Code) | | Sets a custom JDOMFactory to use when building the
transformation result. Use a custom factory to build the tree
with your own subclasses of the JDOM classes.
Parameters:
factory - the custom JDOMFactory to use ornull to use the default JDOMclasses.
See Also: JDOMResult.getFactory |
| setHandler | | public void setHandler(ContentHandler handler)(Code) | | Sets the target to be a SAX2 ContentHandler.
Parameters:
handler - Must be a non-null ContentHandler reference. |
| setLexicalHandler | | public void setLexicalHandler(LexicalHandler handler)(Code) | | Sets the SAX2 LexicalHandler for the output.
This is needed to handle XML comments and the like. If the
lexical handler is not set, an attempt should be made by the
transformer to cast the ContentHandler to a LexicalHandler.
Parameters:
handler - A non-null LexicalHandler forhandling lexical parse events. |
| setResult | | public void setResult(List result)(Code) | | Sets the object(s) produced as result of an XSL Transformation.
Note: This method shall be used by the
javax.xml.transform.Transformer implementations that
natively support JDOM to directly set the transformation
result rather than considering this object as a
SAXResult . Applications should not use this
method.
Parameters:
result - the result of a transformation as ajava.util.List list of JDOM nodes(Elements, Texts, Comments, PIs...).
See Also: JDOMResult.getResult |
|
|