使用命令行创建一个简单的 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 开发者的宝贵工具。

相关推荐
用户611881615196231 分钟前
Java基础面试题
java
DavidSoCool1 小时前
Elasticsearch Java API Client [8.17] 使用
java·大数据·elasticsearch
无世世1 小时前
【Java从入门到起飞】面向对象编程(高级)
java·开发语言
Vic101011 小时前
Mac如何查看 IDEA 的日志文件
java·macos·intellij-idea
陈逸轩*^_^*1 小时前
idea打不开,idea打不开,Error occurred during initialization of VM
java·ide·intellij-idea
=PNZ=BeijingL1 小时前
使用Mockito实现单元测试
java
eggcode1 小时前
IDEA与Maven使用-学习记录(持续补充...)
学习·maven·intellij-idea
yuren_xia1 小时前
在 IntelliJ IDEA(2024) 中创建 JAR 包步骤
java·intellij-idea·jar