weblogic10.3+sitemesh全方位部署
转载自lontoo
Spingframework-2.5.5
Struts-2.0.11
Sitemesh-2.4.1
Hibernate-3.2.6(antlr-2.7.7.jar)
WeblogicServer10.3.1(多语言版本—中文版)【javaversion"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文件。如下：
setSAVE_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:Illeagalcombination-Mode.PAYLOADandProvider<javax.xml.soap.SOAPMessage>
atcom.sun.xml.ws.server.provider.ProviderEndpointModel.<init>(ProviderEndpointModel.java:111)
atcom.sun.xml.ws.server.provider.ProviderInvokerTube.create(ProviderInvokerTube.java:63)
解决的方法
1）使用web.xml2.4的规范而不是使用web.xml2.5规范；
2）在weblogic.xml中设置（参见上面的说明）：
<prefer-web-inf-classes>true</prefer-web-inf-classes>；
3、装饰器无法正常工作
装饰器无法正常工作,只能返回请求页面,不会对页面进行任何装饰。比如提交一个struts2请求/portal/abc.do，同时也设置了sitemesh过滤器映射这个请求，以及在decorators.xml中也设置了装饰器，比如：
<decoratorname="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的对应的decoratormapping源代码。在这里这个文件是：
com\opensymphony\module\sitemesh\mapper\ConfigDecoratorMapper.java
修改这个文件。使用request.getRequestURI()代替request.getServletPath()来获得待匹配的URL。
4、Sitemesh乱码问题
关于sitemesh乱码问题，除了与Tomcat环境下的设置以外。比如：
通过过滤器设置：
request.setCharacterEncoding(encoding);
response.setCharacterEncoding(encoding);
JSP文件设置：
<%@pagecontentType="text/html;charset=UTF-8"pageEncoding="UTF-8"%>
Weblogic针对sitemesh方面还有3个地方出现乱码：
1）在装饰器文件中使用<decorator:body/>乱码。这个是最常用的，也就是最常见的乱码问题。
2）page:applyDecorator，指定了待装饰的jsp文件，比如：t1.jsp:
<page:applyDecoratorpage="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。如下：
setSAVE_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:applyDecoratorpage="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:importurl="/portal/block/userBlock11.jsp"charEncoding="UTF-8"/>