Class SAXSource
- java.lang.Object
-
- javax.xml.transform.sax.SAXSource
-
- All Implemented Interfaces:
- Source
- Direct Known Subclasses:
- JAXBSource
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
SAXParserFactory.setNamespaceAware(boolean awareness)
method.
-
-
Field Summary
Fields Modifier and Type Field and Description static String
FEATURE
IfTransformerFactory.getFeature(java.lang.String)
returns true when passed this value as an argument, the Transformer supports Source input of this type.
-
Constructor Summary
Constructors Constructor and Description SAXSource()
Zero-argument default constructor.SAXSource(InputSource inputSource)
Create aSAXSource
, using a SAXInputSource
.SAXSource(XMLReader reader, InputSource inputSource)
Create aSAXSource
, using anXMLReader
and a SAX InputSource.
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method and Description 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.
-
-
-
Field Detail
FEATURE
public static final String FEATURE
IfTransformerFactory.getFeature(java.lang.String)
returns true when passed this value as an argument, the Transformer supports Source input of this type.- See Also:
- Constant Field Values
-
Constructor Detail
SAXSource
public SAXSource()
Zero-argument default constructor. If this constructor is used, and no SAX source is set using
setInputSource(InputSource inputSource)
, then theTransformer
will create an empty sourceInputSource
usingnew InputSource()
.
SAXSource
public SAXSource(XMLReader reader, InputSource inputSource)
Create aSAXSource
, using anXMLReader
and a SAX InputSource. TheTransformer
orSAXTransformerFactory
will 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.
SAXSource
public SAXSource(InputSource inputSource)
Create aSAXSource
, using a SAXInputSource
. TheTransformer
orSAXTransformerFactory
creates a reader viaXMLReaderFactory
(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 Detail
setXMLReader
public void setXMLReader(XMLReader reader)
Set the XMLReader to be used for the Source.- Parameters:
-
reader
- A valid XMLReader or XMLFilter reference.
getXMLReader
public XMLReader getXMLReader()
Get the XMLReader to be used for the Source.- Returns:
- A valid XMLReader or XMLFilter reference, or null.
setInputSource
public void setInputSource(InputSource inputSource)
Set the SAX InputSource to be used for the Source.- Parameters:
-
inputSource
- A valid InputSource reference.
getInputSource
public InputSource getInputSource()
Get the SAX InputSource to be used for the Source.- Returns:
- A valid InputSource reference, or null.
setSystemId
public void setSystemId(String systemId)
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).
- Specified by:
-
setSystemId
in interfaceSource
- Parameters:
-
systemId
- The system identifier as a URI string.
getSystemId
public String getSystemId()
Get the base ID (URI or system ID) from where URIs will be resolved.
- Specified by:
-
getSystemId
in interfaceSource
- Returns:
-
Base URL for the
Source
, ornull
.
sourceToInputSource
public static InputSource sourceToInputSource(Source source)
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.
-
Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2022, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.