JAWR使用详解
概述
现在的系统都趋向于富客户端,客户端的逻辑很多是Javascript来完成的,这样导致了JavaScript文件数量的增多,加大了对网络带宽的需求。JAWR是一个java项目的javascript和CSS集成和压缩工具,提供如下的功能:
1. 对网络交互的数据进行压缩,比如对JS,CSS,图片等。通过去除空行,空格,换行符,注释,变量名混淆可以大大减少JS和CSS文件大小。常用的压缩工具有JSMin, YuiCompressor,Packer,Microsoft Ajax Minifier和UglifyJS。对于第三方的JS,我们可以预先对其压缩。但对于自己开发的JS,为了可读性和可维护性,我们只能在项目部署的时候压缩。JAWR默认的JS压缩器为JSMIN,CSS的压缩器为CSS Compressor,可选的配置为YuiCompressor(支持JS和CSS)。
2. 可以合并所有的JS文件,合并所有的CSS文件。我们知道浏览器下载一个10K的文件,比下载10个1K的文件的速度要快很多,因为浏览器和服务端每次交互都会发送Request Header,服务器响应也会有Response Header,另外下载一个文件只需要建立一次网络连接,而10个文件则要建立10次网络连接,这个比较耗时。
3. 对图片Base64编码嵌入HTML页面。减少网络交互次数。
如何使用JAWR
1. 修改web.xml文件,加入如下代码:
<servlet>
<servlet-name>JavascriptServlet</servlet-name>
<servlet-class>net.jawr.web.servlet.JawrServlet</servlet-class>
<init-param>
<param-name>configLocation</param-name>
<param-value>/jawr.properties</param-value>
</init-param>
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>JavascriptServlet</servlet-name>
<url-pattern>*.js</url-pattern>
</servlet-mapping>
类似地,可以添加处理CSS和Image的Servlet。
2. 添加配置文件jawr.properties,我们可以在该配置文件中修改JAWR默认的配置选项以及定义Javascript Bundle和CSS Bundle。
3. 在JSP使用JAWR提供的tag来导入Javascript Bundle和CSS Bundle。比如<jwr:script src="${request.contextPath}/bundles/test.js"></jwr:script>
JAWR的工作流程(以JS为例)
1. Web服务器启动时,JAWR会按照配置选项来决定是否压缩JS,打包成Bundle文件,并将JS缓存到内存。
2. 翻译JSP时,将JS的引用转换为JAWR生成的JS Bundle URL,JAWR会将Bundle内容的HashCode作为URL Address的前缀,这样当JS文件发生变化时,JS的URL也会发生变化,客户端会从服务器端获取最新的JS。
3. 客户端请求下载JS文件时,Servlet将gzip压缩(可以配置)后的JS和CSS文件传送给浏览器。
4. 如果客户端请求的资源相对于客户机本地存储的缓存副本并没有发生变化,JAWR会返回Response Code:304 Not Modified, 这样服务端不会返回资源的内容,客户端会直接读取本地缓存副本。
JAWR常用配置选项
1. jawr.debug.on 可选值为true和false,为true时,JAWR不会对资源打包。反之则会对资源打包,压缩。
2. jawr.gzip.on 可选值为true和false,为true时,JAWR会根据浏览器是否支持gzip格式数据来对资源进行gzip压缩。反之,JAWR不会gzip压缩资源。
3. jawr.url.contextpath.override HTTP协议时,JS Bundle后URL地址前缀
4. jawr.url.contextpath.ssl.override HTTPS协议时,JS Bundle后URL地址前缀,可以配置为http://prefix形式,通过这样的配置,可以绕过某些情况下HTTPS页面不缓存JS和CSS的问题,但IE浏览器会给出如下的提示:
5. jawr.js.bundle.factory.bundlepostprocessors 配置JS bundle级别的postprocessor,比如我在项目上配置为YUI,这样JAWR使用YuiCompressor作为JS压缩器。
6. jawr.css.bundle.factory.bundlepostprocessors 同上,只是配置CSS bundle级别的postprocessor
如果在weblogic平台使用YUI压缩器,我们需要修改weblogic jar包的加载顺序,因为YUI使用到了Rhino(JS解释器),weblogic10本身已经包含了老版本的Rhino。我们需要修改jar包的加载顺序确保系统使用的是新版本的JS解释器。
详细的配置选项参见: