专栏首页JavaEdgemaven install,build,package等基操及避坑指南

maven install,build,package等基操及避坑指南

0 前言

全是干货的技术殿堂

文章收录在我的 GitHub 仓库,欢迎Star/fork: Java-Interview-Tutorial https://github.com/Wasabi1234/Java-Interview-Tutorial

1 是什么

Apache的优秀开源项目 是Java项目的构建和管理工具

Maven 是 Apache 组织下的一个跨平台的项目管理工具,它主要用来帮助实现项目的构建、测试、打包和部署。Maven 提供了标准的软件生命周期模型和构建模型,通过配置就能对项目进行全面的管理。它的跨平台性保证了在不同的操作系统上可以使用相同的命令来完成相应的任务。Maven 将构建的过程抽象成一个个的生命周期过程,在不同的阶段使用不同的已实现插件来完成相应的实际工作,这种设计方法极大的避免了设计和脚本编码的重复,极大的实现了复用。

2 能干什么

  1. 用maven方便的创建项目,基于archetype可以创建多种类型的java项目
  2. Maven仓库对jar包(artifact)进行统一管理,避免jar文件的重复拷贝和版本冲突
  3. 团队开发,管理项目的RELEASE和SNAPSHOT版本,方便多模块(Module)项目的各模块之间的快速集成 简介 本文将介绍基于 Apache Maven 3 的项目构建的基本概念和方法。Maven 是一套标准的项目构建和管理工具,使用统一规范的脚本进行项目构建,简单易用,摒弃了 Ant 中繁琐的构建元素,并具有较高的可重用性。读完本文,你将了解 Maven 的基本概念和使用它进行项目构建的基本方法。

Maven vs Ant

Ant 也是 Apache 组织下的一个跨平台的项目构建工具,它是一个基于任务和依赖的构建系统,是过程式的。开发者需要显示的指定每一个任务,每个任务包含一组由 XML 编码的指令,必须在指令中明确告诉 Ant 源码在哪里,结果字节码存储在哪里,如何将这些字节码打包成 JAR 文件。Ant 没有生命周期,你必须定义任务和任务之间的依赖,还需要手工定义任务的执行序列和逻辑关系。这就无形中造成了大量的代码重复。

Maven 不仅是一个项目构建工具还是一个项目管理工具。它有约定的目录结构(表 1)和生命周期,项目构建的各阶段各任务都由插件实现,开发者只需遵照约定的目录结构创建项目,再配置文件中生命项目的基本元素,Maven 就会按照顺序完成整个构建过程。Maven 的这些特性在一定程度上大大减少了代码的重复。

3 常用命令

maven install

  • maven的install可以将项目本身编译并打包到本地仓库,这样其他项目引用本项目的jar包时不用去私服上下载jar包,直接从本地就可以拿到刚刚编译打包好的项目的jar包,很灵活,避免每次都需要重新往私服发布jar包的痛苦。
  • 修改服务端比如manage层和dao层的项目的时候如果eclipse没有自动编译,则在调试的时候容易出很奇怪的错误,就是明明代码已经改好了,但是debug的时候还是在报错,这就是没有项目没有编译完成造成的,看到的改好的代码没有变成class,因此,服务端的文件改动之后如果发现没有效果的时候要记得问题可能是没有编译,这时候可以使用maven的install命令编译
  • IDEA可以很方便创建project和module,但是修改各个module的版本的时候,会遇到import报错的情况,这就是maven仓库中没有对应的包,仍然需要使用到install,注意要使用lifecycle里面的install

这样就可以将已有的module打包到maven仓库,再进行修改版本号,不会影响项目里的其他module

mvn clean

编译命令: mvn compile

打包命令: mvn package

跳过单元测试:mvn clean package -Dmaven.test.skip=true

4 避坑指南

  • 对于多模块的项目,注意父 pom 会设置 JDK 版本,注意对齐版本号!

项目对象模型 POM

POM 即 Project Object Module,项目对象模型,在 pom.xml 文件中定义了项目的基本信息、源代码、配置文件、开发者的信息和角色、问题追踪系统、组织信息、项目授权、项目的 url、以及构建项目所用的插件,依赖继承关系。开发人员需按照 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/maven-v4_0_0.xsd"> 
 <modelVersion>4.0.0</modelVersion> 
 <! – The Basics – > 
 <groupId> … </groupId> 
 <artifactId> … </artifactId> 
 <version> … </version> 
 <packaging> … </packaging> 
 <dependencies> … </dependencies> 
 <parent> … </parent> 
 <dependencyManagement> … </dependencyManagement> 
 <modules> … </modules> 
 <properties> … </properties> 
 <! – Build Settings – > 
 <build> … </build> 
 <reporting> … </reporting> 
 <! – More Project Information – > 
 <name> … </name> 
 <description> … </description> 
 <url> … </url> 
 <inceptionYear> … </inceptionYear> 
 <licenses> … </licenses> 
 <organization> … </organization> 
 <developers> … </developers> 
 <contributors> … </contributors> 
 <! – Environment Settings – > 
 <issueManagement> … </issueManagement> 
 <ciManagement> … </ciManagement> 
 <mailingLists> … </mailingLists> 
 <scm> … </scm> 
 <prerequisites> … </prerequisites> 
 <repositories> … </repositories> 
 <pluginRepositories> … </pluginRepositories> 
 <distributionManagement> … </distributionManagement> 
 <profiles> … </profiles> 
</project>

在每个 POM 文件中都含有的元素是该 project 的坐标,它包含三个基本元素。

groupId 定义了项目属于哪个组,这有助于在大的范围上区别项目。artifactId 定义了这个项目在组中唯一的 ID。name 是一个用户友好的项目名称。

除了项目坐标外,modelVersion 指定 POM 模型的版本,version 指明当前项目的版本,packaging 指定了项目发布时的打包类型。

Maven 插件和仓库

Maven 本质上是一个插件框架,它的核心并不执行任何具体的构建任务,仅仅定义了抽象的生命周期,所有这些任务都交给插件来完成的。每个插件都能完成至少一个任务,每个任务即是一个功能,将这些功能应用在构建过程的不同生命周期中。这样既能保证拿来即用,又能保证 maven 本身的繁杂和冗余。

将生命周期的阶段与插件目标相互绑定,就可以在特定的阶段完成具体的构建任务。例如下面的代码就是要在 validate 这个阶段执行 maven-antrun-plugin 的 run 目标,具体的任务在 元素中定义。

<plugins> 
    <plugin> 
        <groupId>org.apache.maven.plugins</groupId> 
        <artifactId>maven-antrun-plugin</artifactId> 
        <version>1.6</version> 
<executions> 
<execution> 
    <id>version</id> 
   <phase>validate</phase> 
   <configuration> 
<target> 
   具体任务
</target> 
</configuration> 
<goals> 
<goal>  run  </goal> 
    </goals> 
</execution> 
    </executions> 
    </plugin> 
</plugins>

Maven 项目中的插件,依赖和项目构建的输出都可以由 Maven 的坐标进行唯一的区分,基于这种机制,Maven 将所有项目的构件文件放置在一个统一的位置,也就是 Maven 仓库。所有 Maven 项目可以从同一个 Maven 仓库中获取自己所需要的依赖 JAR,这节省了磁盘资源。实际的 Maven 项目中不需要存储依赖的文件,只需要在 POM 文件中生成依赖关系,在构建的时候 Maven 就会自动去仓库中下载。

在安装了 Maven 的机器上,会生成一个 ~.m2\repository 目录,这个目录被称为本地仓库,当 Maven 查找需要的依赖时,首先会在本地查找,如果本地仓库中存在,则直接使用,否则 Maven 回去远程仓库查找,查找到后下载到本地进行使用。远程中央仓库的地址为 http://repo1.maven.org/。当然还有一些镜像仓库可供使用,有兴趣的读者可以参考 Maven 官方网站的相关介绍。

当个人所在的网络无法访问公共的 Maven 仓库时,可以在 settings.xml 中设置代理服务器。打开 ~.m2\settings.xml,如果没有则复制 $Maven_HOME/conf/settings.xml 到此路径下,加入

<proxies> 
  <proxy> 
     <active>true</active> 
     <protocol>http</protocol> 
     <host> 代理地址 </host> 
     <port>8080</port> 
     <username> 用户名 </username> 
     <password> 密码 </password> 
   </proxy> 
</proxies>

依赖、聚合和继承

依赖

我们项目中依赖的 Jar 包可以通过依赖的方式引入,通过在 dependencies 元素下添加 dependency 子元素,可以声明一个或多个依赖。通过控制依赖的范围,可以指定该依赖在什么阶段有效。Maven 的几种依赖范围:

依赖是具有传递性的,例如 Project A 依赖于 Project B,B 依赖于 C,那么 B 对 C 的依赖关系也会传递给 A,如果我们不需要这种传递性依赖,也可以用 去除这种依赖的传递,如

<dependency> 
<groupId>commons-logging</groupId> 
<artifactId>commons-logging</artifactId> 
<version>1.1.1</version> 
<optional>true<optional> 
</dependency>

假设第三方的 jar 包中没有使用 来去除某些依赖的传递性,那么可以在当前的 POM 文件中使用 元素声明排除依赖,exclusions 可以包含一个或者多个 exclusion 子元素,因此可以排除一个或者多个传递性依赖。如

<dependency>    
     <groupId>org.springframework</groupId>  
     <artifactId>spring-core</artifactId>  
     <exclusions>  
           <exclusion>      
                <groupId>commons-logging</groupId>          
                <artifactId>commons-logging</artifactId>  
           </exclusion>  
     </exclusions>  
</dependency>

聚合 现实中一个项目往往是由多个 project 构成的,在进行构建时,我们当然不想针对多个 project 分别执行多次构建命令,这样极容易产生遗漏也会大大降低效率。Maven 的聚合功能可以通过一个父模块将所有的要构建模块整合起来,将父模块的打包类型声明为 POM,通过 将各模块集中到父 POM 中。如清单 7,其中 中间的内容为子模块工程名的相对路径。

清单 7. 聚合 1 2 3 4 …/com.dugeng.project1 …/com.dugeng.project2 父类型的模块,不需要有源代码和资源文件,也就是说,没有 src/main/java 和 src/test/java 目录。Maven 会首先解析聚合模块的 POM 文件,分析要构建的模块,并通过各模块的依赖关系计算出模块的执行顺序,根据这个潜在的关系依次构建模块。将各子模块聚合到父模块中后,我们就可以对父模块进行一次构建命令来完成全部模块的构建。

继承 在面向对象的编程中我们学会了继承的概念,继承是可重用行即消除重复编码的行为。Maven 中继承的用意和面向对象编程中是一致的。与聚合的实现类似,我们通过构建父模块将子模块共用的依赖,插件等进行统一声明,在聚合和继承同时使用时,我们可以用同一个父模块来完成这两个功能。

例如将 com.dugeng.parent 这个模块声明为 project1 和 project2 的父模块,那么我们在 project1 和 2 中用如下代码声明父子关系,如

<parent> 
 <groupId>com.dugeng.mavenproject</groupId> 
 <artifactId>com.dugeng.parent</artifactId> 
 <version>0.0.1-SNAPSHOT</version> 
 <relativePath>../com.dugeng.parent/pom.xml</relativePath> 
</parent>

由于父模块只是用来声明一些可共用的配置和插件信息,所以它也像聚合模块一样只需要包括一个 POM 文件,其它的项目文件如 src/main/java 是不需要的。

聚合和继承存在一些共性和潜在的联系,在实际的应用中,经常将聚合模块的父模块和继承的父模块定义为同一个。

并不是所有的 POM 元素都可以被继承,表 3 是一个可继承的元素列表。

表 3. 可继承元素列表 名称 描述 groupId 项目组 ID version 项目版本 description 描述信息 organization 组织信息 inceptionYear 创始年份 url 项目的 url 地址 developers 开发者 contributors 贡献者信息 distributionManagerment 部署信息 issueManagement 缺陷跟踪系统 ciManagement 持续继承信息 scm 版本控制信息 mailingList 邮件列表信息 properties 自定义的属性 dependencies 依赖配置 dependencyManagement 依赖管理配置 repositories 仓库配置 build 源码目录,插件管理等配置 reporting 报告配置 Maven 属性 在 POM 文件中常常需要引用已定义的属性以降低代码的冗余,提高代码的可重用性,这样不仅能降低代码升级的工作量也能提高代码的正确率。有些属性是用户自定义的,有些属性是可以直接引用的已定义变量。

Maven 的可用属性类型可分为 5 种,它们分别是:

{settings.somename} 就可以得到文件里相应元素的值。 POM 属性。这种属性对应 POM 文件中对应元素的值,例如 project.groupId对应了<groupId></groupId>中的值,{project.groupId} 对应了 <groupId></groupId> 中的值,project.groupId对应了<groupId></groupId>中的值,{project.artifactId} 对应了 </ artifactId > 中的值。 系统环境变量。可以使用 env.

<properties>
  <path>../../sourcecode</path>
</properties>

Maven 3 的新特性

Maven 3 在性能和灵活性方面都比 Maven2 有了很大提升,它的新特性总结起来有以下几点:

  1. 兼容低版本 Maven,也就是向后兼容,因此用户可以将 Maven2 的项目移植到 Maven3 上来。
  2. 性能优化。CPU 利用率更高,内存消耗更小,经过优化的 Maven3 比 Maven2 构建速度快出 50% 以上,这对于构建大型项目的开发者来说无疑会节省大量的时间。
  3. 在早先的版本中,开发者必须在子模块中指定父版本,当进行代码的迁移或升级时,这会带来额外的维护工作,Maven3.1 将会消除在子模块上指定父版本的需要。

4.Maven3 改善了错误报告,它会在错误报告中提供指向 Maven Wiki 页面的链接,这样开发者可以方便的查看更全面的错误描述和可能的原因。

  1. 增加了 Maven Shell,通常我们可以在系统自带的 console 里执行 Maven 命令,但是通过自安装的 Maven Shell 可以提高生成速度,它是一个是 Maven 的命令行接口工具,可以缓存解析过的 POM,避免了重复调用 Maven 的启动成本。Maven Shell 不属于 Maven 发行包的一部分,需要单独下载。
  2. M2Eclipse 实现了 Maven 和 Eclipse 的集成,与一个使用更广泛的 IDE 进行集成从而为开发者带来的便利是不言而喻的。

结束语 Maven 有着许多实用的特点,它使用了标准的目录结构和部署。这就使得开发人员能够适应不同的项目,并且不用学习任何结构方面新的东西,也不用掌握特殊的指令来构建结构。当然,Maven 的使用还不够普及,相信随着时间的推移,它的功能会更完善,使用的人群也会越来越广泛。

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

我来说两句

0 条评论
登录 后参与评论

相关文章

  • 2018-09-04Q:求1+2+3+...+n,要求不能使用乘除法、for、while、if、else、switch、case等关键字及条件判断语句(A?B:C)。方法一:递归实现1+2+..+n;

    共同点:一,利用利用短路 && 来实现 if的功能;二,利用递归来实现循环while的功能

    JavaEdge
  • Java 编程思想第十二章 - 容器持有对象

    Java有多种方式保存对象的引用。例如数组,这种编译器支持的类型,是保存一组对象的最有效的方式,如果想要保存一组基本类型数据,也推荐使用数组。 但数组具有固定...

    JavaEdge
  • 小和问题1 最直接方法2 归并方法

    JavaEdge
  • 活久见!64 张图带你 Maven 实战通关

    通常 Web 项目 开发只会创建一个工程,然后所有的 jar 包都会存放到 WEB-INF/lib 目录下,如下图所示:

    cxuan
  • Maven3入门教程

    Maven是一个异常强大的构建工具,能够帮我们自动化构建过程,从清理、编译、测试到生成报告,再到打包和部署。通过Maven,我们只需要输入简单的命令(如mvn ...

    SmileNicky
  • Maven教程--快速入门

    最近一段时间准备整理下Maven相关的知识,受前面几次野心太大的教训,这次没写一篇就发一篇,不再一直憋着等到后面一起发布。本篇文章是一个使用入门的教程(至于安装...

    付威
  • Maven实践日记(一):本机的Maven环境配置

    Maven是apache的一个开源项目,它的出现影响着现在很多开源项目,并且很多软件公司的项目都采用Maven提倡的方式进行管理。

    用户1289394
  • Maven详解(一)------ Maven概述

    1、引言     你能搜到这个教程,说明你对 Maven 感兴趣,但是又不是太理解。那么接下来这个系列的教程将会详细讲解 Maven 的用法,相信你看完之后,...

    IT可乐
  • 大家都在用 Maven,但你知道它究竟是个啥么?

    Maven 是一个项目管理工具,包含了一个项目对象模型(Project Object Model),反应在配置中就是 pom.xml 文件。其中包含了一个项目的...

    村雨遥
  • Maven安装配置

    武培轩

扫码关注云+社区

领取腾讯云代金券