InputSource


InputSource org.xml.sax

Java 1.4

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 To

javax.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 By

javax.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( )



Java In A Nutshell
Java In A Nutshell, 5th Edition
ISBN: 0596007736
EAN: 2147483647
Year: 2004
Pages: 1220

flylib.com © 2008-2017.
If you may any questions please contact us: flylib@qtcs.net