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>

原文地址：https://www.cnblogs.com/fengleixue/p/8176475.html

时间： 2024-10-13 11:47:31

maven初学的相关文章

Maven 初学+http://mvnrepository.com/

了解 maven是一款服务于java平台的自动化构建工具(项目管理工具) 构建:全方位.多角度.深层次地建立 项目构建是一个项目从:源代码.编译.测试.打包.部署.运行的过程 用来解决团队开发遇到的问题 如: 统一 jar包 统一配置文件,单元测试 的代码位置即 目录结构的统一 传统的项目构建过程 1)在eclipse中创建一个java web工程 2)在工程中编写源代码及配置文件等 3)对源代码进行编译,java文件编译成class文件 4)执行Junit单元测试 5)将工程打成war包部署至

初学maven的一些配置

初学Maven的一些配置 1.maven的安装 2.从官网下载3.6.1版本后,高级版本可能会出现不兼容 jdk1.8 3.配置maven 在 settings.xml <settings>标签中 4. 在你安装maven的目录 我的-->F:\myResource\Maven\apache-maven-3.6.1\conf /path/to/local/repo --> <localRepository>F:\myResource\Maven\maven_reposi

idea初学建立maven项目报错

原理,是因为你没把新创建好的maven项目给设置成一个可被tomcat部署的web项目 解决方案如下:          2.关于浏览器测试tomcat启动报404错误! 操作完上一步的小伙伴弹出浏览器可能会报404错误,,那是因为你web.xml没有配置欢迎页,找不到欢迎页,所以404 Web.xml中添加 <welcome-file-list> <welcome-file>index.jsp</welcome-file> </welcome-file-list

初学springboot, 如何快速使用maven搭建springboot项目呢

搭建Springboot 推荐使用maven, 但也可以不使用maven,用正常的java工程. 在MyEclipse上新建一个maven工程 点击Next,选择create a simple project 点击Next,输入下图所示 点击finish,稍等一下会,项目就构建完成.目录结构如下所示: 上图中的pom.xml提示错误,点开pom.xml,切换至:Dependencies视图,点击红色错误,弹出提示框,点击+号.完成后pom.xml将不会报错. pom.xml增加继承父包 <!--

Maven-003-私人定制 maven archetype

在使用 Maven 创建项目模块的时候,依据其默认的 archetype 模板,创建出的目录.及默认的单元测试工具为 JUnit 3.8.1,而且有些常用的资源文件目录.配置文件(例如:Log4J 的配置文件,网页开发时常用的模板文件样式文件等)均需要手动创建.拷贝,那么如何自定义一个适合自己习惯的 archetype 呢? 可通过 maven-archetype-plugin 插件实现依据现有的工程目录结构结构,创建 archetype 模板文件.以下为创建步骤: 1.首先,通过 eclips

【scala初学】scala IDE eclipse

上一篇我们讲了scala入门,但毕竟不是把他弄的跟脚本语言似的,scala宣扬的是要代替java啊,那我们就看他如何抢夺java的位置. scala常用的编辑器,见如下: Eclipse (using one of two shoddy and unstable Scala plugins) Emacs IntelliJ (basically just syntax highlighting support) TextMate VIM jEdit eclipse因为总是跟maven不能有效的结合

初学spring boot踩过的坑

一.搭建spring boot环境 maven工程 pom文件内容 <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-

SpringMVC框架入门配置 IDEA下搭建Maven项目

,初衷:本人初学SpringMVC的时候遇到各种稀奇古怪的问题,网上各种技术论坛上的帖子又参差不齐,难以一步到位达到配置好的效果,这里我将我配置的总结写到这里供大家初学SpringMVC的同僚们共同学习使用! 关于SpringMVC的介绍我就不在此赘述了,想必每一个配置Spring的人都已经或多或少了解过一些SpringMVC的基础知识,可能有的人用的myeclipse或者eclipse进行项目的搭建,我会告诉你这里步骤是很相似的,在myeclipse里面需要建立web项目,然后加入Spring

maven-struts2-spring maven在struts2上搭建spring，使用依赖注入的方法

配置文件 1 <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 2 xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd"> 3 <mo