org.w3c.css.sac
Class CSSParseException

java.lang.Object
  extended by java.lang.Throwable
      extended by java.lang.Exception
          extended by java.lang.RuntimeException
              extended by org.w3c.css.sac.CSSException
                  extended by org.w3c.css.sac.CSSParseException
All Implemented Interfaces:
java.io.Serializable

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
See Also:
Serialized Form

Field Summary
 
Fields inherited from class org.w3c.css.sac.CSSException
SAC_NOT_SUPPORTED_ERR, SAC_SYNTAX_ERR, SAC_UNSPECIFIED_ERR
 
Constructor Summary
CSSParseException(java.lang.String message, Locator locator)
          Create a new CSSParseException from a message and a Locator.
CSSParseException(java.lang.String message, Locator locator, java.lang.Exception e)
          Wrap an existing exception in a CSSParseException.
CSSParseException(java.lang.String message, java.lang.String uri, int lineNumber, int columnNumber)
          Create a new CSSParseException.
CSSParseException(java.lang.String message, java.lang.String uri, int lineNumber, int columnNumber, java.lang.Exception e)
          Create a new CSSParseException with an embedded exception.
 
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.
 java.lang.String getURI()
          Get the URI of the document where the exception occurred.
 
Methods inherited from class org.w3c.css.sac.CSSException
getCode, getException, getMessage
 
Methods inherited from class java.lang.Throwable
fillInStackTrace, getCause, getLocalizedMessage, getStackTrace, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

CSSParseException

public CSSParseException(java.lang.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.setLocale(java.util.Locale)

CSSParseException

public CSSParseException(java.lang.String message,
                         Locator locator,
                         java.lang.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.setLocale(java.util.Locale)

CSSParseException

public CSSParseException(java.lang.String message,
                         java.lang.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.setLocale(java.util.Locale)

CSSParseException

public CSSParseException(java.lang.String message,
                         java.lang.String uri,
                         int lineNumber,
                         int columnNumber,
                         java.lang.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.setLocale(java.util.Locale)
Method Detail

getURI

public java.lang.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.getURI()

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.getLineNumber()

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.getColumnNumber()