org.springframework.extensions.surf

Class ExternalLessCssThemeHandler

java.lang.Object

org.springframework.extensions.surf.CssThemeHandler

org.springframework.extensions.surf.LessCssThemeHandler

org.springframework.extensions.surf.ExternalLessCssThemeHandler

public class ExternalLessCssThemeHandler
extends LessCssThemeHandler

This is a LESS CSS handler driven by a pre-configured external LESS process.

Typically uses a Node "lessc" module preinstalled via NPM or similar. This is not expected to be used in production environments where adding additional 3rd party modules to the web-tier is not desired or permitted.

Since:

6.0

Author:

Kevin Roast

See Also:

http://lesscss.org/

Field Summary

Fields inherited from class org.springframework.extensions.surf.LessCssThemeHandler

LESS_TOKEN

Constructor Summary

Constructors

Constructor and Description
ExternalLessCssThemeHandler() Sets up a new instance.

Method Summary

Methods

Modifier and Type	Method and Description
String	processCssThemes(String path, StringBuilder cssContents) Overrides the default implementation to add LESS processing capabilities.
void	setCmd(String cmd)

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

getDefaultLessConfig, getLessVariables, logLessException

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

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

Methods inherited from class java.lang.Object

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

Constructor Detail

ExternalLessCssThemeHandler

public ExternalLessCssThemeHandler()

Sets up a new instance.

Method Detail

setCmd

public void setCmd(String cmd)

Parameters:

cmd - The external cmd to execute. For example Node lessc this would be "lessc -". The command must be able to accept LESS CSS as stdin and return output from stdout.

processCssThemes

public String processCssThemes(String path,
                      StringBuilder cssContents)
                        throws IOException

Overrides the default implementation to add LESS processing capabilities.

Overrides:

processCssThemes in class CssThemeHandler

Parameters:

path - The path of the file being processed (used only for error output)

cssContents - The CSS to process

Throws:

IOException - when accessing file contents.