org.springframework.extensions.surf

Class LessCssThemeHandler

java.lang.Object

org.springframework.extensions.surf.CssThemeHandler

org.springframework.extensions.surf.LessCssThemeHandler

Direct Known Subclasses:

ExternalLessCssThemeHandler, LessForJavaCssThemeHandler

public abstract class LessCssThemeHandler
extends CssThemeHandler

Base class for Theme handlers that provide LESS CSS compiling. Provides methods to retrieve the default LESS config from the Surf config and Surf meta objects. Concrete impls can extend this class to provide engine specific implementation but use common LESS config.

Author:

Kevin Roast

Field Summary

Fields

Modifier and Type	Field and Description
static String	LESS_TOKEN

Constructor Summary

Constructors

Constructor and Description
LessCssThemeHandler()

Method Summary

Methods

Modifier and Type	Method and Description
protected String	getDefaultLessConfig() Returns the current default LESS configuration.
String	getLessVariables() Looks for the LESS CSS token which should contain the LESS style variables that can be applied to each CSS file.
String	logLessException(Exception e, String path) This function is used to log exceptions that occur during LESS compilation.

Methods inherited from class org.springframework.extensions.surf.CssThemeHandler

determineThemeTokens, getDependencyHandler, getTargetGroup, getTokenMap, getTokenRegex, getWebFrameworkConfigElement, processCssThemes, processCssThemeTokens, setDependencyHandler, setTargetGroup, setTokenRegex, setWebFrameworkConfigElement

Methods inherited from class java.lang.Object

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

Field Detail

LESS_TOKEN

public static final String LESS_TOKEN

See Also:

Constant Field Values

Constructor Detail

LessCssThemeHandler

public LessCssThemeHandler()

Method Detail

getDefaultLessConfig

protected String getDefaultLessConfig()

Returns the current default LESS configuration. If it has not previously been retrieved then it will attempt to load it.

Returns:

A String containing the default LESS configuration variables.

getLessVariables

public String getLessVariables()

Looks for the LESS CSS token which should contain the LESS style variables that can be applied to each CSS file. This will be prepended to each CSS file processed.

Returns:

The String of LESS variables.

logLessException

public String logLessException(Exception e,
                      String path)

This function is used to log exceptions that occur during LESS compilation. Unfortunately the LessException that is thrown from the LessEngine does not capture all exception eventualities. When a JavaScript error occurs in Rhino this can result in a ClassCastException which needs to be caught separately. Currently Surf still supports Java 6 so cannot process multiple exceptions so the error handling has been abstracted to a helper method.

Parameters:

e - The exception that has been thrown.

path - The path being processed that caused the exception

Returns:

The error message generated