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的着力所做的劳作很少,
    超越1/2干活都会叫给插件来做, 3个插件 是一个或几个对象的集结,
    插件的直观表现正是3个或多少个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定义了一组坐标, 他们能够用来标识3个档次, 1个凭借,
    只怕MavenPom里1个插件.

    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

      设若多于三个连串注重于3个一定的借助, 就能够在
      dependencyManagement中列出那么些依靠,
      父POM包括3个本子和一组排除配置, 在子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]

      第②个参数表示插件中的某1个目的, 第多个参数为对象的拥有音讯,
      同时在:

      “-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会在设置 或布署的时候将 符号展开为
    3个时间和日期,转换为 UTC.(也正是快速照相版本)

    如在创建的时候, 默许为 0.1-SNAPSHOT, 而后将品种布局到了 Maven仓库,
    Maven会将版本进行为 0.1-YYYYMMDD-HH24MISS-1, 那里的时刻 为UTC时间.

    万一项目依赖的2个零件正处在开发进度中, 依赖它的 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 必须有3个被重写,
      无法有完全相同的坐标.
    • 依赖
    • 开发者和贡献者
    • 插件列表
    • 告诉列表
    • 插件执行
    • 插件配置

    一而再中, 当 父级 POM 在 父目录../pom.xml 或许 在 本地仓库目录时 可用,
    不然的话须求指明 父级POM的争执地方.

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