Maven 使用了一个标准的目录结构和一个默认的构建生命周期。

2022-12-20 10:23:46

约定优于配置

当创建 Maven 工程时，Maven 会创建默认的工程结构。开发者只需要合理的放置文件，而在 pom.xml 中不再需要定义任何配置。

Maven - POM

POM 代表工程对象模型。它是使用 Maven 工作时的基本组建，是一个 xml 文件。它被放在工程根目录下，文件命名为 pom.xml。

它被放在工程根目录下

能够在 POM 中设置的一些配置如下：

project dependencies
plugins
goals
build profiles
project version
developers
mailing list

在创建 POM 之前，我们首先确定工程组（groupId），及其名称（artifactId）和版本，在仓库中这些属性是工程的唯一标识。

POM 举例

<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.project-group</groupId>

   <artifactId>project</artifactId>

   <version>1.0</version>

</project>

能够在 POM 中设置的一些配置如下：

project dependencies
plugins
goals
build profiles
project version
developers
mailing list

在创建 POM 之前，我们首先确定工程组（groupId），及其名称（artifactId）和版本，在仓库中这些属性是工程的唯一标识。

POM 举例

<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.project-group</groupId>

   <artifactId>project</artifactId>

   <version>1.0</version>

</project>

需要说明的是每个工程应该只有一个 POM 文件。

所有的 POM 文件需要 project 元素和三个必须的字段：groupId, artifactId,version。
在仓库中的工程标识为 groupId:artifactId:version
POM.xml 的根元素是 project，它有三个主要的子节点：

节点	描述
groupId	这是工程组的标识。它在一个组织或者项目中通常是唯一的。例如，一个银行组织 com.company.bank 拥有所有的和银行相关的项目。
artifactId	这是工程的标识。它通常是工程的名称。例如，消费者银行。groupId 和 artifactId 一起定义了 artifact 在仓库中的位置。
version	这是工程的版本号。在 artifact 的仓库中，它用来区分不同的版本。例如： com.company.bank:consumer-banking:1.0 com.company.bank:consumer-banking:1.1.

Super POM

所有的 POM 都继承自一个父 POM（无论是否显式定义了这个父 POM）。父 POM 也被称作 Super POM，它包含了一些可以被继承的默认设置。

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/

/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 h

ttp://maven.apache.org/xsd/maven-4.0.0.xsd">

  <modelVersion>4.0.</modelVersion>

  <groupId>com.companyname.project-group</groupId>

  <artifactId>project</artifactId>

  <version>1.0</version>

  <build>

    <sourceDirectory>C:\MVN\project\src\main\java</sourceDirectory>

    <scriptSourceDirectory>src/main/scripts</scriptSourceDirectory>

    <testSourceDirectory>C:\MVN\project\src\test\java</testSourceDirectory>

    <outputDirectory>C:\MVN\project\target\classes</outputDirectory>

    <testOutputDirectory>C:\MVN\project\target\test-classes</testOutputDirectory>

    <resources>

      <resource>

        <mergeId>resource-</mergeId>

        <directory>C:\MVN\project\src\main\resources</directory>

      </resource>

    </resources>

    <testResources>

      <testResource>

        <mergeId>resource-</mergeId>

        <directory>C:\MVN\project\src\test\resources</directory>

      </testResource>

    </testResources>

    <directory>C:\MVN\project\target</directory>

    <finalName>project-1.0</finalName>

    <pluginManagement>

      <plugins>

        <plugin>

          <artifactId>maven-antrun-plugin</artifactId>

          <version>1.3</version>

        </plugin>

        <plugin>

          <artifactId>maven-assembly-plugin</artifactId>

          <version>2.2-beta-</version>

        </plugin>

        <plugin>

          <artifactId>maven-clean-plugin</artifactId>

          <version>2.2</version>

        </plugin>

        <plugin>

          <artifactId>maven-compiler-plugin</artifactId>

          <version>2.0.</version>

        </plugin>

        <plugin>

          <artifactId>maven-dependency-plugin</artifactId>

          <version>2.0</version>

        </plugin>

        <plugin>

          <artifactId>maven-deploy-plugin</artifactId>

          <version>2.4</version>

        </plugin>

        <plugin>

          <artifactId>maven-ear-plugin</artifactId>

          <version>2.3.</version>

        </plugin>

        <plugin>

          <artifactId>maven-ejb-plugin</artifactId>

          <version>2.1</version>

        </plugin>

        <plugin>

          <artifactId>maven-install-plugin</artifactId>

          <version>2.2</version>

        </plugin>

        <plugin>

          <artifactId>maven-jar-plugin</artifactId>

          <version>2.2</version>

        </plugin>

        <plugin>

          <artifactId>maven-javadoc-plugin</artifactId>

          <version>2.5</version>

        </plugin>

        <plugin>

          <artifactId>maven-plugin-plugin</artifactId>

          <version>2.4.</version>

        </plugin>

        <plugin>

          <artifactId>maven-rar-plugin</artifactId>

          <version>2.2</version>

        </plugin>

        <plugin>

          <artifactId>maven-release-plugin</artifactId>

          <version>2.0-beta-</version>

        </plugin>

        <plugin>

          <artifactId>maven-resources-plugin</artifactId>

          <version>2.3</version>

        </plugin>

        <plugin>

          <artifactId>maven-site-plugin</artifactId>

          <version>2.0-beta-</version>

        </plugin>

        <plugin>

          <artifactId>maven-source-plugin</artifactId>

          <version>2.0.</version>

        </plugin>

        <plugin>

          <artifactId>maven-surefire-plugin</artifactId>

          <version>2.4.</version>

        </plugin>

        <plugin>

          <artifactId>maven-war-plugin</artifactId>

          <version>2.1-alpha-</version>

        </plugin>

      </plugins>

    </pluginManagement>

    <plugins>

      <plugin>

        <artifactId>maven-help-plugin</artifactId>

        <version>2.1.</version>

      </plugin>

    </plugins>

  </build>

  <repositories>

    <repository>

      <snapshots>

        <enabled>false</enabled>

      </snapshots>

      <id>central</id>

      <name>Maven Repository Switchboard</name>

      <url>http://repo1.maven.org/maven2</url>

    </repository>

  </repositories>

  <pluginRepositories>

    <pluginRepository>

      <releases>

        <updatePolicy>never</updatePolicy>

      </releases>

      <snapshots>

        <enabled>false</enabled>

      </snapshots>

      <id>central</id>

      <name>Maven Plugin Repository</name>

      <url>http://repo1.maven.org/maven2</url>

    </pluginRepository>

  </pluginRepositories>

  <reporting>

    <outputDirectory>C:\MVN\project\target/site</outputDirectory>

  </reporting>

</project>

你可以看到 Maven 在执行目标时需要用到的默认工程源码目录结构、输出目录、需要的插件、仓库和报表目录。

Default (or Build) 生命周期

这是 Maven 的主要生命周期，被用于构建应用。包括下面的 23 个阶段。

生命周期阶段	描述
validate	检查工程配置是否正确，完成构建过程的所有必要信息是否能够获取到。
initialize	初始化构建状态，例如设置属性。
generate-sources	生成编译阶段需要包含的任何源码文件。
process-sources	处理源代码，例如，过滤任何值（filter any value）。
generate-resources	生成工程包中需要包含的资源文件。
process-resources	拷贝和处理资源文件到目的目录中，为打包阶段做准备。
compile	编译工程源码。
process-classes	处理编译生成的文件，例如 Java Class 字节码的加强和优化。
generate-test-sources	生成编译阶段需要包含的任何测试源代码。
process-test-sources	处理测试源代码，例如，过滤任何值（filter any values)。
test-compile	编译测试源代码到测试目的目录。
process-test-classes	处理测试代码文件编译后生成的文件。
test	使用适当的单元测试框架（例如JUnit）运行测试。
prepare-package	在真正打包之前，为准备打包执行任何必要的操作。
package	获取编译后的代码，并按照可发布的格式进行打包，例如 JAR、WAR 或者 EAR 文件。
pre-integration-test	在集成测试执行之前，执行所需的操作。例如，设置所需的环境变量。
integration-test	处理和部署必须的工程包到集成测试能够运行的环境中。
post-integration-test	在集成测试被执行后执行必要的操作。例如，清理环境。
verify	运行检查操作来验证工程包是有效的，并满足质量要求。
install	安装工程包到本地仓库中，该仓库可以作为本地其他工程的依赖。
deploy	拷贝最终的工程包到远程仓库中，以共享给其他开发人员和工程。

码农公寓

约定优于配置

Maven - POM

POM 举例

POM 举例

Super POM

Default (or Build) 生命周期

相关文章