org.javalite.activeweb.controllers

Class AbstractLesscController

java.lang.Object

org.javalite.activeweb.HttpSupport

org.javalite.activeweb.AppController

org.javalite.activeweb.controllers.AbstractLesscController

public abstract class AbstractLesscController
extends AppController

Subclass will compile and serve CSS from LESS files. For more information on LESS, please see lesscss.org. Usually a developer would subclass this controller to trigger and compile in development environment, but the URI to CSS file would be ignored by the framework (configured in RouteConfig), so that a statically compiled version is served by a container or a web server.

This controller does not by itself compile LESS files. It shells out to a lessc compiler, which needs to be installed.

The controller will only compile LESS files if there have been any changes since the last invocation. If there has been no changes, it immediately serves the cached version of CSS compiled previously.

Example usage:

 public class BootstrapController extends AbstractLesscController {
        protected File getLessFile() {
            return new File("src/main/webapp/less/bootstrap.less");
        }
    }
 ...

   public class RouteConfig extends AbstractRouteConfig {
      public void init(AppContext appContext) {
           ignore("/bootstrap.css").exceptIn("development");
      }
 }
 

The line in the RouteConfig ensures that the URI /bootstrap.css is ignored by the framework in every environment except "development". This is why the controller is triggering in development environment only.

Author:

igor on 4/28/14

Nested Class Summary

Nested classes/interfaces inherited from class org.javalite.activeweb.HttpSupport

HttpSupport.HttpBuilder, HttpSupport.RenderBuilder

Constructor Summary

Constructors

Constructor and Description
AbstractLesscController()

Method Summary

Methods

Modifier and Type	Method and Description
protected abstract File	getLessFile() Subclass should return a file handle pointing to the main Less file.
void	index()
String	lessc(File lessFile)

Methods inherited from class org.javalite.activeweb.AppController

actionSupportsHttpMethod, allowedActions, assign, getContentType, getLayout, getRequestBytes, getRequestInputStream, getRequestStream, getRequestString, queryString, render, render, restful, restful, servletPath, standardActionSupportsHttpMethod, values, view

Methods inherited from class org.javalite.activeweb.HttpSupport

appContext, blank, context, cookie, cookies, cookieValue, encoding, exists, flash, flash, flash, flash, format, getEncoding, getFile, getId, getLocale, getMap, getMap, getRealPath, getRequestHost, getRequestPort, getRequestProtocol, getResponseHeaders, getRoute, header, header, header, headers, host, ipAddress, ipForwardedFor, isDelete, isGet, isHead, isPost, isPut, isXhr, locale, locale, logDebug, logError, logError, logError, logInfo, logWarning, logWarning, main, merge, method, multipartFormItems, multipartFormItems, outputStream, outputStream, outputStream, param, param, params, params, params, params1st, params1st, path, port, protocol, redirect, redirect, redirect, redirect, redirect, redirect, redirect, redirect, redirectToReferrer, redirectToReferrer, remoteAddress, remoteHost, render, requestHas, respond, sendCookie, sendCookie, sendFile, sendPermanentCookie, session, session, session, sessionBoolean, sessionDouble, sessionFloat, sessionHas, sessionInteger, sessionLong, sessionObject, sessionString, setContentLength, setEncoding, setLocale, setRequestEncoding, setResponseEncoding, streamOut, uploadedFiles, uploadedFiles, uploadedFiles, uri, url, userAgent, view, view, writer, writer, xhr

Methods inherited from class java.lang.Object

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

Constructor Detail

AbstractLesscController

public AbstractLesscController()

Method Detail

index

public void index()

getLessFile

protected abstract File getLessFile()

Subclass should return a file handle pointing to the main Less file.

Returns:

file handle pointing to the main Less file

lessc

public String lessc(File lessFile)
             throws IOException,
                    InterruptedException

Throws:

IOException

InterruptedException