com.sun.ukit.jaxp

Class Parser

java.lang.Object

javax.xml.parsers.SAXParser

com.sun.ukit.jaxp.Parser

All Implemented Interfaces:

Locator

public final class Parser
extends SAXParser
implements Locator

XML non-validating parser. This non-validating parser conforms to Extensible Markup Language (XML) 1.0 and "Namespaces in XML" specifications. The API used by the parser is JSR-172 subset of JAXP and SAX2.

See Also:

DefaultHandler

Field Summary

Fields

Modifier and Type	Field and Description
static char	EOS The end of stream character.
static String	FAULT

Constructor Summary

Constructors

Constructor and Description
Parser(boolean nsaware) Constructor.

Method Summary

Methods

Modifier and Type	Method and Description
int	getColumnNumber() Return the column number where the current document event ends.
int	getLineNumber() Return the line number where the current document event ends.
String	getPublicId() Return the public identifier for the current document event.
String	getSystemId() Return the system identifier for the current document event.
boolean	isNamespaceAware() Indicates whether or not this parser is configured to understand namespaces.
boolean	isValidating() Indicates whether or not this parser is configured to validate XML documents.
void	parse(InputSource is, DefaultHandler handler) Parse the content given InputSource as XML using the specified DefaultHandler.
void	parse(InputStream src, DefaultHandler handler) Parse the content of the given InputStream instance as XML using the specified DefaultHandler.

Methods inherited from class java.lang.Object

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

Field Detail

FAULT

public static final String FAULT

See Also:

Constant Field Values

EOS

public static final char EOS

The end of stream character.

See Also:

Constant Field Values

Constructor Detail

Parser

public Parser(boolean nsaware)

Constructor.

Method Detail

getPublicId

public String getPublicId()

Return the public identifier for the current document event.

The return value is the public identifier of the document entity or of the external parsed entity in which the markup triggering the event appears.

Specified by:

getPublicId in interface Locator

Returns:

A string containing the public identifier, or null if none is available.

See Also:

getSystemId()

getSystemId

public String getSystemId()

Return the system identifier for the current document event.

The return value is the system identifier of the document entity or of the external parsed entity in which the markup triggering the event appears.

If the system identifier is a URL, the parser must resolve it fully before passing it to the application.

Specified by:

getSystemId in interface Locator

Returns:

A string containing the system identifier, or null if none is available.

See Also:

getPublicId()

getLineNumber

public int getLineNumber()

Return the line number where the current document event ends.

Specified by:

getLineNumber in interface Locator

Returns:

Always returns -1 indicating the line number is not available.

See Also:

getColumnNumber()

getColumnNumber

public int getColumnNumber()

Return the column number where the current document event ends.

Specified by:

getColumnNumber in interface Locator

Returns:

Always returns -1 indicating the column number is not available.

See Also:

getLineNumber()

isNamespaceAware

public boolean isNamespaceAware()

Indicates whether or not this parser is configured to understand namespaces.

Specified by:

isNamespaceAware in class SAXParser

Returns:

true if this parser is configured to understand namespaces; false otherwise.

isValidating

public boolean isValidating()

Indicates whether or not this parser is configured to validate XML documents.

Specified by:

isValidating in class SAXParser

Returns:

true if this parser is configured to validate XML documents; false otherwise.

parse

public void parse(InputStream src,
         DefaultHandler handler)
           throws SAXException,
                  IOException

Parse the content of the given InputStream instance as XML using the specified DefaultHandler.

Specified by:

parse in class SAXParser

Parameters:

src - InputStream containing the content to be parsed.

handler - The SAX DefaultHandler to use.

Throws:

IOException - If any IO errors occur.

IllegalArgumentException - If the given InputStream or handler is null.

SAXException - If the underlying parser throws a SAXException while parsing.

See Also:

DefaultHandler

parse

public void parse(InputSource is,
         DefaultHandler handler)
           throws SAXException,
                  IOException

Parse the content given InputSource as XML using the specified DefaultHandler.

Specified by:

parse in class SAXParser

Parameters:

is - The InputSource containing the content to be parsed.

handler - The SAX DefaultHandler to use.

Throws:

IOException - If any IO errors occur.

IllegalArgumentException - If the InputSource or handler is null.

SAXException - If the underlying parser throws a SAXException while parsing.

See Also:

DefaultHandler