com.bea.xml.stream.reader
public final class XmlReader extends Reader
Note that the autodetection facility should be used only on data streams which have an unknown character encoding. For example, it should never be used on MIME text/xml entities.
Note that XML processors are only required to support UTF-8 and UTF-16 character encodings. Autodetection permits the underlying Java implementation to provide support for many other encodings, such as US-ASCII, ISO-8859-5, Shift_JIS, EUC-JP, and ISO-2022-JP.
Version: $Revision: 1.1 $
Method Summary | |
---|---|
void | close()
Closes the reader. |
static Reader | createReader(InputStream in)
Constructs the reader from an input stream, autodetecting
the encoding to use according to the heuristic specified
in the XML 1.0 recommendation.
|
static Reader | createReader(InputStream in, String encoding)
Creates a reader supporting the given encoding, mapping
from standard encoding names to ones that understood by
Java where necessary.
|
String | getEncoding() Returns the standard name of the encoding in use |
void | mark(int value)
Sets a mark allowing a limited number of characters to
be "peeked", by reading and then resetting. |
boolean | markSupported()
Returns true iff the reader supports mark/reset. |
int | read(char[] buf, int off, int len)
Reads the number of characters read into the buffer, or -1 on EOF. |
int | read()
Reads a single character. |
boolean | ready()
Returns true iff input characters are known to be ready. |
void | reset()
Resets the current position to the last marked position. |
long | skip(long value)
Skips a specified number of characters. |
Parameters: in the input stream from which the reader is constructed
Throws: IOException on error, such as unrecognized encoding
Parameters: in the input stream from which the reader is constructed encoding the IETF standard name of the encoding to use; if null, autodetection is used.
Throws: IOException on error, including unrecognized encoding
Parameters: value how many characters may be "peeked".