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

相关推荐
较真的菜鸟5 小时前
使用ASM和agent监控属性变化
java
黎雁·泠崖5 小时前
【魔法森林冒险】5/14 Allen类(三):任务进度与状态管理
java·开发语言
qq_12498707536 小时前
基于SSM的动物保护系统的设计与实现(源码+论文+部署+安装)
java·数据库·spring boot·毕业设计·ssm·计算机毕业设计
Coder_Boy_6 小时前
基于SpringAI的在线考试系统-考试系统开发流程案例
java·数据库·人工智能·spring boot·后端
Mr_sun.6 小时前
Day06——权限认证-项目集成
java
瑶山6 小时前
Spring Cloud微服务搭建四、集成RocketMQ消息队列
java·spring cloud·微服务·rocketmq·dashboard
abluckyboy6 小时前
Java 实现求 n 的 n^n 次方的最后一位数字
java·python·算法
2301_818732066 小时前
前端调用控制层接口,进不去,报错415,类型不匹配
java·spring boot·spring·tomcat·intellij-idea
2501_941982056 小时前
深度对比:Java、Go、Python 实现企微外部群推送,哪个效率更高?
java·golang·企业微信
马猴烧酒.7 小时前
【面试八股|JAVA多线程】JAVA多线程常考面试题详解
java·服务器·数据库