Maven介绍,包括作用、核心概念、用法、常用命令、扩展及配置

http://www.trinea.cn/android/maven/

两年半前写的关于Maven的介绍,现在看来都还是不错的,自己转下。写博客的一大好处就是方便自己以后查阅,自己总结的总是最靠谱的。

由浅入深,主要介绍maven的用途、核心概念(Pom、Repositories、Artifact、Build Lifecycle、Goal)、用法(Archetype意义及创建各种项目)、maven常用参数和命令以及简单故障排除、maven扩展(eclipse、cobertura、findbugs、插件开发)、maven配置。 较长,可根据个人需要有选择性的查看,比如先看用法再回过头来看核心概念

1、maven的用途 maven是一个项目构建和管理的工具,提供了帮助管理 构建、文档、报告、依赖、scms、发布、分发的方法。可以方便的编译代码、进行依赖管理、管理二进制库等等。 maven的好处在于可以将项目过程规范化、自动化、高效化以及强大的可扩展性 利用maven自身及其插件还可以获得代码检查报告、单元测试覆盖率、实现持续集成等等。

2、maven的核心概念介绍 2.1 Pom pom是指project object Model。pom是一个xml,在maven2里为pom.xml。是maven工作的基础,在执行task或者goal时,maven会去项目根目录下读取pom.xml获得需要的配置信息 pom文件中包含了项目的信息和maven build项目所需的配置信息,通常有项目信息(如版本、成员)、项目的依赖、插件和goal、build选项等等 pom是可以继承的,通常对于一个大型的项目或是多个module的情况,子模块的pom需要指定父模块的pom

pom文件中节点含义如下:

XHTML

123456789101112

project pom文件的顶级元素modelVersion 所使用的object model版本,为了确保稳定的使用,这个元素是强制性的。除非maven开发者升级模板,否则不需要修改groupId 是项目创建团体或组织的唯一标志符,通常是域名倒写,如groupId  org.apache.maven.plugins就是为所有maven插件预留的artifactId 是项目artifact唯一的基地址名packaging artifact打包的方式,如jar、war、ear等等。默认为jar。这个不仅表示项目最终产生何种后缀的文件,也表示build过程使用什么样的lifecycle。version artifact的版本,通常能看见为类似0.0.1-SNAPSHOT,其中SNAPSHOT表示项目开发中,为开发版本name 表示项目的展现名,在maven生成的文档中使用url表示项目的地址,在maven生成的文档中使用description 表示项目的描述,在maven生成的文档中使用dependencies 表示依赖,在子节点dependencies中添加具体依赖的groupId artifactId和versionbuild 表示build配置parent 表示父pom

其中groupId:artifactId:version唯一确定了一个artifact

2.2 Artifact 这个有点不好解释,大致说就是一个项目将要产生的文件,可以是jar文件,源文件,二进制文件,war文件,甚至是pom文件。每个artifact都由groupId:artifactId:version组成的标识符唯一识别。需要被使用(依赖)的artifact都要放在仓库(见Repository)中

2.3 Repositories Repositories是用来存储Artifact的。如果说我们的项目产生的Artifact是一个个小工具,那么Repositories就是一个仓库,里面有我们自己创建的工具,也可以储存别人造的工具,我们在项目中需要使用某种工具时,在pom中声明dependency,编译代码时就会根据dependency去下载工具(Artifact),供自己使用。 对于自己的项目完成后可以通过mvn install命令将项目放到仓库(Repositories)中 仓库分为本地仓库和远程仓库,远程仓库是指远程服务器上用于存储Artifact的仓库,本地仓库是指本机存储Artifact的仓库,对于windows机器本地仓库地址为系统用户的.m2/repository下面。 对于需要的依赖,在pom中添加dependency即可,可以在maven的仓库中搜索:http://mvnrepository.com/

2.4 Build Lifecycle 是指一个项目build的过程。maven的Build Lifecycle分为三种,分别为default(处理项目的部署)、clean(处理项目的清理)、site(处理项目的文档生成)。他们都包含不同的lifecycle。 Build Lifecycle是由phases构成的,下面重点介绍default Build Lifecycle几个重要的phase

Java

1 2 3 4 5 6 7 8

validate 验证项目是否正确以及必须的信息是否可用 compile 编译源代码 test 测试编译后的代码,即执行单元测试代码 package 打包编译后的代码,在target目录下生成package文件 integration-test 处理package以便需要时可以部署到集成测试环境 verify 检验package是否有效并且达到质量标准 install 安装package到本地仓库,方便本地其它项目使用 deploy 部署,拷贝最终的package到远程仓库和替他开发这或项目共享,在集成或发布环境完成

以上的phase是有序的(注意实际两个相邻phase之间还有其他phase被省略,完整phase见lifecycle),下面一个phase的执行必须在上一个phase完成后

若直接以某一个phase为goal,将先执行完它之前的phase,如mvn install 将会先validate、compile、test、package、integration-test、verify最后再执行install phase

2.5 Goal goal代表一个特定任务

Java

1

A goal represents a specific task (finer than a build phase) which contributes to the building and managing of a project.

mvn package表示打包的任务,通过上面的介绍我们知道,这个任务的执行会先执行package phase之前的phase mvn deploy表示部署的任务 mven clean install则表示先执行clean的phase(包含其他子phase),再执行install的phase。

3、maven用法 主要讲下Archetype以及几种常用项目的创建 maven创建项目是根据Archetype(原型)创建的。下面先介绍下Archetype 3.1 Archetype 原型对于项目的作用就相当于模具对于工具的作用,我们想做一个锤子,将铁水倒入模具成型后,稍加修改就可以了。 类似我们可以根据项目类型的需要使用不同的Archetype创建项目。通过Archetype我们可以快速标准的创建项目。利用Archetype创建完项目后都有标准的文件夹目录结构 既然Archetype相当于模具,那么当然可以自己再造模具了啊,创建Archetype 下面介绍利用maven自带的集中Archetype创建项目。创建项目的goal为mvn archetype:generate,并且指定archetypeArtifactId,其中archetypeArtifactId见maven自带的archetypeArtifactId

3.2 quick start工程 创建一个简单的quick start项目,指定 -DarchetypeArtifactId为maven-archetype-quickstart,如下命令 Xml代码 收藏代码 mvn archetype:generate -DgroupId=com.trinea.maven.test -DartifactId=maven-quickstart -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false 其中DgroupId指定groupId,DartifactId指定artifactId,DarchetypeArtifactId指定ArchetypeId, DinteractiveMode表示是否使用交互模式,交互模式会让用户填写版本信息之类的,非交互模式采用默认值 这样我们便建好了一个简单的maven项目,目录结构如下:

现在我们可以利用2.4的build Lifecycle进行一些操作,先命令行到工程根目录下 编译 mvn compile 打包 mvn package,此时target目录下会出现maven-quickstart-1.0-SNAPSHOT.jar文件,即为打包后文件 打包并安装到本地仓库mvn install,此时本机仓库会新增maven-quickstart-1.0-SNAPSHOT.jar文件。

3.3 web工程 创建一个简单的web项目,只需要修 -DarchetypeArtifactId为maven-archetype-webapp即可,如下命令

XHTML

1

mvn archetype:generate -DgroupId=com.trinea.maven.web.test -DartifactId=maven-web -DarchetypeArtifactId=maven-archetype-webapp -DinteractiveMode=false

其他:

src\main\resources文件夹是用来存放资源文件的,maven工程默认没有resources文件夹,如果我们需要用到类似log4j.properties这样的配置文件,就需要在src\main文件夹下新建resources文件夹,并将log4j.properties放入其中。 test需要用到资源文件,类似放到src\test下 对于apache的log4j没有log4j.properties文件或是目录错误,会报如下异常

XHTML

12

log4j:WARN No appenders could be found for logger (org.apache.commons.httpclient.HttpClient).log4j:WARN Please initialize the log4j system properly.

4、maven常用参数和命令 主要介绍maven常用参数和命令以及简单故障排除

4.1 mvn常用参数 mvn -e 显示详细错误 mvn -U 强制更新snapshot类型的插件或依赖库(否则maven一天只会更新一次snapshot依赖) mvn -o 运行offline模式,不联网更新依赖 mvn -N仅在当前项目模块执行命令,关闭reactor mvn -pl module_name在指定模块上执行命令 mvn -ff 在递归执行命令过程中,一旦发生错误就直接退出 mvn -Dxxx=yyy指定java全局属性 mvn -Pxxx引用profile xxx

4.2 首先是2.4 Build Lifecycle中介绍的命令 mvn test-compile 编译测试代码 mvn test 运行程序中的单元测试

mvn compile 编译项目 mvn package 打包,此时target目录下会出现maven-quickstart-1.0-SNAPSHOT.jar文件,即为打包后文件 mvn install 打包并安装到本地仓库,此时本机仓库会新增maven-quickstart-1.0-SNAPSHOT.jar文件。 每个phase都可以作为goal,也可以联合,如之前介绍的mvn clean install

4.3 maven 日用三板斧 mvn archetype:generate 创建maven项目 mvn package 打包,上面已经介绍过了 mvn package -Prelease打包,并生成部署用的包,比如deploy/*.tgz mvn install 打包并安装到本地库 mvn eclipse:eclipse 生成eclipse项目文件 mvn eclipse:clean 清除eclipse项目文件 mvn site 生成项目相关信息的网站

4.4 maven插件常用参数 mvn -Dwtpversion=2.0 指定maven版本 mvn -Dmaven.test.skip=true 如果命令包含了test phase,则忽略单元测试 mvn -DuserProp=filePath 指定用户自定义配置文件位置 mvn -DdownloadSources=true -Declipse.addVersionToProjectName=true eclipse:eclipse 生成eclipse项目文件,尝试从仓库下载源代码,并且生成的项目包含模块版本(注意如果使用公用POM,上述的开关缺省已打开)

4.5 maven简单故障排除

mvn -Dsurefire.useFile=false如果执行单元测试出错,用该命令可以在console输出失败的单元测试及相关信息 set MAVEN_OPTS=-Xmx512m -XX:MaxPermSize=256m 调大jvm内存和持久代,maven/jvm out of memory error mvn -X maven log level设定为debug在运行 mvndebug 运行jpda允许remote debug mvn –help 这个就不说了。。

5、maven扩展 maven常用插件配置和使用

6、maven配置 为了修改maven创建项目默认以来的jdk版本,看了下maven配置 maven2.0默认使用jdk1.5导致反省、@override 等annotation不可用。可用两种方法修改jdk版本 第一种:修改项目的pom.xml,影响单个项目,治标不治本

XHTML

1 2 3 4 5 6 7 8 9 10 11 12 13

<build>     <plugins>         <plugin>             <groupId>org.apache.maven.plugins</groupId>             <artifactId>maven-compiler-plugin</artifactId>             <configuration>                 <source>1.6</source>                 <target>1.6</target>                 <encoding>UTF-8</encoding>             </configuration>         </plugin>     </plugins> </build>

pom中增加build配置,指定java版本为1.6 第二种:修改maven配置,影响maven建立的所有项目 到maven安装目录的conf文件夹下,修改settings.xml文件,如下:

Java

1 2 3 4 5 6 7 8 9 10 11 12 13 14

<profiles>       <profile>           <id>jdk-1.6</id>             <activation>               <activeByDefault>true</activeByDefault>               <jdk>1.6</jdk>             </activation>             <properties>               <maven.compiler.source>1.6</maven.compiler.source>               <maven.compiler.target>1.6</maven.compiler.target>               <maven.compiler.compilerVersion>1.6</maven.compiler.compilerVersion>             </properties>           </profile>       </profiles>

这样便能对所有默认的maven项目指定jdk为1.6

到此为止,休息会儿

参考资料: Maven官方文档:http://maven.apache.org/guides/index.html maven安装:http://maven.apache.org/download.html

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

发表于

我来说两句

0 条评论
登录 后参与评论

相关文章

来自专栏前端萌媛的成长之路

浅谈前端安全

1.7K20
来自专栏程序员同行者

构建NTP时间服务器

30120
来自专栏云计算教程系列

如何在服务器上安装LAMP

在本教程中,我们将在Ubuntu上安装LAMP。Ubuntu将满足我们的第一个要求:Linux操作系统。没有服务器的同学可以在这里购买,不过我个人更推荐您使用免...

55620
来自专栏云计算教程系列

如何在Ubuntu 16.04上使用Deployer自动部署Laravel应用程序

Laravel是一个开源的PHP Web框架,旨在使常见的Web开发任务(如身份验证,路由和缓存)变得更加容易。Deployer是一个开源的PHP部署工具,为许...

38310
来自专栏Golang语言社区

HTTP协议漫谈

简介 园子里已经有不少介绍HTTP的的好文章。对HTTP的一些细节介绍的比较好,所以本篇文章不会对HTTP的细节进行深究,而是从够高和更结构化的角度将H...

39260
来自专栏java学习

maven常用命令集合(收藏大全)

如果你是初学者,或者是自学者!你可以加小编微信(xxf960326)!小编可以给你学习上,工作上的一些建议以及可以给你(免费)提供学习资料!最重要我们还可以交个...

10810
来自专栏北京马哥教育

【Python】windows下Eclipse中安装集成webpy框架

作者:JueDream 来源:http://blog.csdn.net/qq_35731570/article/details/62221021?locatio...

32790
来自专栏用户2442861的专栏

每天一个linux命令(61):wget命令

http://www.cnblogs.com/peida/archive/2013/03/18/2965369.html

23220
来自专栏Golang语言社区

HTTP协议漫谈

简介 园子里已经有不少介绍HTTP的的好文章。对HTTP的一些细节介绍的比较好,所以本篇文章不会对HTTP的细节进行深究,而是从够高和更结构化的角度将H...

370130
来自专栏云计算教程系列

如何在Ubuntu 14.04上使用Pydio托管文件共享服务器

随着云的采用增加,越来越多的数据被远程存储。从音乐到图片再到个人文档,很多人都将文件上传到他们不管理的服务器上。如果您希望将文件保存在您控制的服务器上,则可以使...

40300

扫码关注云+社区

领取腾讯云代金券