Maven指南(一) - 两小时从零到了解

目录导航,方便大家选择性查看

1 Maven 介绍


是什么

Maven是一个项目管理工具,它包含一个目标对象模型POM(project Object Model),一个项目生命周期(Project Lifecycle),一个依赖管理系统(Dependency Management System)和用来运行定义在生命周期阶段中插件目标的逻辑。

约定优于配置

约定优于配置是一个简单的概念,系统、类库、框架给定一个合理的默认值。Maven通过给项目提供默认行为来融合这一概念,在没有自定义的情况下

  • 源代码放在:workspace/src/main/java
  • 资源文件放在:workspace/src/main/resources
  • 测试代码放在:workspace/src/test
  • 字节码文件放在:workspace/target/classes
  • 可发行的jar包放在:workspace/target

Maven和Ant的区别

Apache Ant

  • Ant 没有正式的约定一个项目的目录结构,你必须明确的告诉Ant哪里放源码,哪里放字节码等。
  • Ant 是程序化的,你必须告诉 Ant 做什么,什么时候做。
  • Ant 没有生命周期,你必须定义目标和目标之间的依赖。

Apache Maven

  • Maven 拥有约定,遵守了约定, Maven 就知道你的源代码放在了哪里。
  • Maven 是声明式的。你只需要创建一个 pom.xml 文件并将其放在默认的目录下, Maven 就会帮你干其他的事了。
  • Maven 拥有生命周期,当你运行相应的命令后就会被调用,这条命令会告诉 Maven 执行一系列的有序步骤, 直到达到指定的生命周期。

2 Maven 安装


Maven安装

安装自行解决😁,有问题下方留言

安装及环境变量设置成功显示

  • java -version
  • mvn -v
环境变量设置成功

Maven目录及配置说明

我们先打开安装好的 Maven目录看看。

maven 目录

其中:

  • bin目录:包含了运行 Maven 的一些脚本。
  • boot目录:包含了一个负责创建 Maven 运行所需要的类加载器的 jar 文件 。
  • conf目录:包含了一个全局的 settings.xml 文件,该配置文件用来自定义你电脑上的 Maven 的行为。如果我们要自定义 Maven,我们通常会将该配置文件覆盖掉 ~/.m2目录下的 settings.xml 文件。
  • lib目录:包含了 Maven的核心jar包。
  • LICENSE:包含了 Apache Maven 的软件许可证。
  • NOTICE:包含了 Maven 依赖的类库所需要的通告及权限。
  • README.txt:包含了一些安装指令

接着我们再来看看本地的 Maven 仓库,进入~/.m2目录

本地 maven 仓库

其中:

  • settings.xml:包含了用户的相关凭证,仓库和其它信息的配置。
  • repository目录:本地仓库,当从maven远程仓库下载jar依赖的时候,会自动下载到该目录下。

3 第一个demo


当我们把maven环境搭建好之后,我们来创建一个maven项目。

1) 创建 maven 项目

mvn archetype:create 
                -DgroupId=org.sonatype.mavenbook.ch03 //项目id
                -DartifactId=demo //项目名
                -DpackageName=com.acey.demo  //包的目录结构

注意

  • 第一次创建maven项目会自动下载很多jar包。
  • 如果你的 maven 版本是
  • 2.x,使用命令mvn archetype:create创建maven项目
  • 3.x,使用命令mvn archetype:generate创建maven项目
  • 如果运行上面的命令出现卡死
    卡死

    那么需要加上参数-DarchetypeCatalog=internal,让maven 不要从远程服务器上获取catalog。
mvn archetype:generate
                -DgroupId=org.sonatype.mavenbook.ch03 //项目id
                -DartifactId=demo //项目名
                -DpackageName=com.acey.demo  //包的目录结构
                -DarchetypeCatalog=internal

一切顺利的话,我们便可以在当前目录下找到我们创建的 maven 项目了,打开后可以看到项目的目录结构。


demo 目录结构

2)mvn install

在项目跟路经下执行 mvn install命令

mvn install
install 步骤

可以先看下整个执行步骤,详情会在后面的 maven 生命周期中详细介绍。

3)运行

java -cp target/demo-1.0-SNAPSHOT.jar com.acey.demo.App
结果

4 核心概念


1)Maven 插件和目标(Plugins and Goals)

一个 Maven 插件(plugin)是一个或多个目标(goal)的集合。而一个目标是 Maven 中的一个工作单元(unit of work),他可以作为以个单独的目标运行,也可以作为一个大的构建的一部分和其它目标一起运行。用以下格式表示:

pluginId:goalId

在我们构建 Maven 项目时,我们便用到了archetype插件和generate目标。当然目标也是可以定义一些参数。

mvn archetype(插件):generate(目标)
                -DgroupId=org.sonatype.mavenbook.ch03 //目标参数
                -DartifactId=demo //目标参数
                -DpackageName=com.acey.demo  //目标参数
                -DarchetypeCatalog=internal //目标参数

2)生命周期(Lifecycle)

Maven有三套相互独立的生命周期

  • Clean Lifecycle:在真正的构建之前进行项目的清理工作
  • Default Lifecycle:构建的核心部分,包含编译、测试、打包、部署等。
  • Site Lifecycle:生成项目报告,站点,发布站点。

其中:
Default Lifecycle包含了一系列阶段的序列。

一系列阶段的序列

插件目标也是可以附着在生命周期上的,它会随着生命周期的移动,执行附着在不同生命周期上的目标。每个阶段上附着的零个或多个目标。例如:放我们执行 mvn package时,我们会发现它会默认的执行该生命周期前的生命周期所对应的目标,当达到目标生命周期(package)时,会执行附着在package上的jar:jar进行打包。

mvn package

我们再来看看每个周期所对应的目标

周期对应目标

mvn package 会自动执行它前面周期所对应的目标,然后打包
mvn jar:jar 只会打包


Clean Lifecycle一共包含三个阶段

  • pre-clean:执行一些需要在 clean 之前完成的任务
  • clean:移除所有上次构建所生成的文件
  • post-clean:执行一些需要在 clean 之后完成的任务

Site Lifecycle一共包含了四个阶段

  • pre-site:执行了一些需要在生成报告站点之前完成的工作
  • site:生成项目的站点文档
  • post-site:执行一些需要在生成报告站点之后完成的任务
  • site-deploy:将生成的站点文档部署到远程服务器

当我们执行mvn site后,我们会发现我们的 target 目录下会生成一个 site 目录,里面包含了项目的各种报告。

mvn site

3)Maven 坐标(Coordinates)

Maven坐标定义了一组标识,它可以用来唯一标识一个项目,一个依赖,或者是一个POM里面的插件。我们先来看一个简单的POM。

pom

其中 groupIdartfiactIdversionpackaging共同组成了项目的坐标,Maven通过一个坐标来定位一个项目,Maven 坐标一般会用冒号作为分隔符来书写。

groupId:artifactId:packaging:version

在上图的项目坐标就可以表示为:

testdemo:demo:jar:1.0-SNAPSHOT

当然这个符号也应用于项目依赖,上图项目中依赖了 JUnit的3.8.1版本,那么它就包含了一个junit:junit:jar:3.8.1的依赖。

  • groupId:表示一个团体标识,它一般以创建这个项目的组织名称的逆向域名(version domain name)开头。比如 Apache Software 就以·org.apache·作为 groupId。
  • artifactId:在 groupId 下的表示一个单独项目的唯一标识,一般为项目名。
  • version:一个项目的特定版本。如果是正在开发中的项目那么一般会加上一个特殊的标识,在版本号前加上 “SNAPSHOT"的标记。
  • package:项目的类型,默认为jar,描述了项目打包后的输出格式。也可以打包成一个 war。

4)Maven 仓库(Repositories)

当我们在运行 Maven 项目的时候,Maven 会从 pom.xml 中查找已配置的插件坐标,然后在本地仓库中查找是否有对应的插件,如果没有那么就会从 Maven 自带的远程仓库http://repo1.maven.org/maven2 中下载所需要的插件缓存到本地仓库。本地仓库的默认地址:

  • window中:* C:\Users\USERNAME.m2\repository*
  • linux中:~/.m2/repository

如果我们有需要的话也是可以修改本地仓库的地址

  • 更改配置用户范围的本地仓库:
  • 在 /.m2/ 目录下创建一个setting.xml或者将M2_HOME/conf/settings.xml拷过来
  • 在 setting.xml 中添加以下节点。
<settings>  
    <localRepository>新的仓库地址</localRepository>  
</settings> 
  • 更改配置全局范围的本地仓库
  • 直接在M2_HOME/conf/settings.xml添加以下节点
<settings>  
    <localRepository>新的仓库地址</localRepository>  
</settings> 

当 Maven升级后,所有的配置都将会被清除,所以一般不推荐修改全局的配置


Maven插件存储结构

在我们打开本地仓库(repository) 后,我们会看到很多的插件,Maven 仓库会按以下目录格式来存储插件。

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

比如 c3p0-0.9.1.2.jar的存储方式

c3p0

当我们用mvn install对项目进行install时,Maven 也会按上述的格式将所生成的jar/war包保存在仓库中作为依赖插件。

5)Maven 依赖管理(Dependency Management)

所谓依赖就是项目中使用了一些插件,当我们需要运行项目时,我们必须将相应的插件加进来。而 Maven 依赖管理则是将所需要的插件下载到本地仓库,当我们需要使用插件时,只需要在 pom.xml 中去配置相关的依赖即可。

pom.xml

可以看到我们需要加一个依赖也是很简单,只需要在 pom.xml 中在 dependencies 下加一个 dependency 即可,其中 groupIdartifactIdversion决定了 junit的坐标,而 scope 则表示junit的作用范围,test 表示只有项目在执行 compiler:testCompilesurefire:test目标的时候才会被加入到 classpath中。

几个 scope 范围

  • compile,缺省值,适用于所有阶段,会随着项目一起发布。
  • provided,类似compile,期望JDK、容器或使用者会提供这个依赖。如servlet.jar。
  • runtime,只在运行时使用,如JDBC驱动,适用运行和测试阶段。
  • test,只在测试时使用,用于编译和运行测试代码。不会随项目发布。
  • system,类似provided,需要显式提供包含依赖的jar,Maven不会在Repository中查找它。

Maven 的基础概念就差不多啦,大家有疑问的话可以在下方留言哦。😀
下一篇会讲讲实战和更深层次的内容。
(❤ ω ❤)喜欢的话点个❤呗。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 203,547评论 6 477
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,399评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,428评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,599评论 1 274
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,612评论 5 365
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,577评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,941评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,603评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,852评论 1 297
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,605评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,693评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,375评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,955评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,936评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,172评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 43,970评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,414评论 2 342

推荐阅读更多精彩内容