MAVEN

Maven2 是一种项目管理框架，能够简化项目的开发，形成统一的规范，节省操作时间。

Maven2 是规范的开发流程、软件开发的约定、项目管理框架、构建工具。

Maven2 对项目进行了抽象，用 POM 描述。

Maven2 能够提供一致性、过程重用、敏捷性、可维护性。

 

命名约定：利于维护，输出一般为 <artifactId>-<version>.<extension>

 

 

创建应用目录结构

为了重用，根据高聚合低耦合的方式按方面分解应用。

如下是应用的目录结构：

Proficio API: 应用的编程接口。

Proficio CLI ：提供命令行接口的代码。

Proficio Core: 应用编程接口的实现。

Proficio Model: 应用的数据结构，包含需要的所有类。

Proficio Stores: 放置所有 store 模块，该应用包含 memory-based store 和 XStream-based store 。

Maven 使用默认的命名规则，你可以按照项目决定如何命名，唯一需要注意的就是项目成员能够轻易而一致的理解。

 

检查顶层的 pom ，可以看到应用 Proficio 的子模块，每个模块都是对一个 maven 工程的引用，对应一个 pom 。这种配置就是多模块构建，其 pom 如下：

<project>

<modelVersion>4.0.0</modelVersion>

<groupId>org.apache.maven.proficio</groupId>

<artifactId>proficio</artifactId>

<packaging>pom</packaging>

<version>1.0-SNAPSHOT</version>

<name>Maven Proficio</name>

<url>http://maven.apache.org</url>

[...]

<modules>

<module>proficio-model</module>

<module>proficio-api</module>

<module>proficio-core</module>

<module>proficio-stores</module>

<module>proficio-cli</module>

</modules>

[...]

</project>

注意其中的：

version 元素，其值为 1.0-SNAPSHOT ，在多模块应用中需要同时发布所有子模块，很有必要保持一致的应用版本。在顶层的 pom 中定义应用版本可以使所有模块使用。

Packaging 元素，其值为 pom ，在包含子模块的应用 pom 中，其值必须为 pom 。检查各个子模块对应项目的 pom 中的 Packaging 元素的值，除 Proficio Stores 其值为 pom ，其下包含两个子模块，其余均为 jar ，表明不再包含子模块。

Maven 以这样的方式递归的进行分析。

 

 

使用项目继承

利用项目继承可以将结构信息，部署信息，共同的依赖信息放置在单一的位置。在每个工程的 pom 中：

[...]

<parent>

<groupId>org.apache.maven.proficio</groupId>

<artifactId>proficio</artifactId>

<version>1.0-SNAPSHOT</version>

</parent>

[...]

这使得项目的 pom 可以继承顶层 pom 中的定义，检查顶层 pom 的 dependencies 部分：

<project>

[...]

<dependencies>

<dependency>

<groupId>junit</groupId>

<artifactId>junit</artifactId>

<version>3.8.1</version>

<scope>test</scope>

</dependency>

</dependencies>

[...]

</project>

在各个子模块的 pom 中没有对 Junit 依赖的定义，但是从顶层 pom 中继承了依赖的定义。

为了看清楚可以在一个子模块 pom 所在目录下，执行命令

#mvn help:effective-pom

可以看到最终起效果的 pom ，这在找错时很有效。

 

 

管理依赖

在 pom 中指明 dependency management 元素的方式 maven 结合项目继承来管理依赖。在多模块应用中，可能多个子项目会有共同的依赖。此时为了正确运行，必须让所有的子项目使用依赖项的同一版本。必须确保应用的各个项目的依赖项和版本一致，才能保证测试的和发布的是相同的成果。因此，应在顶层的 pom 中定义共同的依赖关系。

在 Proficio 应用的顶层 pom 中的 dependency management 段如下：

  <dependencyManagement>

    <dependencies>

      <dependency>

        <groupId>com.devzuz.mvnbook.proficio</groupId>

        <artifactId>proficio-model</artifactId>

        <c>${project.version}</version>

      </dependency>

      <dependency>

        <groupId>com.devzuz.mvnbook.proficio</groupId>

        <artifactId>proficio-api</artifactId>

        <version>${project.version}</version>

      </dependency>

      <dependency>

        <groupId>com.devzuz.mvnbook.proficio</groupId>

        <artifactId>proficio-core</artifactId>

         <version>${project.version}</version>

      </dependency>

      <dependency>

        <groupId>com.devzuz.mvnbook.proficio</groupId>

        <artifactId>proficio-store-memory</artifactId>

        <version>${project.version}</version>

      </dependency>

      <dependency>

        <groupId>com.devzuz.mvnbook.proficio</groupId>

        <artifactId>proficio-store-xstream</artifactId>

        <version>${project.version}</version>

      </dependency>

      <dependency>

        <groupId>org.codehaus.plexus</groupId>

        <artifactId>plexus-container-default</artifactId>

        <version>1.0-alpha-9</version>

      </dependency>

    </dependencies>

  </dependencyManagement>

注意 ${project.version} 变量指的是应用的 version 。

顶层 pom 中的 dependencies 与 dependencyManagement 中的 dependencies 元素有一个重要的区别：

dependencyManagement 中的 dependencies 元素只表明依赖项版本的优先选择，并不影响项目的依赖项；而 dependencies 元素则影响项目的依赖项。

检查 Proficio api 模块的 pom:

<project>

  <parent>

    <groupId>com.devzuz.mvnbook.proficio</groupId>

    <artifactId>proficio</artifactId>

    <version>1.0-SNAPSHOT</version>

  </parent>

  <modelVersion>4.0.0</modelVersion>

  <artifactId>proficio-api</artifactId>

  <packaging>jar</packaging>

  <name>Proficio API</name>

  <dependencies>

    <dependency>

      <groupId>com.devzuz.mvnbook.proficio</groupId>

       <artifactId>proficio-model</artifactId>

    </dependency>

  </dependencies>

</project>

其中没有指明依赖项的版本信息，在顶层 pom 中的 dependencyManagement 中表明其优选的版本是 ${project.version} 即 1.0-SNAPSHOT 。为使其模块 pom 完整，其版本信息会注入其中。只有当 dependencies 元素中没有指明版本信息时， dependencyManagement 中的 dependencies 元素才起作用。