【转】maven详解二

时间 2019-11-11

标签 maven 详解栏目 Maven 繁體版

原文原文链接

1. Maven多模块项目

以模块的形式来组织项目，可使得项目的组织结构更加清晰更易维护，每一个模块均可以进行高内聚和独立部署。模块之间的依赖关系能够自由进行组合，以提升软件组件的重用，同时各模块之间可以实现松耦合。

水平项目布局

水平项目布局（Flat Project Layout）指的是父模块项目与子模块项目处于同一级目录下。

分层项目布局

分层项目布局（Hierachical Project Layout）指的是父模块项目做为父目录，该目录下包含了全部的子模块项目。

项目布局的差别

水平和分层结构布局的最主要差别在于父模块pom.xml文件是否与子模块处于同一级目录中。

分层项目布局父模块pom.xml文件与子模块处在同一级目录中，而水平项目布局的方式是处在不一样级目录。

在多模块项目结构中，当父模块pom.xml文件与子模块处在同一级目录时，它可以给咱们带来许多方便之处。

如在父模块POM文件中声明子模块时，分层项目布局的声明方式为：

<modules>
    <module>child1-module</module>
    <module>child2-module</module>
    <module>child3-module</module>
</modules

而水平项目布局的声明方式（因其父模块POM文件与子模块处在不一样级的目录中）：html

<modules>
    <module>../child1-module</module>
    <module>../child2-module</module>
    <module>../child3-module</module>
</modules>

显然第一种方式要比第二种方式更加简洁。总的来讲，推荐使用分层项目布局的方式来组织项目的结构。mysql

建立分层结构布局的项目

文档传送门： http://maven.apache.org/plugins/maven-eclipse-plugin/reactor.html

建立父模块项目maven-multiple-modules-sample：

mvn archetype:generate -DgroupId=org.fanlychie -DartifactId=maven-multiple-modules-sample -Dversion=0.0.1-SNAPSHOT

进入父模块目录：react

cd maven-multiple-modules-sample

删除父模块的src目录（父模块是一个没有源代码的项目，所以不须要src目录）：web

rd /s/q src

父模块项目的打包类型必须为pom，修改pom.xml的打包类型以下：sql

<packaging>pom</packaging>

建立子模块项目user-facade：数据库

mvn archetype:generate -DgroupId=org.fanlychie -DartifactId=user-facade -Dversion=0.0.1-SNAPSHOT

子模块pom.xml文件中会自动生成其父模块信息：apache

<parent>
    <groupId>org.fanlychie</groupId>
    <artifactId>maven-multiple-modules-sample</artifactId>
    <version>0.0.1-SNAPSHOT</version>
</parent>

建立子模块项目user-serviceapp

mvn archetype:generate -DgroupId=org.fanlychie -DartifactId=user-service -Dversion=0.0.1-SNAPSHOT

建立子模块项目blog-web：eclipse

mvn archetype:generate -DgroupId=org.fanlychie -DartifactId=blog-web -Dversion=0.0.1-SNAPSHOT -DarchetypeArtifactId=maven-archetype-webapp

在父模块POM文件中使用<modules>声明其子模块：webapp

<!-- modules:
     声明子模块。模块间的前后顺序是没有要求的，maven不须要开发者考虑模块间的依赖关系，
     maven在构建项目时，它会对模块自动进行拓扑排序并确保在依赖模块以前构建依赖的模块项目。
     module:
     它的值一般是子模块项目相对于父模块POM文件的相对路径的名称。
-->
<modules>
    <module>user-facade</module>
    <module>user-service</module>
    <module>blog-web</module>
</modules>

将项目导入IntelliJ IDEA（主流的JAVA IDE开发工具）。菜单：File --> Open...选择父模块项目：

项目导入到IntelliJ IDEA后，IntelliJ IDEA可以识别并自动将各个模块转换成maven项目。如图示：

在命令行中执行打包项目的命令，如在cmd中到父模块根目录下执行：

$ mvn clean -Dmaven.test.skip package

能够看到，maven在构建多模块项目时，它会根据模块之间的依赖关系，整理出一个新的构建顺序，而后再按这个顺序来构建各个模块。构建完成以后，会在各个子模块项目的target目录下生成输出相对应的jar或war软件包。

在IntelliJ IDEA中运行web项目：

建立水平结构布局的项目

按分层结构布局方式建立多模块项目，而后在项目根目录maven-multiple-modules-sample下建立父模块目录parent-module，并将maven-multiple-modules-sample/pom.xml文件移动到parent-module文件中。修改parent-module/pom.xml（<artifactId>、<name>、<modules>）配置以下：

<?xml version="1.0" encoding="UTF-8"?>
<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>org.fanlychie</groupId>
    <artifactId>parent-module</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <packaging>pom</packaging>
    <name>parent-module</name>
    <url>http://maven.apache.org</url>
    <!-- 子模块的相对路径（相对父模块pom.xml的路径） -->
    <modules>
        <module>../user-facade</module>
        <module>../user-service</module>
        <module>../blog-web</module>
    </modules>
</project>

子模块项目pom.xml配置文件中继承父模块部分的配置修改成：

<parent>
    <groupId>org.fanlychie</groupId>
    <artifactId>parent-module</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <!-- 用于指定父模块POM的相对路径。它的默认值是"../" -->
    <relativePath>../parent-module</relativePath>
</parent>

子模块POM继承父模块POM，在子模块POM配置中<relativePath>用于指定其父模块的POM文件的相对路径。若是<relativePath>配置的值是一个目录，则默认寻找该目录下的/pom.xml文件。即等效于：

<parent>
    <groupId>org.fanlychie</groupId>
    <artifactId>parent-module</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <!-- 用于指定父模块POM的相对路径。它的默认值是"../" -->
    <relativePath>../parent-module/pom.xml</relativePath>
</parent>

将项目导入IntelliJ IDEA。菜单：File --> Open...选择项目的根目录：

导入后是一个普通文件目录，IntelliJ IDEA不可以识别出是maven项目，如图示：

接下来须要将项目转换为maven项目，菜单：File --> New --> Module from Existing Sources...

仍然选到项目的根目录：

选择maven，点击下一步：

勾选复选框Search for projects recursively递归搜索项目：

选择maven构建环境：

直接下一步：

选择编译使用的JDK版本，点击完成按钮：

若是项目还报找不到JDK的问题，按快捷键Ctrl+Alt+Shift+S从新选择JDK：

子模块可继承的POM元素

父模块项目POM配置文件中的大部分元素信息可以被子模块所继承，这些元素有：

元素	描述
groupId	项目组ID
version	项目版本号
description	项目描述信息
url	项目的地址
inceptionYear	项目成立年份
organization	项目的组织信息
licenses	项目许可证
developers	项目开发者信息
contributors	项目贡献者信息
mailingLists	项目的邮件列表
scm	项目源代码管理系统信息
issueManagement	项目缺陷跟踪管理系统信息
properties	项目自定义的属性
dependencyManagement	项目的依赖管理配置
dependencies	项目的依赖配置
repositories	项目的仓库配置
pluginRepositories	项目的插件仓库配置
build	项目的构建配置
profiles	项目的环境配置

文档传送门： http://maven.apache.org/pom.html#Inheritance

2. Maven多模块项目版本管理

若是一个项目要迭代一个新的版本，特别是对于一些子模块数量较多的项目，那就须要手工的一个一个的去修改各个模块POM中的版本号信息，这显然不是一个最好的作法。 Versions Maven Plugin可用于管理控制Maven多模块项目POM中的版本号信息。

versions:set

用于设置当前项目的版本。若是当前项目是一个父模块项目，则修改会传播给全部的子模块项目。

$ mvn versions:set -DnewVersion=0.0.2-SNAPSHOT

在项目pom.xml目录下执行此命令，以更新项目POM的版本号信息。以此同时会在此目录下生成一个pom.xml.versionsBackup文件，该文件是执行更新项目版本号信息前，对当前项目pom.xml文件的一个备份文件。

versions:revert

恢复项目pom.xml文件的上一个版本号信息。回滚的过程依赖生成的pom.xml.versionsBackup文件。若是恢复成功，插件会自动删除pom.xml.versionsBackup文件。

versions:commit

提交项目版本号信息的修改。提交后插件会自动删除pom.xml.versionsBackup文件。

3. Maven多环境构建配置

一个项目从开发到最后发布上线，一般须要在多套不一样的环境经受反复的测试和验证，例如开发环境、测试环境、预生产环境、生产环境等。项目部署到不一样的环境时，项目的配置一般也是不一样的，例如数据库的数据源配置等。maven提供了一套profiles配置，开发者能够在项目POM文件中预先定义好若干个不一样环境的profile配置，项目能够根据不一样的构建参数来动态选择其中的一个环境设置。这就意味着相同的一套项目代码，能够在构建时根据传入的不一样环境参数打出不一样环境的软件包来。这也是maven竭力保证的软件可移植性。

多环境配置

项目pom.xml配置示例以下：

<!-- 多环境构建配置 -->
<profiles>
    <!-- 开发环境配置 -->
    <profile>
        <!-- 标识符, 能够经过 -P[id] 来激活 --> <!-- -Pdev -->
        <id>dev</id>
        <!-- 激活条件 -->
        <activation>
            <!-- 能够经过 -D[name]=[value] 来激活 --> <!-- -Denv=dev -->
            <property>
                <name>env</name>
                <value>dev</value>
            </property>
            <!-- 默认激活 -->
            <activeByDefault>true</activeByDefault>
        </activation>
        <!-- 自定义的属性, 能够经过 ${label} 来引用 --> <!-- ${jdbcUrl} -->
        <properties>
            <jdbcUrl>jdbc:mysql://localhost:3306/dev</jdbcUrl>
        </properties>
    </profile>
    <!-- 测试环境配置 -->
    <profile>
        <!-- 标识符, 能够经过 -P[id] 来激活 --> <!-- -Ptest -->
        <id>test</id>
        <!-- 激活条件 -->
        <activation>
            <!-- 能够经过 -D[name]=[value] 来激活 --> <!-- -Denv=dev -->
            <property>
                <name>env</name>
                <value>test</value>
            </property>
        </activation>
        <!-- 自定义的属性, 能够经过 ${label} 来引用 --> <!-- ${jdbcUrl} -->
        <properties>
            <jdbcUrl>jdbc:mysql://localhost:3306/test</jdbcUrl>
        </properties>
    </profile>
</profiles>

自定义属性<properties>须要配合<resources>使用才能发挥做用：

<build>
    <!-- 类路径资源配置, 最终输出到软件包中 -->
    <resources>
        <resource>
            <!-- 资源目录路径, 此路径是相对当前POM文件的位置 -->
            <directory>src/main/resources</directory>
            <!-- filtering=true, 可以代入具体的值替换${label}占位符 -->
            <filtering>true</filtering>
        </resource>
    </resources>
</build>

项目配置文件src/main/resources/environment.properties的内容以下：

mysql.jdbc.url = ${jdbcUrl}

打包开发环境的软件包：

$ mvn clean -Pdev package

或：

$ mvn clean -Denv=dev package

打包测试环境的软件包：

$ mvn clean -Ptest package

或：

$ mvn clean -Denv=test package

配置的方式

maven支持的profile配置方式主要有如下几种：

与项目相关的profile配置能够定义在项目pom.xml文件中；
与用户相关的profile配置能够定义在用户settings.xml（%USER_HOME%/.m2/settings.xml）文件中；
全局的profile配置能够定义在全局settings.xml（%MAVEN_HOME%/.m2/settings.xml）文件中；

外部文件（用户或全局settings.xml文件）方式配置的profile是没法移植的。这种方式你只能经过配置<repositories>、<pluginRepositories>、<properties>三个标签元素来影响构建的过程，但并不能改变构建最终输出的结果。

内嵌配置（项目pom.xml文件）方式配置的profile是在项目内部定义的，所以它具备良好的可移植性。这种方式你有更多的标签元素可选择，而且可以改变构建最终输出的结果。这些标签元素有：

<profile>
    <!-- 参与构建的模块 -->
    <modules>...</modules>
    <!-- 构件依赖声明 -->
    <dependencies>...</dependencies>
    <!-- 构件依赖管理 -->
    <dependencyManagement>...</dependencyManagement>
    <!-- 构件发布管理 -->
    <distributionManagement>...</distributionManagement>
    <!-- 插件仓库 -->
    <pluginRepositories>...</pluginRepositories>
    <!-- 自定义属性 -->
    <properties>...</properties>
    <!-- 生成站点的报告信息 -->
    <reporting>...</reporting>
    <!-- 构件仓库 -->
    <repositories>...</repositories>
    <!-- 构建配置 -->
    <build>
        <!-- 默认的构建目标, 在命令行中若是直接执行mvn没有带生命周期阶段, 则默认执行此处配置的阶段 -->
        <defaultGoal>...</defaultGoal>
        <!-- 类路径资源 -->
        <resources>...</resources>
        <!-- 单元测试的类路径资源 -->
        <testResources>...</testResources>
        <!-- 打包的名称 -->
        <finalName>...</finalName>
    </build>
</profile>

激活方式

用户或全局settings.xml以及项目pom.xml的配置可使用<activeByDefault>来激活：

<profile>
    <id>dev</id>
    <activation>
        <!-- 默认激活 -->
        <activeByDefault>true</activeByDefault>
    </activation>
</profile>

用户或全局settings.xml的配置还可使用<activeProfiles>来激活：

<profile>
    <id>dev</id>
</profile>
<activeProfiles>
    <!-- 根据ID标识符来激活 -->
    <activeProfile>dev</activeProfile>
</activeProfiles>

命令行可使用-P[id]或-P [id]或-P [id1,id2]来激活：

<profile>
    <id>dev</id>
</profile>
<profile>
    <id>test</id>
</profile>

$ mvn clean -Pdev package

$ mvn clean -P dev package
$ mvn clean -P dev,test package

命令行还可使用-D[name]=[value]的方式来激活：

<profile>
    <activation>
        <property>
            <name>env</name>
            <value>dev</value>
        </property>
    </activation>
</profile>

$ mvn clean -Denv=dev package

查看激活

$ mvn help:active-profiles

输出信息示例以下：

The following profiles are active:
- jdk7-development (source: external)
- dev (source: org.fanlychie:maven-multiple-modules-sample:0.0.2-SNAPSHOT)

文档传送门： http://maven.apache.org/guides/introduction/introduction-to-profiles.html

文档传送门： http://maven.apache.org/pom.html#Profiles