项目需要,要把原本的struts做升级,遇到页面样式失效的问题,特此记录查寻结果和修改方法
一、下载官方参考的struts2.5升级时使用的jar包
commons-fileupload-1.3.3.jar
commons-io-2.5.jar
freemarker-2.3.23.jar
javassist-3.20.0-GA.jar
log4j-api-2.8.2.jar
ognl-3.1.15.jar
struts2-core-2.5.13.jar
这里的jdk需要更换成1.8版本
http://struts.apache.org/download.cgi#struts2526
http://struts.apache.org/download.cgi#struts2530
我们可以下载all(环境包)和src(源码)
二、替换项目中的jar包
同名jar包更换新版本,删除xwork-core的jar包,在新版的struts2-core-2.5的新版本jar包中包含了该内容。
三、更新struts.xml文件中的内容
1、修改struts头部的版本(例如这里将原版的2.1修改位2.5)
-
<!DOCTYPE struts PUBLIC "-//Apache Software Foundation//DTD Struts Configuration 2.1//EN"
"http://struts.apache.org/dtds/struts-2.1.dtd"><!DOCTYPE struts PUBLIC "-//Apache Software Foundation//DTD Struts Configuration 2.5//EN"
"http://struts.apache.org/dtds/struts-2.5.dtd"> - 2、在<struts>标签内增加
- <constant name="struts.enable.DynamicMethodInvocation" value="true"/>
- 3、在<package>标签内增加
- <global-allowed-methods>regex:.*</global-allowed-methods>
四、修改web.xml文件
1、使用StrutsPrepareAndExecuteFilter拦截器
新的拦截器不再存在于ng包下,这里需要更换成
org.apache.struts2.dispatcher.filter.StrutsPrepareAndExecuteFilter
如果是在文件中引用import了该包也需要修改去掉ng包
<filter>
<filter-name>struts2</filter-name>
<filter-class>org.apache.struts2.dispatcher.ng.filter.StrutsPrepareAndExecuteFilter</filter-class>
</filter>
五、修改页面的struts标签(新的struts中一些属性发生了更改)
1、修改escape属性为escapeHtml
例如<s:property value="name" escape="false" />
修改<s:property value="name" escapeHtml="false" />
2、修改部分s标签中的id属性为var(<s:iterator>、<s:bean>)
例如<s:iterator value="userList" id="user" status="status">
修改<s:iterator value="userList" var="user" status="status">
3、<s:set>的name属性需要修改为var属性
六、类方法ActionContext.getParameters()返回类型发生变化
由原Map<String, Object>类型变化为了HttpParameters,这里可以做一些兼容的改动
原:Map<String, Object> params = ServletActionContext.getContext().getParameters();
新:HttpParameters params = ServletActionContext.getContext().getParameters();
1、使用toMap方法做一次转换
Map<String, String[]> stringMap = HttpParameters.toMap();
2、使用遍历的方式放入
Map<String, Object> map = new HashMap<String, Object>();
for (Map.Entry<String, Parameter> entry: params.entrySet()) {
map.put(entry.getKey(), params.get(entry.getKey()));
}
七、可能出现的乱码问题
对jar包中的class进行编辑替换可以解决
八、遇到的一些问题
1、Struts2找不到org.apache.struts2.dispatcher.ng.filter.StrutsPrepareAndExecuteFilter
参考:https://blog.csdn.net/hgx_suiyuesusu/article/details/78167616
引用包需要从org.apache.struts2.dispatcher.ng.filter.StrutsPrepareAndExecuteFilter
更改为org.apache.struts2.dispatcher.filter.StrutsPrepareAndExecuteFilter
2、ClassNotFoundException: org.apache.logging.log4j.Logger
引入相应log的jar包即可
可参考:https://blog.csdn.net/weixin_42756361/article/details/102502842
https://bbs.csdn.net/topics/392182439
在maven中引入新的log4j包
<dependency>
<groupId>org.apache.logging.log4j</groupId>
<artifactId>log4j-api</artifactId>
<version>2.11.0</version>
</dependency>
<dependency>
<groupId>org.apache.logging.log4j</groupId>
<artifactId>log4j-core</artifactId>
<version>2.11.0</version>
</dependency>
如果不是maven的项目就将jar包下载下来放在项目的lib目中并引入
3、org.apache.struts2.convention.DefaultClassFinder - Unable to read class
可参考:https://blog.csdn.net/qq_16711967/article/details/79345906
使用SSH框架但是报错不能读取,根据报错明显是struts2-convention插件创建导致了不兼容问题,项目中不需要它,所以删除该插件,然后编译运行没有运行错误。
4、java.lang.NoSuchMethodError:org.apache.commons.lang3.reflect.MethodUtils.getAnnotation
https://blog.csdn.net/qq_44790703/article/details/108078498
5、Struts jsp标签问题,有两个错误。
5.1、org.apache.jasper.JasperException: /main/synccontent/retransquery/manage_list.jsp(24,5) Attribute id invalid for tag bean according to TLD
这个问题,是jar包升级后,原有的标签写法不能用了,这也是Struts的一个缺点,版本升级居然不做向下兼容,导致我这边的jsp用的低版本标签,全部作废,第一想法就是,修改jsp页面了,这工作量太大了,不现实。于是,想到了自定义标签的办法,来解决这个兼容问题
首先在web.xml里配置关联自定义标签的文件
<jsp-config>
<taglib>
<taglib-uri>/struts-tags</taglib-uri>
<taglib-location>/WEB-INF/struts-tags.tld</taglib-location>
</taglib>
</jsp-config>
然后,编写struts-tags.tld文件,内容如下,可以复制直接使用,添加tag和attribute标签
<?xml version="1.0" encoding="UTF-8"?>
<taglib xmlns="http://java.sun.com/xml/ns/j2ee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="2.0" xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-jsptaglibrary_2_0.xsd">
<description><![CDATA["To make it easier to access dynamic data;
the Apache Struts framework includes a library of custom tags.
The tags interact with the framework's validation and internationalization features;
to ensure that input is correct and output is localized.
The Struts Tags can be used with JSP FreeMarker or Velocity."
]]></description>
<display-name>"Struts Tags"</display-name>
<tlib-version>2.2.3</tlib-version>
<short-name>s</short-name>
<uri>/struts-tags</uri>
<tag>
<description><![CDATA[Print out expression which evaluates against the stack]]></description>
<name>property</name>
<tag-class>org.apache.struts2.views.jsp.PropertyTag</tag-class>
<body-content>empty</body-content>
<attribute>
<description><![CDATA[The default value to be used if <u>value</u> attribute is null]]></description>
<name>default</name>
<required>false</required>
<rtexprvalue>false</rtexprvalue>
</attribute>
<attribute>
<description><![CDATA[ Whether to escape HTML]]></description>
<name>escape</name>
<required>false</required>
<rtexprvalue>false</rtexprvalue>
</attribute>
<attribute>
<description><![CDATA[Whether to escape Javascript]]></description>
<name>escapeJavaScript</name>
<required>false</required>
<rtexprvalue>false</rtexprvalue>
</attribute>
<attribute>
<description><![CDATA[Value to be displayed]]></description>
<name>value</name>
<required>false</required>
<rtexprvalue>false</rtexprvalue>
</attribute>
<dynamic-attributes>false</dynamic-attributes>
</tag>
</taglib>
这样配置好后,就可以解决上述问题
5.2、javax.servlet.ServletException: /main/synccontent/retransquery/manage_list.jsp(129,21) Unable to find setter method for attribute: escape
这个问题是基于5.1解决之后,产生的问题,attribute 配置问题。我这边升级的jar版本是
struts2-core-2.5.26.jar。但是,自定义标签配置中,escape attribute 对应的java类,没有set方法,导致的这个错误。
我们查看struts-tags.tld配置文件,发现,对应的class是
<tag-class>org.apache.struts2.views.jsp.PropertyTag</tag-class>
可以看出,它是Struts jar包中的类。
全局搜索出这个PropertyTag.class文件,会发现,里面确实没有escape对应的set方法
于是,修补jar包,加上set方法即可
6、tag ‘select’, field ‘list’, name ‘contentType’: The requested list key ‘#syscodeBean.syscodeBysernoList’ could not be resolved as a collection/array/map/enumeration/iterator type. Example: people or people.{name} - [unknown location]
访问jsp页面总是报这个错误
排查过程:
首先看错误日志,找到这个错误片段,但是,还是很难定位原因
然后,启动本地项目,访问同一个jsp页面,居然是好的,看来是项目代码管理乱了
再叫运维拉服务器代码,到本地查看比对两个页面的差异
发现,不一样的地方是
服务器代码:
<s:bean name="com.linkage.system.components.system.ui.pagebean.SyscodeBean" id="syscodeBean">
本地代码:
<s:bean name="com.linkage.system.components.system.ui.pagebean.SyscodeBean" var="syscodeBean">
遇到的不仅<s:bean>标签<s:iterator>标签等中的id换成var
会发现,是id和var变量的问题
这里就涉及到Struts2的自定义标签的知识点
按住ctrl,点击id,进入tld配置文件,找到class
org.apache.struts2.views.jsp.BeanTag
直觉判断,是Struts2的标签里把变量名定义成var,所以,用id时候无法识别
于是,debug,发现
org.apache.struts2.views.jsp.BeanTag中
protected void populateParams() {
super.populateParams();
((Bean)this.component).setName(this.name);
}
发现,用id的时候,component里面对应的变量var是null
查看ContextBeanTag.super.populateParams();
发现,这里定义了变量名是var,于是,确定了根源在这个class文件的不兼容问题上
在找到低版本的jar,查看同名文件,发现低版本的里面
public void setId(String id) {
this.setVar(id);
}
通过这个方法,吧id值传给了var变量,从而做到了兼容效果,解决了该问题
7、升级对struts.xml的修改
1.头部改为:2.3改为2.5
<!DOCTYPE struts PUBLIC "-//Apache Software Foundation//DTD Struts Configuration 2.5//EN" "http://struts.apache.org/dtds/struts-2.5.dtd">
2.增加DynamicMethodInvocation配置(下面文件的10行)
<constant name="struts.enable.DynamicMethodInvocation" value="true"/>
3.增加自定义action global-allowed-methods配置(下面文件的40行)
<global-allowed-methods>regex:.*</global-allowed-methods>
4.可能存在页面样式失效的问题(下面文件的13至16行)
<!-- 让jsp拥有html同样的样式,防止变形 -->
<constant name="struts.ui.theme" value="simple" />
<constant name="struts.ui.templateDir" value="template" />
<constant name="struts.ui.templateSuffix" value="ftl" />
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE struts PUBLIC "-//Apache Software Foundation//DTD Struts Configuration 2.5//EN"
"http://struts.apache.org/dtds/struts-2.5.dtd">
<struts>
<constant name="struts.multipart.maxSize" value="1073741824" />
<constant name="struts.custom.i18n.resources" value="applicationResource_en" />
<constant name="struts.i18n.encoding" value="UTF-8" />
<constant name="struts.multipart.saveDir" value="/ticm/temp" />
<constant name="struts.objectFactory" value="spring" />
<constant name="struts.enable.DynamicMethodInvocation" value="true"/>
<constant name="struts.action.extension" value="do" />
<!-- 让jsp拥有html同样的样式,防止变形 -->
<constant name="struts.ui.theme" value="simple" />
<constant name="struts.ui.templateDir" value="template" />
<constant name="struts.ui.templateSuffix" value="ftl" />
<package name="abstract_struts" abstract="true" extends="struts-default"
namespace="/">
<result-types>
<result-type name="json" class="org.apache.struts2.json.JSONResult" />
</result-types>
<!-- check login interceptor -->
<interceptors>
<interceptor name="checkLoginInterceptor" class="checkLoginStack" />
<interceptor-stack name="checkLoginStack">
<interceptor-ref name="checkLoginInterceptor" />
<interceptor-ref name="defaultStack" />
</interceptor-stack>
</interceptors>
<default-interceptor-ref name="checkLoginStack" />
<global-results>
<result name="loginAciton" type="redirect">/loginPage.do</result>
<result name="loginPage">/system/login/login.jsp</result>
<result name="error">/pages/common/errors/error.jsp</result>
<result name="exception">
/pages/common/errors/exception.jsp
</result>
</global-results>
<global-allowed-methods>regex:.*</global-allowed-methods>
</package>
<include file="struts/struts-import-basic.xml" />
<include file="struts/struts-import-prom.xml" />
</struts>
遇到问题时多排查日志发现问题