Sass for Java
Don't let those ruby devs have all the fun, with a simple filter you can have sass in your java too.
Usage
Add this to your web.xml
<filter>
<filter-name>SassCompiler</filter-name>
<filter-class>com.sass_lang.SassCompilingFilter</filter-class>
</filter>
<filter-mapping>
<filter-name>SassCompiler</filter-name>
<url-pattern>*.css</url-pattern>
</filter-mapping>
Put your sass templates in WEB-INF/sass and each request for a css file will regenerate as needed.
Maven
Since getting stuff in central is a PITA, add the following to your pom.xml
<repositories>
<repository>
<id>sass-java</id>
<url>http://sass-java.googlecode.com/svn/repo/</url>
</repository>
</repositories>
<dependencies>
<dependency>
<groupId>com.sass-lang</groupId>
<artifactId>sass-java</artifactId>
<version>3.1.1.4</version>
</dependency>
</dependencies>
Ant
Download the jar with depenencies
##Config
Configuration is done through filter init parameters
- templateLocation - the location where the sass templates will be found (default WEB-INF/sass)
- cssLocation - the location where the sass templates will be compiled to (default stylesheets)
- cacheLocation - the location that sass will use for compile caching (default WEB-INF/.sass-cache)
- cache - turn caching on/off (default true)
- onlyRunWhenKey - the system property or environment variable to check to see if sass compilation should run, use this to turn sass generation off in production
- onlyRunWhenValue - the corresponding value to check to see if sass compilation should run
You probably only want the css generation to run in development mode and
then commit the generated css to source control. This is achieved by the
onlyRunWhenKey
and onlyRunWhenValue
filter init parameters.
<filter>
<filter-name>SassCompiler</filter-name>
<filter-class>com.sass_lang.SassCompilingFilter</filter-class>
<init-param>
<param-name>onlyRunWhenKey</param-name>
<param-value>RUNTIME_ENVIRONMENT</param-value>
</init-param>
<init-param>
<param-name>onlyRunWhenValue</param-name>
<param-value>local</param-value>
</init-param>
</filter>
With this configuration the filter will check a system property or environment variable called RUNTIME_ENVIRONMENT and only run the sass compilation if that value is equal to local
##Try it out
- git clone https://github.com/darrinholst/sass-java.git
- cd sass-java
- mvn jetty:run
- wait for maven to download the internet
- open http://localhost:8080/sass-java
- change src/test/sample-webapp/WEB-INF/sass/application.scss
- repeat step 5
- be amazed