Skip to content

基本项目操作

4.1 创建 Maven 项目

Maven 提供了多种方式来创建项目,最常用的是使用 archetype 插件。

使用 Maven 命令创建项目

bash
# 使用 Maven 命令创建一个简单的 Java 项目
mvn archetype:generate -DgroupId=com.example -DartifactId=my-project -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false

# 使用 Maven 命令创建一个 Web 项目
mvn archetype:generate -DgroupId=com.example -DarchetypeArtifactId=maven-archetype-webapp -DartifactId=my-webapp -DinteractiveMode=false

使用 IDE 创建项目

大多数 IDE(如 IntelliJ IDEA、Eclipse、NetBeans)都提供了图形化界面来创建 Maven 项目:

  1. IntelliJ IDEA:文件 → 新建 → 项目 → Maven
  2. Eclipse:文件 → 新建 → Maven 项目
  3. NetBeans:文件 → 新建项目 → Maven → Java 应用

4.2 项目结构解析

Maven 定义了一套标准的项目目录结构,如下所示:

my-project/
├── pom.xml              # Maven 项目配置文件
├── src/
│   ├── main/
│   │   ├── java/        # 主源代码目录
│   │   ├── resources/   # 主资源文件目录
│   │   └── webapp/      # Web 项目的 Web 资源目录(仅 Web 项目)
│   └── test/
│       ├── java/        # 测试源代码目录
│       └── resources/   # 测试资源文件目录
└── target/              # 构建输出目录

主要目录说明

  • pom.xml:Maven 项目的核心配置文件,定义了项目的基本信息、依赖关系和构建配置。
  • src/main/java:存放项目的主要源代码。
  • src/main/resources:存放项目的主要资源文件,如配置文件、国际化资源等。
  • src/main/webapp:存放 Web 项目的 Web 资源,如 HTML、CSS、JavaScript 文件等。
  • src/test/java:存放项目的测试源代码。
  • src/test/resources:存放项目的测试资源文件。
  • target:存放构建过程中生成的文件,如编译后的 class 文件、打包后的 JAR/WAR 文件等。

4.3 POM 文件基本配置

POM 文件是 Maven 项目的核心配置文件,包含了项目的基本信息、依赖关系和构建配置。

基本配置示例

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-project</artifactId>
  <version>1.0.0</version>
  <packaging>jar</packaging>
  
  <name>My Project</name>
  <description>A sample Maven project</description>
  
  <!-- 依赖管理 -->
  <dependencies>
    <dependency>
      <groupId>junit</groupId>
      <artifactId>junit</artifactId>
      <version>4.13.2</version>
      <scope>test</scope>
    </dependency>
  </dependencies>
  
  <!-- 构建配置 -->
  <build>
    <plugins>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-compiler-plugin</artifactId>
        <version>3.8.1</version>
        <configuration>
          <source>11</source>
          <target>11</target>
        </configuration>
      </plugin>
    </plugins>
  </build>
</project>

主要配置项说明

  • modelVersion:POM 模型版本,固定为 4.0.0。
  • groupId:组织或公司的标识符。
  • artifactId:项目的标识符。
  • version:项目的版本号。
  • packaging:项目的打包方式,如 jar、war、pom 等。
  • name:项目的名称。
  • description:项目的描述。
  • dependencies:项目的依赖列表。
  • build:项目的构建配置。

4.4 常用构建命令

Maven 提供了一系列构建命令,用于执行不同的构建任务。

4.4.1 mvn clean

清理项目,删除 target 目录及其内容。

bash
mvn clean

4.4.2 mvn compile

编译项目的源代码。

bash
mvn compile

4.4.3 mvn test

运行项目的测试。

bash
mvn test

4.4.4 mvn package

打包项目,生成 JAR、WAR 等文件。

bash
mvn package

4.4.5 mvn install

将项目打包并安装到本地仓库。

bash
mvn install

4.4.6 mvn deploy

将项目打包并部署到远程仓库。

bash
mvn deploy

组合命令

可以将多个命令组合使用,例如:

bash
# 清理并编译
mvn clean compile

# 清理并打包
mvn clean package

# 清理并安装
mvn clean install

命令选项

Maven 命令支持多种选项,例如:

bash
# 跳过测试
mvn package -DskipTests

# 强制更新依赖
mvn package -U

# 指定构建配置文件
mvn package -P production

通过这些基本操作,您可以开始使用 Maven 来管理和构建项目。