com.github.edgarespina.mwa.wro4j.WroModule Maven / Gradle / Ivy
package com.github.edgarespina.mwa.wro4j;
import static com.google.common.base.Preconditions.checkNotNull;
import java.util.Collection;
import java.util.HashMap;
import java.util.HashSet;
import java.util.List;
import java.util.Map;
import java.util.Map.Entry;
import java.util.Set;
import javax.servlet.FilterChain;
import javax.servlet.ServletContext;
import javax.servlet.ServletException;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import org.apache.commons.io.FilenameUtils;
import org.apache.commons.lang3.StringUtils;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.context.EnvironmentAware;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.core.env.Environment;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.servlet.handler.HandlerInterceptorAdapter;
import ro.isdc.wro.config.Context;
import ro.isdc.wro.config.jmx.WroConfiguration;
import ro.isdc.wro.extensions.model.factory.SmartWroModelFactory;
import ro.isdc.wro.http.ConfigurableWroFilter;
import ro.isdc.wro.http.WroFilter;
import ro.isdc.wro.manager.factory.BaseWroManagerFactory;
import ro.isdc.wro.manager.factory.WroManagerFactory;
import ro.isdc.wro.model.WroModel;
import ro.isdc.wro.model.factory.WroModelFactory;
import ro.isdc.wro.model.group.DefaultGroupExtractor;
import ro.isdc.wro.model.group.Group;
import ro.isdc.wro.model.resource.Resource;
import ro.isdc.wro.model.resource.locator.ClasspathUriLocator;
import ro.isdc.wro.model.resource.locator.ServletContextUriLocator;
import ro.isdc.wro.model.resource.locator.ServletContextUriLocator.LocatorStrategy;
import ro.isdc.wro.model.resource.locator.UrlUriLocator;
import ro.isdc.wro.model.resource.locator.factory.SimpleUriLocatorFactory;
import ro.isdc.wro.model.resource.locator.factory.UriLocatorFactory;
import ro.isdc.wro.model.resource.processor.ResourcePostProcessor;
import ro.isdc.wro.model.resource.processor.ResourcePreProcessor;
import ro.isdc.wro.model.resource.processor.factory.ProcessorsFactory;
import ro.isdc.wro.model.resource.processor.factory.SimpleProcessorsFactory;
import ro.isdc.wro.util.ObjectFactory;
import ro.isdc.wro.util.Transformer;
import com.github.edgarespina.mwa.Application;
import com.github.edgarespina.mwa.Application.Mode;
/**
*
* The {@link WroModule} configure all the necessary infrastructure required by
* the WebResourceOptimizer
*
*
* Features:
*
*
* - Intercept all the *.js and *.css request and apply the all the registered
* {@link Processors processors}.
*
- The wro file descriptor can be written in: 'xml', 'groovy' or 'json'.
*
- While running in 'dev', the resource is treated as a single file (no
* group)
*
- While running in 'dev', a HTML is printed if a js or css file doesn't
* follow the rules of jsHint, jsLint or cssLint.
*
- While running in 'NO-dev', a group of files can be merged, minified and
* compressed as a single bundle.
*
*
* Please see the {@link Processors processors} for a full list of processors.
*
*
* @author edgar.espina
* @since 0.1.2
* @see Processors
*/
@Configuration
public class WroModule {
/**
* Extract the group name from a URI. The class works with
* {@link GroupPerFileModel}.
*
* @author edgar.espina
* @devOnly
*/
private static class GroupPerFileExtractor extends DefaultGroupExtractor {
/**
* {@inheritDoc}
*/
@Override
public String getGroupName(final HttpServletRequest request) {
if (request == null) {
throw new IllegalArgumentException("Request cannot be NULL!");
}
String uri = request.getRequestURI();
uri = uri.replace(request.getContextPath(), "");
final String groupName = fileToGroup(uri);
return StringUtils.isEmpty(groupName) ? null : groupName;
}
}
/**
* This class create a group for every single resource in a {@link WroModel}.
*
* @author edgar.espina
* @devOnly
*/
private static class GroupPerFileModel implements Transformer {
/**
* {@inheritDoc}
*/
@Override
public WroModel transform(final WroModel input) throws Exception {
Collection groups = input.getGroups();
Map> map = new HashMap>();
for (Group group : groups) {
List resources = group.getResources();
for (Resource resource : resources) {
String groupName = fileToGroup(resource.getUri());
Set newGroup = map.get(groupName);
if (newGroup == null) {
newGroup = new HashSet();
map.put(groupName, newGroup);
}
newGroup.add(resource);
}
}
WroModel output = new WroModel();
for (Entry> g : map.entrySet()) {
Group newGroup = new Group(g.getKey());
Set resources = g.getValue();
if (resources.size() > 2) {
throw new IllegalStateException("Multiples resource " + resources
+ " for group: " + g.getKey());
}
for (Resource resource : resources) {
newGroup.addResource(resource);
}
output.addGroup(newGroup);
}
return output;
}
}
/**
* A custom {@link WroConfigurationFactory}. Required by wro4j.
*
* @author edgar.espina
* @since 0.1.2
*/
private static class WroConfigurationFactory implements
ObjectFactory {
/**
* The {@link WroConfiguration}.
*/
private WroConfiguration configuration;
/**
* Creates a new {@link WroConfigurationFactory}.
*
* @param configuration The {@link WroConfiguration}. Required.
*/
public WroConfigurationFactory(final WroConfiguration configuration) {
this.configuration =
checkNotNull(configuration, "The wroConfiguration is required.");
}
/**
* {@inheritDoc}
*/
@Override
public WroConfiguration create() {
return configuration;
}
}
/**
* A {@link WroFilter} that handle exception and print html report while
* running in 'dev'.
*
* @author edgar.espina
* @since 0.1.2
*/
private static class ExtendedWroFilter extends ConfigurableWroFilter {
/**
* The {@link WroConfigurationFactory}.
*/
private WroConfigurationFactory configurationFactory;
/**
* The {@link WroConfiguration}.
*/
private WroConfiguration configuration;
/**
* Creates a new {@link ExtendedWroFilter}.
*
* @param configuration The {@link WroConfiguration}. Required.
* @param wroManagerFactory The {@link WroModelFactory. Required.
*/
public ExtendedWroFilter(final WroConfiguration configuration,
final WroManagerFactory wroManagerFactory) {
this.configuration =
checkNotNull(configuration, "The wroConfiguration is required.");
this.configurationFactory = new WroConfigurationFactory(configuration);
setWroManagerFactory(wroManagerFactory);
}
/**
* {@inheritDoc}
*/
@Override
protected ObjectFactory newWroConfigurationFactory() {
return configurationFactory;
}
/**
* Handle the exception by printing a HTML page in 'dev' mode. {@inheritDoc}
*/
@Override
protected void onRuntimeException(final RuntimeException ex,
final HttpServletResponse response, final FilterChain chain) {
if (configuration.isDebug()) {
HttpServletRequest request = Context.get().getRequest();
WroProblemReporter.bestFor(ex).report(ex, request, response);
} else {
// Just fail
throw ex;
}
}
}
/**
* It delegate the work to {@link WroFilter}.
*/
@RequestMapping({"/**/*.js", "/**/*.css" })
private static class WroInterceptor extends HandlerInterceptorAdapter {
/**
* The {@link WroFilter}. Required.
*/
private WroFilter wroFilter;
/**
* Creates a new {@link WroInterceptor}.
*
* @param wroFilter The {@link WroFilter}. Required.
*/
public WroInterceptor(final WroFilter wroFilter) {
this.wroFilter = checkNotNull(wroFilter, "The wroFilter is required.");
}
/**
* {@inheritDoc}
*/
@Override
public boolean preHandle(final HttpServletRequest request,
final HttpServletResponse response, final Object handler)
throws Exception {
wroFilter.doFilter(request, response, null);
return false;
}
}
/**
* The logging system.
*/
private static Logger logger = LoggerFactory.getLogger(WroModule.class);
/**
* Intercept js and css resource and apply all the registered
* {@link Processors}.
*
* @param application The application object. Required.
* @param servletContext The {@link ServletContext}. Required.
* @param configuration The {@link WroConfiguration}. Required.
* @param wroManagerFactory The {@link WroModelFactory}. Required.
* @return An interceptor for js and css resources.
* @throws ServletException If a web component cannot be created.
*/
@Bean
public WroInterceptor wroInterceptor(final Application application,
final ServletContext servletContext,
final WroConfiguration configuration,
final WroManagerFactory wroManagerFactory) throws ServletException {
final ConfigurableWroFilter wroFilter =
new ExtendedWroFilter(configuration, wroManagerFactory);
wroFilter.init(new WroFilterConfig(servletContext));
return new WroInterceptor(wroFilter);
}
/**
* Creates a {@link WroConfiguration} using the application's environment.
*
* @param env The application's environment. Required.
* @return A {@link WroConfiguration} using the application's environment.
*/
@Bean
public WroConfiguration wroConfiguration(final Environment env) {
checkNotNull(env, "The application's environment is required.");
boolean debug =
Application.DEV.matches(env
.getRequiredProperty(Application.APPLICATION_MODE));
boolean disableCache = true;
boolean gzipEnabled = false;
boolean cacheGzippedContent = false;
long cacheUpdatePeriod = 0;
long modelUpdatePeriod = 1;
boolean parallelPreprocessing = false;
if (!debug) {
cacheGzippedContent = true;
gzipEnabled = true;
disableCache = false;
modelUpdatePeriod = 0;
}
WroConfiguration configuration = new WroConfiguration();
configuration.setCacheGzippedContent(env.getProperty(
"wro.cacheGzippedContent", Boolean.class, cacheGzippedContent));
configuration.setCacheUpdatePeriod(env.getProperty(
"wro.cacheUpdatePeriod", Long.class, cacheUpdatePeriod));
configuration.setConnectionTimeout(env.getProperty(
"wro.connectionTimeout", Integer.class,
WroConfiguration.DEFAULT_CONNECTION_TIMEOUT));
configuration.setDebug(debug);
configuration.setDisableCache(env.getProperty(
"wro.disableCache", Boolean.class, disableCache));
configuration.setEncoding(env.getProperty(
"wro.encoding", String.class, WroConfiguration.DEFAULT_ENCODING));
configuration.setGzipEnabled(env.getProperty(
"wro.gzipEnabled", Boolean.class, gzipEnabled));
configuration.setHeader(env.getProperty("wro.header"));
configuration.setIgnoreEmptyGroup(env.getProperty(
"wro.ignoreEmptyGroup", Boolean.class, true));
configuration.setIgnoreMissingResources(env.getProperty(
"wro.ignoreMissingResources", Boolean.class, true));
configuration.setJmxEnabled(env.getProperty(
"wro.jmxEnabled", Boolean.class, false));
configuration.setMbeanName(env.getProperty("wro.mbeanName"));
configuration.setModelUpdatePeriod(env.getProperty(
"wro.modelUpdatePeriod", Long.class, modelUpdatePeriod));
configuration.setParallelPreprocessing(env.getProperty(
"wro.parallelPreprocessing", Boolean.class, parallelPreprocessing));
return configuration;
}
/**
* Creates a new {@link UriLocatorFactory} service. Web resources can be on
* the classpath, web path or in remote location.
*
* @return A new {@link UriLocatorFactory} service. Web resources can be on
* the classpath, web path or in remote location.
* @see ServletContextUriLocator
* @see ClasspathUriLocator
* @see UrlUriLocatorl
*/
@Bean
public UriLocatorFactory wroUriLocatorFactory() {
return new SimpleUriLocatorFactory()
.addUriLocator(new ServletContextUriLocator()
.setLocatorStrategy(LocatorStrategy.SERVLET_CONTEXT_FIRST))
.addUriLocator(new ClasspathUriLocator())
.addUriLocator(new UrlUriLocator());
}
/**
* Publish a {@link BaseWroManagerFactory}.
*
* @param environment The application's environment. Required.
* @param application The application's descriptor. Required.
* @param processorsFactory The user-defined {@link ProcessorsFactory}.
* Required.
* @param uriLocatorFactory The {@link UriLocatorFactory}. Required.
* @return A new {@link BaseWroManagerFactory}.
*/
@Bean
public BaseWroManagerFactory wroManagerFactory(final Environment environment,
final Application application, final ProcessorsFactory processorsFactory,
final UriLocatorFactory uriLocatorFactory) {
checkNotNull(environment, "The application's environment is required.");
checkNotNull(application, "The application's descriptor is required.");
checkNotNull(processorsFactory, "The processor's factory is required.");
checkNotNull(uriLocatorFactory, "The uri locator factory is required.");
BaseWroManagerFactory wroManagerFactory = new BaseWroManagerFactory();
wroManagerFactory
.setUriLocatorFactory(uriLocatorFactory)
.setModelFactory(wroModelFactory());
if (application.mode() == Application.DEV) {
wroManagerFactory.addModelTransformer(new GroupPerFileModel());
wroManagerFactory.setGroupExtractor(new GroupPerFileExtractor());
wroManagerFactory.setProcessorsFactory(processorsFactory(
application.mode(), processorsFactory, uriLocatorFactory,
environment));
} else {
wroManagerFactory.setProcessorsFactory(processorsFactory(
application.mode(), processorsFactory, uriLocatorFactory,
environment));
}
return wroManagerFactory;
}
/**
* Creates a new {@link WroModelFactory}.
*
* @return A new {@link WroModelFactory}.
*/
@Bean
public WroModelFactory wroModelFactory() {
return new SmartWroModelFactory();
}
/**
* Publish a model variable with html scripts elements from a 'wro' file
* descriptor.
*
* @param wroModelFactory The {@link WroModelFactory}. Required.
* @return A new {@link CssExporter}.
*/
@Bean
public JavaScriptExporter wroJavaScriptExporter(
final BaseWroManagerFactory wroModelFactory) {
return new JavaScriptExporter(wroModelFactory);
}
/**
* Publish a model variable with html links elements from a 'wro' file
* descriptor.
*
* @param wroModelFactory The {@link WroModelFactory}. Required.
* @return A new {@link CssExporter}.
*/
@Bean
public CssExporter wroCssExporter(
final BaseWroManagerFactory wroModelFactory) {
return new CssExporter(wroModelFactory);
}
/**
* Turn off some {@link ResourcePostProcessor} and
* {@link ResourcePreProcessor} if they don't match the given environment.
*
* @param mode The application's mode.
* @param processors The candidate processor's factory.
* @param uriLocatorFactory The uri locator factory.
* @param environment The application's environment.
* @return A new {@link ProcessorsFactory} for the given environment.
*/
private static ProcessorsFactory processorsFactory(final Mode mode,
final ProcessorsFactory processors,
final UriLocatorFactory uriLocatorFactory,
final Environment environment) {
SimpleProcessorsFactory result = new SimpleProcessorsFactory();
for (ResourcePreProcessor processor : processors.getPreProcessors()) {
if (applyProcessor(mode, uriLocatorFactory, environment, processor)) {
result.addPreProcessor(processor);
}
}
for (ResourcePostProcessor processor : processors.getPostProcessors()) {
if (applyProcessor(mode, uriLocatorFactory, environment, processor)) {
result.addPostProcessor(processor);
}
}
return result;
}
/**
* True if the given processor apply for the enviroment.
*
* @param mode The application's environment.
* @param uriLocatorFactory The uri locator factory.
* @param environment The application's environment.
* @param processor The candidate processor.
* @return True if the given processor apply for the enviroment.
*/
private static boolean applyProcessor(final Mode mode,
final UriLocatorFactory uriLocatorFactory, final Environment environment,
final Object processor) {
if (WroHelper.enabled(processor, mode)) {
// Check for specific contract
if (processor instanceof UriLocatorFactoryAware) {
((UriLocatorFactoryAware) processor)
.setUriLocatorFactory(uriLocatorFactory);
}
if (processor instanceof EnvironmentAware) {
((EnvironmentAware) processor).setEnvironment(environment);
}
return true;
} else {
logger.info("Processor: {} is not allowed in: {} mode", processor
.getClass().getSimpleName(), mode);
return false;
}
}
/**
* Convert the given file's name to a wro group's name.
*
* @param filename The file's name.
* @return The group's name.
*/
private static String fileToGroup(final String filename) {
String group = filename;
if (group.startsWith("/")) {
group = group.substring(1);
}
group = FilenameUtils.removeExtension(group);
return group.replace("/", "_");
}
}
© 2015 - 2025 Weber Informatics LLC | Privacy Policy