Package com.helger.css.reader.errorhandler

Interface ICSSParseErrorHandler

All Known Implementing Classes:

CollectingCSSParseErrorHandler, DoNothingCSSParseErrorHandler, LoggingCSSParseErrorHandler, ThrowingCSSParseErrorHandler

public interface ICSSParseErrorHandler

Special CSS handler that is invoked during reading in case of a recoverable errors. In case of unrecoverable errors, a ParseException is thrown!

Author:

Philip Helger

Method Summary

Modifier and Type	Method	Description
default ICSSParseErrorHandler	and(ICSSParseErrorHandler aOther)	Create a new ICSSParseErrorHandler that invokes both this and the other error handler in a serial way.
void	onCSSBrowserCompliantSkip(ParseException ex, Token aFromToken, Token aToToken)	This method is only called in browser compliant mode if a certain part of the CSS is skipped.
void	onCSSDeprecatedProperty(Token aPrefixToken, Token aIdentifierToken)	To be called, if a deprecated old IE 6/7 property is found.
void	onCSSParseError(ParseException aParseEx, Token aLastSkippedToken)	Called upon a recoverable error.
void	onCSSUnexpectedRule(Token aCurrentToken, String sRule, String sMsg)	Called upon an unexpected rule.
default void	onIllegalCharacter(char cIllegalChar)	This method is invoked, when an illegal character is encountered (in TokenManager), and the respective rule is part of the JavaCC grammar.

Method Detail

onCSSParseError

void onCSSParseError(@Nonnull
                     ParseException aParseEx,
                     @Nullable
                     Token aLastSkippedToken)
              throws ParseException

Called upon a recoverable error. The parameter list is similar to the one of the ParseException.

Parameters:

aParseEx - The original parse exception. May not be null.

aLastSkippedToken - The token until which was skipped (incl.) May be null.

Throws:

ParseException - In case the error is fatal and should be propagated.

onCSSUnexpectedRule

void onCSSUnexpectedRule(@Nonnull
                         Token aCurrentToken,
                         @Nonnull @Nonempty
                         String sRule,
                         @Nonnull @Nonempty
                         String sMsg)
                  throws ParseException

Called upon an unexpected rule. This happens e.g. when @import is used in the middle of the file.

Parameters:

aCurrentToken - The token that could not be interpreted. Never null.

sRule - The name of the rule. Always starts with a '@'. Neither null nor empty.

sMsg - The custom error message. Neither null nor empty.

Throws:

ParseException - In case the error is fatal and should be propagated.

onCSSDeprecatedProperty

void onCSSDeprecatedProperty(@Nonnull
                             Token aPrefixToken,
                             @Nonnull
                             Token aIdentifierToken)
                      throws ParseException

To be called, if a deprecated old IE 6/7 property is found.

Parameters:

aPrefixToken - The prefix token found (like '$' or '*'). Never null.

aIdentifierToken - The identifier token found. Never null.

Throws:

ParseException - In case the error is fatal and should be propagated.

Since:

6.5.0

onCSSBrowserCompliantSkip

void onCSSBrowserCompliantSkip(@Nullable
                               ParseException ex,
                               @Nonnull
                               Token aFromToken,
                               @Nonnull
                               Token aToToken)
                        throws ParseException

This method is only called in browser compliant mode if a certain part of the CSS is skipped.

Parameters:

ex - The original ParseException that causes the parser to skip. May be null.

aFromToken - Original token that caused the error and was skipped (inclusive). Never null.

aToToken - The end token until which was skipped (exclusive). Never null.

Throws:

ParseException - In case the error is fatal and should be propagated.

See Also:

CSSReaderSettings.setBrowserCompliantMode(boolean)

onIllegalCharacter

default void onIllegalCharacter(char cIllegalChar)

This method is invoked, when an illegal character is encountered (in TokenManager), and the respective rule is part of the JavaCC grammar.

Parameters:

cIllegalChar - The illegal char

Since:

5.0.3

and

@Nonnull
default ICSSParseErrorHandler and(@Nonnull
                                  ICSSParseErrorHandler aOther)

Create a new ICSSParseErrorHandler that invokes both this and the other error handler in a serial way.

Parameters:

aOther - The other handler to also be invoked.

Returns:

A new instance. Never null.