maven学习--基础篇

2016-01-5 16:13:43

 发现一些错误,文章修改中……

(部分图片截取自其他地方,不是很清楚)

一、 maven的项目创建和基本命令

maven是一个项目管理工具,包含了一个项目对象模型POM,一组标准集合,一个项目生命周期,一个依赖管理系统,和用来运行定义在生命周期阶段中插件目标的逻辑。

maven遵循约定由于配置的原则,是指maven虽然支持配置方式,但如果有约定好的默认值,比如约定好的目录结构,就使用约定的。

maven的安装不再介绍,验证maven是否安装成功:

  

安装成功后,maven下有四个目录:

bin:包含运行命令mvn、mvnDebug等,既有在windows下运行的,也有在linux/unix下运行的;

boot:有maven自己开发的类加载器;

lib:maven运行所需要的一些jar包,刚安装maven时,它其实是非常小的,它只安装了自己必须的jar包。对于以后在工作中所需要的插件、jar包,他会根据你的需要不断的进行下载。

conf:配置文件setting.xml,如果在里面改变配置参数的话,它会对所有的系统用户都生效,但我们通常并不希望这件事情发生,我们希望配置只对当前用户生效,所以通常会把settings.xml粘贴到到c盘的.m2下。

 具体的项目创建:

博客http://blog.csdn.net/edward0830ly/article/details/8748986中介绍的很清楚

常用的命令:

mvn compile :会对src/main目录底下的资源和类进行编译处理,src/main/resources目录中的所有文件及子目录,会复制到target/classes目录中,为以后的打包提供了方便。

mvn test-compile :只对测试目录底下的类和资源进行处理,但因为测试依赖于main下面的资源和类,所以会先对这些进行处理。src/test/resources目录中的所有文件及子目录,会复制到target/test-classes目录中,为后续的测试做准备。

mvn test : 执行测试的一个命令,默认情况是把工程所有的testcase都执行一遍。如果需要执行某一个 testcase类,可以通过-Dtest参数。

mvn clean  :把target目录给清理掉了,很多缓存输出在target文件夹中。

(mvn claen instal l可以避免一些错误的发生,如果不执行clean,而直接install的话,其过程中生成的如.class文件就会覆盖原来的文件,这在一般情况下是没有问题的。但是,比如你在源文件删除了一个java,结果没有clean,则它依然存在与target中,可能会对最终的结果造成影响。)

mvn package :在target目录下打包;

mvn exec:可以执行项目中的main函数。

(二)maven的生命周期

http://juvenshun.iteye.com/blog/213959

Maven有三套相互独立的生命周期,请注意这里说的是“三套”,而且“相互独立”,初学者容易将Maven的生命周期看成一个整体,其实不然。这三套生命周期分别是:

Clean Lifecycle 在进行真正的构建之前进行一些清理工作;

Default Lifecycle 构建的核心部分,编译,测试,打包,部署等等;

Site Lifecycle 生成项目报告,站点,发布站点。

我再次强调一下它们是相互独立的,你可以仅仅调用clean来清理工作目录,仅仅调用site来生成站点。当然你也可以直接运行 mvn clean install site 运行所有这三套生命周期。

每套生命周期都由一组阶段(Phase)组成,mvn clean ,这个clean是Clean生命周期的一个阶段。Clean生命周期一共包含了三个阶段:

pre-clean  执行一些需要在clean之前完成的工作;

clean  移除所有上一次构建生成的文件;

post-clean  执行一些需要在clean之后立刻完成的工作。

注意:

      在一个生命周期中,运行某个阶段的时候,它之前的所有阶段都会被运行,也就是说,mvn clean 等同于 mvn pre-clean clean ,如果我们运行 mvn post-clean ,那么 pre-clean,clean 都会被运行。这是Maven很重要的一个规则,可以大大简化命令行的输入。

Site生命周期的各个阶段:

  • pre-site     执行一些需要在生成站点文档之前完成的工作
  • site    生成项目的站点文档
  • post-site     执行一些需要在生成站点文档之后完成的工作,并且为部署做准备
  • site-deploy     将生成的站点文档部署到特定的服务器上

对于Maven的最重要的Default生命周期,绝大部分工作都发生在这个生命周期中,这里,只解释一些比较重要和常用的阶段:

  • process-resources     复制并处理资源文件,至target目标目录,准备打包。
  • compile     编译项目的源代码。
  • process-test-resources     复制并处理资源文件,至target目标测试目录。
  • test-compile     编译测试源代码。
  • test     使用合适的单元测试框架运行测试。这些测试代码不会被打包或部署。
  • package     接受编译好的代码,打包成可发布的格式,如 JAR 。
  • install     将包安装至本地仓库,以让其它项目依赖。
  • deploy     将最终的包复制到远程的仓库,以让其它开发人员与项目共享。 

(三)POM (project object model)

Pom其实就是一个xml文件,写在节点<project></project>里面

<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-4.0.0.xsd">
  <modelVersion>4.0.0</modelVersion>

  <groupId>com.test.maven</groupId>
  <artifactId>test1</artifactId>
  <version>0.0.1-SNAPSHOT</version>
  <packaging>jar</packaging>

  <name>test1</name>
  <url>http://maven.apache.org</url>

  <properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
  </properties>

  <dependencies>
    <dependency>
      <groupId>junit</groupId>
      <artifactId>junit</artifactId>
      <version>3.8.1</version>
      <scope>test</scope>
    </dependency>
  </dependencies>
</project>

其中,modelVersion:maven的默认版本

groupId:创建组织的标识符,一般是域名的倒写

artifactId:定义了项目在所属组织下的唯一标识,一个组织下可以有多个项目

version:当前项目的版本,SNAPSHOT,表示是快照版本,在开发中

url:这个项目所在的网页地址

properties:指定这个工程在创建或编译的时候所使用的编码格式

dependencies:这里添加了对junit的依赖

scope:确定junit在什么范围内生效。

      complie:默认使用该依赖,对编译、测试、运行三种classpath都有效;

      test:只对测试时有效,如这里的junit;

      provided:在运行时无效,对编译和测试有效,如servlet-api;

      runtime:如jdbc,对测试和运行有效,在编译时无效。

除了在上述pom.xml中配置依赖,使需要的jar包加载到本地仓库中,还可以手动加载,使用前面提过的mvn install命令,下面的例子可以参考

(四)在Eclipse中的应用

将上述POM文件中提到的test1导入到eclipse里:

首先执行命令mvn eclipse:eclipse ,生成 Eclipse 项目文件。将test1转成一个eclipse工程后,我们会发现test1里多了两个文件,一个是.classpath文件,一个是.project文件;

然后在eclipse中导入项目,file—import—exsiting……。

成功将test1导入eclipse后,如果想在这个工程中继续添加对其他的包的依赖,直接打开pom.xml文件进行编辑即可。但如果想删除某一依赖的话,因为在做mvn eclipse:eclipse时都已经添加到classpath中去了,需要在修改pom.xml文件后,再在eclipse中刷新一下,这样工程对包的依赖就改变了。

mvn eclipse:clean  删除增加的.classspath和.project文件,即清除掉eclipse的一些系统设置。

如果开发工具是intelliJ,使用mvn idea:idea,将工程改造成intellij工程。同样的可以使用 mvn idea:clean 来把这个intelliJ工程的信息给删除掉。

(五)maven本地仓库转移

本地仓库repository放在c盘其实是不太好的,因为如果要重新安装操作系统的话,仓库就会被格式化掉。

完成仓库的转移:

1、拷贝repository到其他盘下,如D盘;

2、打开.m2下的setting.xml文件(从maven的conf目录下拷贝过去的),找到

 <!-- localRepository
   | The path to the local repository maven will use to store artifacts.
   |
   | Default: ${user.home}/.m2/repository
  <localRepository>/path/to/local/repo</localRepository>
  -->

删除注释,改为<localRepository>D: epository</localRepository>

(六)maven插件 

在eclipse上安装maven插件,windows—preference-maven-installation中默认的maven是embedded的,

如果想使用本地maven的话,需要add添加进来。还要注意user settings的文件 ,这里使用的是.m2目录下的settings.xml。

在修改setting后,一定要update setting,并reindex,否则eclipse无法知道对maven的更改,这样在eclipse中使用maven插件会出问题的。

在pom中,可能会有提示功能,例如输入一个尖括号<,会自动出现可以匹配的文本,这是。因为maven插件安装时在xml catalog中加载进了maven 的xml catalog ,如下 

(七)超级pom

如果工程需要对spring-beans这个包添加依赖,但本地仓库中没有这个jar包,我们执行编译等命令时可能并没有错误,因为它自动从一个位置下载下来了。

Maven怎么知道从哪下载jar包呢,因为maven有一个超级pom,这个pom是所有pom的父pom。

找到maven的安装目录,在lib底下有这么一个jar包 

打开这个包,可以看到pom-4.0.0.xml 

在这个文件里就规定了默认仓库的位置的,规定了java工程的目录结构,规定了plugin核心插件的版本(因为要保证maven3.3正常运行,就要保证这些插件的版本和它是匹配的)等等。

最后生效的超级pom和自定义pom叠加产生的有效的pom,即effctive pom,它的内容比我们自定义的pom多的多。

执行命令mvn help:effective-pom可以在命令行中查看effective pom,也可以很方便的在eclipse中查看,下面以hello-world工程为例进行展示:

 

里面有repositories和PluginRepositories,你还可以在pom中添加自己的repository,将它放在中央仓库的上面。

下面是build构建,这是maven最核心的部分了,

其中包括源代码的目录,测试源代码的目录,输出目录、资源文件的目录等,我们的工程结构就是来自于这个地方。

如何将一个已有的项目(其工程结构并不符合maven工程要求)纳入到maven管理中去呢?显然,移动相应的类、包使他符合maven工程的结构并不现实,一个有效的方法就是自定义pom文件。

再下面是<PluginManagement>,PluginManagement表示插件声明,即你在项目中的PluginManagement下声明了插件,maven不会加载该插件,pluginManagement声明可以被继承。
一个使用案例是当有父子项目的时候,父项目中可以利用PluginManagement声明子项目中需要用到的插件。之后,当子项目需要加载该插件的时候,就可以在子项目中plugins节点只配置 groupId 和 artifactId就可以完成插件的引用。
pluginManagement主要是为了统一管理插件,确保所有子项目使用的插件版本保持一致,类似的还是dependencies和dependencyManagement。 

 

…… 

<plugins>中的plugin是给当前工程用的,是当前工程即将要使用到的plugin,会告诉你使用的是哪一个plugin,版本是多少以及要执行的阶段、目标。

原文地址:https://www.cnblogs.com/kanhaiba/p/5104150.html