前言
本文可以帮助你加深对Maven的整体认识,不是一篇基础文章。如果你现在还没有用 Maven 跑过 HelloWorld,那么本文可能不适合你。
一、Maven简介
Maven是一个项目管理工具,它包含了一个项目对象模型 (Project Object Model),一组标准集合,一个项目生命周期(Project Lifecycle),一个依赖管理系统(Dependency Management System),和用来运行定义在生命周期阶段(phase)中插件(plugin)目标(goal)的逻辑。
1.版本:maven有自己的版本定义和规则。
2.构建:可以完成编译,打包,部署等。
3.依赖管理:方便引入所需依赖 Jar 包,不需手动下载。
4.文档生成:maven的site命令支持各种文档信息的发布,包括构建过程的各种输出,javadoc,产品文档等。
5.项目关系:一个大型的项目通常有几个小项目或者模块组成,用maven可以很方便地管理。
二、Maven生命周期
maven把项目的构建划分为不同的生命周期(lifecycle)。粗略一点的话,它这个过程(phase)包括:
1.验证(validate):验证项目是否正确
2.编译(compile): 编译项目的源代码
3.测试(test):使用合适的单元测试框架测试编译的源代码。这些测试不应该要求代码被打包或部署
4.打包(package)
5.验证(verify)
6.安装(install)
7.部署(deploy)
maven中所有的执行动作(goal)都需要指明自己在这个过程中的执行位置,然后maven执行的时候,就依照过程的发展依次调用这些goal进行各种处理。
这个也是maven的一个基本调度机制。一般来说,位置稍后的过程都会依赖于之前的过程。当然,maven同样提供了配置文件,可以依照用户要求,跳过某些阶段。
三、Maven 版本规范
maven使用如下几个要素来唯一定位某一个输出物:
groupId:artifactId:packaging:version 。
比如org.springframework:spring:2.5 。每个部分的解释如下:
1.groupId 公司,团体等。如Apache Software的项目有以org.apache开头的groupId。
2.artifactId 项目的唯一标识符。比如一个helloworld项目就叫helloworld。
3.packaging 项目打包输出的类型,默认是jar。类型为war的项目产生一个web应用。
4.version 一个项目的特定版本。发布的项目有一个固定的版本标识来指向该项目的某一个特定的版本。而正在开发中的项目可以用一个特殊的标识,这种标识给版本加上一个"SNAPSHOT"的标记。
SNAPSHOT 如果一个版本包含字符串"SNAPSHOT",Maven就会在安装或发布这个组件的时候将该符号展开为一个日期和时间值,转换为UTC时间。例如,"1.0-SNAPSHOT"会在2010年5月5日下午2点10分发布时候变成1.0-20100505-141000-1。这个词只能用于开发过程中,因为一般来说,项目组都会频繁发布一些版本,最后实际发布的时候,会在这些snapshot版本中寻找一个稳定的,用于正式发布,比如1.4版本发布之前,就会有一系列的1.4-SNAPSHOT,而实际发布的1.4,也是从中拿出来的一个稳定版。
LATEST 指某个特定构件的最新发布,这个发布可能是一个发布版,也可能是一个snapshot版,具体看哪个时间最后。
RELEASE 指最后一个发布版。
Maven有自己的版本规范,一般是如下定义 ..- ,比如1.2.3-beta-01。要说明的是,maven自己判断版本的算法是major,minor,incremental部分用数字比较,qualifier部分用字符串比较,所以要小心 alpha-2和alpha-15的比较关系,最好用 alpha-02的格式。
Maven在版本管理时候可以使用几个特殊的字符串 SNAPSHOT ,LATEST ,RELEASE 。比如"1.0-SNAPSHOT"。各个部分的含义和处理逻辑如下说明:
四、Maven插件机制
1.Maven默认插件
不配置Plugin时,Maven默认会使用以下插件。如果针对各个 plugin 有特殊配置的话,需要显示指定 plugin 和 属性配置。
maven-site-plugin:将工程所有文档生成网站,生成的网站界面默认和apache的项目站点类似,但是其文档用doxia格式写的,目前不支持docbook,需要用其他插件配合才能支持。需要指出的是,在maven 2.x系列中和maven3.x的site命令处理是不同的,在旧版本中,用 mvn site 命令可以生成reporting节点中的所有报表,但是在maven3中,reporting过时了,要把这些内容作为 maven-site-plugin的configuration的内容才行。
2. Maven常用插件
2.1 Tomcat插件
tomcat插件有两种:tomcat-maven-plugin 和 tomcat7-maven-plugin,使用方式基本相同。
tomcat-maven-plugin 插件是org.codehaus.mojo组织提供的,里面的tomcat是6.0.29版本,没有更新了。
tomcat7-maven-plugin 插件是apache提供的,官网:tomcat.apache.org/mave...
1.tomcat7-maven-plugin 插件使用
命令:
2. tomcat-maven-plugin 插件使用
命令:
配置参数:
path:是访问应用的路径
port:是tomcat 的端口号
uriEncoding:URL按UTF-8进行编码,这样就解决了中文参数乱码。
Server:指定tomcat名称。
2.2 自动部署插件wagon
自动部署包含三个步骤:编译打包、上传到服务器、在服务器上执行linux命令
2.2.1 文件上传到服务器
Maven项目可使用 mvn install 指令打包,打包完成后包位于target目录下,要想在远程服务器上部署,首先要将包上传到服务器。
首先在本地的setting.xml中配置server的信息,包括id,用户名,密码。(当然也可以在pom.xml里面配置)
pom.xml
linux_server:在setting.xml中配置的server的id名字target/test.war:
是要上传到服务器的文件,一般来说是jar或者war包 scp://user:password@192.168.20.128/home/tomcat7/webapps:配置服务器的用户、密码、地址以及文件上传的目录
命令:
如果觉的wagon命令太长,可以设置 excutions 来配置phase和goals来简化命令。
2.2.2 在服务器上执行linux命令
1.运行jar文件
命令
2. 上传war包并启动Tomcat
命令
2.2.3 配置execution
如果觉得 mvn clean package wagon:upload-single wagon:sshexec 命令太长了不好记,那么可以配置execution,在运行deploy的同时运行upload-single和sshexec。
命令
2.2.4. 完整示例配置
首先在本地的setting.xml中配置server的信息,包括id,用户名,密码。(当然也可以在pom.xml里面配置)
pom.xml
命令
五、Maven 项目依赖
1. 多模块依赖和继承
项目结构图:
parent中执行mvn install就能将 childA和childB 一起编译
parent的pom.xml做如下配置:
childA和childB的pom.xml都需要配置parent,防止引入的包冲突(如果不加parent,会分别去编译他们引入的依赖,会重复引入包):
子pom间存在引用关系,比如childB引用到了childA的jar包
2. 子项目继承父项目的依赖
parent中加上,child项目就可以继承parent项目的依赖,并且在child中可以不用加version了。
3. 依赖范围
如果不显示执行 属性时,默认 compile。
scope 属性包括:
1.compile(编译范围):编译范围的在所有的classpath中可用,同时它们也会被打包。
2.provided(已提供范围):表示部署的环境当中有某容器已经提供了该jar包,只在编译classpath(不是运行时)可用。它们不是传递性的,也不会被打包。例如,如果你开发了一个web应用,你可能在编译classpath中需要可用的Servlet API来编译一个servlet,但是你不会想要在打包好的WAR中包含这个Servlet API;这个Servlet API JAR由你的servlet容器(Tomcat)提供。
3.runtime(运行时范围):只在运行和测试系统的时候需要,但在编译的时候不需要。
4.test(测试范围):在一般的 编译和运行时都不需要,它们只有在测试编译和测试运行阶段可用。
5.system (系统范围):该范围不推荐使用(你应该一直尽量去从公共或定制的Maven仓库中引用依赖)
六、Maven profiles切换测试环境和正式环境
id代表这个环境的唯一标识,在 mvn install -Pdev 来指定。
此properties定义了三个环境,分别是dev(开发环境)、beta(测试环境)、release(发布环境)
activeByDefault=true代表如果不指定某个固定id的profile,那么就使用这个环境
使用 mvn install -Pdev会将 id 为 dev 的 profile 中的定义的属性profiles.active自动替换${profiles.active}占位符的变量。最终build到classpath的资源文件由maven-resources-plugin来指定,为src/main/resources/config/dev文件下的所有文件。
七、Maven 变量
1.内置属性
2. Pom/Project properties
所有pom中的元素都可以用 project. 前缀进行引用,以下是部分常用的
3. 本地用户设定
所有用的的 settings.xml 中的设定都可以通过 settings. 前缀进行引用
4. 环境变量
系统的环境变量通过 env. 前缀引用
5. java系统属性
所有JVM中定义的java系统属性.
6. pom.xml自定义变量
则引用 ${project.build.finalName} 就会得到值 hellowolrld
7. parent 工程的变量
parent工程的pom.xml中的变量用前缀 ${project.parent} 引用. 上级工程的版本也可以这样引用: ${parent.version }.
编辑整理丨田培辰