Class SAXSource
- All Implemented Interfaces:
- 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
 SAXParserFactory.setNamespaceAware(boolean awareness) method.
- Since:
- 1.4
- 
Field SummaryFieldsModifier and TypeFieldDescriptionstatic final StringIfTransformerFactory.getFeature(java.lang.String)returns true when passed this value as an argument, the Transformer supports Source input of this type.
- 
Constructor SummaryConstructorsConstructorDescriptionZero-argument default constructor.SAXSource(InputSource inputSource) Create aSAXSource, using a SAXInputSource.SAXSource(XMLReader reader, InputSource inputSource) Create aSAXSource, using anXMLReaderand a SAX InputSource.
- 
Method SummaryModifier and TypeMethodDescriptionGet the SAX InputSource to be used for the Source.Get the base ID (URI or system ID) from where URIs will be resolved.Get the XMLReader to be used for the Source.booleanisEmpty()Indicates whether theSAXSourceobject is empty.voidsetInputSource(InputSource inputSource) Set the SAX InputSource to be used for the Source.voidsetSystemId(String systemId) Set the system identifier for this Source.voidsetXMLReader(XMLReader reader) Set the XMLReader to be used for the Source.static InputSourcesourceToInputSource(Source source) Attempt to obtain a SAX InputSource object from a Source object.
- 
Field Details- 
FEATUREIfTransformerFactory.getFeature(java.lang.String)returns true when passed this value as an argument, the Transformer supports Source input of this type.- See Also:
 
 
- 
- 
Constructor Details- 
SAXSourcepublic SAXSource()Zero-argument default constructor. If this constructor is used, and no SAX source is set using setInputSource(InputSource inputSource), then theTransformerwill create an empty sourceInputSourceusingnew InputSource().- See Also:
 
- 
SAXSourceCreate aSAXSource, using anXMLReaderand a SAX InputSource. TheTransformerorSAXTransformerFactorywill set itself to be the reader'sContentHandler, 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.
 
- 
SAXSourceCreate aSAXSource, using a SAXInputSource. TheTransformerorSAXTransformerFactorycreates a reader (if setXMLReader is not used), sets itself as the reader'sContentHandler, 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.
 
 
- 
- 
Method Details- 
setXMLReaderSet the XMLReader to be used for the Source.- Parameters:
- reader- A valid XMLReader or XMLFilter reference.
 
- 
getXMLReaderGet the XMLReader to be used for the Source.- Returns:
- A valid XMLReader or XMLFilter reference, or null.
 
- 
setInputSourceSet the SAX InputSource to be used for the Source.- Parameters:
- inputSource- A valid InputSource reference.
 
- 
getInputSourceGet the SAX InputSource to be used for the Source.- Returns:
- A valid InputSource reference, or null.
 
- 
setSystemIdSet 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). - Specified by:
- setSystemIdin interface- Source
- Parameters:
- systemId- The system identifier as a URI string.
 
- 
getSystemIdGet the base ID (URI or system ID) from where URIs will be resolved. - Specified by:
- getSystemIdin interface- Source
- Returns:
- Base URL for the Source, ornull.
 
- 
sourceToInputSourceAttempt 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.
 
- 
isEmptypublic boolean isEmpty()Indicates whether theSAXSourceobject is empty. Empty is defined as follows:- if the system identifier and InputSourcearenull;
- if the system identifier is null, and theInputSourceis empty.
 
- if the system identifier and 
 
-