MAVEN

    技术2022-05-20  38

    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 元素才起作用。


    最新回复(0)