org.w3c.css.sac

Class CSSParseException

public class CSSParseException extends CSSException

Encapsulate a CSS parse error or warning.

This exception will include information for locating the error in the original CSS document. Note that although the application will receive a CSSParseException as the argument to the handlers in the ErrorHandler interface, the application is not actually required to throw the exception; instead, it can simply read the information in it and take a different action.

Since this exception is a subclass of CSSException, it inherits the ability to wrap another exception.

Version: $Revision: 477010 $

Author: Philippe Le Hegaret

Constructor Summary
CSSParseException(String message, Locator locator)
Create a new CSSParseException from a message and a Locator.
CSSParseException(String message, Locator locator, Exception e)
Wrap an existing exception in a CSSParseException.
CSSParseException(String message, String uri, int lineNumber, int columnNumber)
Create a new CSSParseException.
CSSParseException(String message, String uri, int lineNumber, int columnNumber, Exception e)
Create a new CSSParseException with an embedded exception.
Method Summary
intgetColumnNumber()
The column number of the end of the text where the exception occurred.
intgetLineNumber()
The line number of the end of the text where the exception occurred.
StringgetURI()
Get the URI of the document where the exception occurred.

Constructor Detail

CSSParseException

public CSSParseException(String message, Locator locator)
Create a new CSSParseException from a message and a Locator.

This constructor is especially useful when an application is creating its own exception from within a DocumentHandler callback.

Parameters: message The error or warning message. locator The locator object for the error or warning.

See Also: Locator Parser

CSSParseException

public CSSParseException(String message, Locator locator, Exception e)
Wrap an existing exception in a CSSParseException.

This constructor is especially useful when an application is creating its own exception from within a DocumentHandler callback, and needs to wrap an existing exception that is not a subclass of CSSException.

Parameters: message The error or warning message, or null to use the message from the embedded exception. locator The locator object for the error or warning. e Any exception

See Also: Locator Parser

CSSParseException

public CSSParseException(String message, String uri, int lineNumber, int columnNumber)
Create a new CSSParseException.

This constructor is most useful for parser writers.

the parser must resolve the URI fully before creating the exception.

Parameters: message The error or warning message. uri The URI of the document that generated the error or warning. lineNumber The line number of the end of the text that caused the error or warning. columnNumber The column number of the end of the text that cause the error or warning.

See Also: Parser

CSSParseException

public CSSParseException(String message, String uri, int lineNumber, int columnNumber, Exception e)
Create a new CSSParseException with an embedded exception.

This constructor is most useful for parser writers who need to wrap an exception that is not a subclass of CSSException.

The parser must resolve the URI fully before creating the exception.

Parameters: message The error or warning message, or null to use the message from the embedded exception. uri The URI of the document that generated the error or warning. lineNumber The line number of the end of the text that caused the error or warning. columnNumber The column number of the end of the text that cause the error or warning. e Another exception to embed in this one.

See Also: Parser

Method Detail

getColumnNumber

public int getColumnNumber()
The column number of the end of the text where the exception occurred.

The first column in a line is position 1.

Returns: An integer representing the column number, or -1 if none is available.

See Also: Locator

getLineNumber

public int getLineNumber()
The line number of the end of the text where the exception occurred.

Returns: An integer representing the line number, or -1 if none is available.

See Also: Locator

getURI

public String getURI()
Get the URI of the document where the exception occurred.

The URI will be resolved fully.

Returns: A string containing the URI, or null if none is available.

See Also: Locator