javax.xml.transform.sax
public class SAXSource extends Object implements Source
Acts as an holder for SAX-style Source.
Note that XSLT requires namespace support. Attempting to transform an input source that is not generated with a namespace-aware parser may result in errors. Parsers can be made namespace aware by calling the {@link javax.xml.parsers.SAXParserFactory#setNamespaceAware(boolean awareness)} method.
Version: $Revision: 226183 $, $Date: 2005-04-08 06:39:14 -0400 (Fri, 08 Apr 2005) $
Field Summary | |
---|---|
static String | FEATURE
If {@link javax.xml.transform.TransformerFactory#getFeature}
returns true when passed this value as an argument,
the Transformer supports Source input of this type. |
Constructor Summary | |
---|---|
SAXSource() Zero-argument default constructor. | |
SAXSource(XMLReader reader, InputSource inputSource)
Create a SAXSource , using an {@link org.xml.sax.XMLReader}
and a SAX InputSource. | |
SAXSource(InputSource inputSource)
Create a SAXSource , using a SAX InputSource .
|
Method Summary | |
---|---|
InputSource | getInputSource()
Get the SAX InputSource to be used for the Source.
|
String | getSystemId() Get the base ID (URI or system ID) from where URIs will be resolved. |
XMLReader | getXMLReader()
Get the XMLReader to be used for the Source.
|
void | setInputSource(InputSource inputSource)
Set the SAX InputSource to be used for the Source.
|
void | setSystemId(String systemId)
Set the system identifier for this Source. |
void | setXMLReader(XMLReader reader)
Set the XMLReader to be used for the Source.
|
static InputSource | sourceToInputSource(Source source)
Attempt to obtain a SAX InputSource object from a Source
object.
|
Zero-argument default constructor. If this constructor is used, and
no SAX source is set using
{@link #setInputSource(InputSource inputSource)} , then the
Transformer
will
create an empty source {@link org.xml.sax.InputSource} using
{@link org.xml.sax.InputSource#InputSource() new InputSource()}.
See Also: Transformer
SAXSource
, using an {@link org.xml.sax.XMLReader}
and a SAX InputSource. The {@link javax.xml.transform.Transformer}
or {@link javax.xml.transform.sax.SAXTransformerFactory} will set itself
to be the reader's {@link org.xml.sax.ContentHandler}, and then will call
reader.parse(inputSource).
Parameters: reader An XMLReader to be used for the parse. inputSource A SAX input source reference that must be non-null and that will be passed to the reader parse method.
SAXSource
, using a SAX InputSource
.
The {@link javax.xml.transform.Transformer} or
{@link javax.xml.transform.sax.SAXTransformerFactory} creates a
reader via {@link org.xml.sax.helpers.XMLReaderFactory}
(if setXMLReader is not used), sets itself as
the reader's {@link org.xml.sax.ContentHandler}, and calls
reader.parse(inputSource).
Parameters: inputSource An input source reference that must be non-null and that will be passed to the parse method of the reader.
Returns: A valid InputSource reference, or null.
Get the base ID (URI or system ID) from where URIs will be resolved.
Returns: Base URL for the Source
, or null
.
Returns: A valid XMLReader or XMLFilter reference, or null.
Parameters: inputSource A valid InputSource reference.
The system identifier is optional if there is a byte stream or a character stream, but it is still useful to provide one, since the application can use it to resolve relative URIs and can include it in error messages and warnings (the parser will attempt to open a connection to the URI only if no byte stream or character stream is specified).
Parameters: systemId The system identifier as a URI string.
Parameters: reader A valid XMLReader or XMLFilter reference.
Parameters: source Must be a non-null Source reference.
Returns: An InputSource, or null if Source can not be converted.