Maven 笔记

Maven 学习笔记

1      Maven基础介绍

1.1     使用archetype生成项目

archetype:美['ɑrkə'taɪp]原型

如果要快速生成原型，可以使用archetype生成项目。

mvn archetype:generate

1.2    maven坐标

Manven坐标包括：groupID,artifactId,version,packing,classifier

参考Artifact

1.3     依赖的范围

scope:依赖的范围

        compile     ：编译依赖范围。默认。编译、测试、运行都有效。

        test            : 测试依赖范围。测试时有效。

        provided   : 已提供依赖范围。编译、测试时有效。

        runtime      : 运行时依赖。测试、运行有效。

        system      : 系统依赖范围，同provided。配合systemPath使用，显示依赖文件的路径，不使用仓库，

而用本地绑定，不可移植。

                   import       :导入依赖范围。

           

1.4     依赖的分析

dependency:list / tree   可以查看依赖的信息

dependency:analyze     分析当前的依赖

 

2      Maven仓库的配置

 

2.1     仓库

仓库可以分为远程仓库，本地仓库。默认配置的情况下，当本地仓库没有构件的时候，就会尝试从中央仓库下载。（中央仓库是maven自带的远程仓库）。

私服是另外一种远程仓库，为了节省带宽和时间，局域网架设一个私服。用其代理外部的远程仓库。

除了中央仓库和私服，还有许多其他的公开的远程仓库。

 

                   修改maven仓库目录

                   修改maven安装目录/conf/settings.xml

                   <settings>

                            <localRepository>d:\myData\</ localRepository >

                   </…>

 

            远程仓库的配置：参考repositories

                  

其中releases和snapshots元素用来控制对于发布版和快照版的下载。

layout元素值default表示仓库的布局是Maven2及Manven3的默认布局，而非Maven1的布局。

2.2     远程仓库的配置

2.2.1        远程仓库的认证

远程仓库如果需要配置，可以在settings.xml中配置认证信息。

假设需要为一个id为my-proj的仓库配置认证信息，编辑settings.xml如下：

<settings>

         <servers>

                   <server>

                            <id>my-proj</id>

                       <username>xxx</username>

<password>xxx</password>

                   </server>

         </servers>

</settings>

                   server元素的id必须与pom需要认证的repository元素的id完全一致。

2.2.2        部署至远程仓库

日常开发中可以将构建，发布到私服，或者远程仓库。Maven可以将构建发布到远程仓库。pom修改如下：

配置distributionManagement

  <distributionManagement>

    <snapshotRepository>

      <id>repo-id</id>

      <name>my snapshot repository</name>

      <url>file:///path/to/snapshot/repo</url>

    </snapshotRepository>

    <repository>

      <id>repo-id2</id>

      <name>my repository</name>

      <url>file:///path/to/repo</url>

    </repository>

  </distributionManagement>

包含repository和snapshotRepository子元素,前者表示发布版本的仓库，后者表示快照的仓库。

往远程仓库部署构件的时候，往往需要认证，认证方式就是settings.xml创建一个元素。

配置成功后，可以使用mvn clean deploy发布。

2.3     镜像

如果仓库X可以提供Y的所有内容，那么可以认为X是Y的镜像。创建镜像的好处是，由于地理位置的因素，有些镜像比中央服务仓库的服务更快。配置如下

编辑settings.xml

<settings>

  ...

  <mirrors>

    <mirror>

      <id>maven.net.cn</id>

      <name>one of the central mirrors in china</name>

      <url>http://maven.net.cn/content/groups/public/</url>

      <mirrorOf>central</mirrorOf>

    </mirror>

  </mirrors>

  ...

</settings>

配置mirrorOf的值为central,表示该配置为中央仓库的配置。对于任何中央仓库的请求都会转至该镜像。

3       生命周期与插件

3.1     生命周期

Maven有三套独立的生命周期，clean、default、site。Clean的生命周期的目的是清理项目，default的生命周期的目的是构建项目，site的目的是建立项目站点。

每个生命周期包含一些阶段，这些阶段是有序的。Clean的阶段有pre-clean、clean、post-clean。当用户执行post-clean时，前面两个自动执行.

3.1.1       Clean生命周期

Clean生命周期一共包含了三个阶段：

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

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

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

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

3.1.2       default生命周期

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

·        validate

·        initialize

·        generate-sources

·        process-sources

·        generate-resources

·        process-resources     复制并处理资源文件，至目标目录，准备打包。

·        compile     编译项目的源代码。

·        process-classes

·        generate-test-sources

·        process-test-sources

·        generate-test-resources

·        process-test-resources     复制并处理资源文件，至目标测试目录。

·        test-compile     编译测试源代码。

·        process-test-classes

·        test     使用合适的单元测试框架运行测试。这些测试代码不会被打包或部署。

·        prepare-package

·        package     接受编译好的代码，打包成可发布的格式，如 JAR。

·        pre-integration-test

·        integration-test

·        post-integration-test

·        verify

·        install     将包安装至本地仓库，以让其它项目依赖。

·        deploy     将最终的包复制到远程的仓库，以让其它开发人员与项目共享。

基本上，根据名称我们就能猜出每个阶段的用途，关于其它阶段的解释，请参考

记住，运行任何一个阶段的时候，它前面的所有阶段都会被运行，这也就是为什么我们运行mvn install的时候，代码会被编译，测试，打包。

3.1.3       default生命周期

Site生命周期的各个阶段：

·        pre-site     执行一些需要在生成站点文档之前完成的工作

·        site    生成项目的站点文档

·        post-site     执行一些需要在生成站点文档之后完成的工作，并且为部署做准备

·        site-deploy     将生成的站点文档部署到特定的服务器上

这里经常用到的是site阶段和site-deploy阶段，用以生成和发布Maven站点，这可是Maven相当强大的功能，Manager比较喜欢，文档及统计数据自动生成，很好看。

3.2     插件目标

为了能够复用代码，往往能够完成多个任务，每个功能就是一个目标（goal）。比如dependency:analyze、dependency：tree。冒号前为插件前缀，冒号后面为插件的目标。

3.3     插件绑定

Maven的生命周期与插件相互绑定，完成实际的构建任务。生命周期的各个阶段与插件的目标相互绑定。例如编译这一任务，他对应了default生命周期的compile这一阶段，而maven-compiler-plugin这一插件的compile目标。

3.3.1        内置绑定

Maven为一些主要的生命周期阶段绑定了很多插件目标。比如：clean生命周期中的clean阶段，与maven-clean-plugin：clean绑定。如下图

3.3.2        自定义绑定

将某个插件的目标绑定到生命周期的某个阶段。

假设把maven-source-plugin插件的jar-no-fork目标绑定到default的verify阶段。(jar-no-fork主要用来创建项目的源码jar包)

在pom.xml的根元素下添加以下内容：

  <build>

         <plugins>

                   <plugin>

                            <groupId>org.apache.maven.plugins</groupId>

                            <artifactId>maven-source-plugin</artifactId>

                            <version>2.1.1</version>

                            <executions>

                                     <execution>

                                               <id>attach-sources</id>

                                               <phase>verify</phase>

                                               <goals>

                                                        <goal>jar-no-fork</goal>

                                               </goals>

                                     </execution>

                            </executions>

                   </plugin>

         </plugins>

   </build>

mvn clean install

从控制台输出可以看到在插件maven-jar-plugin插件执行jar目标后，紧接着执行verify阶段的jar-no-fork目标:

3.4     插件配置

完成了插件和生命周期的绑定之后，用户还可以配置插件目标的参数，调整插件目标所执行的任务。用户可以通过命令行和pom配置方式进行配置。

3.4.1        命令行插件配置

很多插件目标的参数都支持命令行配置，用户可以在命令行中使用-D参数，并伴随着一个参数键=参数值的形式。

Eg:maven-surefire-plugin提过了一个maven.test.skip参数，为true则跳过执行测试。

$  mvn install -Dmaven.test.skip=true

参数-D是java自带的，功能是通过命令行设置一个java系统属性，maven简单的重用了该参数。

3.4.2       POM中插件全局配置

用户可以在声明插件的时候，对插件进行一个全局的配置。不是所有参数都可以从命令行执行，有些参数在项目创建到项目发布也都不会改变，就可以在pom文件中一次性配置。比如java 1.5这个参数。

          <plugin>

              <groupId>org.apache.maven.plugins</groupId>

              <artifactId>maven-compiler-plugin</artifactId>

              <version>2.3.2</version>

              <configuration>

                  <source>1.6</source>

                  <target>1.6</target>

                  <encoding>UTF-8</encoding>

              </configuration>

           </plugin>

 

这样，不管绑定到compile阶段，还是绑定到test阶段，都可以用到该配置，仅于java1.6进行编译

3.4.3       POM中插件任务配置

以下配置可以让Maven在绑定的阶段执行任务。也可以绑定多个execetuion，让Maven在不同的生命周期执行不同的任务。
下例为ant脚本插件，用于执行ant命令，输出正在创建的目录，用于提示信息

<build>

         <plugins>