maven初学

Maven初入

maven 是一个品类管理工具, 它涵盖了一个 项目对象模型(Project Object Model
POM), 一组正式集合, 一个门类生命周期(Project Lifecycle),
一个倚重管理系列(Dependency Management System), 和用来运行 定义在
生命周期阶段中插件目的的逻辑.

Maven的基本只做一些基础的事务, 解析XML文档, 管理生命周期, 插件,
仅此而已; Maven的首要职责是委任给各类各类的插件, 如编译源码,
打包二进制代码, 宣布站点 和 其他构建任务, 而插件从 maven仓库拿到.

文档参考自: Maven权威指南

Maven初步

安装自不必赘述, Maven的相干安排在 ~/.m2/settings.xml,

~/.m2/repository 是当地仓库目录.

maven主题概念

  1. 插件和对象

    就像在头里所提到过的, Maven的中坚所做的行事很少,
    大部分工作都会叫给插件来做, 一个插件 是一个或六个对象的汇聚,
    插件的直观表现就是一个或五个jar包, 目的指的就是 某一个切实可行的章程,
    可以配备相应的参数, 同时需要给定一些必须参数;

    简写: pluginId:goalId

  2. 生命周期(Lifecycle)

    生命周期是带有在一个品种中一密密麻麻有序的等级,
    在maven中配有默认的生命周期, 以表达项目的为主完整性起头,
    以把项目揭破成成品截止.

    中间, 插件目的是足以依附在生命周期上的, 会随着生命周期的阶段
    一步步执行, 当 maven执行一个等级的时候,
    他先是会平稳实施前面的享有阶段, 并执行绑定在等级上的默认目的,
    到命令指定的万分阶段截至;

    recourses: recourses; Recourses插件的 recourses目标绑定在了
    recourses阶段, 那多少个目的复制 src/main/recourses 下的兼具资源 和
    其他任何配置的资源目录, 到输出目录;

    compiler: compile 绑定到了 compile阶段,编译 src/main/java
    下的享有源代码 和 其他任何配置的资源目录, 到输出目录.

    recourses: testRecourses Resources插件的 testRecourses目标绑定到了
    test-recourses阶段, 对应 src/test/resources

    compiler: testCompile 对应 src/test/java

    surefire: test surefire插件的对象test 绑定到 test阶段,
    那些目标运行具有的测试, 并创造那么些 捕捉 详细测试结果的文本,
    默认情状下, 倘诺有测试战败, 那么些目标会截至

    jar:jar 绑定到 package阶段, 把出口目录打包成 jar文件.

  3. Maven 坐标

    POM为项目命名, 提供了花色的一组唯一标识符(坐标), 并通过
    依赖(dependencies), 父(parents) 和 先决条件(prerequisite)
    来定义和其它类型的关系.

    Maven定义了一组坐标, 他们可以用来标识一个项目, 一个倚重,
    或者MavenPom里一个插件.

    GroupId: 团体, 集团, 组织等其他, 就是java中的 com.company.project

    artifactId: 项目的识

    version: 版本号, 一般会通过充分 “SNAPSHOT”标记, 标识正在开发中.

    packing(非必须): 默认为 jar, 项目打包后输出, war 表示web 项目.

    同时需要专注的是: 在 artifactId中最好永不使用 “.”

  4. Maven仓库

    路线为, 相对于仓库根目录:

    /<groupId>/<artifactId>/<version>/<artifactId>-<version>.<packing>

  5. Maven依赖

    对此依靠, 如今只需要了然倚重具有传递性,即可.

Maven注意事项

  1. 优化, 降低看重重复

    1. 腾飞共同的依赖至 dependencyManagement

      假定多于一个门类倚重于一个一定的依赖性, 就能够在
      dependencyManagement中列出这个依靠,
      父POM包含一个本子和一组排除配置, 在子POM中需要动用
      groupId和artifactId引用这一个依靠, 尽管倚重已经在
      dependencyManagement中列出, 子项目得以额忽略版本和扫除配置;

      <properties>
          <hibernate.annotation.version>3.3.0</hibernate.annotation.version>
      </properties>
      

      透过这种模式将版本音信定义为 常量, 通过 ${ }引用变量

      <dependency>
          <groupId>org.hibernate</groupId>
          <artifactId>hibernate-annotation</artifactId>
          <version>${hibernate.hibernate.annotation.version}</version>
      </dependency>
      
    2. 为小兄弟项目利用内置的 version 和 groupId

    3. 采纳相同的 groupId 和 ${project.version}.

    4. 进化共同的 plugin 至 pluginManagement

    5. 显示的宣示依赖, 不要通过倚重传递性来引用 jar包

    6. 使用 Maven Denpendency插件优化:

      透过 mvn dependency:analyze 对品种展开解析,
      但增删依赖判断的先决条件是单元测试;

      在 analyze中, 生命周期依次为:
      recourses, compile, testRecourses, testCompile, analyze;

      会将进行中的错误, 未阐明的 jar, 注脚未利用的jar 各类显示出来.

      而拔取 mvn dependency:tree , 会列出项目中兼有的直接和传递性倚重.

    7. 多少个援助插件

      mvn help:active-profiles 列出近年来构建中移动的 Profile

      mvn help:effective-pom 突显当前构建的实际 pom

      mvn help:effective-settings 打印实际的setting,
      包含全局和用户级此外

      mvn help:describe 描述插件的习性, 无需在类型目录下运行,
      但必须提供插件的 groupId 和 artifactId

      如: mvn help:describe -Dplugin=complier [Dmojo=compile]
      [-Dfull]

      其次个参数表示插件中的某一个目的, 第三个参数为对象的拥有音讯,
      同时在:

      “-D<name>=<value>” 这种方法设定 调用 mvn 插件目的,传入目标中的参数中的 值. 需要小心的是, 这并非是 Maven的语法,
      其实是 java 用来设置系统性能的形式.

Maven Pom

有着的 Maven POM 都继承自一流POM, 一级POM所处目录为: {Maven
HOME}/lib/maven-model-builder-{Maven Version}.jar 内
org.apache.maven.model 下的 POM-4.0.0.xml.

文件着重定义了:

  1. 单身的长距离仓库, https://repo.maven.apache.org/maven2

    <repositories>
    <repository>
    <id>central</id>
    <name>Central Repository</name>
    <url>https://repo.maven.apache.org/maven2</url>
    <layout>default</layout>
    <snapshots>
        <enabled>false</enabled>
    </snapshots>
    </repository>
    </repositories>
    
  2. 为骨干插件提供了默认的本子

咱俩友好建立的 POM最顶层继承自 顶尖 POM, 其次是所有的 父级POM, 自上向下
会一层层 覆盖此前的默认配置, 通过 mvn help:effective
可以查看当前项目的有用pom.

下边就起来一步步看POM.xml文件中的配置:

  1. version

    <major version>.<minor version>.<incremental version>-<qualifier>
    
    1.3.5-beta-01
    

    里面1为主版本号, 3为次版本号, 5为增量版本号,
    beta-01为限量版本号(alpha 和 beta). 假若版本号符合规则要求,
    则遵照版本号来相比较, 否则遵照字符串规则来举行相比较. 比如 a10 是 排在
    a2面前的, 由此 a10属于旧版本, 但在大家的定义中, 却相应是相反的.

    本子界限配置情势:

    (loVersion, hiVersion) 不包含
    [loVersion, hiVersion] 包含

    <version>[3.8, 4.1.2]</version>
    

    当不点名上界/下界时, 则为上述/以下

    SNAPSHOT

    一旦你在本子中使用了 字符串 SNAPSHOT, 表示项目正处在 活动的
    开发意况, Maven会在装置 或配备的时候将 符号展开为
    一个刻钟和日期,转换为 UTC.(也就是快照版本)

    如在创建的时候, 默认为 0.1-SNAPSHOT, 而后将项目配置到了 Maven仓库,
    Maven会将版本举办为 0.1-YYYYMMDD-HH24MISS-1, 这里的光阴 为UTC时间.

    要是项目依赖的一个零件正处在开发过程中, 倚重它的 SNAPSHOT版本,
    则在运作构建的时候, 会自动从仓库下载最新的 SNAPSHOT, 同时, 要依赖SNAPSHOT版本, 用户必须在 POM中应用 repository 和 pluginRepository
    开启下载 SNAPSHOT效用.

    <!--选择对应的 坐标, 将 enabled 属性设置为 true 即可-->
    <repositories>
        <repository>
        <id>central</id>
        <name>Central Repository</name>
        <url>https://repo.maven.apache.org/maven2</url>
        <snapshots>
            <enabled>true</enabled>
        </snapshots>
        </repository>
    </repositories>
    
    <pluginRepositories>
        <pluginRepository>
        <id>central</id>
        <name>Central Repository</name>
        <url>https://repo.maven.apache.org/maven2</url>
        <snapshots>
            <enabled>true</enabled>
        </snapshots>
        </pluginRepository>
    </pluginRepositories>
    

    而发布到 非 snapshot的 Maven仓库的构建无法依靠于 SNAPSHOT版本,
    仅用于开发过程.

    LATEST 和 RELEASE

    当依赖于一个插件 或 倚重, 可以使用非常值:

    LATEST: 最新宣布的版本 或 快照版.

    RELEASE: 仓库中 最终一个非快照版本.

    在品种揭发的时候, 尽量不要接纳 这六个首要字, 仅在支付时采纳

  2. 变量引用

    在Maven中有两个放置隐士变量:

    env: 表示 environment, 系统的环境变量, 如 ${env.PATH},
    需要小心的是急需大写, 如 ${env.JAVA_HOME}

    settings: 这么些指的是 settings.xml中的属性, 但平昔引用不成功.

    project: 引用当前 project中的属性 如 ${project.artifactId}.

    ${basedir}, 可以访问当前项目根目录

    Java系统特性

    凡是足以被 java.lang.System 中的 getProperties()方法访问的性质

    可以在Java中经过 System.getProperties().list(System.out);
    在Maven中通过 ${} 直接访问, 如 ${java.runtime.name}

    自定义属性:

    <properties>
        <attribute>value</attribute>
    </properties>
    

    访问情势即: ${attribute.value}

  3. 依赖范围

    <version>1.0</version>
    <scope>test</scope>
    

    compile: 编译范围, 默认范围, 在具备的classpath都可以使用, 也会被打包

    provided: 已提供范围, 唯有当 JDK/容器已经提供该看重之后才使用, 如在
    开发中 需要 Servlet API编译一个 Servlet,
    但在卷入发布之后这部分应该由 容器/服务器本身来提供. 仅在编译时可用.
    不可传递, 不会打包.

    runtime: 运行时限制, 在编译时不需要, 在运行时需要.

    test: 测试范围, 仅在测试时需要, 测试运行, 测试编译.

    system: 系统范围, 必须提供 systemPath, 即本地jar文件的路径.

    可选依赖:

    <version>1.0</version>
    <optional>true</optional>
    

    透过这种办法生命的倚重, 不会被传递. 需要在子项目中重新生命

  4. 依靠的传递

    test范围不会被传送, provided范围 仅在 provided中被传送, runtime 和
    compile 在 四种限制都会被传递.

    e.g. : A 包含对 B的测试范围倚重, B 包含对 C的编译时倚重, 则
    C为A的测试范围依赖

    A:
    <dependency>
        <groupId>B</groupId>
        <artifactId>B</artifactId>
        <version>1.0</version>
        <scope>test</scope>
    </dependency>
    B:
    <dependency>
        <groupId>C</groupId>
        <artifactId>C</artifactId>
        <version>1.0</version>
    </dependency>
    

    e.g. : A包含对 B的测试范围依赖, B包含对C的测试范围依赖, 则 A与C无关.

    A:
    <dependency>
        <groupId>B</groupId>
        <artifactId>B</artifactId>
        <version>1.0</version>
        <scope>test</scope>
    </dependency>
    B:
    <dependency>
        <groupId>C</groupId>
        <artifactId>C</artifactId>
        <version>1.0</version>
        <scope>test</scope>
    </dependency>
    

    依傍追踪:

    在 Maven中, 若是六个体系看重于同一个 project, 则Maven会找到
    所有倚重中版本最新的 依赖, 作为最终的拔取, 所以可以解除对应的看重,
    且同时 可以 更换自己想要的版本.

    e.g.:

    <dependency>
        <groupId>B</groupId>
        <artifactId>B</artifactId>
        <version>1.0</version>
        <exclusions>
            <exclusion>
                <groupId>C</groupId>
                <artifactId>C</artifactId>
            </exclusion>
        </exclusions>
    </dependency>
    
  5. 借助管理

    这在事先 优化 已经关系, 选择在父级项目中定义 dependencyManagement,
    pluginManagement, 在子级中沿用父级的本子, 仅需要列出所采用的
    倚重坐标, 而无需再次定义版本(要是定义子级版本, 父级就会被忽略);

    多模块项目:

    <modules>
        <module>project-a</module>
        <module>project-b</module>
    </modules>
    

    多模块项目标打包总是一个 POM 而非构建, 其中各类模块可以为 POM 或者
    jar

    花色后续:

    <parent>
        <groupId>C</groupId>
        <artifactId>C</artifactId>
        <version>1.0-SNAPSHOT</version>
    </parent>
    

    可以被连续的门类:

    • 定义符: groupId 和 artifactId 必须有一个被重写,
      不可能有完全相同的坐标.
    • 依赖
    • 开发者和进献者
    • 插件列表
    • 告诉列表
    • 插件执行
    • 插件配置

    持续中, 当 父级 POM 在 父目录../pom.xml 或者 在 本地仓库目录时 可用,
    否则的话需要指明 父级POM的相对地方.

     <parent>
        <groupId>C</groupId>
        <artifactId>C</artifactId>
        <version>1.0-SNAPSHOT</version>
        <relativePath>../a-parent/pom.xml</relativePath>
    </parent>
    

 

相关文章