在现代Java Web开发中，将强大的依赖管理工具Maven与经典的MVC框架Struts2相结合，是一种高效且规范的项目构建方式，Maven能够自动化处理项目构建、报告和文档，同时统一管理项目所需的第三方库（JAR包），极大地简化了开发环境的配置和团队协作，本文将详细介绍如何通过Maven来配置一个标准的Struts2项目，从项目创建到成功运行,涵盖所有关键步骤。
创建基于Maven的Web项目
我们需要创建一个Maven管理的Web应用程序骨架，这通常通过使用Maven的archetype（项目模板）来完成，打开命令行工具,执行以下命令：
mvn archetype:generate -DgroupId=com.example -DartifactId=struts2-demo -DarchetypeArtifactId=maven-archetype-webapp -DinteractiveMode=false
这条命令会创建一个名为struts2-demo的目录，其内部包含了标准的Maven Web项目结构，包括src/main/java、src/main/resources、src/main/webapp等目录，以及核心的pom.xml配置文件。
配置pom.xml文件
pom.xml是Maven项目的核心，用于定义项目的基本信息、依赖、插件等,配置Struts2主要就是在这里添加相关的依赖项。
添加Struts2核心依赖
打开项目根目录下的pom.xml文件，在<dependencies>节点内添加Struts2的核心依赖，建议使用一个较新的稳定版本，例如2.5.x系列。
<dependency>
<groupId>org.apache.struts</groupId>
<artifactId>struts2-core</artifactId>
<version>2.5.30</version>
</dependency>
添加其他必要依赖
Struts2的正常运行还需要其他一些库的支持，为了确保项目完整且稳定,建议一并添加以下依赖。
| 依赖 | 用途 | scope说明 |
|---|---|---|
javax.servlet-api |
Servlet API，用于编译时检查，运行时由Tomcat等容器提供 | provided |
org.apache.logging.log4j |
日志框架，Struts2 2.5+默认集成Log4j2 | compile |
org.apache.logging.log4j.core |
Log4j2核心实现 | compile |
以下是这些依赖在pom.xml中的配置示例：
<!-- Servlet API (由服务器提供) -->
<dependency>
<groupId>javax.servlet</groupId>
<artifactId>javax.servlet-api</artifactId>
<version>4.0.1</version>
<scope>provided</scope>
</dependency>
<!-- Log4j2 日志依赖 -->
<dependency>
<groupId>org.apache.logging.log4j</groupId>
<artifactId>log4j-api</artifactId>
<version>2.17.2</version>
</dependency>
<dependency>
<groupId>org.apache.logging.log4j</groupId>
<artifactId>log4j-core</artifactId>
<version>2.17.2</version>
</dependency>
配置完成后，Maven会自动从中央仓库下载这些JAR包到本地仓库,并将其添加到项目的类路径中。
配置web.xml
web.xml是Web应用的部署描述文件，所有进入Web应用的HTTP请求都会经过它，要让Struts2框架生效,必须在此文件中配置Struts2的核心过滤器。
在src/main/webapp/WEB-INF/web.xml中添加如下配置：
<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd"
version="4.0">
<display-name>Struts2 Demo Application</display-name>
<!-- Struts2 核心过滤器配置 -->
<filter>
<filter-name>struts2</filter-name>
<filter-class>org.apache.struts2.dispatcher.filter.StrutsPrepareAndExecuteFilter</filter-class>
</filter>
<filter-mapping>
<filter-name>struts2</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
<welcome-file-list>
<welcome-file>index.jsp</welcome-file>
</welcome-file-list>
</web-app>
这里，StrutsPrepareAndExecuteFilter是Struts2的入口，它负责拦截所有请求（），并根据struts.xml的配置将请求分发给相应的Action处理。
创建struts.xml配置文件
struts.xml是Struts2框架的核心配置文件，用于定义Action、结果页面、拦截器等，该文件通常放置在src/main/resources目录下，这样Maven在打包时会自动将其复制到WEB-INF/classes目录下。
在src/main/resources目录下创建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" />
<package name="default" extends="struts-default" namespace="/">
<!-- 定义一个名为hello的Action -->
<action name="hello" class="com.example.action.HelloWorldAction">
<!-- 配置Action执行成功后跳转的页面 -->
<result name="success">/hello.jsp</result>
</action>
</package>
</struts>
这个配置定义了一个名为hello的Action，它由com.example.action.HelloWorldAction类处理，当处理成功（返回”success”字符串）时，请求会被转发到/hello.jsp页面。
创建Action和JSP页面
根据struts.xml的配置,我们需要创建对应的Action类和JSP页面。
在src/main/java目录下创建包com.example.action，并在其中创建HelloWorldAction.java：
package com.example.action;
public class HelloWorldAction {
private String message;
public String execute() {
message = "Hello, Struts2 with Maven!";
return "success"; // 返回的逻辑视图名，与struts.xml中的<result>匹配
}
public String getMessage() {
return message;
}
}
在src/main/webapp目录下创建hello.jsp：
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>Hello Struts2</title>
</head>
<body>
<h1>${message}</h1>
</body>
</html>
运行与测试
至此，一个基础的Maven管理的Struts2项目已经配置完成，你可以将项目部署到Tomcat等Servlet容器中运行，启动服务器后，在浏览器中访问 http://localhost:8080/struts2-demo/hello.action，如果一切正常，页面将显示 “Hello, Struts2 with Maven!”。
通过以上步骤，我们成功地利用Maven构建了一个结构清晰、依赖管理规范的Struts2应用程序，这种方式不仅简化了初始配置,也为项目的后续维护和扩展奠定了坚实的基础。
相关问答FAQs
Q1: 在Maven项目中，为什么有时会出现ClassNotFoundException或NoClassDefFoundError，即使我已在pom.xml中添加了依赖？
A1: 这个问题通常由以下几个原因造成：
- 依赖范围错误：检查
pom.xml中依赖的<scope>设置。javax.servlet-api应设置为provided，因为它由Web容器（如Tomcat）提供，如果错误地设置为compile或runtime,可能会导致容器自带的类库与项目中的产生冲突。 - 依赖未正确传递：某些依赖需要其他依赖才能工作，虽然Maven会处理传递性依赖，但有时某些可选依赖不会被自动引入，你可以使用
mvn dependency:tree命令分析项目的依赖树,查看是否存在缺失的依赖。 - 项目未重新编译/打包：在修改
pom.xml后，需要确保项目被重新构建，在IDE中，执行Rebuild或Reload Maven Projects操作，或者使用mvn clean install命令重新打包项目,确保所有依赖都被包含在最终的WAR文件中。
Q2: 如何利用Maven为不同的环境（如开发、测试、生产）配置不同的Struts2参数（例如struts.devMode）？
A2: 这可以通过Maven的Profile功能结合资源过滤来实现。
- 定义Profile：在
pom.xml中定义多个Profile，每个Profile对应一个环境，并为每个环境设置不同的属性值。<profiles> <profile> <id>dev</id> <properties> <struts.devMode>true</struts.devMode> </properties> <activation> <activeByDefault>true</activeByDefault> </activation> </profile> <profile> <id>prod</id> <properties> <struts.devMode>false</struts.devMode> </properties> </profile> </profiles> - 启用资源过滤：在
<build>节点中配置资源过滤，告诉Maven在处理资源文件时替换其中的占位符。<build> <resources> <resource> <directory>src/main/resources</directory> <filtering>true</filtering> </resource> </resources> ... </build> - 修改
struts.xml：将struts.xml中的硬编码值替换为Maven属性占位符。<constant name="struts.devMode" value="${struts.devMode}" /> - 构建时指定Profile：在执行Maven命令时，使用
-P参数激活指定的Profile，为生产环境打包时，使用命令mvn clean package -Pprod，Maven会使用prodProfile中定义的struts.devMode值（false）来替换struts.xml中的占位符。
图片来源于AI模型，如侵权请联系管理员。作者：酷小编，如若转载，请注明出处：https://www.kufanyun.com/ask/29833.html
