使用 Maven 构建一个简单的 Java 项目

news2024/11/24 3:22:08

Apache Maven 是一个强大的构建自动化工具，主要用于 Java 项目。它简化了构建和管理任何基于 Java 的项目的流程。

本指南将涵盖 Maven 的安装、设置一个简单的 Java 项目以及使用 Maven 运行该项目。

1. 安装

安装 Java

在安装 Maven 之前，需要确保您的系统上已安装了 Java。请按照以下步骤操作：

下载 JDK：从官方 Oracle 网站或 OpenJDK 网站下载最新版本的 JDK（Java 开发工具包）。
安装 JDK：按照下载页面提供的安装说明进行操作。务必设置 JAVA_HOME 环境变量指向 JDK 安装目录。
验证安装：打开终端或命令提示符，输入以下命令以验证安装：
```
java -version
```
您应该能看到安装在系统上的 Java 版本信息。

安装 Maven

接下来，按照以下步骤安装 Maven：

下载 Maven：从官方 Apache Maven 网站下载最新版本的 Maven。
安装 Maven：解压下载的归档文件到您选择的目录。设置 M2_HOME 和 MAVEN_HOME 环境变量指向 Maven 安装目录，并将 bin 目录添加到您的 PATH 中。
验证安装：打开终端或命令提示符，输入以下命令以验证安装：
```
mvn -version
```
您应该能看到安装在系统上的 Maven 版本信息。

2. 创建一个简单的 Java 项目

现在让我们使用 Maven 设置一个简单的 Java 项目，我们将创建一个基本的“Hello World”应用程序。

步骤 1：创建项目目录

打开终端或命令提示符，创建一个新的项目目录：
```
mkdir my-maven-project
cd my-maven-project
```

步骤 2：生成 Maven 项目

使用 Maven Archetype 插件来生成新项目：
```
mvn archetype:generate -DgroupId=com.example -DartifactId=my-maven-project -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false
```
此命令会生成一个基本的 Maven 项目结构。重要的文件和目录包括：
- src/main/java：包含 Java 源代码文件。
- src/test/java：包含测试 Java 源代码文件。
- pom.xml：项目对象模型文件，其中包含项目配置。

步骤 3：添加“Hello World”代码

导航至 src/main/java/com/example 目录并打开 App.java 文件。用以下代码替换其内容：

package com.example;

public class App {
    public static void main(String[] args) {
        System.out.println("Hello World!");
    }
}

步骤 4：更新 `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-maven-project</artifactId>
    <version>1.0-SNAPSHOT</version>
    <packaging>jar</packaging>
    <name>my-maven-project</name>
    <url>http://maven.apache.org</url>
    <properties>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <maven.compiler.source>11</maven.compiler.source>
        <maven.compiler.target>11</maven.compiler.target>
    </properties>
    <dependencies>
        <dependency>
            <groupId>org.junit.jupiter</groupId>
            <artifactId>junit-jupiter</artifactId>
            <version>5.10.0</version>
            <scope>test</scope>
        </dependency>
    </dependencies>
    <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-jar-plugin</artifactId>
                <version>3.3.0</version>
                <configuration>
                    <archive>
                        <manifest>
                            <mainClass>com.example.App</mainClass>
                        </manifest>
                    </archive>
                </configuration>
            </plugin>
        </plugins>
    </build>
</project>