public class

SAXSource

extends Object
implements Source
java.lang.Object
   ↳ javax.xml.transform.sax.SAXSource

Class Overview

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 setNamespaceAware(boolean) method.

Summary

Constants
String FEATURE If getFeature(String) returns true when passed this value as an argument, the Transformer supports Source input of this type.
Public Constructors
SAXSource()

Zero-argument default constructor.

SAXSource(XMLReader reader, InputSource inputSource)
Create a SAXSource, using an XMLReader and a SAX InputSource.
SAXSource(InputSource inputSource)
Create a SAXSource, using a SAX InputSource.
Public Methods
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.
[Expand]
Inherited Methods
From class java.lang.Object
From interface javax.xml.transform.Source

Constants

public static final String FEATURE

Since: API Level 8

If getFeature(String) returns true when passed this value as an argument, the Transformer supports Source input of this type.

Constant Value: "http://javax.xml.transform.sax.SAXSource/feature"

Public Constructors

public SAXSource ()

Since: API Level 8

Zero-argument default constructor. If this constructor is used, and no SAX source is set using setInputSource(InputSource) , then the Transformer will create an empty source InputSource using new InputSource().

public SAXSource (XMLReader reader, InputSource inputSource)

Since: API Level 8

Create a SAXSource, using an XMLReader and a SAX InputSource. The Transformer or SAXTransformerFactory will set itself to be the reader's 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.

public SAXSource (InputSource inputSource)

Since: API Level 8

Create a SAXSource, using a SAX InputSource. The Transformer or SAXTransformerFactory creates a reader via XMLReaderFactory (if setXMLReader is not used), sets itself as the reader's 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.

Public Methods

public InputSource getInputSource ()

Since: API Level 8

Get the SAX InputSource to be used for the Source.

Returns
  • A valid InputSource reference, or null.

public String getSystemId ()

Since: API Level 8

Get the base ID (URI or system ID) from where URIs will be resolved.

Returns
  • Base URL for the Source, or null.

public XMLReader getXMLReader ()

Since: API Level 8

Get the XMLReader to be used for the Source.

Returns
  • A valid XMLReader or XMLFilter reference, or null.

public void setInputSource (InputSource inputSource)

Since: API Level 8

Set the SAX InputSource to be used for the Source.

Parameters
inputSource A valid InputSource reference.

public void setSystemId (String systemId)

Since: API Level 8

Set the system identifier for this Source. If an input source has already been set, it will set the system ID or that input source, otherwise it will create a new input source.

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.

public void setXMLReader (XMLReader reader)

Since: API Level 8

Set the XMLReader to be used for the Source.

Parameters
reader A valid XMLReader or XMLFilter reference.

public static InputSource sourceToInputSource (Source source)

Since: API Level 8

Attempt to obtain a SAX InputSource object from a Source object.

Parameters
source Must be a non-null Source reference.
Returns
  • An InputSource, or null if Source can not be converted.