maven学习

maven出现的目的：

 

除了编写源代码，我们每天有相当一部分时间花在了编 译、运行单元测试、生成文档、打包和部署等烦琐且不起眼的工作上，这就是构建。如果我们现在还手工这样做，那成本也太高了，于是有人用软件的方法让这一系 列工作完全自动化，使得软件的构建可以像全自动流水线一样，只需要一条简单的命令，所有烦琐的步骤都能够自动完成，很快就能得到最终结果。

 

Maven作为一个构建工具，不仅能帮我们自动化构建，还能够抽象构建过程，提供构建任务实现；它跨平台，对外提供了一致的操作接口，这一切足以使它成为优秀的、流行的构建工具。

 

Maven是跨平台的，这意味着无论是在Windows上，还是在Linux或者Mac上，都可以使用同样的命令。

 

Maven不仅是构建工具，还是一个依赖管理工具和项目信息管理工具。 它提供了中央仓库，能帮我们自动下载构件。

 

在这个开源的年代里，几乎任何Java应用都会借用一些第三方的开源类库，这些 类库都可通过依赖的方式引入到项目中来。随着依赖的增多，版本不一致、版本冲突、依赖臃肿等问题都会接踵而来。手工解决这些问题是十分枯燥的，幸运的是 Maven提供了一个优秀的解决方案，它通过一个坐标系统准确地定位每一个构件（artifact），也就是通过一组坐标Maven能够找到任何一个 Java类库（如jar文件）。Maven给这个类库世界引入了经纬，让它们变得有秩序，于是我们可以借助它来有序地管理依赖，轻松地解决那些繁杂的依赖 问题

 

maven环境搭建

 

参考如下 安装环境地址

 

maven入门

 

Maven项目的核心是pom.xml。POM（Project Object Model，项目对象模型）定义了项目的基本信息，用于描述项目如何构建，声明项目依赖，等等。现在我们先为Hello World项目编写一个最简单的pom.xml。

 

首先创建一个名为hello-world的文件夹（本书中各章的代码都会对应一个以ch开头的项目），打开该文件夹，新建一个名为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/maven-v4_0_0.xsd">  
  <modelVersion>4.0.0</modelVersion>  
  <groupId>com.zyy.text</groupId>  
  <artifactId>hello-world</artifactId>  
  <version>1.0-SNAPSHOT</version>  
  <name>Maven Hello World Project</name>  
</project> 

 

 

代码的第一行是XML头，指定了该xml文档的版本和编码方式。紧接着是project元素，project是所有pom.xml的根元素，它还声明了一些POM相关的命名空间及xsd元素，虽然这些属性不是必须的，但使用这些属性能够让第三方工具（如IDE中的XML编辑器）帮助我们快速编辑POM。

 

根元素下的第一个子元素modelVersion指定了当前POM模型的版本，对于Maven2及Maven 3来说，它只能是4.0.0。

 

这段代码中最重要的是groupId，artifactId和version三行。这三个元素定义了一个项目基本的坐标，在Maven的世界，任何的jar、pom或者war都是以基于这些基本的坐标进行区分的。

 

groupId定义了项目属于哪个组，这个组往往和项目所在的组织或公司存在关联，譬如你在googlecode上建立了一个名为myapp的项目，那么groupId就应该是com.googlecode.myapp，如果你的公司是mycom，有一个项目为myapp，那么groupId就应该是com.mycom.myapp。本书中所有的代码都基于groupId com.juvenxu.mvnbook。

 

artifactId定义了当前Maven项目在组中唯一的ID，我们为这个Hello World项目定义artifactId为hello-world，本书其他章节代码会被分配其他的artifactId。而在前面的groupId为com.googlecode.myapp的例子中，你可能会为不同的子项目（模块）分配artifactId，如：myapp-util、myapp-domain、myapp-web等等。

 

顾名思义，version指定了Hello World项目当前的版本——1.0-SNAPSHOT。SNAPSHOT意为快照，说明该项目还处于开发中，是不稳定的版本。随着项目的发展，version会不断更新，如升级为1.0、1.1-SNAPSHOT、1.1、2.0等等。本书的6.5小节会详细介绍SNAPSHOT，第13章介绍如何使用Maven管理项目版本的升级发布。

 

最后一个name元素声明了一个对于用户更为友好的项目名称，虽然这不是必须的，但我还是推荐为每个POM声明name，以方便信息交流。

 

没有任何实际的Java代码，我们就能够定义一个Maven项目的POM，这体现了Maven的一大优点，它能让项目对象模型最大程度地与实际代码相独立，我们可以称之为解耦，或者正交性，这在很大程度上避免了Java代码和POM代码的相互影响。比如当项目需要升级版本时，只需要修改POM，而不需要更改Java代码；而在POM稳定之后，日常的Java代码开发工作基本不涉及POM的修改。

 

 

 

Maven项目的标准文件结构

 

标准目录结构： 
src 
  -main 
      –bin 脚本库 
      –java java源代码文件 
      –resources 资源库，会自动复制到classes目录里 
      –filters 资源过滤文件 
      –assembly 组件的描述配置（如何打包） 
      –config 配置文件 
      –webapp web应用的目录。WEB-INF、css、js等 
  -test 
      –java 单元测试java源代码文件 
      –resources 测试需要用的资源库 
      –filters 测试资源过滤库 
  -site Site（一些文档） 
target 
LICENSE.txt Project’s license 
README.txt Project’s readme 

工程根目录下就只有src和target两个目录 

target是有存放项目构建后的文件和目录，jar包、war包、编译的class文件等。 

target里的所有内容都是maven构建的时候生成的 

 

 

 

 Maven常用命令

 

 

• mvn archetype:create ：创建 Maven 项目

• mvn compile ：编译源代码

• mvn test-compile ：编译测试代码

• mvn test ： 运行应用程序中的单元测试

• mvn site ： 生成项目相关信息的网站

• mvn clean ：清除目标目录中的生成结果

• mvn package ： 依据项目生成 jar 文件

• mvn install ：在本地 Repository 中安装 jar

• mvn eclipse:eclipse ：生成 Eclipse 项目文件

• mvn -Dmaven.test.skip=true : 忽略测试文档编译

 

 

下面命令：出自这里

 

 1. mvn help:describe

你是否因为记不清某个插件有哪些goal而痛苦过,你是否因为想不起某个goal有哪些参数而苦恼,那就试试这个命令吧,它会告诉你一切的.

参数: 1. -Dplugin=pluginName   2. -Dgoal(或-Dmojo)=goalName:与-Dplugin一起使用,它会列出某个插件的goal信息,

如果嫌不够详细,同样可以加-Ddetail.(注:一个插件goal也被认为是一个 “Mojo”)

 下面大家就运行mvn help:describe -Dplugin=help -Dmojo=describe感受一下吧!

 

2. mvn archetype:generate

你是怎么创建你的maven项目的?是不是像这样:mvn archetype:create -DarchetypeArtifactId=maven-archetype-quickstart -DgroupId=com.ryanote -Dartifact=common,

如果你还再用的话,那你就out了,现代人都用mvn archetype:generate了,它将创建项目这件枯燥的事更加人性化,你再也不需要记那么多的archetypeArtifactId,你只需输入archetype:generate,剩下的就是做”选择题”了.

 

3. mvn tomcat:run

用了maven后,你再也不需要用eclipse里的tomcat来运行web项目(实际工作中经常会发现用它会出现不同步更新的情况),只需在对应目录里运行 mvn tomat:run命令,

然后就可在浏览器里运行查看了.如果你想要更多的定制,可以在pom.xml文件里加下面配置:

01 02 03 04 org.codehaus.mojo 05 tomcat-maven-plugin 06 07 /web 08 9090 09 10 11 12 当然你也可以在命令里加参数来实现特定的功能,

下面几个比较常用:

1. 跳过测试:-Dmaven.test.skip(=true)

2. 指定端口:-Dmaven.tomcat.port=9090

3. 忽略测试失败:-Dmaven.test.failure.ignore=true 当然,如果你的其它关联项目有过更新的话,一定要在项目根目录下运行mvn clean install来执行更新,再运行mvn tomcat:run使改动生效.

 

4. mvnDebug tomcat:run

这条命令主要用来远程测试,它会监听远程测试用的8000端口,在eclipse里打开远程测试后,它就会跑起来了,设断点,调试,一切都是这么简单.上面提到的那几个参数在这里同样适用.

 

5. mvn dependency:sources

 故名思义,有了它,你就不用到处找源码了,运行一下,你项目里所依赖的jar包的源码就都有了

 

 

Maven常用命令： 
1. 创建Maven的普通java项目：
   mvn archetype:create  -DgroupId=packageName  -DartifactId=projectName 
2. 创建Maven的Web项目：  
    mvn archetype:create -DgroupId=packageName   -DartifactId=webappName-DarchetypeArtifactId=maven-archetype-webapp   
3. 编译源代码： mvn compile
4. 编译测试代码：mvn test-compile   
5. 运行测试：mvn test   
6. 产生site：mvn site  
7. 打包：mvn package  
8. 在本地Repository中安装jar：mvn install
9. 清除产生的项目：mvn clean  
10. 生成eclipse项目：mvn eclipse:eclipse 
11. 生成idea项目：mvn idea:idea 
12. 组合使用goal命令，如只打包不测试：mvn -Dtest package  
13. 编译测试的内容：mvn test-compile 
14. 只打jar包: mvn jar:jar 
15. 只测试而不编译，也不测试编译：mvn test -skipping compile -skipping test-compile
      ( -skipping 的灵活运用，当然也可以用于其他组合命令) 
16. 清除eclipse的一些系统设置:mvn eclipse:clean 

ps：

一般使用情况是这样，首先通过cvs或svn下载代码到本机，然后执行mvn eclipse:eclipse生成ecllipse项目文件，然后导入到eclipse就行了；修改代码后执行mvn compile或mvn test检验，也可以下载eclipse的maven插件。

mvn -version/-v               显示版本信息
mvn archetype:generate        创建mvn项目
mvn archetype:create -DgroupId=com.oreilly -DartifactId=my-app   创建mvn项目

mvn package              生成target目录，编译、测试代码，生成测试报告，生成jar/war文件
mvn jetty:run            运行项目于jetty上,
mvn compile              编译
mvn test                 编译并测试
mvn clean                清空生成的文件
mvn site                 生成项目相关信息的网站
mvn -Dwtpversion=1.0 eclipse:eclipse        生成Wtp插件的Web项目
mvn -Dwtpversion=1.0 eclipse:clean          清除Eclipse项目的配置信息(Web项目)
mvn eclipse:eclipse                         将项目转化为Eclipse项目

在应用程序用使用多个存储库 
<repositories>    
    <repository>     
        <id>Ibiblio</id>     
        <name>Ibiblio</name>     
        <url>http://www.ibiblio.org/maven/</url>   
    </repository>   
    <repository>     
        <id>PlanetMirror</id>     
        <name>Planet Mirror</name>     
        <url>http://public.planetmirror.com/pub/maven/</url>   
    </repository>  
</repositories>

mvn deploy:deploy-file -DgroupId=com -DartifactId=client -Dversion=0.1.0 -Dpackaging=jar -Dfile=d:\client-0.1.0.jar -DrepositoryId=maven-repository-inner -Durl=ftp://xxxxxxx/opt/maven/repository/

发布第三方Jar到本地库中：

mvn install:install-file -DgroupId=com -DartifactId=client -Dversion=0.1.0 -Dpackaging=jar -Dfile=d:\client-0.1.0.jar

-DdownloadSources=true

-DdownloadJavadocs=true

mvn -e              显示详细错误 信息.
mvn validate        验证工程是否正确，所有需要的资源是否可用。
mvn test-compile    编译项目测试代码。 。
mvn integration-test     在集成测试可以运行的环境中处理和发布包。
mvn verify               运行任何检查，验证包是否有效且达到质量标准。    
mvn generate-sources     产生应用需要的任何额外的源代码，如xdoclet。

 

 

 -------------------------------------------------------------------- -------------------------------------------------------------------- -------------------------------------------------------------------- -------------------------------------------------------------------- --------------------------------------------------------------------

 

 从Maven仓库中导出jar包：进入工程pom.xml 所在的目录下，

输入以下命令：

mvn dependency:copy-dependencies -DoutputDirectory=lib

更简单的 

mvn dependency:copy-dependencies   

会导出到target\dependency 下面

 

#查看项目jar的依赖情况

mvn dependency:tree

https://blog.csdn.net/sun_wangdong/article/details/51852113

 

私服和本地同样的版本号，拉取规则：如果版本号一致，则比较

deploy是发布到哪个路径下面的 releases/snapshots   ？

 

SNAPSHOT的jar：

本地获取的时候，总是先从私服去拉取最新的快照jar

非SNAPSHOT jar:

如果本地有对应版本的jar，则优先使用本地的jar，想要使用私服上面的版本，需要将本地库中的jar删除掉

 

 

 

#用命令将jar上传到私服  https://blog.csdn.net/u013308504/article/details/78952221

 

 

mvn deploy:deploy-file -DgroupId=com.eastmoney -DartifactId=quote-common -Dversion=4.0.6 -Dpackaging=jar -Dfile=E:\quote-common-deploy\quote-common-4.0.6.jar -Durl=http://172.16.57.34:8080/nexus/content/repositories/releases/ -DrepositoryId=nexus-releases

 

 

 

#maven拉取框架的源码方式：

使用maven命令：mvn dependency:sources 下载依赖包的源代码。

 

 

或者

mvn dependency:sources -DdownloadSources=true -DdownloadJavadocs=true

 

或者

eclipse窗口->首选项->maven->勾选download artifact sources

 

还有一种应该也行：

            <plugin>

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

                <artifactId>maven-idea-plugin</artifactId>

                <version>2.9</version>

                <configuration>

                    <downloadSources>true</downloadSources>

                    <downloadJavadocs>true</downloadJavadocs>

                </configuration>

            </plugin>