在现代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
等目录,以及核心的配置文件。
配置文件
是Maven项目的核心,用于定义项目的基本信息、依赖、插件等,配置Struts2主要就是在这里添加相关的依赖项。
添加Struts2核心依赖
打开项目根目录下的文件,在节点内添加Struts2的核心依赖,建议使用一个较新的稳定版本,例如2.5.x系列。
org.apache.struts struts2-core 2.5.30
添加其他必要依赖
Struts2的正常运行还需要其他一些库的支持,为了确保项目完整且稳定,建议一并添加以下依赖。
| 依赖 | 用途 | 说明 |
|---|---|---|
javax.servlet-api
|
Servlet API,用于编译时检查,运行时由Tomcat等容器提供 | |
org.apache.logging.log4j
|
日志框架,Struts2 2.5+默认集成Log4j2 | |
org.apache.logging.log4j.core
|
Log4j2核心实现 |
以下是这些依赖在中的配置示例:
javax.servlet javax.servlet-api 4.0.1 provided org.apache.logging.log4j log4j-api 2.17.2 org.apache.logging.log4j log4j-core 2.17.2
配置完成后,Maven会自动从中央仓库下载这些JAR包到本地仓库,并将其添加到项目的类路径中。
配置
是Web应用的部署描述文件,所有进入Web应用的HTTP请求都会经过它,要让Struts2框架生效,必须在此文件中配置Struts2的核心过滤器。
在
src/main/webapp/WEB-INF/web.xml
中添加如下配置:
Struts2 Demo Application struts2 org.apache.struts2.dispatcher.filter.StrutsPrepareAndexecuteFilter struts2 /* index.jsp
这里,
StrutsPrepareAndExecuteFilter
是Struts2的入口,它负责拦截所有请求(),并根据
struts.xml
的配置将请求分发给相应的Action处理。
创建
struts.xml
配置文件
struts.xml
是Struts2框架的核心配置文件,用于定义Action、结果页面、拦截器等,该文件通常放置在
src/main/resources
目录下,这样Maven在打包时会自动将其复制到
WEB-INF/classes
目录下。
在
src/main/resources
目录下创建
struts.xml
文件,并添加一个简单的配置:
/hello.jsp
这个配置定义了一个名为的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中的匹配}public String getMessage() {return message;}}
在
src/main/webapp
目录下创建:
<%@ page contentType="text/html;charset=UTF-8" language="java" %>Hello Struts2${message}
运行与测试
至此,一个基础的Maven管理的Struts2项目已经配置完成,你可以将项目部署到Tomcat等Servlet容器中运行,启动服务器后,在浏览器中访问
,如果一切正常,页面将显示 “Hello, Struts2 with Maven!”。
通过以上步骤,我们成功地利用Maven构建了一个结构清晰、依赖管理规范的Struts2应用程序,这种方式不仅简化了初始配置,也为项目的后续维护和扩展奠定了坚实的基础。
相关问答FAQs
Q1: 在Maven项目中,为什么有时会出现
ClassNotFoundException
或
NoClassDefFoundError
,即使我已在中添加了依赖?
这个问题通常由以下几个原因造成:
Q2: 如何利用Maven为不同的环境(如开发、测试、生产)配置不同的Struts2参数(例如
struts.devMode
)?
这可以通过Maven的Profile功能结合资源过滤来实现。














发表评论