Class Parser

public class Parser
{
  // Constructors
  public Parser();

  // Methods
  public final XMLOutputStream createOutputStream(OutputStream out);
  public final void parse(URL url, ElementFactory factory, DTD dtd,
        Element root) throws ParseException;
  final public void parse(InputStream in, ElementFactory factory,
        DTD dtd, Element root) throws ParseException;
  final public void report(ParseException e, OutputStream out);
}

This class implements an eXtensible Markup Language (XML) parser according to the latest World Wide Web Consortium (W3C) working draft of the XML specification. This parser class is used internally by the XML document load method, so you shouldn't need to use it directly.

Constructors

Parser

public Parser();

Creates a new parser object.

Methods

createOutputStream

public final XMLOutputStream createOutputStream(OutputStream out);

Creates an output stream that best matches the XML data format found during parsing. For example, this will match big endian or little endian XML data formats.

Return Value:

Returns an XMLOutputStream object that uses the newline separator defined by the system property "line.separator".

Parameter	Description
out	The output stream.

parse

public final void parse(URL url, ElementFactory factory, DTD dtd,
        Element root) throws ParseException;

Parses the XML document pointed to by the given URL and creates the corresponding XML document hierarchy.

Return Value:

No return value.

Parameter	Description
url	The URL address of the XML document to parse.
factory	The element factory used to create XML Element objects during parsing.
dtd	The object that the parser stores DTD information in.
root	The starting root node to which children are added during parsing.

Exceptions:

com.ms.xml.parser.ParseException if syntax or other errors are encountered.

parse

final public void parse(InputStream in, ElementFactory factory, DTD dtd,
        Element root) throws ParseException;

Parses the XML from the given input stream.

Return Value:

No return value.

Parameter	Description
in	The input stream containing XML data to parse.
factory	The element factory used to create XML Element objects during parsing.
dtd	The object that the parser stores DTD information in.
root	The starting root node to which children are added during parsing.

Exceptions:

com.ms.xml.parser.ParseException if syntax or other errors are encountered.

report

final public void report(ParseException e, OutputStream out);

Reports errors to the specified output stream including parsing context and stack trace where the error occurred.

Return Value:

No return value.

Parameter	Description
e	The exception to report.
out	The output stream to write the report to.