Ubuntu下Maven安装和使用

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.3.9.bin.tar.gz

1.2 解压到HOME目录

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

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

建立Maven的HOME目录变量：

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

将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>

二、用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 l
ib/spring-beans-3.1.4.RELEASE.jar lib/spring-context-3.1.4.RELEASE.ja
r lib/spring-expression-3.1.4.RELEASE.jar lib/log4j-1.2.16.jar lib/sl
f4j-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.F
inal.jar lib/zkclient-0.1.jar lib/zookeeper-3.3.3.jar lib/jline-0.9.9
4.jar
Created-By: Apache Maven 3.3.9
Main-Class: com.jessin.dubbo.main.Main
Archiver-Version: Plexus Archiver

安装jar包到本地仓库：

mvn install

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

mvn deploy

六、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