org.jdom.transform
public class JDOMSource extends SAXSource
The is provides input to a {@link javax.xml.transform.Transformer JAXP TrAX Transformer}.
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);
}
}
Version: $Revision: 1.18 $, $Date: 2004/08/31 04:43:48 $
Field Summary | |
---|---|
static String | JDOM_FEATURE
If {@link javax.xml.transform.TransformerFactory#getFeature}
returns true when passed this value as an
argument, the Transformer natively supports JDOM.
|
Constructor Summary | |
---|---|
JDOMSource(Document source)
Creates a JDOM TrAX source wrapping a JDOM document.
| |
JDOMSource(List source)
Creates a JDOM TrAX source wrapping a list of JDOM nodes.
| |
JDOMSource(Element source)
Creates a JDOM TrAX source wrapping a JDOM element.
|
Method Summary | |
---|---|
Document | getDocument()
Returns the source document used by this TrAX source.
|
List | getNodes()
Returns the source node list used by this TrAX source.
|
XMLReader | getXMLReader()
Returns the XMLReader to be used for the Source.
|
void | setDocument(Document source)
Sets the source document used by this TrAX source.
|
void | setInputSource(InputSource inputSource)
Sets the SAX InputSource to be used for the Source.
|
void | setNodes(List source)
Sets the source node list used by this TrAX source.
|
void | setXMLReader(XMLReader reader)
Set the XMLReader to be used for the Source.
|
true
when passed this value as an
argument, the Transformer natively supports JDOM.
Note: This implementation does not override the {@link SAXSource#FEATURE} value defined by its superclass to be considered as a SAXSource by Transformer implementations not natively supporting JDOM.
Parameters: source the JDOM document to use as source for the transformations
Throws: IllegalArgumentException if source
is
null
.
Parameters: source the JDOM nodes to use as source for the transformations
Throws: IllegalArgumentException if source
is
null
.
Parameters: source the JDOM element to use as source for the transformations
Throws: IllegalArgumentException if source
is
null
.
Returns: the source document used by this TrAX source or
null
if the source is a node list.
See Also: JDOMSource
Returns: the source node list used by this TrAX source or
null
if the source is a JDOM document.
See Also: JDOMSource
This implementation returns a specific XMLReader reading the XML data from the source JDOM document.
Returns: an XMLReader reading the XML data from the source JDOM document.
Parameters: source the JDOM document to use as source for the transformations
Throws: IllegalArgumentException if source
is
null
.
See Also: JDOMSource
As this implementation only supports JDOM document as data source, this method always throws an {@link UnsupportedOperationException}.
Parameters: inputSource a valid InputSource reference.
Throws: UnsupportedOperationException always!
Parameters: source the JDOM nodes to use as source for the transformations
Throws: IllegalArgumentException if source
is
null
.
See Also: JDOMSource
As this implementation only supports JDOM document as data source, this method throws an {@link UnsupportedOperationException} if the provided reader object does not implement the SAX {@link XMLFilter} interface. Otherwise, the JDOM document reader will be attached as parent of the filter chain.
Parameters: reader a valid XMLReader or XMLFilter reference.
Throws: UnsupportedOperationException if reader
is not a SAX
{@link XMLFilter}.
See Also: JDOMSource