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: 1.4 $
Author:
Philippe Le Hegaret

Field Summary

Fields inherited from class org.w3c.css.sac.CSSException

SAC_NOT_SUPPORTED_ERR, SAC_SYNTAX_ERR, SAC_UNSPECIFIED_ERR, code

Constructor Summary

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.
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.

Method Summary

int
getColumnNumber()
The column number of the end of the text where the exception occurred.
int
getLineNumber()
The line number of the end of the text where the exception occurred.
String
getURI()
Get the URI of the document where the exception occurred.

Methods inherited from class org.w3c.css.sac.CSSException

getCode, getException, getMessage

Constructor Details

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.

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.

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.

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

Method Details

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.

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.

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.