Maven环境下如何从零开始配置Struts2项目？

Maven项目创建与依赖配置

配置的第一步是创建一个基于Maven的Web应用程序骨架,并在其核心配置文件pom.xml中声明Struts2所需的依赖。

可以通过IDE（如IntelliJ IDEA或Eclipse）或使用Maven命令行工具创建一个新的Webapp项目，使用命令行：
mvn archetype:generate -DgroupId=com.example -DartifactId=struts2-demo -DarchetypeArtifactId=maven-archetype-webapp -DinteractiveMode=false

项目创建后,关键在于编辑项目根目录下的pom.xml文件，我们需要在此文件中添加Struts2的核心依赖，为了确保项目纯净且避免版本冲突，建议明确指定所需依赖的版本。

以下是pom.xml中<dependencies>节点的一个示例配置：

<dependencies>
    <!-- Java Servlet API, 由服务器提供，因此scope设置为provided -->
    <dependency>
        <groupId>javax.servlet</groupId>
        <artifactId>javax.servlet-api</artifactId>
        <version>4.0.1</version>
        <scope>provided</scope>
    </dependency>
    <!-- Struts2 核心库 -->
    <dependency>
        <groupId>org.apache.struts</groupId>
        <artifactId>struts2-core</artifactId>
        <version>2.5.30</version>
    </dependency>
</dependencies>

为了更清晰地理解这些依赖,下表列出了关键组件及其作用：

完成依赖配置后,Maven会自动从中央仓库下载这些JAR包到本地仓库，并将它们添加到项目的类路径中。

Web.xml配置

web.xml是任何Java Web应用程序的入口点，它负责配置Servlet、过滤器等组件，要让Struts2框架接管所有Web请求，必须在web.xml中配置Struts2的核心过滤器——StrutsPrepareAndExecuteFilter。

此过滤器负责初始化Struts2框架的核心分发器,并拦截所有符合特定URL模式的请求，将其交由Struts2框架处理，配置如下所示，文件位于src/main/webapp/WEB-INF/web.xml：

<!DOCTYPE web-app PUBLIC
 "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
 "http://java.sun.com/dtd/web-app_2_3.dtd" >
<web-app>
  <display-name>Struts2 Maven Demo</display-name>
  <!-- Struts2 核心过滤器配置 -->
  <filter>
    <filter-name>struts2</filter-name>
    <filter-class>org.apache.struts2.dispatcher.filter.StrutsPrepareAndExecuteFilter</filter-class>
  </filter>
  <!-- 过滤器映射，拦截所有URL请求 -->
  <filter-mapping>
    <filter-name>struts2</filter-name>
    <url-pattern>/*</url-pattern>
  </filter-mapping>
</web-app>

<url-pattern>/*</url-pattern>表示该过滤器会拦截所有进入该Web应用的请求，这是Struts2应用的标准配置。

Struts2核心配置

Struts2框架自身的配置主要通过struts.xml文件完成，该文件定义了Action（业务逻辑控制器）与URL请求之间的映射关系，以及Action执行后应跳转到的视图资源（如JSP页面）。

struts.xml文件通常放置在项目的src/main/resources目录下，这样在编译后它会被自动复制到WEB-INF/classes目录中，确保框架能够正确加载。

一个基础的struts.xml配置示例如下：

<?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.devMode" value="true" />
    <!-- 定义一个包，用于组织Action -->
    <package name="default" namespace="/" extends="struts-default">
        <!-- 定义一个名为 "hello" 的 Action -->
        <action name="hello" class="com.example.action.HelloWorldAction">
            <!-- 定义当Action返回 "success" 时，要跳转到的页面 -->
            <result name="success">/hello.jsp</result>
        </action>
    </package>
</struts>

在这个配置中：

• <constant>标签用于设置框架的全局常量，struts.devMode=true在开发阶段非常有用。
• <package>用于将相关的Action、拦截器等组织在一起。extends="struts-default"意味着该包继承了Struts2的默认配置栈。
• <action>标签是核心，它将一个URL（/hello.action）映射到一个Java类（com.example.action.HelloWorldAction）。
• <result>标签定义了Action执行后根据返回值（如"success"）进行页面跳转的目标。

相关问答FAQs

问题1：我已经按照步骤配置了所有文件，但访问/hello.action时总是出现404错误，可能是什么原因？
解答： 404错误通常意味着服务器找不到对应的资源，请按以下顺序排查：

1. 检查web.xml： 确认StrutsPrepareAndExecuteFilter的<filter-mapping>中的<url-pattern>是否正确设置为，并且没有其他过滤器错误地拦截了请求。
2. 检查struts.xml： 确认文件位于src/main/resources目录下，检查<action>标签的name属性是否与URL中的名称匹配（URL是hello.action，则name应为hello），同时检查namespace是否与URL路径匹配。
3. 检查Action类： 确认class属性指定的Action类（如com.example.action.HelloWorldAction）是否存在，并且实现了正确的逻辑（通常需要有一个返回String的execute()方法）。
4. 检查部署： 确认项目已成功构建（mvn clean package）并部署到Web服务器上，且服务器已成功启动，检查服务器的控制台日志，看是否有Struts2启动错误或Action类加载失败的异常信息。

问题2：在pom.xml中添加了依赖，但IDE提示ClassNotFoundException，如何解决？
解答： 这个问题通常与IDE和Maven的同步有关，请尝试以下解决方案：

1. 刷新/重新导入Maven项目： 在你的IDE中，找到Maven工具窗口，右键点击项目，选择“Reload project”或“Reimport”选项，这会强制IDE重新读取pom.xml并下载依赖。
2. 清理并重新构建： 在项目根目录下运行Maven命令 mvn clean install，这个命令会清理之前的构建输出，重新编译代码、运行测试并打包到本地仓库，确保所有依赖都正确解析。
3. 检查本地Maven仓库： 确认你的本地Maven仓库（通常在用户目录下的.m2/repository）中是否存在对应的JAR包，如果不存在，可能是网络问题导致下载失败，可以尝试配置Maven镜像源。
4. 检查IDE设置： 确保你的IDE已正确配置了Maven的路径（settings.xml文件的位置），并且项目使用的JDK版本与依赖要求一致。