本教程将指导您通过命令行创建一个简单的 Maven Web 应用程序。
我们将使用最新版本的 Java 和依赖项。
本指南将带您完成项目设置、添加必要依赖项、配置 Web 应用程序并运行它的整个过程。
先决条件
- 已安装 JDK 21
- 已安装 Maven
- 一个 Web 浏览器
第一步:生成 Maven 项目
首先,打开命令行终端并运行以下命令来生成一个 Maven 项目:
mvn archetype:generate -DgroupId=com.example -DartifactId=my-webapp -DarchetypeArtifactId=maven-archetype-webapp -DinteractiveMode=false
此命令将创建一个具有基本目录结构的 Maven 项目,适用于 Web 应用程序。
第二步:导航到项目目录
切换到新创建的项目目录:
cd my-webapp
第三步:更新
pom.xml
文件
打开
pom.xml
文件并更新以包含最新版本的依赖项和插件。以下是一个更新后的
pom.xml
示例:
<projectxmlns="http://maven.apache.org/POM/4.0.0"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"><modelVersion>4.0.0</modelVersion><groupId>com.example</groupId><artifactId>my-webapp</artifactId><version>1.0-SNAPSHOT</version><packaging>war</packaging><name>My Web Application</name><description>A simple Maven web application</description><properties><maven.compiler.source>21</maven.compiler.source><maven.compiler.target>21</maven.compiler.target><project.build.sourceEncoding>UTF-8</project.build.sourceEncoding></properties><dependencies><dependency><groupId>jakarta.servlet</groupId><artifactId>jakarta.servlet-api</artifactId><version>6.0.0</version><scope>provided</scope></dependency><dependency><groupId>jakarta.jsp</groupId><artifactId>jakarta.jsp-api</artifactId><version>3.1.0</version><scope>provided</scope></dependency><dependency><groupId>org.glassfish.web</groupId><artifactId>jakarta.servlet.jsp.jstl</artifactId><version>3.0.0</version></dependency></dependencies><build><plugins><plugin><groupId>org.apache.maven.plugins</groupId><artifactId>maven-war-plugin</artifactId><version>3.3.2</version><configuration><failOnMissingWebXml>false</failOnMissingWebXml></configuration></plugin><plugin><groupId>org.apache.tomcat.maven</groupId><artifactId>tomcat7-maven-plugin</artifactId><version>2.2</version><configuration><url>http://localhost:8080/manager/text</url><server>TomcatServer</server><path>/my-webapp</path></configuration></plugin></plugins></build></project>
第四步:创建 Web 应用程序目录结构
确保目录结构如下所示:
my-webapp
│ pom.xml
└───src
└───main
└───java
└───resources
└───webapp
│ WEB-INF
│ index.jsp
src/main/java
: 放置您的 Java 源文件。src/main/resources
: 放置您的资源文件。src/main/webapp
: 放置您的 Web 内容(例如,HTML、JSP 文件)。src/main/webapp/WEB-INF
: 放置您的web.xml
文件和其他配置文件。
第五步:创建简单的 JSP 页面
在
src/main/webapp
目录中创建一个名为
index.jsp
的文件,内容如下:
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
<title>My Web Application</title>
</head>
<body>
<h2>Hello, World!</h2>
</body>
</html>
第六步:创建
web.xml
文件
在
src/main/webapp/WEB-INF
目录中创建一个名为
web.xml
的文件,内容如下:
<!DOCTYPEweb-appPUBLIC"-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN""http://java.sun.com/dtd/web-app_2_3.dtd"><web-app><display-name>Archetype Created Web Application</display-name></web-app>
第七步:构建项目
运行以下命令来构建项目:
mvn clean package
此命令将在
target
目录中生成一个 WAR 文件。
第八步:运行应用程序
要运行 Web 应用程序,您可以使用嵌入式的 Tomcat 服务器。确保
pom.xml
中包含以下插件配置:
<build><plugins><plugin><groupId>org.apache.tomcat.maven</groupId><artifactId>tomcat7-maven-plugin</artifactId><version>2.2</version><configuration><path>/my-webapp</path></configuration></plugin></plugins></build>
现在,使用以下命令启动应用程序:
mvn tomcat7:run
第九步:访问应用程序
打开 Web 浏览器并导航到
http://localhost:8080/my-webapp
。
会看到来自
index.jsp
页面的 “Hello, World!” 消息。
总结
恭喜!您已经成功使用命令行创建了一个简单的 Maven Web 应用程序。
本指南涵盖了从生成项目到在嵌入式 Tomcat 服务器上运行它的所有关键步骤。
Maven 简化了依赖管理和 Java Web 应用程序的构建过程,是 Java 开发者的宝贵工具。
版权归原作者 疯一样的码农 所有, 如有侵权,请联系我们删除。