NO.90 Struts2.3.15.1升级总结
来源:互联网 发布:淘宝运费险保费 编辑:程序博客网 时间:2024/06/06 12:39
由于大家都懂的原因,涉struts2的项目需要将struts2相关包升级至2.3.15.1。今将升级方法和常见问题解决简单总结如下。
一、基本升级操作
1. 获取Struts2.3.15.1jar包
从Struts官网下载struts2.3.15.1发布包:
http://apache.fayea.com/apache-mirror//struts/library/struts-2.3.15.1-lib.zip
2.工程中的jar包替换
以下清单为示例,请根据工程实际情况参照替换成struts-2.3.15.1-lib.zip包中的版本:
原始版本(版本号为示例)
升级后版本
commons-lang-2.*.jar
commons-lang-2.4.jar
commons-lang3-3.1.jar (新增)
commons-logging-1.*.jar
commons-logging-1.1.3.jar
commons-fileupload-1.*.*.jar
commons-fileupload-1.3.jar
freemarker-2.3.*.jar
freemarker-2.3.19.jar
ognl-*.*.*.jar
ognl-3.0.6.jar
struts2-core-2.*.*.*.jar
struts2-core-2.3.15.1.jar
struts2-spring-plugin-2.*.*.*.jar
struts2-spring-plugin-2.3.15.1.jar
struts2-dojo-plugin-2. *.*.*.jar
struts2-dojo-plugin-2.3.15.1.jar
struts2-dwr-plugin-2. *.*.*.jar
struts2-dwr-plugin-2.3.15.1.jar
xwork-core-2.3.*.*.jar或者xwork-2.*.*.jar
xwork-core-2.3.15.1.jar
javassist-3.*.*.GA.jar
javassist-3.11.0.GA.jar
aspectjrt-1.5.2a.jar(见附件3.其它jar包)
aspectjweaver-1.5.2a.jar(见附件3.其它jar包)
(这三个文件若没有则需添加)
注1:工程中以struts2打头的jar包均需替换为2.3.15.1版本;
注2:除非表格中另有说明,则原始版本中若不存在相应jar包,则也不需要添加相应的2.3.15.1版jar包;
3.web.xml可能的修改
注意:如文件中原本已是调整后的配置,则请忽略本部分内容。
3.1修改struts2dispatcher过滤器
原始内容:
<filter>
<filter-name>struts2</filter-name> <filter-class>org.apache.struts2.dispatcher.FilterDispatcher</filter-class>
</filter>
修改后内容:
<filter>
<filter-name>struts2</filter-name>
<filter-class>org.apache.struts2.dispatcher.ng.filter.StrutsPrepareAndExecuteFilter</filter-class>
</filter>
3.2去掉或注掉ActionContextCleanUp过滤器
请去掉或注掉web.xml中ActionContextCleanUp过滤器:
<!--filter>
<filter-name>struts-cleanup</filter-name>
<filter-class>org.apache.struts2.dispatcher.ActionContextCleanUp</filter-class>
</filter-->
<!--filter-mapping>
<filter-name>struts-cleanup</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping-->
注意:不修改可能导致第二节中问题5。
4.所有*validators.xml可能的修改
注意:如文件中原本已是调整后的配置,则请忽略本部分内容。
4.1标签头的调整
原始内容:
<!DOCTYPE validators PUBLIC
"-//OpenSymphony Group//XWork Validator Config 1.0//EN"
"http://www.opensymphony.com/xwork/xwork-validator-config-1.0.dtd">
修改后内容:
<!DOCTYPEvalidatorsPUBLIC
"-//ApacheStruts//XWork Validator Config 1.0//EN"
"http://struts.apache.org/dtds/xwork-validator-config-1.0.dtd">
注意:不修改可能导致第二节中问题2。
二、常见问题及解决方案
1. NoClassDefFoundError:com/opensymphony/xwork2/util/TextUtils问题解决
现象:启动报出以下错误
<2013-7-30 下午03时58分11秒 CST> <Error> <HTTP> <BEA-101020> <[ServletContext@13341578[app:piccallweb module:piccallweb path:/piccallweb spec-version:2.5]] Servlet failed with Exception
java.lang.NoClassDefFoundError:com/opensymphony/xwork2/util/TextUtils
at com.googlecode.jsonplugin.SerializationParams.<init>(SerializationParams.java:38)
at com.googlecode.jsonplugin.JSONResult.writeToResponse(JSONResult.java:194)
at com.googlecode.jsonplugin.JSONResult.execute(JSONResult.java:184)
at com.opensymphony.xwork2.DefaultActionInvocation.executeResult(DefaultActionInvocation.java:371)
at com.opensymphony.xwork2.DefaultActionInvocation.invoke(DefaultActionInvocation.java:275)
Truncated. see log file for complete stacktrace
>
原因:xwork-core-2.3.15.1.jar中由于升级现已去除com.opensymphony.xwork2.util.TextUtils。
解决方案:
1.替换jar包
原始版本
修改后版本
jsonplugin-0.**.jar
json-lib-1.1-jdk13.jar
struts2-json-plugin-2.3.15.1.jar
json-lib-2.3-jdk15.jar
struts2-junit-plugin--2.3.15.1.jar
2.所有*struts*.xml配置的extends="struts-default"改成extends="json-default"
2.启动报 com.opensymphony.xwork2.config.ConfigurationException问题解决
现象:启动报出以下错误(仅截取了最上面和最下面的异常信息)
com.opensymphony.xwork2.config.ConfigurationException:Caught Exception while registering Interceptor classorg.apache.struts2.interceptor.validation.AnnotationValidationInterceptor
atcom.opensymphony.xwork2.ObjectFactory.buildInterceptor(ObjectFactory.java:214) ~[xwork-core-2.3.15.1.jar:2.3.15.1]
……
Caused by:java.net.UnknownHostException:www.opensymphony.com
atjava.net.InetAddress.getAllByName0(InetAddress.java:1157) ~[na:1.6.0_29]
atjava.net.InetAddress.getAllByName(InetAddress.java:1083) ~[na:1.6.0_29]
atjava.net.InetAddress.getAllByName(InetAddress.java:1019) ~[na:1.6.0_29]
原因:由于xwork升级,validator.xml的文件头dtd配置需要做相应更新。
解决办法:参见第四节中第(1)部分内容。
3. struts2的标签报错问题解决
现象:显示页面报错:struts2的标签使用出现问题,标签中不支持表达式,如:EL表达式
This attribute does not supportrequest time values.
<s:select list="#{'':'','0':'否','1':'是'}"id="prpCmainProp.quakeFlag" name="prpCmainProp.quakeFlag"value="${prpCmainProp.quakeFlag}"
原因:struts2.3.15中使用s标签,默认不支持表达式。
解决办法:修改struts-tags.tld中所有的rtexprvalue标签属性为true。
<rtexprvalue>true</rtexprvalue>
4. ajax异步调用中文参数后台变乱码问题解决
现象:前台通过POST往后台传值时中文字符为乱码
原因:struts2.3.15中org.apache.struts2.dispatcher.Dispatcher类prepare方法中新增了对于异步调用情况字符集强制转换为UTF-8(见下方代码),因此如果工程中jsp指定的字符集不是UTF-8,则中文传至后台会变成乱码。
if ("XMLHttpRequest".equals(request.getHeader("X-Requested-With"))) {
encoding = "UTF-8";
}
解决办法:改写org.apache.struts2.dispatcher.Dispatcher类注掉上面三行内容
后直接放在工程源码中
5. ActionContextCleanUp is deprecatedWARNING问题解决
现象:系统启动报“>>>ActionContextCleanUp<<< is deprecated! Pleaseuse the new filters!”WARNING
原因:从Struts2.1.3起废弃了ActionContextCleanUp过滤器,其相关功能在StrutsPrepareAndExecuteFilter实现。
解决办法:参见第三节中第(2)部分内容。
6. struts2的TextFieldTag和SelectTag等标签required属性报错问题解决
现象:JSP报“contains no methods named setRequired”错误
原因:2.3.X版本中required属性已替换为requiredLabel,官方说明参见http://struts.apache.org/release/2.3.x/docs/textfield.html。
解决办法:批量替换标签中的required为requiredLabel。
7. OGNL表达式问题解决
现象:部分系统中对com.opensymphony.xwork2.util.OgnlUtils.java和ognl.OgnlRuntime.java有单独覆盖,升级后存在不兼容现象
解决办法:新的Ognl中已经修复了历史OgnlUtils中存在的问题,所以删除系统中OgnlUtils.java即可,ognl.OgnlRuntime.java这个文件按照新版本Ognl进行覆盖修改
三、其它注意事项
为保证更新成功,请注意删除工程在中间件中产生的临时文件,以weblogic为例,WebLogicDomain下工程的缓存文件所在目录可能包括但不限于以下位置:
- [domain所在目录]\servers\[server名]\tmp
- weblogic.xml中配置的working-dir目录
- NO.90 Struts2.3.15.1升级总结
- NO.90 Struts2.3.15.1升级总结
- NO.90 Struts2.3.16.1升级总结
- Struts2.3.15.1升级总结
- struts2.1.6升级到struts2.3.15.1
- struts2.1.6升级到struts2.3.15.1
- Struts2.3.15.1升级Struts2.3.32
- NO.93 WebLogic1213升级常见问题总结
- struts2升级到2.3.15.1总结
- struts2升级到2.3.15.1总结
- struts2.0升级到struts2.1
- Struts2.1.8.1 升级至Struts2.3.20
- Struts2.3升级struts2.5.10.1
- Struts2 升级
- struts2升级
- struts2.1.8.1升级到struts2.3.15.1出现action 404错误
- 不知道哪位大神给个建议,Struts2.3.15.1升级为Struts2.3.32时出错
- Struts2 漏洞:Struts2.2.1版本紧急升级Struts2.3.15.1版本中遇到问题和解决方法,你中招了没?!
- MPIA demo_v1.3
- 【Transact-SQL】一个计算用电量的问题
- js获取当前页面的一些值,比如大小宽度等(借鉴)
- Hibernate配置
- 复习快速排序
- NO.90 Struts2.3.15.1升级总结
- Essential C++中文版——满汉全席之外
- android:仪表盘(简单易实现)
- PL/SQL表---table()函数用法
- Context泄漏:Handlers & Inner Classes
- JSR286 Portlet开发:Portlet之间的Events通信
- 再谈DOS批处理下格式化日期字符串的方法(详解)
- java List 排序 Collections.sort() 对 List 排序
- 浅析大数据量高并发的数据库优化