Ubuntu下Maven安装和使用

一、安装Maven

安装Maven之前，必须安装了JDK，另外IDEA可以从https://download.jetbrains.8686c.com/idea/ideaIC-2016.2.5.tar.gz下载，里面有说明如何安装IDEA

1.1 首先下载Maven的压缩包

下载apache-maven-3.8.4-bin.tar.gz

1.2 解压到HOME目录

tar zxvf apache-maven-3.8.4-bin.tar.gz -C ~

1.3 在/etc/profile下添加环境变量

建立Maven的HOME目录变量：

export M2_HOME=/home/gzx/apache-maven-3.8.4

将Maven的bin目录添加到path路径

PATH=$M2_HOME/bin:$PATH

1.4 重新启动系统，或者在终端下输入

source /etc/profile

1.5 验证环境变量是否存在

echo $M2_HOME

echo $PATH

1.6 验证Maven配置是否成功

mvn -v

1.7 修改本地仓库

不修改配置的话，下载的文件都会保存到本地仓库~/.m2/repositoryMaven中。这里指定本地仓库为/home/gzx/Documents/Program/maven_localRepository。
在文件$M2_HOME/conf/settings.xml的localRepository的开头添加一行：

<localRepository>/home/gzx/Documents/Program/maven_localRepository</localRepository>

1.8 更改Maven的中央仓库为aliyun，提高下载jar的速度

在$M2_HOME/conf/settings.xml下添加如下内容：

<mirrors><mirror><id>alimaven</id><name>aliyun maven</name><url>https://maven.aliyun.com/repository/public</url><mirrorOf>central</mirrorOf>        </mirror>
</mirrors>

二、用Maven生成Java项目

2.1 生成Java SE项目

运行命令：

mvn archetype:generate -DgroupId=com.baobao -DartifactId=javase

一路默认即可。
注意是generate命令，而不是create命令。这样将在test目录下生成一个javase的目录，有测试目录和源码目录，同时生成相应的com/bao的java类包。这样的目录是Maven默认生成的，如下：

可以看到javase的根目录下有一个pom.xml的配置文件，这个文件是Maven的核心文件，指定了依赖的jar包、源码的编码、打包方式等。

<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"><!-- Maven的版本 --><modelVersion>4.0.0</modelVersion><!-- 下面三个是本项目区别于其他项目的坐标 --><groupId>com.baobao</groupId><artifactId>javase</artifactId><version>1.0-SNAPSHOT</version><!-- 打包成jar格式 --><packaging>jar</packaging><name>javase</name><url>http://maven.apache.org</url><!-- 源码的编码方式为UTF-8 --><properties><project.build.sourceEncoding>UTF-8</project.build.sourceEncoding></properties><!-- 声明本项目依赖的jar包 --><dependencies><dependency><!-- 单元测试jar包，scope指定只在测试目录起作用 --><groupId>junit</groupId><artifactId>junit</artifactId><version>3.8.1</version><scope>test</scope></dependency></dependencies>
</project>

2.2 生成Java Web项目

运行命令：
mvn archetype:generate -DgroupId=com.baobao -DartifactId=javaee -DarchetypeArtifactId=maven-archetype-webapp
这样将产生默认目录的web项目：

2.3 Maven的默认目录

目录	用途
src/main/java	Application/Library sources
src/main/resources	Application/Library resources
src/main/filters	Resource filter files
src/main/assembly	Assembly descriptors
src/main/config	Configuration files
src/main/scripts	Application/Library scripts
src/main/webapp	Web application sources
src/test/java	Test sources
src/test/resources	Test resources
src/test/filters	Test resource filter files
src/site	Site
LICENSE.txt	Project’s license
NOTICE.txt	Notices and attributions required by libraries that the project depends on
README.txt	Project’s readme

三、用IDEA 2016.2.5建立Maven web项目

3.1 新建web项目

单击File → New → Project… → Maven → 打钩Create from archetype → 单击webapp → Next
填写坐标
默认情况下IDEA会有自己的Maven，而且版本与我们的不一样。换成自己的Maven Home Directory，并修改配置文件的路径和本地仓库的路径：
填写项目名
生成的项目结构

跟用命令行生成的是一样的，注意webapp目录就是我们网站的根目录，Tomcat的web目录都必须是这样的结构。

3.2 开启自动导入jar

我们可以点击右下角的Auto import，这样的话IDEA会自动导入我们依赖的包到本地仓库。或者
New → Settings → Build,Execution,Deployment → Build Tools → Maven → importing → import Maven project automatically打钩

3.3 新建Java目录

显然这里没有可以存放Java源码的项目，我们可以手动新建。我们可以在main下建立一个java目录：右击main创建java目录 → 点击New → project structure → Modules → 点击Sources选项卡 → 选择java目录，点击Mark as : Sources

这时候就可以在java目录里面建立类了，同时java目录变为蓝色。

3.4 新建Tomcat服务器

Run → Edit Configurations → 点击左上角的+ → 拉到最下，选择Tomcat Sever，选择Local → 输入MyTomcat，并去掉After launch的打钩
点击第二个选项卡Deployment → 点击右上角的+，选择artifact → 选择exploded war → 填写上下文为/javaee_idea

这样回到主界面时，就会在右上角有一个MyTomcat的服务器，点击箭头，即可以运行。

用浏览器访问：

3.5 使用jar包

假设我们要使用Guava API，用http://mvnrepository.com/查询依赖关系，在搜索框输入guava，点击20.0那个版本，拷贝依赖关系，在pom.xml的dependencies下填写：

<!-- https://mvnrepository.com/artifact/com.google.guava/guava -->
<dependency><groupId>com.google.guava</groupId><artifactId>guava</artifactId><version>20.0</version>
</dependency>

这样就导入了guava-20.0.jar，可以在代码中使用Guava API了。
直接运行，在target下生成相应的class。

本人的pom.xml模板：

<?xml version="1.0" encoding="UTF-8"?>
<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.qunar.fresh2017.training1</groupId><artifactId>training1</artifactId><version>1.0-SNAPSHOT</version><properties><project.build.sourceEncoding>UTF-8</project.build.sourceEncoding></properties><dependencies><dependency><groupId>com.google.guava</groupId><artifactId>guava</artifactId><version>20.0</version></dependency><dependency><groupId>commons-collections</groupId><artifactId>commons-collections</artifactId><version>3.2.1</version></dependency><!-- logging --><dependency><groupId>ch.qos.logback</groupId><artifactId>logback-core</artifactId><version>1.1.8</version></dependency><dependency><groupId>ch.qos.logback</groupId><artifactId>logback-classic</artifactId><version>1.1.8</version></dependency><dependency><groupId>org.slf4j</groupId><artifactId>slf4j-api</artifactId><version>1.7.22</version></dependency><!-- logging end --><dependency><groupId>junit</groupId><artifactId>junit</artifactId><version>4.12</version></dependency></dependencies><build><plugins><plugin><groupId>org.apache.maven.plugins</groupId><artifactId>maven-compiler-plugin</artifactId><version>3.1</version><configuration><source>1.7</source><target>1.7</target></configuration></plugin></plugins></build></project>

四、使用Maven生成war并部署到Tomcat

4.1 建立一个Tomcat用户

首先，修改$TOMCAT_HOME/conf/tomcat-users.xml，在tomcat-users的标签下添加一个用户：

<role rolename="admin-gui"/>
<role rolename="admin-script"/>
<role rolename="manager-gui"/>
<role rolename="manager-script"/>
<role rolename="manager-jmx"/>
<role rolename="manager-status"/>
<user username="jessin" password="201314" roles="manager-gui,manager-script,manager-jmx,manager-status,admin-script,admin-gui"/>

4.2 在Maven配置Tomcat用户

在$M2_HOME/conf/settings.xml的servers的标签下，添加对应的用户和密码，id可以随便起，便于IDEA引用。但用户名和密码必须和上述对应。

<server><id>tomcat8</id><username>jessin</username><password>201314</password></server>

上述配置完成，以后直接在IDEA引用即可。

4.3 在IDEA项目中使用Tomcat用户

在IDEA的pom.xml的build标签下添加：

<plugins><plugin><groupId>org.apache.tomcat.maven</groupId><artifactId>tomcat7-maven-plugin</artifactId><version>2.2</version><configuration><!-- 注意此处的url，上传javaee_idea.war到url，此时本地的tomcat服务器必须开启 --><url>http://localhost:8080/manager/text</url><!-- 此处的名字必须和setting.xml中配置的ID一致，而该id对应的用户必须在tomcat的conf/tomcat-users.xml有配置--><server>tomcat8</server><!-- 此处的名字是项目发布的工程名 : http://localhost:8080/javaee_idea,也是war名--><path>/javaee_idea</path></configuration></plugin>
</plugins>

4.4 启动本地tomcat服务器

先停止运行IDEA中的TOMCAT。

cd $TOMCAT_HOME

sudo ./bin/startup.sh

关于Tomcat的安装可以参考http://blog.csdn.net/ac_dao_di/article/details/49454795

4.5 生成和部署war

在命令行下切到javaee_idea的根目录下，运行

mvn tomcat7:deploy

部署到Tomcat:

在$TOMCAT_HOME/webapps下有javaee_idea.war包：

用浏览器访问：

4.6 直接运行项目

mvn clean tomcat7:run

五、Maven常用命令

清除target目录：

mvn clean

编译：

mvn compile

运行：

mvn exec:java -Dexec.mainClass="主类全名" -Dexec.args="传递的参数"

测试：

mvn test

跳过测试打包

mvn package -DskipTests

打包：

mvn package

下载当前项目依赖的jar包的源码：

mvn dependency:sources

下载当前项目依赖的jar包的文档：

mvn dependency:resolve -Dclassifier=javadoc

将所有class打到一个jar中，包括依赖包，这时依赖和本项目的类将混在一起，同时pom.xml，xsd等文件没有打进去，对于spring类型的可能会出问题。打包命令为mvn package。

<plugin><groupId>org.apache.maven.plugins</groupId><artifactId>maven-assembly-plugin</artifactId><configuration><descriptorRefs><descriptorRef>jar-with-dependencies</descriptorRef></descriptorRefs></configuration><!-- 绑定，本质上是mvn assembly:single--><executions><execution><id>make-assembly</id><phase>package</phase><goals><goal>single</goal></goals><execution><executions>
</plugin>

将依赖包导入lib中，且在同一个目录下将自己项目的类打成jar，同时指定入口类，可以通过java -jar 项目jar包运行起来。同样使用mvn package来打包。对于packaging为war该命令会直接打包成war的形式，也就是将所有依赖打入到lib目录下。

<build><finalName>dubbo_provider_demo</finalName><plugins><!--在target目录下将classes文件打成jar，并填写MANIFEST的入口和类路径为lib所有的依赖均被放到lib下--><plugin><groupId>org.apache.maven.plugins</groupId><artifactId>maven-jar-plugin</artifactId><configuration><archive><manifest><addClasspath>true</addClasspath><!-- 指定类路径 --><classpathPrefix>lib/</classpathPrefix><!-- 指定入口--><mainClass>com.jessin.dubbo.main.Main</mainClass></manifest><!-- 添加.到类路径 --><manifestEntries><Class-Path>.</Class-Path></manifestEntries></archive></configuration></plugin><plugin><groupId>org.apache.maven.plugins</groupId><artifactId>maven-dependency-plugin</artifactId><executions><execution><id>copy-dependencies</id><phase>prepare-package</phase><goals><goal>copy-dependencies</goal></goals><configuration><outputDirectory>${project.build.directory}/lib</outputDirectory><overWriteReleases>false</overWriteReleases><overWriteSnapshots>false</overWriteSnapshots><overWriteIfNewer>true</overWriteIfNewer></configuration></execution></executions></plugin></plugins></build>

这时自己项目的jar里面的MANIFEST.MF如下：

Manifest-Version: 1.0
Built-By: jessin
Build-Jdk: 1.7.0
Class-Path: . lib/dubbo_api_demo1-1.0.0-SNAPSHOT.jar lib/spring-aop-3.1.4.RELEASE.jar lib/aopalliance-1.0.jar lib/spring-asm-3.1.4.RELEASE.jar lib/spring-core-3.1.4.RELEASE.jar lib/commons-logging-1.1.1.jar lib/spring-beans-3.1.4.RELEASE.jar lib/spring-context-3.1.4.RELEASE.jar lib/spring-expression-3.1.4.RELEASE.jar lib/log4j-1.2.16.jar lib/slf4j-api-1.6.6.jar lib/slf4j-log4j12-1.6.6.jar lib/dubbo-2.5.3.jar lib/spring-2.5.6.SEC03.jar lib/javassist-3.15.0-GA.jar lib/netty-3.2.5.Final.jar lib/zkclient-0.1.jar lib/zookeeper-3.3.3.jar lib/jline-0.9.94.jar
Created-By: Apache Maven 3.3.9
Main-Class: com.jessin.dubbo.main.Main
Archiver-Version: Plexus Archiver

安装jar包到本地仓库：

mvn install

安装jar源码到本地仓库：

mvn source:jar install

安装jar doc到本地仓库：

mvn javadoc:jar install

上传jar包到本地仓库和私服：

mvn deploy

安装某个目录下的pom到本地仓库：

mvn install:install-file -DgroupId=a.tc -DartifactId=tcdev -Dversion=init-SNAPSHOT -Dpackaging=pom -Dfile=tcdev-init-SNAPSHOT.pom

六、maven依赖冲突及处理

6.1 依赖冲突的默认处理

当依赖于同一个jar的不同版本时，这时出现依赖冲突，maven按照两个原则解决冲突：路径优先原则和声明优先原则。如A->B->X(1.0)和A->C->D->X(2.0)，这时使用的是X(1.0)；如A->B->X(1.0)和A->C->X(2.0)，但是B先声明于C，则使用的是X(1.0)。举例如下：
有一个pom.xml：

<?xml version="1.0" encoding="UTF-8"?>
<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.qunar.jessin.dubbo</groupId><artifactId>dubbo_api_demo1</artifactId><version>1.0.1</version><dependencies><dependency><groupId>commons-logging</groupId><artifactId>commons-logging</artifactId><version>1.2</version></dependency><dependency><groupId>com.google.guava</groupId><artifactId>guava</artifactId><version>15.0</version></dependency><dependency><groupId>org.dbunit</groupId><artifactId>dbunit</artifactId><version>2.2</version></dependency><dependency><groupId>junit-addons</groupId><artifactId>junit-addons</artifactId><version>1.4</version></dependency></dependencies>
</project>

依赖图如下：

    可以看到commons-logging依赖的路径不等长：dubbo_api_demo1 --> commons-logging(1.2)和dubbo_api_demo1 --> dbunit --> commons-logging(1.0.4)，根据路径优先原则，用的是1.2版本。对于junit的依赖都是路径等长的传递依赖：dubbo_api_demo1 --> dbunit --> junit(3.8.2) 和 dubbo_api_demo1 --> junit-addons --> junit(3.8.1)，但是dbunit先声明了，所以使用的是3.8.2版本。图中的红线表示不使用。
    且所有的依赖为：直接引入的commons-logging、guava、dbunit、addons，剩下的均为传递依赖。
    看下idea左下角的依赖即可验证这两个原则，而且左边所有依赖的jar，刚好对应右图的传递依赖+直接依赖的所有jar。

    使用如下命令查看依赖冲突的处理：

mvn dependency:tree -Dverbose

如下：

6.2 手动处理依赖冲突

maven默认的处理可能存在问题，maven提供了dependencyManagement的方式来统一管理依赖版本。
在上述pom.xml中加入dependencyManagement：

<?xml version="1.0" encoding="UTF-8"?>
<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.qunar.jessin.dubbo</groupId><artifactId>dubbo_api_demo1</artifactId><version>1.0.1</version><dependencyManagement><dependencies><dependency><groupId>junit</groupId><artifactId>junit</artifactId><version>4.12</version></dependency></dependencies></dependencyManagement><dependencies><dependency><groupId>commons-logging</groupId><artifactId>commons-logging</artifactId><version>1.2</version></dependency><dependency><groupId>com.google.guava</groupId><artifactId>guava</artifactId><version>15.0</version></dependency><dependency><groupId>org.dbunit</groupId><artifactId>dbunit</artifactId><version>2.2</version></dependency><dependency><groupId>junit-addons</groupId><artifactId>junit-addons</artifactId><version>1.4</version></dependency></dependencies>
</project>

如下，则使用的junit是4.12版本，且图中红线消失，指向的版本均为4.12，统一了：

这时在使用上述命令，如下：

可以发现junit版本统一为4.12了。

参考：
http://developer.51cto.com/art/201405/439918.htm
https://my.oschina.net/angel243/blog/178554
https://www.cnblogs.com/davenkin/p/advanced-maven-resolve-dependencies-conflicts.html