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 1

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

建立Maven的HOME目录变量：

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

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

PATH=$M2_HOME/bin:$PATH 1 1

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

source /etc/profile 1 1

1.5 验证环境变量是否存在

echo $M2_HOME 1 1 echo $PATH 1 1

1.6 验证Maven配置是否成功

mvn -v 1 1

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 1

二、用Maven生成Java项目

2.1 生成Java SE项目

运行命令：

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

一路默认即可。     注意是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> 1234567891011121314151617181920212223242526272829 1234567891011121314151617181920212223242526272829

2.2 生成Java Web项目

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

2.3 Maven的默认目录

目录用途src/main/javaApplication/Library sourcessrc/main/resourcesApplication/Library resourcessrc/main/filtersResource filter filessrc/main/assemblyAssembly descriptorssrc/main/configConfiguration filessrc/main/scriptsApplication/Library scriptssrc/main/webappWeb application sourcessrc/test/javaTest sourcessrc/test/resourcesTest resourcessrc/test/filtersTest resource filter filessrc/siteSiteLICENSE.txtProject’s licenseNOTICE.txtNotices and attributions required by libraries that the project depends onREADME.txtProject’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> 123456 123456

这样就导入了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> 12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667 12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667

四、使用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"/> 1234567 1234567

4.2 在Maven配置Tomcat用户

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

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

上述配置完成，以后直接在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> 123456789101112131415 123456789101112131415

4.4 启动本地tomcat服务器

先停止运行IDEA中的TOMCAT。

cd $TOMCAT_HOME 1 1 sudo ./bin/startup.sh 1 1

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

4.5 生成和部署war

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

mvn tomcat7:deploy 1 1

部署到Tomcat:

    在$TOMCAT_HOME/webapps下有javaee_idea.war包：     用浏览器访问：

4.6 直接运行项目

mvn clean tomcat7:run 1 1

五、Maven常用命令

    清除target目录：

mvn clean 1 1

    编译：

mvn compile 1 1

    运行：

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

    测试：

mvn test 1 1

    跳过测试打包

mvn package -DskipTests 1 1

    打包：

mvn package 1 1

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

mvn dependency:sources 1 1

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

mvn dependency:resolve -Dclassifier=javadoc 1 1

    将所有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> 12345678910111213141516171819 12345678910111213141516171819

    将依赖包导入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> 1234567891011121314151617181920212223242526272829303132333435363738394041424344454647 1234567891011121314151617181920212223242526272829303132333435363738394041424344454647

    这时自己项目的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 123456789101112131415 123456789101112131415

    安装jar包到本地仓库：

mvn install 1 1

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

mvn deploy 1 1

参考： http://developer.51cto.com/art/201405/439918.htm https://my.oschina.net/angel243/blog/178554