This simple class describes a source of input for an XMLReader . An InputSource object can be passed to the parse( ) method of XMLReader , and is also the return value of the EntityResolver.resolveEntity( ) method. Create an InputSource( ) with one of the constructor methods , specifying the system identifier (a URL) of the file to be parsed, or specifying a byte or character stream that the parser should read the document from. In addition to calling the constructor, you may also want to call setSystemId( ) to specify and/or setPublicId( ) to provide identifiers for the document being parsed. Having a filename or URL is useful if an error arises, and your ErrorHandler object needs to print an error message, for example. If you specify the document to parse as a URL or as a byte stream, you can also call setEncoding( ) to specify the character encoding of the document. The parser will use this encoding value if you supply it, but XML documents are supposed to describe their own encoding in the <?xml?> declaration, so the parser ought to be able to determine the encoding of the document even if you do not call setEncoding( ) . This class allows you to specify more than one input source. The XMLReader will first call getCharacterStream( ) and use the returned Reader if there is one. If that method returns false , then it calls getByteStream( ) and uses the InputStream it returns. Finally, if no character or byte stream is found, then the parser will call getSystemId( ) and will attempt to read an XML document from the returned URL. An XMLReader will never use any of the set( ) methods to modify the state of an InputSource object. public class InputSource { // Public Constructors public InputSource ( ); public InputSource (java.io.Reader characterStream ); public InputSource (java.io.InputStream byteStream ); public InputSource (String systemId ); // Public Instance Methods public java.io.InputStream getByteStream ( ); default:null public java.io.Reader getCharacterStream ( ); default:null public String getEncoding ( ); default:null public String getPublicId ( ); default:null public String getSystemId ( ); default:null public void setByteStream (java.io.InputStream byteStream ); public void setCharacterStream (java.io.Reader characterStream ); public void setEncoding (String encoding ); public void setPublicId (String publicId ); public void setSystemId (String systemId ); } Passed Tojavax.xml.parsers.DocumentBuilder.parse( ) , javax.xml.parsers.SAXParser.parse( ) , javax.xml.transform.sax.SAXSource.{SAXSource( ) , setInputSource( )} , javax.xml.xpath.XPath.evaluate( ) , javax.xml.xpath.XPathExpression.evaluate( ) , Parser.parse( ) , XMLReader.parse( ) , org.xml.sax.helpers.ParserAdapter.parse( ) , org.xml.sax.helpers.XMLFilterImpl.parse( ) , org.xml.sax.helpers.XMLReaderAdapter.parse( ) Returned Byjavax.xml.transform.sax.SAXSource.{getInputSource( ) , sourceToInputSource( )} , EntityResolver.resolveEntity( ) , HandlerBase.resolveEntity( ) , org.xml.sax.ext.DefaultHandler2.{getExternalSubset( ) , resolveEntity( )} , org.xml.sax.ext.EntityResolver2.{getExternalSubset( ) , resolveEntity( )} , org.xml.sax.helpers.DefaultHandler.resolveEntity( ) , org.xml.sax.helpers.XMLFilterImpl.resolveEntity( ) |