Package com.helger.css.reader.errorhandler

Class CollectingCSSParseErrorHandler

java.lang.Object

com.helger.css.reader.errorhandler.CollectingCSSParseErrorHandler

All Implemented Interfaces:

ICSSParseErrorHandler

@ThreadSafe
public class CollectingCSSParseErrorHandler
extends Object
implements ICSSParseErrorHandler

A collecting implementation of ICSSParseErrorHandler. So in case a recoverable error occurs, it is remembered in the internal list and can be retrieved by getAllParseErrors().

Author:

Philip Helger

Constructor Summary

Constructors

Constructor	Description
CollectingCSSParseErrorHandler()

Method Summary

Modifier and Type	Method	Description
com.helger.commons.collection.impl.ICommonsList<CSSParseError>	getAllParseErrors()
int	getParseErrorCount()
boolean	hasParseErrors()
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.
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.
String	toString()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface com.helger.css.reader.errorhandler.ICSSParseErrorHandler

and

Constructor Details

CollectingCSSParseErrorHandler

public CollectingCSSParseErrorHandler()

Method Details

onCSSParseError

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

Description copied from interface: ICSSParseErrorHandler

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

Specified by:

onCSSParseError in interface ICSSParseErrorHandler

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

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

Description copied from interface: ICSSParseErrorHandler

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

Specified by:

onCSSUnexpectedRule in interface ICSSParseErrorHandler

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

public void onCSSDeprecatedProperty(@Nonnull
 Token aPrefixToken,
 @Nonnull
 Token aIdentifierToken)

Description copied from interface: ICSSParseErrorHandler

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

Specified by:

onCSSDeprecatedProperty in interface ICSSParseErrorHandler

Parameters:

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

aIdentifierToken - The identifier token found. Never null.

onCSSBrowserCompliantSkip

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

Description copied from interface: ICSSParseErrorHandler

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

Specified by:

onCSSBrowserCompliantSkip in interface ICSSParseErrorHandler

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

public void onIllegalCharacter(char cIllegalChar)

Description copied from interface: ICSSParseErrorHandler

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

Specified by:

onIllegalCharacter in interface ICSSParseErrorHandler

Parameters:

cIllegalChar - The illegal char

hasParseErrors

@Nonnegative
public boolean hasParseErrors()

Returns:

true if at least one parse error is contained, false otherwise.

getParseErrorCount

@Nonnegative
public int getParseErrorCount()

Returns:

The number of contained parse errors. Always ≥ 0.

getAllParseErrors

@Nonnull
@ReturnsMutableCopy
public com.helger.commons.collection.impl.ICommonsList<CSSParseError> getAllParseErrors()

Returns:

A copy of the list with all contained errors. Never null but maybe empty.

See Also:

• getParseErrorCount()
• hasParseErrors()

toString

public String toString()

Overrides:

toString in class Object