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

本教程将指导您通过命令行创建一个简单的 Maven Web 应用程序。

我们将使用最新版本的 Java 和依赖项。

本指南将带您完成项目设置、添加必要依赖项、配置 Web 应用程序并运行它的整个过程。

先决条件

  • 已安装 JDK 21
  • 已安装 Maven
  • 一个 Web 浏览器

第一步:生成 Maven 项目

首先,打开命令行终端并运行以下命令来生成一个 Maven 项目:

sh 复制代码
mvn archetype:generate -DgroupId=com.example -DartifactId=my-webapp -DarchetypeArtifactId=maven-archetype-webapp -DinteractiveMode=false

此命令将创建一个具有基本目录结构的 Maven 项目,适用于 Web 应用程序。

第二步:导航到项目目录

切换到新创建的项目目录:

sh 复制代码
cd my-webapp

第三步:更新 pom.xml 文件

打开 pom.xml 文件并更新以包含最新版本的依赖项和插件。以下是一个更新后的 pom.xml 示例:

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 的文件,内容如下:

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 的文件,内容如下:

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>

第七步:构建项目

运行以下命令来构建项目:

sh 复制代码
mvn clean package

此命令将在 target 目录中生成一个 WAR 文件。

第八步:运行应用程序

要运行 Web 应用程序,您可以使用嵌入式的 Tomcat 服务器。确保 pom.xml 中包含以下插件配置:

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>

现在,使用以下命令启动应用程序:

sh 复制代码
mvn tomcat7:run

第九步:访问应用程序

打开 Web 浏览器并导航到 http://localhost:8080/my-webapp

会看到来自 index.jsp 页面的 "Hello, World!" 消息。

总结

恭喜!您已经成功使用命令行创建了一个简单的 Maven Web 应用程序。

本指南涵盖了从生成项目到在嵌入式 Tomcat 服务器上运行它的所有关键步骤。

Maven 简化了依赖管理和 Java Web 应用程序的构建过程,是 Java 开发者的宝贵工具。

相关推荐
小突突突13 分钟前
浅谈Java中的反射
java·开发语言
Anastasiozzzz24 分钟前
LeetCode Hot100 295. 数据流的中位数 MedianFinder
java·服务器·前端
我真的是大笨蛋34 分钟前
Redo Log详解
java·数据库·sql·mysql·性能优化
索荣荣1 小时前
Java动态代理实战:从原理到精通
java·开发语言
兩尛1 小时前
c++的数组和Java数组的不同
java·开发语言·c++
roman_日积跬步-终至千里1 小时前
【Java并发】多线程/并发问题集
java·开发语言
それども1 小时前
什么是MalformedStreamException,和WebKitFormBoundary有什么关系
java
思想在飞肢体在追2 小时前
Springboot项目配置Nacos
java·spring boot·后端·nacos
cyforkk2 小时前
09、Java 基础硬核复习:异常处理(容错机制)的核心逻辑与面试考点
java·数据库·面试
??(lxy)2 小时前
java高性能无锁队列——MpscLinkedQueue
java·开发语言