sitemesh 简介 sitemesh装饰后的html中文乱码解决方法

现在的位置: 首页 > java > 正文

RSS

小中大

上篇下篇

sitemesh 简介 sitemesh装饰后的html中文乱码解决方法

2012年05月09日 ⁄ java ⁄ 共 2442字 ⁄ 暂无评论

SiteMeshTest eclipse 例子

　OS(OpenSymphony)的SiteMesh是一个用来在JSP中实现页面布局和装饰（layout and decoration）的框架组件，能够帮助网站开发人员较容易实现页面中动态内容和静态装饰外观的分离。

　　Sitemesh功能基础

　　Sitemesh是由一个基于Web页面布局、装饰及与现存Web应用整合的框架。它能帮助我们再由大量页面工程的项目中创建一致的页面布局和外观，如一致的导航条、一致的banner、一致的版权等。它不仅能处理动态的内容，如JSP、PHP、ASP、CGI等产生的内容，还能处理静态的内容，比如HTML的内容，使得它的内容也符合你的页面结构的要求。甚至它能像include那样将HTML文件作为一个面板的形式嵌入到别的文件中去。所有的这些，都是GOF的Decorator模式的最生动的实现。装饰模式是在不必改变原类文件和使用集成的情况下，动态地扩展一个对象的功能。它能通过创建一个包装对象，也就是装饰来包裹的对象。尽管它是由Java语言来实现的，但是它能与其他Web应用很好的集成

应用了sitemesh装饰模板后，所有html页面，只有有中文都会出现乱码问题，导致页面加载超级慢，或直接就报错了。

郁闷了很久，开始不知道是sitemesh搞的鬼，测试了n多都不知道是什么原因，后来搜索html乱码才知道是sitemesh引起的。

于是搜索相关资料，综合了几个设置终于解决了，分享下解决方法。

有几个地方要改的：

1.排除不装饰的html文件目录

<excludes>
   <pattern>/index.jsp</pattern>
   <pattern>/coos/*.*</pattern>
   <pattern>/scripts/*.*</pattern>
</excludes>

2. 在web.xml里面加入一个filter

(1)到你apache-tomcat-6.0.14webappsexamples WEB-INFclassesfilters下找到SetCharacterEncodingFilter.java这个文件。
(2)把 SetCharacterEncodingFilter.java放到你的工程代码中。
(3)设置web.xml
    <filter>
     <filter-name>Set Character Encoding </filter-name>
     <filter-class>你的包.SetCharacterEncodingFilter </filter-class>
     <init-param>
       <param-name>encoding </param-name>
       <param-value>UTF-8 </param-value>
     </init-param>
     <init-param>
       <param-name>ignore </param-name>
       <param-value>true </param-value>
     </init-param>
   </filter>
   <filter-mapping>
     <filter-name>Set Character Encoding </filter-name>
     <servlet-name>action </servlet-name>
   </filter-mapping>

3.在 struts.properties　添加：
struts.locale=zh_CN
struts.i18n.encoding=UTF-8

4.在web.xml中EncodingFilter的位置应该在Struts2的FilterDispatcher之前，因为要先调整字符集，然后进入Action。按照Struts2的API，filter的顺序是
struts-cleanup filter
SiteMesh filter
FilterDispatcher

总之，所有涉及到编码的地方都改成UTF-8吧

jsp的可以根据<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>来识别编码，HTML的却不行，而且没有好的解决方案。

附网上不完美的解决方案：

静态html在sitemesh中乱码的解决方法。
前提条件：sitemesh的decorator的编码全部用UTF- 8，使用SetCharacterEncodingFilter把request的encoding也
设置成UTF-8

问题 1、decorator中的内容出现乱码。
原因：
解决方法：改进SetCharacterEncodingFilter，使它对 response也设置encoding为UTF-8

问题2、被修饰的html内容出现乱码。
原因：sitemesh根据 html的contenttype（例如：text/html;charset=utf-8）来决定html文件的encoding，
如果 contenttype是像（text/html）这样的形式，sitemesh就无法知道html的encoding，这时sitemesh就
使用DEFAULT_ENCODING即System.getProperty("file.encoding")，在jetty中正是后面那样，估计 tomcat也是这样。

解决方法：使html的encoding和 System.getProperty("file.encoding")相同。
1、启动jetty时将java系统变量file.encoding设置为UTF-8，html的编码也用UTF-8.（推荐）

注：即使是编码都是UTF-8，只要没排除装饰还是不行。