struts2.3升级到 struts2.5.13

log4j 1 升级到 log4j 2

1、删除掉 log4j 1的配置文件。如 classpath 下面的 log4j.xml 或者 log4j.properties。
2、新增 log4j2.xml 文件在 classpath 下。以下是最基本的配置。

我的生产配置

3、maven 配置


    org.apache.logging.log4j
    log4j-core
    2.8.2


    org.apache.logging.log4j
    log4j-slf4j-impl
    2.8.2


    org.apache.logging.log4j
    log4j-web
    2.8.2

去除xerces依赖

1、移除对 xerces 的依赖包括 xerces、xercesImpl、mlParserAPIs（重点）
2、 maven 移除以下配置（检查 lib 中是否已经移除掉了）


    org.apache
    xerces
    2.5.0


    xerces
    xercesImpl
    2.10.0

maven 工程，需要分析依赖（使用命令 mvn dependency:tree ）是否存在传递的依赖的xerces
阻止依赖传送门
注意：如果依赖的 jar 文件中还存在以上的 jar 会出现一个错误是说注解无法注入。据说是 JDK 默认携带了此类的实现。

小插曲：出现下面的问题的时候，真心奔溃。这个提示明显是说annotation转换出现异常。看了2.5.13的源码。org.apache.struts2.convention.annotation.Result.name()这个是一个数组，而在2.3里面确实一个string，各种排查。无果。重新build了工程，也就是去掉了xerces这些依赖

java.lang.annotation.AnnotationTypeMismatchException: Incorrectly typed data found for annotation element public abstract java.lang.String[] org.apache.struts2.convention.annotation.Result.name() (Found data of type class java.lang.String[view])

Struts2 配置文件修改

struts2 的配置文件修改 dtd 头部引用

web.xml修改


    struts2
    
        org.apache.struts2.dispatcher.filter.StrutsPrepareAndExecuteFilter

遗留问题

如果系统中使用 struts struts.convention.action.includeJars来导入包的话（配置如下）。会在tomcat6和7偶然出现在 classpath 找不到指定的 jar 文件。但是在最新版的 tomcat 8.5.23 是可以的。但是最奇怪的是 build 多几次就可以了 _{_}

后面要研究一下这个扫包的逻辑

更新20171126

经过发现 struts.convention.action.includeJars 的 jar 文件没有META-INF文件夹。正确的jar 文件目录是

*.jar
|--META-INF
|--com
    |--youpackage

而在 lib 下面的却没有 META-INF。
使用命令mvn clean install 打包的时候看了输出的目录的 jar 所有东西都有。然后在本地的 repositories 里面的 jar 也没有问题。

image

后来发现原来是这个锅是 IDEA 的。系统分为4个工程。依赖如下

d工程（web）
|--src
|--WebRoot
    |--WEB-INF
        |--lib
            |--a工程.jar
            |--b工程.jar
            |--c工程.jar
        |--classes

如果在 IDEA 中导入 d工程。然后再导入其他三个工程。启动 tomcat 的时候 IDEA 会自动编译一下其他的三个工程。把其他三个工程的 jar 文件打包到 lib 下面。打包的时候就出现没有 jar 文件 META-INF这个目录。最奇怪的第二次启动就可以了_{_}。

备注

实验过 jar 文件中必须有META-INF这层目录（里面可以没有描述文件）。没有的话跳过此包不扫描。（猜想：估计在 tomcat6、7 扫描的时候没有此目录的话可能会被认为是普通的压缩文件。不需要装载到系统中去。tomcat8是支持没有META-INF的） 。有兴趣的可以去官网看卡传送门。另外发现IBM 一篇干货 link

文章出自 http://blog.wordty.cn