com.icl.saxon
Class ExtendedInputSource

java.lang.Object
  org.xml.sax.InputSource
      com.icl.saxon.ExtendedInputSource

public class ExtendedInputSource

extends org.xml.sax.InputSource

This class allows a SAXON application to encapsulate information about an input source in a single object, which may include a public identifier, a system identifier, a byte stream (possibly with a specified encoding), a character stream, or a file.

Most of the functionality is inherited directly from the SAX InputSource class; the additional functionality offered by ExtendedInputSource is to allow the input source to be specified as a File object.

Constructor Summary

ExtendedInputSource()
Default constructor

ExtendedInputSource(java.io.File file)
Create a new input source from a File.

ExtendedInputSource(org.xml.sax.InputSource in)
Create an ExtendedInputSource from an existing InputSource

ExtendedInputSource(java.io.InputStream stream)
Create a new input source from a byte stream

ExtendedInputSource(java.io.Reader reader)
Create a new input source from a character stream

ExtendedInputSource(java.lang.String systemId)
Create a new input source from a System ID

Method Summary

static java.lang.String	createURL(java.io.File file) Create a URL that refers to a given File
int	getEstimatedLength() Get the estimated length of the file (advisory only; -1 if not known)
void	setEstimatedLength(int length) Set the estimated length of the file (advisory only)
void	setFile(java.io.File file) Specify that input is to come from a given File.

Methods inherited from class org.xml.sax.InputSource

getByteStream, getCharacterStream, getEncoding, getPublicId, getSystemId, setByteStream, setCharacterStream, setEncoding, setPublicId, setSystemId

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ExtendedInputSource

public ExtendedInputSource()

Default constructor

ExtendedInputSource

public ExtendedInputSource(java.lang.String systemId)

Create a new input source from a System ID

ExtendedInputSource

public ExtendedInputSource(java.io.Reader reader)

Create a new input source from a character stream

ExtendedInputSource

public ExtendedInputSource(java.io.InputStream stream)

Create a new input source from a byte stream

ExtendedInputSource

public ExtendedInputSource(java.io.File file)

Create a new input source from a File. Note that the directory in which the file occurs will be used as the base for resolving any system identifiers encountered within the XML document

Example of use:
parser.parse(new ExtendedInputSource(new File("test.xml")))

Parameters:

file - A File object identifying the XML input file

ExtendedInputSource

public ExtendedInputSource(org.xml.sax.InputSource in)

Create an ExtendedInputSource from an existing InputSource

Method Detail

setFile

public void setFile(java.io.File file)

Specify that input is to come from a given File.

setEstimatedLength

public void setEstimatedLength(int length)

Set the estimated length of the file (advisory only)

getEstimatedLength

public int getEstimatedLength()

Get the estimated length of the file (advisory only; -1 if not known)

createURL

public static java.lang.String createURL(java.io.File file)

Create a URL that refers to a given File