本指南将引导您通过命令行创建一个简单的 Maven 项目。本教程假设您已经在您的机器上安装了 Maven 和 JDK 21。
第一步:验证 Maven 和 Java 安装
在开始之前,我们需要验证 Maven 和 Java 是否已正确安装在您的系统上。
验证 Maven 安装
打开命令行终端并输入以下命令:
mvn -v
您应该看到类似以下的输出:
Apache Maven 3.8.5 (b89d5959fcde851dcb1c8946e2987cb6db844df6)
Maven home: /usr/local/apache-maven-3.8.5
Java version: 21, vendor: Oracle Corporation
Java home: /usr/lib/jvm/java-21
验证 Java 安装
输入以下命令检查您的 Java 版本:
java -version
您应该看到类似以下的输出:
java version "21" 2023-09-21 LTS
Java(TM) SE Runtime Environment (build 21+36-LTS-1491)
Java HotSpot(TM) 64-Bit Server VM (build 21+36-LTS-1491, mixed mode, sharing)
第二步:创建简单的 Maven 项目
我们将使用 Maven 的 archetype:generate
目标来创建一个简单的项目。此目标基于预定义的原型生成项目结构。
在终端中运行以下命令:
mvn archetype:generate -DgroupId=com.companyname.projectname -DartifactId=simple-maven-project -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false
此命令创建一个新 Maven 项目,参数如下:
groupId
: 项目的组标识符,通常遵循反向域名约定。artifactId
: 项目的名称。archetypeArtifactId
: 指定要使用的原型。maven-archetype-quickstart
是一个适合初学者的简单原型。interactiveMode
: 如果设置为false
,则以批处理模式运行,不会提示用户输入。
执行命令后,您应该看到类似以下的输出:
[INFO] Scanning for projects...
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 12.345 s
[INFO] Finished at: 2024-11-21T14:50:30+05:30
[INFO] ------------------------------------------------------------------------
第三步:导航到项目目录
切换到新创建的项目目录:
cd simple-maven-project
第四步:理解项目结构
生成的项目结构如下:
simple-maven-project
│ pom.xml
└───src├───main│ └───java│ └───com│ └───companyname│ └───projectname│ └───App.java└───test└───java└───com└───companyname└───projectname└───AppTest.java
关键文件和目录
pom.xml
: 项目对象模型文件,用于定义项目配置和依赖项。src/main/java
: 包含应用程序的源代码。src/test/java
: 包含应用程序的测试代码。
第五步:更新 pom.xml
文件
打开 pom.xml
文件并更新以下内容,以确保我们使用最新版本的 Java 和 JUnit:
<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.companyname.projectname</groupId><artifactId>simple-maven-project</artifactId><version>1.0-SNAPSHOT</version><properties><maven.compiler.source>21</maven.compiler.source><maven.compiler.target>21</maven.compiler.target></properties><dependencies><dependency><groupId>org.junit.jupiter</groupId><artifactId>junit-jupiter-api</artifactId><version>5.9.3</version><scope>test</scope></dependency><dependency><groupId>org.junit.jupiter</groupId><artifactId>junit-jupiter-engine</artifactId><version>5.9.3</version><scope>test</scope></dependency></dependencies><build><plugins><plugin><groupId>org.apache.maven.plugins</groupId><artifactId>maven-compiler-plugin</artifactId><version>3.10.1</version><configuration><source>21</source><target>21</target></configuration></plugin></plugins></build>
</project>
第六步:构建项目
运行以下命令来构建项目:
mvn clean install
此命令将编译项目并运行任何测试。输出应指示构建成功:
[INFO] -------------------------------------------------------
[INFO] T E S T S
[INFO] -------------------------------------------------------
[INFO] Running com.companyname.projectname.AppTest
[INFO] Tests run: 1, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0.001 sec
[INFO]
[INFO] Results:
[INFO]
[INFO] Tests run: 1, Failures: 0, Errors: 0, Skipped: 0
[INFO]
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 2.345 s
[INFO] Finished at: 2024-11-21T14:52:30+05:30
[INFO] ------------------------------------------------------------------------
第七步:运行应用程序
“Hello World!” 消息来自 Maven 原型创建的 App.java
文件。打开 src/main/java/com/companyname/projectname/App.java
文件,您将看到以下代码:
package com.companyname.projectname;/*** Hello world!**/
public class App
{public static void main( String[] args ){System.out.println( "Hello World!" );}
}
打包并运行 JAR 文件
首先使用 Maven 将应用程序打包成 JAR 文件:
mvn package
此命令将在 target
目录中创建一个 JAR 文件。
导航到 target
目录并使用以下命令运行 JAR 文件:
java -jar target/simple-maven-project-1.0-SNAPSHOT.jar
您应该看到以下输出:
Hello World!
结论
在本教程中,我们通过命令行创建了一个简单的 Maven 项目。我们使用了 Maven 的 archetype:generate
目标生成项目结构,更新了 pom.xml
以使用最新版本的 Java 和 JUnit,构建了项目,并运行了打包后的 JAR 文件。Maven 简化了项目管理和依赖管理,是 Java 开发者的重要工具。