org.w3c.css.sac: public class: CSSParseException

org.w3c.css.sac
public class: CSSParseException [javadoc | source]

java.lang.Object
   java.lang.Throwable
      java.lang.Exception
         java.lang.RuntimeException
            org.w3c.css.sac.CSSException
               org.w3c.css.sac.CSSParseException

All Implemented Interfaces:
Serializable

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

Fields inherited from org.w3c.css.sac.CSSException:
s, SAC_UNSPECIFIED_ERR, SAC_NOT_SUPPORTED_ERR, SAC_SYNTAX_ERR, S_SAC_UNSPECIFIED_ERR, S_SAC_NOT_SUPPORTED_ERR, S_SAC_SYNTAX_ERR, e, code

Fields inherited from java.lang.RuntimeException:
serialVersionUID

Fields inherited from java.lang.Exception:
serialVersionUID

Constructor:

Constructor:
public CSSParseException(String message, Locator locator) { super(message); this.code = SAC_SYNTAX_ERR; this.uri = locator.getURI(); this.lineNumber = locator.getLineNumber(); this.columnNumber = locator.getColumnNumber(); } 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. Also see: Locator Parser#setLocale
public CSSParseException(String message, Locator locator, Exception e) { super(SAC_SYNTAX_ERR, message, e); this.uri = locator.getURI(); this.lineNumber = locator.getLineNumber(); this.columnNumber = locator.getColumnNumber(); } 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 Also see: Locator Parser#setLocale
public CSSParseException(String message, String uri, int lineNumber, int columnNumber) { super(message); this.code = SAC_SYNTAX_ERR; this.uri = uri; this.lineNumber = lineNumber; this.columnNumber = 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. Also see: Parser#setLocale
public CSSParseException(String message, String uri, int lineNumber, int columnNumber, Exception e) { super(SAC_SYNTAX_ERR, message, e); this.uri = uri; this.lineNumber = lineNumber; this.columnNumber = columnNumber; } 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. Also see: Parser#setLocale

 public CSSParseException(String message,
    Locator locator) {
	super(message);
	this.code = SAC_SYNTAX_ERR;
	this.uri = locator.getURI();
	this.lineNumber = locator.getLineNumber();
	this.columnNumber = locator.getColumnNumber();
}

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.

Also see:

Locator

Parser#setLocale

 public CSSParseException(String message,
    Locator locator,
    Exception e) {
	super(SAC_SYNTAX_ERR, message, e);
	this.uri = locator.getURI();
	this.lineNumber = locator.getLineNumber();
	this.columnNumber = locator.getColumnNumber();
}

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

Also see:

Locator

Parser#setLocale

 public CSSParseException(String message,
    String uri,
    int lineNumber,
    int columnNumber) {
	super(message);
	this.code = SAC_SYNTAX_ERR;
	this.uri = uri;
	this.lineNumber = lineNumber;
	this.columnNumber = columnNumber;
}

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.

Also see:

Parser#setLocale

 public CSSParseException(String message,
    String uri,
    int lineNumber,
    int columnNumber,
    Exception e) {
	super(SAC_SYNTAX_ERR, message, e);
	this.uri = uri;
	this.lineNumber = lineNumber;
	this.columnNumber = columnNumber;
}

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.

Also see:

Parser#setLocale

Method from org.w3c.css.sac.CSSParseException Summary:
getColumnNumber, getLineNumber, getURI

Methods from org.w3c.css.sac.CSSException:
getCode, getException, getMessage

Methods from java.lang.Throwable:
fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods from java.lang.Object:
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method from org.w3c.css.sac.CSSParseException Detail:
public int getColumnNumber() { return this.columnNumber; } The column number of the end of the text where the exception occurred. The first column in a line is position 1.
public int getLineNumber() { return this.lineNumber; } The line number of the end of the text where the exception occurred.
public String getURI() { return this.uri; } Get the URI of the document where the exception occurred. The URI will be resolved fully.

Method from org.w3c.css.sac.CSSParseException Detail:

 public int getColumnNumber() {
	return this.columnNumber;
}

The first column in a line is position 1.

 public int getLineNumber() {
	return this.lineNumber;
}

The line number of the end of the text where the exception occurred.

 public String getURI() {
	return this.uri;
}

The URI will be resolved fully.