com.icl.saxon

Class ExtendedInputSource

public class ExtendedInputSource extends 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.

Author: Michael H. Kay

Constructor Summary
ExtendedInputSource()
Default constructor
ExtendedInputSource(String systemId)
Create a new input source from a System ID
ExtendedInputSource(Reader reader)
Create a new input source from a character stream
ExtendedInputSource(InputStream stream)
Create a new input source from a byte stream
ExtendedInputSource(File file)
Create a new input source from a File.
ExtendedInputSource(InputSource in)
Create an ExtendedInputSource from an existing InputSource
Method Summary
static StringcreateURL(File file)
Create a URL that refers to a given File
intgetEstimatedLength()
Get the estimated length of the file (advisory only; -1 if not known)
voidsetEstimatedLength(int length)
Set the estimated length of the file (advisory only)
voidsetFile(File file)
Specify that input is to come from a given File.

Constructor Detail

ExtendedInputSource

public ExtendedInputSource()
Default constructor

ExtendedInputSource

public ExtendedInputSource(String systemId)
Create a new input source from a System ID

ExtendedInputSource

public ExtendedInputSource(Reader reader)
Create a new input source from a character stream

ExtendedInputSource

public ExtendedInputSource(InputStream stream)
Create a new input source from a byte stream

ExtendedInputSource

public ExtendedInputSource(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(InputSource in)
Create an ExtendedInputSource from an existing InputSource

Method Detail

createURL

public static String createURL(File file)
Create a URL that refers to a given File

getEstimatedLength

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

setEstimatedLength

public void setEstimatedLength(int length)
Set the estimated length of the file (advisory only)

setFile

public void setFile(File file)
Specify that input is to come from a given File.