Fork me on GitHub

jawr

add to furl add to del.icio.us add to technorati add to blinklist add to digg add to google add to stumbleupon add to yahoo

Jawr is a tunable packaging solution for Javascript and CSS which allows for rapid development of resources in separate module files. Developers can work with a large set of split javascript files in development mode, then Jawr bundles all together into one or several files in a configurable way.
By using a tag library, Jawr allows you to use the same, unchanged pages for development and production. Jawr also minifies and compresses the files, resulting in reduced page load times.
Jawr is configured using a simple .properties descriptor, and aside of standard java web applications it can also be used with Facelets, Grails, Wicket and Spring applications.

jawr

It is common knowledge that it is faster to serve one large file rather than two smaller ones, because of increased HTTP negotiation and the fact that most browsers only keep two connections open to the same host at any given time. Jawr will reduce the number of requests needed to load a page and the amount of data to transfer to clients, achieving drastic improvement of loading times. With a simple configuration file, resources can be distributed in bundles to best suit the usage pattern for a site. Files not added to bundles also benefit from minification and compression (if no bundles are declared, Jawr will work as an easy to configure resources compressor).

A JSP tag library (Facelets also supported) is used to import the resources to pages. In development mode, the tags generate <script> and <style> links for each resource mapped to a bundle. In production mode, the tags generate a single link pointing to the bundle file. Thus, there is no need to change code in pages when switching from development to production mode.

There is an increasing trend towards richer client interfaces with complex javascript implementations. Using Jawr will ease the development process by allowing to distribute modules in separate files without worrying about how the application will be served to clients.

The alternatives to using Jawr are:

  • Developing all-in-one script files which conform to the deployment scheme. That is, cram all the modules into a few files. Version control becomes unmanageable and it is hard to find a component that needs change. As the project grows, the code becomes near to impossible to mantain.
  • Use a build script to join and compress the files, which forces developers to build and redeploy the whole application for testing even the slightest of changes in their code.
  • For java projects, use another libray like : Wro4j
  • For grails projects, use another plugin like :

Jawr offers the best of both worlds, by combining a powerful bundling-minifying-compressing scheme for optimal service in production, with a rapid development mode for quick change-save-test cycles.

You can download the latest release of Jawr here. Also, check out the quick start tutorial to see how easy it is to use Jawr in your project.
And don't forget to check the FAQ - Howto page for tips and troubleshooting.

Features

  • Free and open source: Released under an Apache 2.0 license, Jawr can be used free of charge with or without modifications, for both commercial and noncommercial purposes.
  • Easy to setup: All you need to start using Jawr is to declare a couple of servlets in you deployment descriptor, create a simple .properties configuration file, and use the Jawr tag library to import css and javascript resources to your pages. A complete setup takes a matter of minutes and requires little or no modifications over time.
  • Lightweight: Bundling and compression is done once at server startup so there is no overhead to requests. Also, a cache component is available and enabled by default to serve resources directly from memory instead of from the filesystem.
  • Built-in minification and postprocessing: Jawr includes JSMin and the YUI compressor, both from Yahoo!. A custom minificator for CSS is also included, although the YUI compressor can be used for CSS too. For each bundle, a customizable postprocessing chain is executed during startup. Relative URLs in CSS files are rewritten by a postprocessor so they keep working with a different relative path. It is also easy to create custom postprocessors to perform any modifications to your js and css files at deploy time. Learn more.
  • Third party frameworks integration: Jawr can be used with DWR, Spring, JSF, Facelets, Wicket, Commons Validator (with Struts), and Grails. It can also be easily plugged into your own infrastructure.

There are many more features, check the features list page for a full listing.

Requirements

You can use Jawr with any compliant Java Servlet 2.5 or higher container implementation (i.e. Tomcat, Jetty, BEA Weblogic etc.), as long as the virtual machine it runs on is 1.7 or higher. There are no other requirements.

Announcements

Here are the latest announcements regarding Jawr. You can find older version announcements with all the features that have been added over time at the change log.

  • 22nd August 2016: Version 3.9 released:
    This version is containing bug fixes and some new features.
    One of the focus of this new version is to speed up the bundling process, by adding caching feature to generated resources and also by providing "smart bundling" feature which allow Jawr to rebuild bundles only if they've been modified. Please check the smart bundling tutorial for more information.
    New features & improvements :
    • [JAWR-247] Jawr now allows you to used extension based resources (.less, .coffee, ...) from classpath generators (like classpath, webjars, ...) This means that you can now adds resources like : jar:/less/myStyle.less in your bundle mapping.
    • [JAWR-313] The biggest feature of this new version is the "smart bundling". This feature is used to speed up bundle generation by detecting which bundle should be processed. Please check the following tutorial to see how to set up this new feature.
    • [JAWR-364] The DWR 3 extension has been updated to use the latest DWR 3.0.1-RELEASE version.
    • [JAWR-362] Jawr provides now a JRuby sass compiler for Sass Generator, which is closer to the original version than the Vaadin one. Please check the Sass Ruby generator documentation for more detail.
    • [JAWR-398] The Jawr javascript tag has been updated to add crossorigin attribute.
    • [JAWR-404] The Jawr Autoprefixer postprocessor has been upgraded to use the version 6.4.0
    • [JAWR-403] The Google closure global postprocessor has been upgraded to use the version v20160713
    Fixed issues :
    • [JAWR-365] Add more exception info when failing to read resource
    • [JAWR-369] Add semicolon between JavaScript files if necessary
    • [JAWR-381] Improve performance generation of generated resources (less, sass, ...)
    • [JAWR-383] Provide Spring Boot auto-configuration
    • [JAWR-388] Convert site documentation from apt to markdown
    • [JAWR-389] Use annotation to identify variant post processor
  • Thanks to marrdev, paranoiabla, jmaslac, tsachev, H.Schulz, senorplankton, mayjak, jiri_pejchal for reporting the issues.
    Thanks to dtrunk90, janningvygen, donv, jeremysnyder, holmis83, diocerty, davidwebster48 for reporting the issues and providing patches.
  • 28th August 2015: Version 3.8 released:
    This version is containing bug fixes and some new features.

    New features:
    • [JAWR-354] Jawr now provides support for SASS resource (*.scss).
      You can now use SASS files in your bundle mapping.
      Please check the generator documentation for more detail.
    • [JAWR-353] Jawr now uses less4j engine instead of less-engine.
      Please check the generator documentation for more detail.
    • [JAWR-351] Jawr now allows users to enable performance logging for bundle or request handling.
      Please check the tutorial for more detail.
    • [JAWR-350] Jawr allows you to define which JS script engine, you would like to use for JS based processors or generators like coffee script, uglify or Autoprefixer.
      This means that you can use Nashorn JS engine if you're using Java 8
      To define which engine to use, you only need to set the property jawr.js.engine.
      For more information, please check the tutorial about how to set the Javascript Engine for more detail.
    • [JAWR-349] To reference webjars resources, you can now use short reference instead of full one.
      For example, you can now use : webjars:/css/bootstrap.css instead of webjars:/bootstrap/3.2.0/css/bootstrap.css
      For more information, please check the webjars generator documentation for more information.
    • [JAWR-348] Jawr allows you to define external bundles. This is used for resources which are not handle in Jawr in Production or debug mode, but you can still use the Jawr taglib to reference them
      For more information, please check the bundle documentation for more detail.
    • [JAWR-342] Jawr allows developers to override comments generation in link renderer
    • [JAWR-340] Jawr allows users to specify if licence information should be kept or not in CSSMinifier.
      Please check the CSS minifier documentation for more detail.
    • [JAWR-274] Jawr now support nested composite bundles. You can now define a composite bundle in another composite bundle
      For more information, please check the composite bundle documentation for more detail.
    • [JAWR-153] Jawr provides a new postprocessor based on Autoprefixer.
      The autoprefixer postprocessor will generate vendor specific prefixes for CSS rules. Please check the postprocessor documentation for more detail.
    Fixed issues :
    • [JAWR-347] Reloading i18n generator does not work
    • [JAWR-345] Closure Compiler doesn't generate gzip bundle content
    • [JAWR-344] JAWR should throw an exception on start up if 'javax.servlet.context.tempdir' is null
    • [JAWR-343] Issue with CoffeeScript generator on Tomcat 8, where the script can't be generated
    • [JAWR-341] CSS import postprocessor doesn't handle properly url declaration boundaries
    • [JAWR-338] Grails taglib doesn't handle properly "jawr.use.random.parameter" property
    • [JAWR-331] Clear RendererContext when DispatchError appears
  • Thanks to tzrlk, michele, ksokol, paranoiabla, dtrunk90, Infeligo, mzz6wh, tveimo for reporting the issues.
    Thanks to vakopian, tedliang for reporting the issues and providing patches.
  • 23rd May 2015: Version 3.7 released:
    This version is containing bug fixes and some new features.

    Important note : The version 3.7 of Jawr requires Java 1.7.
    This relase contains the fix for a security issue. It is highly recommended to upgrade to this new version.

    New features:
    • The Jawr binary servlet to handle ".cur" and ".woff2" files
    • The Jawr servlet allows you to access resources which is not directly handle by Jawr. For instance, if your Jawr JS servlet is mapped to "*.js" resources, you can access the JS resources, which are not part of the bundles.
    Fixed issues :
    • Issue #336 fixed: Issue in Less generator when importing resource using absolute URL
    • Issue #335 fixed: Issue with grails plugin in development mode (using run-app command)
    • Issue #334 fixed: Path traversal vulnerability
    • Issue #333 fixed: Default CSS compressor is compressing calc functions incorrectly
    • Issue #332 fixed: Logging Level should be WARN for ResourceNotFound and missing binary extension
    • Issue #328 fixed: Jawr doesn't handle properly exception while retrieving resource using ResourceReader
    • Issue #326 fixed: Licensing issue with UnicodeBOMInputStream
    • Issue #323 fixed: Issue with line ending in generated bundles, which should not be different depending on the platform
    • Issue #321 fixed: Improve execution time of integration tests
    • Issue #320 fixed: With strictMode off and debugMode off image request which are not registered in jawr.properties results in 404
    • Issue #318 fixed: JawrBinaryResourceRequestHandler doesn't handle properly browser disconnection
    • Issue #317 fixed: ResourceReaderHandler doesn't handle properly exception when retrieving stream
    • Issue #311 fixed: Invalid resource path generated for CSS with IE11 in SSL mode
    • Issue #308 fixed: Issue in debug mode for CSS resources where URL reference an HTTP resource
    • Issue #304 fixed: StringIndexOutOfBoundsException occurs when Jawr tries to handle a request without prefix
    • Issue #246 fixed: Issue with bas64 postprocessor with sprite image
  • Thanks to shoot_the_moon, damartin, paranoiabla, H.Schulz for reporting the issues. Thanks to farethewell, janningvygen, frabasic, diocerty for reporting the issues and providing patches.
  • A special thank to janningvygen for his great contribution in this release.
  • 06th October 2014: Version 3.6 released:
    This version is containing bug fixes and some new features.
    Important note : The version 3.6 of Jawr is not backward compatible. The component handling image resource has evolved. We've kept the task as easy as possible to migrate from the previous version to this new one. Please read the migration guide.

    New features:
    • Jawr now support font web font caching (*.ttf, *.eot, *.woff, ...).
      The component which was handling the image caching has evolved to support any binary web resources.
      You will need to update your web.xml configuration to use the new binary, which now replace the old img type. Please check the servlet documentation and the migration guide for more info.
    • Jawr provides a new generator to handle webjars resources. For more information about webjars, please check the folllowing link : webjars site To reference webjars resources, you'll need to use the new prefix "webjars:".
      For example, you could use webjars:/jquery/1.11.1/jquery.js to reference the jquery script associated to the JQuery webjars. (Source site)
      Please check the generator documentation for more information.
    • Jawr provides by default a new JS minifier based on UglifyJS. It is important to note that this Javascript minifier will become the default one in the next release. Please check the postprocessor documentation for more information.
    • Jawr now support JSON format for the configuration file using net.jawr.web.resource.bundle.factory.util.JsonPropertiesSource for configPropertyResolverClass in the Jawr Servlet initialisation parameter. Please check the Jawr servlet documentation for more information.
    • The Spring MVC extension has been renamed to jawr-spring instead of jawr-spring-2.0.x.
    Fixed issues :
    • Issue #216 fixed: JsMin is failing with a RegEx trying to process Modernizr
    • Issue #264 fixed: BrowserResolver doesn't recognize IE11, returning NULL
    • Issue #278 fixed: Less generator don't properly handle import directive
    • Issue #280 fixed: Add check in Jawr to handle case where resource type is not properly set
    • Issue #282 fixed: Mime-Type missing for jawr_loader.js
    • Issue #283 fixed: JSMin doesn't handle properly tabulation in strings
    • Issue #284 fixed: The JAWR/smartsprite directory isn't being cleared when JAWR runs again
    • Issue #285 fixed: Uncorrect behavior for unknown browser variants
    • Issue #286 fixed: In CSSImportPostProcessor, external URLs are causing errors
    • Issue #289 fixed: Image URLs are not properly generated when setting jawr.url.contextpath.override and image servlet mapping as empty
    • Issue #291 fixed: Issue in Jawr image tag which appends the jsessionid at the end of the URL
    • Issue #292 fixed: When using the jawr.locale.generator.quoteMsgKey property, only a part of key messages is quoted
    • Issue #293 fixed: Unable to define multiple ResourceBundle in message generator using pipe character
    • Issue #296 fixed: Jawr doesn't handle properly font resources from generated css content like CSS in classpath
    • Issue #299 fixed: Jawr doesn't properly handle URL rewriting in CSS when URL contains the following characters '?' and '#'
    • Issue #300 fixed: Issue with skin generator for image URL rewriting
    • Issue #302 fixed: Issue with generated resources containing dot characters but no extension
    • Issue #303 fixed: Issue in debug mode with Image URL rewriting in CSS provided by generators when servlet mapping is not empty
  • Thanks to tdahmez, ungarida, sudnam, rragan, takacsot, diorcety, shoot_the_moon for reporting the issues.
  • Thanks to M.Cegledi, volt0, kazimir70 for reporting the issues and also provding patches.
  • 06th October 2014: Grails plugin 3.6 released:
    The grails plugin has been released in the grails central repository.
    You'll need at least Grails 2.4.3 to use this version. Please check the grails plugin documentation for more detail on how to use it.
    Fixed issue :
    • Issue #243 fixed: Allow Jawr Grails plugin message generator to retrieve message from others grails plugins
  • Thanks to kevin.mershon for reporting this issue
  • 08th May 2014: Version 3.5.2 released:
    This version is a minor version containing only a bug fix about sprite generation.
    Fixed issue :
    • Issue #279 fixed: Sprite generation doesn't work properly
  • Thanks to shoot_the_moon for reporting the issues.
  • 18th April 2014: Grails plugin 3.5.1 released:
    The grails plugin has been released in the grails central repository.
    Please check the grails plugin documentation for more detail on how to use it.
    Fixed issue :
    • Issue #265 fixed: Grails plugin can't be loaded
  • 18th April 2014: Version 3.5.1 released:
    This version is a minor version containing mainly bug fixes. New features:
    • Jawr allows the users to define if they want to put quote for the key of their messages in the message generator using a new property jawr.locale.generator.quoteMsgKey. Please check descriptor syntax doc for more detail. This property is set to true by default. If your message keys are don't have a dash in their name, you can use this option to remive the unnecessary quote.
    • Jawr allows the users to define bundle path prefix for generated URLs. For instance, if the user would like to have a bunch of secured budnle, he would be able to define a prefix for those bundle which will be prepend before the bundle hashcode. This will allow him to define a filter which will check the access right for the users for example. The new property jawr.[type].bundle.[name].bundle.prefix has been added to the bundle. Please check descriptor syntax doc for more detail.
    Fixed issues :
    • Issue #225 fixed: Bundling Bootstrap CSS file with CSSMinifier causing java.lang.StackOverflowError
    • Issue #239 fixed: Issue with productionURL and dependencies
    • Issue #241 fixed: Issue when using jawr.use.bundle.mapping option with a bundle using a production URL
    • Issue #254 fixed: /jawr_loader.js not serving bundles correct path prefix override when request is secure
    • Issue #255 fixed: Issue with alternateProduction URL on global bundle
    • Issue #258 fixed: Jawr.use.bundle.mapping and productionURL do not work together
    • Issue #259 fixed: Exception during startup when contextPath is empty
    • Issue #260 fixed: Remove log4j dependency in smartsprites global preprocessor
    • Issue #261 fixed: In Production mode, the debugnever bundle property is not properly handled for composite bundle
    • Issue #262 fixed: Sprite generation doesn't work for not generated css content
    • Issue #267 fixed: JAWR cannot process Bootstrap CSS
    • Issue #269 fixed: Javascript i18n message generator doesn't create escaped Unicode characters.
    • Issue #271 fixed: Jawr doesn't handle properly bundle dependencies in Closure compiler arguments
    • Issue #272 fixed: OverrideKey does not work in production mode for composite bundle
    • Issue #273 fixed: ResourceBundleMessagesGenerator does not add quotes around property message keys The new property jawr.locale.generator.quoteMsgKey has been added allows the user to choose if he would like to put quote or not for the message keys
    • Issue #275 fixed: Exceptions not properly handle in PathNormalizer.extractBundleInfoFromPath(requestedPath)
    • Issue #276 fixed: Custom global post processors not properly registered
    • Issue #277 fixed: LessException not properly handled in LessGenerator (cast issue & nullPointerException)
  • Thanks to Monomachus, dr.piefel, pbusque, sessert, LightningMan, mzz6wh, hweic for reporting the issues. Thanks to paranoiabla, dmurat, webguy, sbaruzza, diorcety for reporting the issues and also providing patches.
  • 06th Januray 2014: Grails plugin 3.5 released:
    The grails plugin has been released in the grails central repository.
    Please check the grails plugin documentation for more detail on how to use it.
  • 01rst January 2014: Version 3.5 released:
    This version is a major version. This version requires at least the use of java 6 and servlet API 2.5. For those, who were using the version 3.3.x, please read the migration guide.

    New features:
    • It is now possible to set a custom Javascript ClientSideGenerator using the new jawr.js.clientside.handler.generator.class configuration property. Please check descriptor syntax doc for more detail.
    • It is now possible to set custom link renderer using the following properties jawr.js.bundle.link.renderer.class, jawr.css.bundle.link.renderer.class, jawr.img.bundle.link.renderer.class. Please check descriptor syntax doc for more detail.
    • Jawr adds support to JS compression with Google Compiler. Please check this tutorial for more detail.
    • Jawr adds new jawr.locale.generator.fallbackToSystemLocale property for i18n message resource generator, to use System locale if no locale is found. Please check descriptor syntax doc for more detail.
    • Jawr allows the user to define the use of random parameter in debug mode at application level using jawr.debug.use.random.parameter. Please check descriptor syntax doc for more detail.
    • Jawr adds support for custom generator resolver. Before the 3.5 version, the generator were only available with a mapping prefix (for ex: ""jar:" for classpath generator). Now the users are able to define their own generator resolver. For those who had defines their custom generator, they will need to update their generator. Please check the migration guide for more info.
    • Jawr provides a built-in LESS Css generator. You can take a look to the generators documentation for more info.
    • Jawr provides a built-in CoffeeScript generator. You can take a look to the generators documentation for more info.
    • Jawr allows the user to define prefix to Jawr JMX MBean using jawr.jmx.mbean.prefix property. This will fix issues, for application which are deployed on different server using the same application context. Please check descriptor syntax doc for more detail.
    • Jawr allows the user to define a custom cache mechanism using jawr.cache.manager. Please check descriptor syntax doc for more detail.
    • Jawr adds support for built-in EhCache manager. jawr.cache.manager. Please check the cache manager documentation for more detail.
    • Jawr allows the user to define the configuration property resolver in the Jawr configurationd files using configPropertyResolverClass in the Jawr servlet definition. Please check servlet configuration documentation for more detail.
    • Jawr allows the user to define an external base context directory where Jawr will be able to find resources using the jawr.basecontext.directory, and you can now define what is the priority when searching for resource using the property jawr.basecontext.directory.high.priority. This allows user to create bundle from resources oustide the war file. Please check descriptor syntax doc for more detail.
    • Jawr allows the user to define custom implementation of built in Resolvers (LocaleResolver, BrowserTypeResolver, ConnectionTypeResolver, SkinVariantResolver, ) using configuration properties jawr.locale.resolver, jawr.browser.resolver, jawr.url.connection.type.resolver, jawr.css.skin.resolver Please check descriptor syntax doc for more detail.
    • Jawr now uses slf4j as logging framework. For those who are using log4j as loging framework, you must add slf4j-log4j12-xxx.jar in your classpath. Please check the slf4j documentation for more detail.
    • The Jawr javascript tag now support the aysnc and defer attributes. Please check the taglib doc for more detail.
    • The URL of the Jawr facelet taglib has been updated from https://jawr.dev.java.net/jsf/facelets to https://jawr.java.net/jsf/facelets.
    • Unfortunately, we weren't able to include the updated version of the grails plugin in this release. We will try to release it as soon as possible. So grails users will have to wait to get the 3.5 release. .
    • jawr.css.image.classpath.use.servlet properties removed. It is replaced by jawr.css.classpath.handle.image.
    Fixed issues :
    • Issue #72 fixed: Avoid skipping repeated members of bundles
    • Issue #166 fixed: Generated URL is different for jwr:script and JAWR.loader.script
    • Issue #168 fixed: URL of CSS resources using CSS skin are not properly handled by JAWR.loader
    • Issue #169 fixed: Base64 encoding works only on composite bundle for IE
    • Issue #171 fixed: SmartSpritesResourceHandler does not resolve absolute css-url()s
    • Issue #174 fixed: Media parameter not taking in account in debughandler.js
    • Issue #177 fixed: MessageBundleGenerator doesn't handle properly messages bundle charset
    • Issue #178 fixed: Issue with use.bundling.mapping for preprocessed orphan bundles containing dots in the name
    • Issue #180 fixed: Bundle contents are mangled when using cache feature on high load
    • Issue #183 fixed: Jawr groovy TagLib attributes not properly handle for boolean
    • Issue #187 fixed: Documentation for base64postprocessor contradicts itself
    • Issue #193 fixed: CSSMinifier issue with new CSS 3 "@media" syntax.
    • Issue #195 fixed: Problem in documentation for PostProcessors
    • Issue #196 fixed: JMX refreshConfig() does not re-read jawr.properties
    • Issue #197 fixed: Taglib should honor refreshKey parameter
    • Issue #198 fixed: Memory leak when restarting server due to missing reset of a ThreadLocal
    • Issue #200 fixed: Jawr CSS minifier doesn't handle properly CSS3 selectors like : E[foo$="bar"]
    • Issue #202 fixed: Issue when defining OrphanResourceBundlesMapper basedir as generated path
    • Issue #203 fixed: Issue with generator when using JRockit R27.4.0-xxx
    • Issue #204 fixed: Inappropriate log level in CssSmartSpritesGlobalPreprocessor
    • Issue #206 fixed: Byte-Order-Marks (BOM) in Javascript files corrupt bundle
    • Issue #208 fixed: BundleProcessor doesn't handle properly a web.xml where the servlet-class contains spaces
    • Issue #209 fixed: BundleProcessor doesn't use the jars defined in /WEB-INF/lib in its classloader
    • Issue #210 fixed: In CSSMinifier, when an exception is raised add a log to define which bundle is causing the issue
    • Issue #211 fixed: Make inheritance easier in BundleProcessor
    • Issue #212 fixed: Issue while setting jawr.image.resources to a generated path using directory wildcard
    • Issue #213 fixed: Orphan resources cannot be found if basedir is set to webapp root directory
    • Issue #215 fixed: Issue when using a Servlet API 2.5 with Jawr bundle preprocessor
    • Issue #217 fixed: Issue with character encoding for Grails messages
    • Issue #218 fixed: The values of the jawr.properties file must be trimmed
    • Issue #220 fixed: CSS media queries not correctly minified
    • Issue #221 fixed: Javascript i18n message generator uses a pipe separator, not a comma as mentioned in the documentation
    • Issue #222 fixed: Issue in Wicket integration: Unable to serialize net.jawr.web.resource.bundle.renderer.CSSHTMLBundleLinkRenderer
    • Issue #223 fixed: CacheBusterUrl generation does not support urls with postfixes
    • Issue #224 fixed: Random debug parameter in the URL is not set for the generated resources in debug mode
    • Issue #226 fixed: When using debug override the bundle defines as debugonly and debug never are not properly taken in account
    • Issue #227 fixed: JmxUtils.getMBeanObjectName doesn't handle root context path correctly
    • Issue #230 fixed: Minification of js anonymous function expessions is incorrect
    • Issue #231 fixed: Jawr doesn't handle properly the font URL in CSS.
    • Issue #233 fixed: Issue with base64 postprocessor when the css files are not in the same directory level
    • Issue #245 fixed: Issue with bas64 postprocessor, which didn't work properly. Please check the tutorial on how to set up the bas64 postprocessor.
  • Thanks to julienw, kgo, ghillert, henrik242, sfrancois99, gregkatz, EddiBosh, brienwheeler, omega_ula, dtabuenc, dtrunk90, D_mitar, TimDGSL, jfasrc, smalbegui, bai.ben, deleted_user, pakmans for reporting the issues. Thanks to das2k_117, sankar_netsoft, ZikFat, nbourdeau, Musikolo, tduffey, nik9000, wwwpol, hay_dave, tgilles, glin, Stephane Landelle, oxc, Chris Kulinski for reporting the issues and also providing patches.
  • 15th August 2010: Version 3.3.3 released:
    This version contains 2 bug fixes including a major one. It is highly recommended to upgrade to this version.

    There was an issue in the hashcode generation, which causes the bundle to be reloaded even if the bundle content didn't change. This implies some performance penalties.
    The hashcode was based on the Java object ID instead of the bundle content.
    The consequences are :
    • If you restart your application server, for the same application, Jawr could generate different hashcodes for the same bundle.
    • If you are using load balancing and run the same application on 2 servers, they could generate different hashcodes for the same bundle.
    Fixed issues:
    • Issue #160 fixed: An exception is thrown, when using JMX on an application whose the context path is empty
    • Issue #163 fixed: Issue with bundle hashcode generation which must be based on bundle content

    Thanks to Mark W. for reporting the hashcode generation issue.

  • 20th July 2010: Version 3.3.2 released:
    This version contains only bug fixes.

    Fixed issues:
    • Issue #157 fixed: NullPointerException thrown in BrowserResolver when no user agent found in HTTP header
    • Issue #159 fixed: Space in the dependencies configuration lead to omitted dependencies

    Thanks to zafo and Trygve Lie for reporting these issues.

  • 06/29/2010: Version 3.3.1 released:
    This version contains a lot of new features and bug fixes.

    New features:
    • One of the big new features of this release is the ability to define variant bundles. A variant bundle is the generalization of what already exists for the locale aware bundle. A variant bundle is a bundle which can change depending on some defined criteria. This means for example that you can define a specific bundle content by browser type. You can define a specific bundle for IE, and for the same bundle sent another content to Firefox, Chrome, Opera... For more information about the variant bundle, please check the following variant bundle documentation for more detail.
    • One of the feature derived from the use of variant bundle is the support for CSS bundle skin. Jawr allows you to define CSS bundle, where the skin variant will be sent back to the user depending on the skin used by the user. The user skin is defined in a cookie. The good news is that the CSS skin can also be combined with the user locale, which means that Jawr is able to sent to the user the CSS bundle depending on the user skin and also depending on the user locale. For more information about how to use the new skin feature, please check the following Jawr skin documentation for more detail.
    • The Jawr CSS tag has been updated to be able to generate title and alternate attributes for CSS bundles. The Jawr CSS tag has also been updated to be able to generate alternate for CSS skin bundles. Look for the CSS tag at the tag library doc for extra info.
    • The Jawr skin switcher javascript generator has been created to generate the javascript file for the skin switcher. You can take a look to the generators documentation for more info.
    • Jawr now supports base64 image encoding.
      Jawr is now able to generate base64 encoded image in your CSS bundle using a new postprocessor.
      Please check the tutorial on how to use Jawr to generate base64 image in CSS bundle for more detail.
      The Jawr image tags have been updated to be able to generate base64 encoded image. Please check the documentation on the taglib description for more detail.
    • Jawr supports hashcode bundle generator. This means that you can now define your own implementation of the id used to identify the bundle.(Ex: application version based, ...) For more detail, about how to implement your own hashcode bundle generator, take a look at the documentation about hashcode bundle generator.
    • Jawr provides also an MD5 hashcode bundle generator, which use MD5 to create the bundle hashcode. Take a look at the documentation about hashcode bundle generator.
    • Jawr introduces the strict mode. For earlier version, Jawr didn't take in account the hashcode of the requested bundle.
      This means that if a user request a bundle, for which the hashcode is different from the current one, Jawr will sent back the current bundle.
      This may be an issue if you are using an application on a clustered environment. If you deploy a new version of your application on one server, while the other is still up. You can face cases where the user request a page on one server, and try to retrieve the web resource bundles one another.
      This may lead to strange behaviors.
      To overcome this issue, Jawr introduces the strict mode. In this mode, Jawr will allow you to define how you want to handle such requests by defining your own IllegalBundleRequestHandler. Jawr also provides a default implementation whch returns a "404" if it receive a such request. Take a look at the documentation about strict mode and illegal bundle request handler. Jawr provides just a default implementation, if you want to contribute and share your own implementation with the community, feel free to create and attach a patch in the issue tracker.
    • Jawr supports composite bundle postprocessors for bundle and for the unitary files.
      You can take a look to the postprocessors documentation for more info.
    • Jawr uses now alphabetical ordering for bundle resources by default.
    • Jawr supports media keyword in CSS Import PostProcessor. Please check the CSS import postprocessor documentation for more detail.
    • Jawr introduce a new postprocessor to combine CSS media. Please check the CSS combine media postprocessor documentation for more detail. Thanks to Gerben Jorna for the implementation of this feature.
    Fixed issues:
    • Issue #41 fixed: Add title attribute to style tag
    • Issue #127 fixed: Problem parsing jawr-jsp2x.tld in Resin
    • Issue #132 fixed: CSS image URL not written properly for generators which don't handle CSS images
    • Issue #133 fixed: Issue on Jawr context management for debug mode and JMX in the JawrSpringController
    • Issue #134 fixed: In debug mode, Jawr generates wrong CSS image paths for generated Css resources when using JawrSpringController
    • Issue #139 fixed: Jawr don't handle *.ico files as image files
    • Issue #141 fixed: Issue on Jawr CssMinifier which doesn't handle properly CSS rules with linefeed inside
    • Issue #144 fixed: NPE when using jawr.debug.ie.force.css.bundle=true and ieonly.condition bundle property.
    • Issue #145 fixed: Jawr not compatible with Java 1.4.
    • Issue #146 fixed: ThreadLocal memory leak when reloading application.
    • Issue #151 fixed: The Wicket image tag rendering is not working properly for HTML images
    • Issue #152 fixed: For the image tags in Wicket, Jawr doesn't handle properly the URL generation of generated images

    Thanks to eliotsykes, mkkoch, wangg3, Martin Jönsson, jnichols959 and all those who participate through the discusion forum for reporting issues and giving feedbacks.
    Thanks also to Gerben Jorna for his implementation of the combine media post processor and for the base implementation of the base64 CSS image postprocessor.



    Jawr ant task and maven plugin - Version 1.4 released:
    This version contains one new feature and one bug fix.

    New feature:
    • For IE6 and IE7 CSS bundles which use the new base64ImageEncoder, the bundle processor generates a placeholder for the web application URL. Please take a look to the following documentation for more detail.
    Fixed issue:
    • Issue #142 fixed: Add support to generate exact path mapping for Jawr bundle processor .


    Jawr Grails plugin - Version 3.3.1 released:
    We are happy to finally provide to the Grails community the latest Jawr Grails plugin, which is fully compatible with all the new features of the Jawr 3.3.1 version. We also would like to apologize for the discontinuation of the plugin release.
    We are sorry for the inconvenience made to the Grails users, which where not able to use Jawr. We hope that you will enjoy this new version with all the latest features of Jawr.
    The Grails plugin 3.3.1 is available here.
    It will be soon available at the grails plugin repository.

    New feature:
    • Compatible with Grails version > 1.2.1
    • Fully compatible with Jawr 3.3.1.
    Fixed issues:
    • Issue #68 fixed : jawr.config.reload.refreshKey fails on the Grails plugin
    • Issue #130 fixed: In develpment Since Grails 1.2, Jawr can't reference pluing resources
    • Issue #148 fixed: Since grails 1.2, Jawr is not able to generate i18n messages
    • Issue #149 fixed: Since grails 1.2, Jawr is not able to generate i18n messages


    The following Jawr sample applications have been updated. You can have a look to them to see how to integrate the latest features :
    • basicwebapp
    • spring sample
    • wicket sample
    • grails sample
    You can retrieve them from the different modules on the SVN repository : https://svn.java.net/svn/jawr~svn

    Important note :
    It is important to notice that this version will be the last version which supports Java 1.4. The next major release will target Java 5.

    Thanks to all of you who contributed and provided feedback in the discussion forum.
    There still a lot to do. So any contribution is more than welcome.
    If you want to be part of the Jawr project, don't hesitate, join us.
  • 01rst February 2010: Version 3.2.1 released:
    This version contains mainly bug fixes.

    New feature:
    • For spring MVC projects, Jawr now allows you to use simultaneously configuration and configLocation properties. The values found in the configuration file at configLocation will be overrided by the properties defined in configuration.
      The configuration property is no more deprecated. Thanks to sfrancois99 and szeller for their feedbacks.
      Please check the documentation on the Spring MVC integration for more detail.
    Fixed issues:
    • Issue #81 fixed: jawr.[type].factory.dirmapper.excluded property doesn't work.
    • Issue #113 fixed: In spring MVC, when using only configuration property an exception is thrown.
    • Issue #115 fixed: Css image sprite generation doesn't work for generated CSS resource.
    • Issue #118 fixed: Image Streaming throws exception if the browser closes the stream
    • Issue #123 fixed: Images are not handled property with JawrSpringController.
    • Issue #124 fixed: The property "factory.use.orphans.mapper" is never taken in account. To be compliant with the Jawr properties naming convention, this property has been renamed to jawr.factory.use.orphans.mapper. Please check descriptor syntax doc for more detail.
    • Issue #125 fixed: In Spring MVC, an exception is thrown when the controller mapping is defined while the Spring servlet mapping is set to "/*".

    Thanks to qxo, mahoney266 and Robin Sander for reporting issues.



    Jawr ant task and maven plugin - Version 1.3 released:
    This version contains only one bug fix.

    Fixed issue:
    • Issue #116 fixed: Jawr bundle processing with the maven plugin or ant Task doesn't work with a spring MVC project. Please check the bundle preprocessing documentation for more detail.

    Thanks to acklenx for reporting the issue.

  • 09th December 2009: Version 3.2 released:
    A serious security issue has been found in Jawr when using the property jawr.debug.overrideKey, which allowed a user to access the content of the WEB-INF folder, and any file of your web application if the user finds the value of the property jawr.debug.overrideKey, which is defined your configuration file.
    This issue is fixed in this new version.

    We highly recommend you to switch to this new version or at least to remove this property from your configuration file if you want to stay with a previous version. The recommended way to switch your current session from production to debug, is to use the JMX feature of Jawr. Please check the JMX documentation for more detail.
    For those, who have created their own resource generator, we recommend them to look at the security issue section of the generator documentation

    New features/ fixed issues:
    • Jawr supports the generation of CSS image sprites. Jawr uses smartsprites for the sprite generation. Thanks to Stanislaw Osinski, smartsprites creator, for his help on the integration of Jawr with smartsprites.
      Please check the tutorial on the image sprite generation with Jawr for more detail.
    • Jawr now provides a new property named dependencies, which allows the user to define the dependencies for a bundle. Thanks to kgray for the original idea.
      Please check the bundle definition document for more detail.
    • Jawr now provides support for Wicket, thanks to a patch submitted by Robert Kopaczewski.
      Please check the Wicket integration document for more detail.
    • The generator API has been enhanced. Now you can create image generators, locale aware generators and generators, which support directory mapping. Please check the advanced generators document for more detail.
    • Jawr provides an new API for global preprocessor. The global preprocessors are executed before the standard resource bundling and post processing. Please check the global preprocessor document for more detail.
    • Jawr has introduced a new feature to overcome in debug mode the IE limitation, which can only handle 30 stylesheets in one page.
      This is particularly usefull for user which have CSS bundles in one page, containing more than 30 stylesheets. The new property jawr.debug.ie.force.css.bundle has been added for this purpose. If you set this value to true, in debug mode with an IE browser, Jawr will reference each CSS bundle as a unique CSS resource, instead of referencing all the resources of the bundle. Please check descriptor syntax doc for more detail.
    • The property jawr.css.image.classpath.use.servlet has been renamed to jawr.css.classpath.handle.image. So the use of jawr.css.image.classpath.use.servlet in your configuration file is deprecated. Use the property jawr.css.classpath.handle.image instead. Please check descriptor syntax doc for more detail.


    Fixed issues:
    • Issue #98 fixed: Input image tag produces <input type="image" disabled="false"> which disables the button.
    • Issue #105 fixed: css @charset declarations must be filtered out for CSS bundle.
    • Issue #107 fixed: NullPointerException when using JAWR in JSR-168 context.
    • Issue #108 fixed: No check for duplicate rendering of bundles using an alternate production URL.
    • Issue #109 fixed: Unnecessary bundling process for bundle using alternate production URL.
    • Issue #110 fixed: Image content length is set after the response has been sent.
    • Issue #111 fixed: Able to view files under web-inf directory.
    • Issue #112 fixed: jawr.config.reload.interval, jawr.config.reload.refreshKey don't work for Jawr with Spring MVC.

    Thanks to rodneyphillips, axelfont, tkaefer and chupa for reporting issues.

  • 28th September 2009: Version 3.1.2 released:
    This version contains only bug fixes.

    Fixed issues:
    • Issue #93 fixed: Localized messages generation only generates default locale when using message generator parameters.
    • Issue #95 fixed: CSS classpath generated resources contain postprocessors data in debug mode.

    Thanks to jmundt for reporting localized messages issue.



    Jawr ant task and maven plugin - Version 1.1.2 released:
    This version contains only one bug fix.

    Fixed issue:
    • Issue #96 fixed: Remove entity resolution when using bundle preprocessor.

    Thanks to acklenx for reporting the issue.

  • 01rst September 2009: Version 3.1.1 released:
    This version contains only bug fixes.

    Fixed issues:
    • Issue #76 fixed: A Page should render resource bundle only once.
    • Issue #89 fixed: Multiple invocations of a custom generator.
    • Issue #90 fixed: RendererRequestUtils.setRequestDebuggable(...) creates http sessions.
    • Issue #91 fixed: Src of img tag does not support relative path and is incorrect when the requested page is not in the web application root directory.
    • Issue #92 fixed: Jawr trips over Javascript multiline string literals

    We would like to thank qxo, jmundt, reardonm, cpo, kape and axelfont for reporting issues and providing patches when possible.

  • 10th August 2009: Version 3.1 released:
    This version contains mainly bug fixes.

    New features/ fixed issues:
    • A new tag have been added to the tag library to generate the URL to an image which is handled by Jawr. Look for the image tags at the tag library doc for extra info.
    • Issue #74 fixed: NoSuchElementException when bundle has no file. The issue occured when a bundle was defined with no mapping.
    • Issue #75 fixed: NullPointerException when using JawrImgServlet and image does not exist.
    • Issue #79 fixed: NullPointerException while requesting a CSS in debug mode if no Jawr image servlet was defined.
    • Issue #88 fixed: Incorrect logging of "The jawr bundle mapping 'jawr-img-mapping.properties' is not found"

    We would like to thank sfrancois99, qxo and nordicdevil for reporting issues and providing patches when possible.

  • 03rd August 2009: Version 3.0 released:
    New features/ fixed issues:
    • Jawr is now able to handle images. This means that all images managed by Jawr will be cached in the browser as the other Javascript and CSS resources. By default all CSS images will be handled by Jawr if the Jawr image servlet is defined. Look for the Jawr image handling section in the servlet docs and at jawr.image.resources in the descriptor syntax docs for extra info.
      Two new tags have been added to the tag library to handle these images. Look for the image tags at the tag library doc for extra info.
    • Jawr supports now JMX, which means that you will be able to modify at runtime the behaviour of Jawr using a JMX console. For example, you will be able to pass from production mode to debug mode an entire application or only one session at runtime. Look at the JMX support doc for extra info.
    • A new "bundle preprocessing" feature has been added in Jawr. This feature is also known as "build time bundle processing". This feature allows the user to skip the bundling process at server start-up, and use instead the data of preprocessed bundles. Look at the bundle preprocessing documentation for extra info.
      This feature is a new one, it can certainly be improved. So please don't hesitate to give your feedback on the Discussion Forum, on this feature and on Jawr in general.
    • We have also created a maven plugin and an Ant task to integrate the new bundle preprocessing feature in the project build phase. Look at the Jawr Ant task docs and the Jawr maven plugin docs for extra info.
      Thanks to Andreas Andreou for the original idea of the maven plugin.
    • We have also decided to provide a better support to usage of CDN in Jawr.
      The new property jawr.url.contextpath.ssl.override allows you to define what the CDN URL to use for HTTPS requests is.
      In debug mode, it is now possible to reference the debug resource files deployed on the CDN. To enable this feature, you will have to set to true, the property jawr.url.contextpath.override.used.in.debug.mode.
      Look for these properties in the descriptor syntax docs for extra info.
    • The property jawr.css.imagepath.override which defined the override path for CSS images has been removed. Now for CSS images, Jawr generates URLs which are relative to the CSS bundle even if the resource is deployed on a CDN. Look at the jawr.css.imagepath.override section at the bundle preprocessing doc for extra info.
    • For a better support of CDN, Jawr provides resources which can be integrated more easily in CDN. These files are generated using the bundle preprocessing feature. It even provides a rewrite configuration file for Apache server. Look at the CDN support section at the bundle preprocessing doc for extra info.
    • Jawr is now able to discover automatically the locales available for message resources. So the use of the bundle property jawr.js.bundle.[name].locales is no more necessary. Look for jawr.js.bundle.[name].locales at descriptor syntax doc for extra info.
    • Issue #69 fixed: CSS from jar file fails when using jawr.debug.overrideKey in production, is now fixed.
    • Issue #66 fixed: Add support for @import keyword in CSS is now fixed. You can use the new cssimport post processor to resolve the CSS import. Please take a look at the section CSS Import resolver at postprocessors documentation for more info.
    • Issue #72 fixed: Avoid skipping repeated members of bundles in debug mode which is fixed now. Before when the same resources was referenced twice in debug mode, the second one was skipped.
    • Issue #73 fixed: java.lang.IndexOutOfBoundsException in CSSMinifier is fixed now. The issue occured when the CSS file contains a '$' character in a non commented section.
  • 31 May 2009: Version 2.8 released:
    New features/ fixed issues:
    • While until now it has been possible to load CSS from the classpath, images referenced in them would not be resolved. Now the Jawr servlet can be used to serve images from the classpath as well, thus enabling fully the ability to serve styles and related images from jar files. Look for jawr.css.image.classpath.use.servlet at the servlet docs for extra info.
    • The classpath resource generator now allows to use the jar: prefix to map css (it used to be jar_css: for css, now the syntax is the same for both js and css files).
    • It is possible to request debug debug mode for a page in production mode. The purpose is to be able to have a javascript debugging session in a deployed application. The bundle members will be requested separately as if Jawr were in debug mode easing debug operations without having to redeploy. This is done by adding a special request parameter which is defined in configuration. Look for jawr.debug.overrideKey at the debug and production modes documentation for extra info.
    • A new way to force a refresh of all bundles has been added. A secret parameter name is defined in configuration using the key jawr.config.reload.refreshKey, and whenever a request that matches the Jawr servlet includes it, the configuration wil be reloaded. Look for jawr.config.reload.refreshKey at the servlet docs for extra info.
    • Orphans search and auto bundle generation can now be disabled for convenience using a new configuration parameter named factory.use.orphans.mapper. It is on by default but when set to false orphans will no longer be searched for.
    • Bundles can now be defined with an alternate static URL to use in production mode. This is useful for instance to use publicly served libraries (e.g. the YUI framework) while still using locally served files in development mode. Details can be found at at the bundle definition documentation, check out the productionURL param.
    • Issue #60 fixed: Per-file custom postprocessor were not being added to the postprocessing chain. Thanks to user ebottard for providing a patch to solve the issue.
    • Issue #61 fixed: The URL path rewriting postprocessor for CSS files was corrupting data: scheme image URLs which is now fixed. Thanks to user Tim Kingman for providing a patch to solve the issue.
    • Issue #63 fixed: The 'jawr.custom.postprocessors.names' property is no longer required. Instead, Jawr will detect all 'jawr.custom.postprocessors.[name_of_the_postprocessor].class' declarations to define postprocessors.
    • Issue #65 fixed: There was a file leak when using the jawr.config.reload.interval parameter because of a non closed FileInputStream. Fixed.
    • Issue #67 fixed: It was not possible to use more than one custom postprocessor per chain due to a bug which is now fixed.
    This release includes features and fixes by a new commiter, Ibrahim Chaehoi, who had already submitted patches for previous releases and decided to join the project. And indeed he has taken it seriously since most of the changes for this version are his work. Cheers to our new member!
  • 13th February 2009: Version 2.7 released:
    New features/ fixed issues:
    • EL expressions in tag libraries are now supported on older servlet containers, thanks to a patch submitted by Ibrahim Chaehoi.
    • The jawr.*.bundle.names property is now deprecated, also thanks to a patch submitted by Ibrahim Chaehoi. You may remove all jawr.js.bundle.names and jawr.css.bundle.names from your descriptors. You can still use them if you feel more comfortable that way.
    • Jawr now supports jawr.url.contextpath.override that begin with: //. This is a protocol relative url structure. It's handy when you are sharing your css and/or js with different domains and protocols. So these // urls will work relative to http and https.
    • Added jawr.css.imagepath.override property to allow for css url replacement that supports absolute URLs or really anything you would like prepended to the URL. This is usefull if you are sharing your css across multiple domains and use background images.
    • Classloading has been improved to better support the 18n messages generator, which failed to load properties files under certain conditions.
    • Fixed issue 49 (with no jawr.csslinks.flavor setting, style tags are ended with 'null')
    • Fixed issue 56 (incorrect path management in Spring MVC controller )
    This release includes code from our new commiter, Matt Ruby. Welcome aboard!. Also, as noted above, Ibrahim Chaehoi submitted a couple of high quality patches that were included in the release. Thanks a lot Ibrahim!
  • 23rd November 2008: Version 2.6 released:
    New features/ fixed issues:
    • Spring MVC support added. Jawr now provides a Spring MVC Controller so it can now be fully configured through Spring's configuration mechanism. See the manual page for details.
    • The way LINK tags are rendered can now be configured. Specifically, depending on the content type you choose for your pages, you may need the link tags to be closed differently, or even not closed at all. By default, tags will be closed as usual (i.e. with '/>'). But adding a new parameter to the properties configuration will make this behavior change. Check the taglib documentation and look for 'jawr.csslinks.flavor' for details.
    • A new generator has been added. Now CSS resources can be retrieved from the classpath by using the jar_css prefix.
    • [Issue #46] The jawr[css|js].bundle.names property is now augmentable when using ConfigPropertiesAugmenter, as it should have from the start.
    • [Unregistered Issue] Jawr does not close the outputstream nor the output writers handed by the servlet container, since that's an illegal operation, as was pointed out by user Lance.