Package net.n3.nanoxml
Interface IXMLReader
-
- All Known Implementing Classes:
StdXMLReader
public interface IXMLReader
IXMLReader reads the data to be parsed.- Version:
- $Name: RELEASE_2_2_1 $, $Revision: 1.4 $
- Author:
- Marc De Scheemaecker
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description boolean
atEOF()
Returns true if there are no more characters left to be read.boolean
atEOFOfCurrentStream()
Returns true if the current stream has no more characters left to be read.int
getLineNr()
Returns the line number of the data in the current stream.String
getPublicID()
Returns the current public ID.int
getStreamLevel()
Returns the current "level" of the stream on the stack of streams.String
getSystemID()
Returns the current system ID.Reader
openStream(String publicID, String systemID)
Opens a stream from a public and system ID.char
read()
Reads a character.void
setPublicID(String publicID)
Sets the public ID of the current stream.void
setSystemID(String systemID)
Sets the system ID of the current stream.void
startNewStream(Reader reader)
Starts a new stream from a Java reader.void
startNewStream(Reader reader, boolean isInternalEntity)
Starts a new stream from a Java reader.void
unread(char ch)
Pushes the last character read back to the stream.
-
-
-
Method Detail
-
read
char read() throws IOException
Reads a character.- Returns:
- the character
- Throws:
IOException
- If no character could be read.
-
atEOFOfCurrentStream
boolean atEOFOfCurrentStream() throws IOException
Returns true if the current stream has no more characters left to be read.- Throws:
IOException
- If an I/O error occurred.
-
atEOF
boolean atEOF() throws IOException
Returns true if there are no more characters left to be read.- Throws:
IOException
- If an I/O error occurred.
-
unread
void unread(char ch) throws IOException
Pushes the last character read back to the stream.- Parameters:
ch
- the character to push back.- Throws:
IOException
- If an I/O error occurred.
-
getLineNr
int getLineNr()
Returns the line number of the data in the current stream.
-
openStream
Reader openStream(String publicID, String systemID) throws MalformedURLException, FileNotFoundException, IOException
Opens a stream from a public and system ID.- Parameters:
publicID
- the public ID, which may be null.systemID
- the system ID, which is never null.- Throws:
MalformedURLException
- If the system ID does not contain a valid URL.FileNotFoundException
- If the system ID refers to a local file which does not exist.IOException
- If an error occurred opening the stream.
-
startNewStream
void startNewStream(Reader reader)
Starts a new stream from a Java reader. The new stream is used temporary to read data from. If that stream is exhausted, control returns to the "parent" stream.- Parameters:
reader
- the reader to read the new data from.
-
startNewStream
void startNewStream(Reader reader, boolean isInternalEntity)
Starts a new stream from a Java reader. The new stream is used temporary to read data from. If that stream is exhausted, control returns to the parent stream.- Parameters:
reader
- the non-null reader to read the new data fromisInternalEntity
- true if the reader is produced by resolving an internal entity
-
getStreamLevel
int getStreamLevel()
Returns the current "level" of the stream on the stack of streams.
-
setSystemID
void setSystemID(String systemID) throws MalformedURLException
Sets the system ID of the current stream.- Parameters:
systemID
- the system ID.- Throws:
MalformedURLException
- If the system ID does not contain a valid URL.
-
setPublicID
void setPublicID(String publicID)
Sets the public ID of the current stream.- Parameters:
publicID
- the public ID.
-
getSystemID
String getSystemID()
Returns the current system ID.
-
getPublicID
String getPublicID()
Returns the current public ID.
-
-