使用命令行创建一个简单的 Maven Web 应用程序

本教程将指导您通过命令行创建一个简单的 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 示例：

<project xmlns="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 的文件，内容如下：

<!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>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 开发者的宝贵工具。