通过nexus了解maven及其生命周期

前言

感谢以下博文作者为我的学习提供了帮助：
maven生命周期介绍：
http://juvenshun.iteye.com/blog/213959

Nexus私服安装：
私服的安装步骤网上有很多，我主要参考了这一篇，我感觉这个步骤和我真实的安装情况比较符合。我会在下面对这篇博文做点补充，标注一些我安装过程中遇到的问题，供参考。
http://blog.csdn.net/shenshen123jun/article/details/9084293

具体下载不多说了，我只简单讲一下安装步骤，详细步骤参考上面提到的博文，可以两篇博文对比着看，相互补充。

nexus安装

安装nexus

用cmd进入nexus安装程序的bin目录，输入【nexus.bat install】安装nexus

开启nexus服务

运行框输入services.msc，找到“nexus”启动服务

登录nexus

nexus默认8081端口，管理员用户名admin 密码admin123
浏览器输入localhost:8081/nexus，打开nexus页面

配置nexus依赖下载功能

为了让项目能够从我们安装的nexus下载jar，我们需要下载对应仓库的索引

打开仓库管理界面

展开左边菜单栏“Views/Repositories”点击“Repositories”，右边会出现仓库的列表

开启仓库索引的自动下载

仓库的具体功能和作用参见上面的博文，开启索引以后就可以在这个nexus中搜索maven的依赖了。
具体方法：
分别点击三个“type”为“proxy”仓库：“Apache Snapshots”、“Central”、“Codehaus Snapshots”，找到它们下面的“Configuration”中的“Download Remote Indexes”分别改成True并点击“save”保存；

这时，可以在左侧菜单“Administration”中打开“Scheduled Task”，可以看见有一个正在进行的任务，就是正在下载索引了。

注：如果设置了true以后“Scheduled Task”中没有看到下载任务，可以把true改为false保存后重新改为true再保存试试看。我安装时候就没有，找了半天不知道原因，最后是这么解决的。

下载完成后就在左边的“Artifact Search”上面的搜索框中输入spring等关键字就可以搜索到spring相关的依赖了。

这时，我们的maven项目还不会从nexus私服下载jar，因为它还不知道从哪下载。我们需要进行配置，总共有两种方式：
1、仅让我们开发的项目从nexus私服下载依赖；
2、让所有项目都从私服下载依赖。

仅让当前项目从私服下载依赖

第一种方案的配置是在我们项目的pom.xml中加入如下配置：

<repositories>  
        <repository>  
            <id>nexus</id>  
            <name>nexus</name>  
            <url>http://127.0.0.1:8081/nexus/content/groups/public/</url>  
            <releases>  
                <enabled>true</enabled>  
            </releases>  
            <snapshots>  
                <enabled>true</enabled>  
            </snapshots>  
        </repository>  
    </repositories>  

这样，我们的项目就会从本地的nexus下载jar了

让所有项目都从私服下载依赖

第二种配置方法需要修改maven的配置文件，打开conf下的setting.xml，在profiles节点之间加入如下配置：

<profile>
            <!--这里可以不加id，而是将下面的activation设为true-->
            <id>central</id>
            <activation>
            <!--如果这里是false，那么就需要再加上下一个步骤activeProfiles的配置，且上面的这个id要和activeProfile的名称相同-->
                <activeByDefault>true</activeByDefault>
            </activation>
            <repositories>
                <repository>
                    <id>public</id>
                    <name>public repository group </name>
                    <url>http://localhost:8081/nexus/content/groups/public/</url>
                    <layout>default</layout>
                    <releases>
                        <enabled>true</enabled>
                        <updatePolicy>always</updatePolicy>
                    </releases>
                    <snapshots>
                        <enabled>false</enabled>
                        <updatePolicy>always</updatePolicy>
                    </snapshots>
                </repository>
            </repositories>
        </profile>

如果上面的activation不是true，则需要加入下列配置激活profile，在setting里面加入：

 <activeProfiles>
        <!--注意这里的“central”一定要和上面的profile的id相同-->
        <activeProfile>central</activeProfile>
    </activeProfiles>

注：总结一下上面的配置，加入profile是为了指定私服的下载地址，默认activation为false，为了激活私服下载地址配置的profile需要加上profile的activation配置。
配置方法又有两种：
一种是在profile配置中直接加上activeByDefault为true的配置，即直接加activeByDefault；
另一种是在setting中加入activeProfile，activeProfile之间的名称需要和profile的id相同，即：id+activeProfiles。
如果这里配置错误，项目将不会从nexus私服下载依赖，千万注意！！！

测试是否从nexus私服下载jar

你可以测试看看，如果不行那就说明上面的配置没成功。
我这里有个方法，可能不太好，不过能测试就行：
1、先删除本地maven仓库中的jar包，注意这里是maven仓库就是你项目jar下载的地方，一般是xxx.m2\repository比如我电脑的E:\maven.m2\repository\org\springframework。
我删除了spring-core目录。
2、删除掉以后，刷新项目依赖，maven就会找本地nexus下载jar，因为本地还没有jar，所以nexus会到网上找公共仓库下载，等下载完了以后，本地仓库就有jar了。
3、这时候你再删除这个spring-core，项目就会再次找不到依赖，这时候，你断开网络，刷新项目的maven依赖，它就会再去找nexus私服下载，因为我们断开了网络，所以jar不可能是从互联网的公共仓库下载的，并且之前下载过这个spring-core，所以这次就算没有连网，也是可以通过nexus仓库将jar下载到本地maven仓库的

注：不知道是因为我英语不好还是什么原因，我没搞懂public Repositories（就是仓库列表最上面哪个type为group的仓库）里面configuration的一个配置项的含义，导致遇到了另外的问题：
打开public Repositories的配置窗口configuration，里面有两个列表：ordered group Repositories 和 avaliable Repositories。
左边的这个ordered xxx（排好序的仓库）实际上是生效的仓库名称而右边的avaliable xxx（可用仓库）是未生效的 ，我一直以为把仓库放在avaliable才可以通过public Repositories 这个仓库下载jar，导致我找了好久原因。所以，如果你想要使用nexus下载依赖的功能千万要注意把仓库加到左边的ordered里面，别想我一样，随手一点让自己多走了很多弯路。我看了nexus的介绍，说是这里会根据ordered顺序优先选择前面的仓库来下载jar。详细的知识再深入学习把。

至此，下载依赖的nexus私服就好了，但是我们还想将自己的项目发布到私服上，所以还有下面的配置

配置nexus的发布功能

我暂且不严谨地将项目的发布分为两种：一种是将oracle驱动、baidu、alibaba等类型的第三方jar上传到nexus；另一种是通过IDE将自己开发的项目发布到nexus。

上传jar包

上传很简单，没什么复杂的，可以参考这篇博文：http://blog.csdn.net/shenshen123jun/article/details/9084293
我就不多介绍了，就是找到hosted仓库上传jar，填写依赖的配置信息即可。这里的上传尽量规范，比如spring-core的artifact信息如下：

<dependency>
  <groupId>org.springframework</groupId>
  <artifactId>spring-core</artifactId>
  <version>4.0.2.RELEASE</version>
</dependency>

否则很多人上传同一个jar的时候会让开发人员不知道到底选取哪个作为maven项目中的依赖，最好的做法是：固定一位或多位管理员，为他们提供上传权限（权限问题我这里就不讲了），其他人一概不允许上传，让管理员上传时按照规范来编写依赖信息。比如我上传一个百度ueditor的jar包，我会这么写：

<dependency>
  <groupId>org.baidu</groupId>
  <artifactId>ueditor</artifactId>
  <version>1.0.0.RELEASE</version>
</dependency>

这样一来，让管理员规范对版本的认识从而增强开发人员对版本的认识。否则可能会因为多次上传了jar让开发人员错误地使用artifact的版本信息（尽管你随便写groupId、artifactId、version，甚至都写成111、222、333也可以使用，但是为何不规范一点让大家从小事做起呢，反正我在公司深受这方面不规范的毒害……经常不知道选取哪个版本的jar作为依赖使用）

通过maven发布项目

要想通过IDE发布项目，首先要开启repositories的部署功能，我以snapshot为例，打开仓库测configuration界面：

将Deployment Policy（部署策略）改为允许，即项目允许往snapshots仓库发布快照版本（snapshot），这里是否为快照版本取决于你项目的pom.xml文件中的version信息（一般在pom.xml的最上面），如我的一个测试项目信息为：1.0.0-SNAPSHOTS

<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.haycm</groupId>
    <artifactId>haycm</artifactId>
    <!--这里SNAPSHOTS和RELEASED不能写错，否则maven将不知道发布到哪个仓库，快照就要写成SNAPSHOTS-->
    <version>1.0.0-SNAPSHOTS</version>
    <packaging>war</packaging>
</project>

仅仅这样还不够，还需要在pom中加入配置告诉maven发布仓库的URL

<!--这里配置发布仓库的路径-->
    <distributionManagement>
        <repository>
            <id>nexus-releases</id>
            <name>Nexus Releases Repository</name>
            <url>http://localhost:8081/nexus/content/repositories/releases</url>
        </repository>
        <snapshotRepository>
            <id>nexus-snapshots</id>
            <name>Nexus Snapshots Repository</name>
            <url>http://localhost:8081/nexus/content/repositories/snapshots</url>
        </snapshotRepository>
    </distributionManagement>

并且在maven的conf/setting.xml文件中配置仓库的用户名和密码，只有让maven可以登录nexus才能好把东西部署到nexus嘛：
在setting.xml中servers节点下加入如下配置

<server>
            <id>nexus-releases</id>
            <username>deployment</username>
            <password>password</password>
        </server>
        <server>
            <id>nexus-snapshots</id>
            <username>deployment</username>
            <password>password</password>
        </server>

这里setting.xml中snapshot仓库的id和pom.xml中snapshot仓库的id要一样，release仓库的id也是。否则maven会不知道哪个仓库用哪个用户名发布登录（现实过程中snapshot和release仓库可能给两个不同权限的用户，所以需要区分）

这样，maven就可以通过deploy操作把项目发布到对应仓库了，deploy操作也会运行前面的clean、compile等步骤，如果项目中存在错误的话（比如测试用例错误，代码语法错误等）会build failure。

build success后，就可以到仓库搜索，查看部署结果，应该就有了：
输入关键字

搜索结果

nexus deploy失败相关说明

问题1

描述：认证失败401
因为setting.xml和pom.xml中对应的名称不一致、密码错误、或者对应的用户名密码没有对应仓库的权限
http://www.javatang.com/archives/2010/01/23/4518375.html

问题2：

描述：resolution will not be reattempted until the update interval of nexus has el
http://kia126.iteye.com/blog/1785120

其它的都差不多，我也就简单看看，恕不一一列出。

maven生命周期干了啥

通过maven项目操作查看它们分别干了什么来理解maven的生命周期，并了解每个生命周期大概都有什么用处。可以在Intellij中把每个生命周期点一下，百度上看看相关操作产生了哪些变化，并了解一下这些变化在项目中有什么作用，一般什么时候用哪个操作，都了解之后就知道干嘛的了，以下这些只是我暂时的一些理解。

Clean

Target目录是项目make、complie一些动作后生成的项目运行需要的文件，比如war包、比如java代码.class文件 还有项目里面其它配置文件，总之，就是项目编译过后生成的一系列文件。Clean的动作就是删除target这个目录，为接下来的重新编译做准备；

Compile

在target下面生成classes、generated-sources目录，并产生项目中java编译的class文件、框架相关的配置文件，比如我这里的spring mybatis的配置文件；

Test

运行项目中test模块下的测试，如果项目中测试写的不够完善或者没写完整，可以把这里的东西都清理掉，否则影响后面的package等步骤

Package

编译的文件和web相关的页面、样式、js等前端打成war包，如果生成war包，便可以直接放入到tomcat下面的webapps中运行（运行时得保证数据库连接等环境正常）；

Install

将war（或者jar，看你maven项目的具体类型）打包到本地仓库，供其它项目作为依赖使用；

Deploy

将项目发布到maven仓库，这里就需要nexus私服了，因为我们平时使用的是apache的maven仓库，别人明显是不会让你随意发布应用的，所以我们需要自己搭建仓库并做相关配置才能发布应用。发布的应用可以在nexus私服的仓库搜索到；