weblogic10.3+sitemesh全方位部署

Spingframework-2.5.5
Struts-2.0.11
Sitemesh-2.4.1
Hibernate-3.2.6(antlr-2.7.7.jar)
Weblogic Server 10.3.1(多语言版本—中文版)【java version "1.6.0_11"】

1、包antlr冲突问题

org.hibernate.QueryException:
ClassNotFoundException: org.hibernate.hql.ast.HqlToken
引起这个问题的原因是包antlr2.6.1.jar在WEBLOGIC10.3中与项目中HIBERNATE3.x用来解析SQL语句的包antlr-2.7.7.jar冲突了。

大致有3种方式可以解决这类问题：
1）在启动weblogic时，优先启动项目中使用到的antlr-2.7.7.jar的文件。在weblogic启动文件 的 classpath上优先增加antlr-2.7.7.jar 文件。如下：
set SAVE_CLASSPATH=.; d:\antlr-2.7.7.jar;%CLASSPATH%
注意：
你必须把antlr-2.7.7.jar 拷贝到 d:目录下或者其他你自己设定的目录名。

2）在hibernate.properties或者hibernate-cfg.xml，或者 db-jdbc.properties中设置一个属性hibernate.query.factory_class的值为
org.hibernate.hql.classic.ClassicQueryTranslatorFactory
注意：
●选择Hibernate3.x的查询翻译器：
org.hibernate.hql.ast.ASTQueryTranslatorFactory
●选择Hibernate2.x的查询翻译器
org.hibernate.hql.classic.ClassicQueryTranslatorFactory

3）在/WEB-INF 目录下增加或者修改 weblogic.xml文件。
<container-descriptor>
<prefer-web-inf-classes>true</prefer-web-inf-classes>
</container-descriptor>
注意：
●这个方法不是推荐的，因为这个设置可能会引起JSTL的设置冲突。

2、Servlet2.5规范问题
如果使用servlet2.5规范来配置web.xml文件。在系统启动时出现以下错误：
java.lang.IllegalArgumentException: Illeagal combination - Mode.PAYLOAD and Provider<javax.xml.soap.SOAPMessage>
at com.sun.xml.ws.server.provider.ProviderEndpointModel.<init>(ProviderEndpointModel.java:111)
at com.sun.xml.ws.server.provider.ProviderInvokerTube.create(ProviderInvokerTube.java:63)

解决的方法
1）使用 web.xml 2.4 的规范 而不是使用 web.xml 2.5 规范；
2）在weblogic.xml中设置（参见上面的说明）：
<prefer-web-inf-classes>true</prefer-web-inf-classes>；

3、装饰器无法正常工作
装饰器无法正常工作,只能返回请求页面,不会对页面进行任何装饰。比如提交一个struts2请求 /portal/abc.do，同时也设置了sitemesh过滤器映射这个请求，以及在decorators.xml中也设置了装饰器，比如：
<decorator name="foreDecorator" page="template.jsp">
<pattern>/portal/abc.do</pattern>
</decorator>
现在假设struts2请求 /portal/abc.do将会返回到一个页面 abc.jsp页面。结果，页面只返回了abc.jsp页面上的数据，而没有被template.jsp页面进行装饰。通过查看源代码发现。在准备装饰之时，weblogic的 request.getServletPath()得到是 abc.jsp，而不是/portal/abc.do。
因此在decorators.xml并不能找到需要装饰的mapping。除非将<pattern>/portal/abc.do</pattern>修改为：
<pattern>/abc.jsp</pattern>
是可以被映射并装饰了。

解决的方法
修改sitemesh的对应的decorator mapping源代码。在这里这个文件是：
com\opensymphony\module\sitemesh\mapper\ConfigDecoratorMapper.java
修改这个文件。使用 request.getRequestURI() 代替 request.getServletPath()来获得待匹配的URL。

4、Sitemesh乱码问题
关于sitemesh乱码问题，除了与Tomcat环境下的设置以外。比如：
通过过滤器设置：
request.setCharacterEncoding(encoding);
response.setCharacterEncoding(encoding);

JSP文件设置：
<%@page contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>

Weblogic针对sitemesh方面还有3个地方出现乱码：
1）在装饰器文件中使用 <decorator:body /> 乱码。这个是最常用的，也就是最常见的乱码问题。
2）page:applyDecorator，指定了待装饰的jsp文件，比如：t1.jsp:
<page:applyDecorator page="t1.jsp" name="t1Decorator"/>
这样t1.jsp渲染后出现乱码。
3）一个请求通过了sitemesh过滤器，但同时又没有找到对应的装饰器（同时并不在excludes中指定），这样就是使用默认的装饰器（NoDecorator）进行直接输出。
com.opensymphony.sitemesh.webapp.decorator.NoDecorator

虽然是各种不同的情况，但原因都有些类似，就是在weblogic环境下，Sitemesh在装饰页面时，如果response的contentType为null，则使用java虚拟机属性值"file.encoding"，而该值与操作系统相关，在windows系统下，该值=GBK.由于页面本身是UTF-8编码的，经过sitemesh装饰后，使用GBK编码转换，产生乱码。

解决的方法
既然跟file.encoding有关系，那么就直接设置这个系统属性可以解决上面的全部问题。解决如下：在weblogic启动文件 的 启动参数上增加-Dfile.encoding。如下：
set SAVE_JAVA_OPTIONS=%JAVA_OPTIONS% -Dfile.encoding=UTF-8
注意：
●这个方法简单明了，而且不用修改其他方面；
●但是，如果这样设置的话，Weblogic本身的启动等相关信息就乱码了。

因此，在下面使用其他的方式来解决上面的3个问题：
1）通过查看源代码，发现进行内容装饰之前需要进行对内容字节转换成字符串，在转换的时候，如果没有获得编码，那么就是用file.encoding。因此，可以修改这个文件，使默认使用的编码为”UTF-8”.
com.opensymphony.module.sitemesh.filter.TextEncoder

2）page:applyDecorator，指定了待装饰的jsp文件，那么，同时需要指定这个文件使用的编码。如下：
<page:applyDecorator page="t1.jsp" name="t1Decorator" encoding="UTF-8"/>

3）针对第3个乱码问题，可以通过修改如下文件：
com.opensymphony.sitemesh.webapp.decorator.NoDecorator
让输出的字符串作为 UTF-8的方式直接输出到response中。

5、<c:import…>乱码问题
所包含的文件需要使用charEncoding="UTF-8"进行限定。
<c:import url="/portal/block/userBlock11.jsp" charEncoding="UTF-8"/>