同样是放在有道云笔记里,各种散乱加发霉,抽空来整理整理,分几个部分来扯扯maven。
一、Maven是啥求。
Maven 为Apache 组织中的开源项目,主要服务于基于Java 平台的项目构建、依赖管理和项目信息管理。这样说大家又要问了,啥时构建,啥是依赖管理啊。构建说起来可简单,每个码农都在项目中接触过。何为构建呢?编译、运行单元测试、生成文档、打包和部署等烦琐且不起眼的工作上,这就是构建。在软件项目过程中,手动的构建会占用大量的时间以及精力,于是有人用软件的方法让这一系列工作完全自动化,使得软件的构建可以像全自动流水线一样。
除此之外,Maven还是一个依赖管理工具以及项目信息管理工具。它提供了中央仓库,能帮我们自动下载构件。在这个开源的年代里,几乎任何Java应用都会借用一些第三方的开源类库,传统的方式当然就是手动下载开源的jar包,手动导入到项目中。随着依赖的增多,版本不一致、版本冲突、依赖臃肿等问题都会接踵而来。手工解决这些问题是十分枯燥的,这时候就需要maven大展宏图了。Maven通过一个坐标系统可以准确的定位到每一个构建(artifact),也就是通过一组坐标Maven能够找到任何一个Java 类库(如jar文件)。
Maven的坐标系统
如上文所述,maven通过一个坐标系统可以准确的定位到每一个构建。maven定义了这样一组规则:groupId、artifactId、version、packaging、classifier五元组来表示一个唯一的构建。
- groupId:定义当前maven项目隶属的实际项目。
- artifactId:定义实际项目中的一个maven项目(模块),推荐的做法是使用实际的项目名称作为artifactId的前缀。
- version:定义maven当前所处的版本。
- packaging:定义maven项目的打包方式,可选的(默认为jar)
- classifier:该元素用来帮助定义构建输出的一些附属构件,该属性不能直接定义。
Maven的安装:
Maven 是一个基于 Java 的工具,所以要做的第一件事情就是安装 JDK。Maven不同版本对jdk的版本有不同的要求,Maven 3.3 要求 JDK 1.7 或以上。
从以下网址下载 Maven 3.3.9:http://maven.apache.org/download.html,解压文件到你想要的位置来安装 Maven 3.3.9。
解压完成之后配置对应机器的环境变量,M2_HOME、PATH。
环境变量配置完成之后,打开控制台,输入mvn --version来验证maven是否安装成功。
二、Maven仓库
在 Maven 的术语中,仓库是一个位置(place),例如目录,可以存储所有的工程 jar 文件、library jar 文件、插件或任何其他的工程指定的文件。
Maven 仓库有三种类型:
- 本地:Maven 本地仓库是机器上的一个文件夹,它在你第一次运行任何 maven 命令的时候创建,Maven 本地仓库默认被创建在 %USER_HOME% 目录下。
- 中央:Maven 中央仓库是由 Maven 社区提供的仓库,其中包含了大量常用的库。
- 远程:如果 Maven 在中央仓库中也找不到依赖的库文件,它会停止构建过程并输出错误信息到控制台。为避免这种情况,Maven 提供了远程仓库的概念,它是开发人员自己定制仓库,包含了所需要的代码库或者其他工程中用到的 jar 文件。
三、Maven配置
settings.xml
maven的配置文件为settings.xml,在下面路径中可以找到这个文件,分别为:
- $M2_HOME/conf/settings.xml:全局设置,在maven的安装目录下;
- ${user.home}/.m2/settings.xml:用户设置,需要用户手动添加,可以将安装目录下的settings.xml文件拷贝过来修改。
一般而言,该文件不需要修改,但是在国内访问maven的中央仓库太慢了,所以最好配置mirror用于拦截maven对remote repository的相关请求,把请求里的remote repository地址,重定向到mirror里配置的地址。
修改maven根目录下的conf文件夹中的settings.xml文件,内容如下:
<mirrors> <mirror> <id>alimaven</id> <name>aliyun maven</name> <url>http://maven.aliyun.com/nexus/content/groups/public/</url> <mirrorOf>central</mirrorOf> </mirror> </mirrors>
pom.xml
POM 包含了关于工程和各种配置细节的信息,Maven 使用这些信息构建工程。POM 也包含了目标和插件。当执行一个任务或者目标时,Maven 会查找当前目录下的 POM,从其中读取所需要的配置信息,然后执行目标。
POM举例:
<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><!--maven2.0必须是这样写,现在是maven2唯一支持的版本--> <!-- The Basics --> <groupId>...</groupId> <!--创建项目的组织或团体的唯一 Id,例如:org.apache.maven--> <artifactId>...</artifactId> <!--指定工程名例如:appfuse--> <version>...</version> <!--指定版本号--> <packaging>...</packaging> <!--打包物的扩展名,一般有 JAR,WAR,EAR 等--> <classifier>...</classifier> <!--projects are displayed as groupId:artifactId:packaging:classifier:version--> <name>...</name> <!--一项目的显示名,常用于 Maven 生成的文档--> <url>...</url> <!--组织的站点,常用于 Maven 生成的文档--> <dependencies> <dependency> <groupId>junit</groupId> <artifactId>junit</artifactId> <version>4.0</version> <type>jar</type> <!--相应的依赖产品包形式,如jar,war--> <scope>test</scope> <!--用于限制相应的依赖范围,包括以下的几种变量 compile :默认范围,使用该依赖范围,对于编译,测试,运行三种classpath都有效。 provided:对于编译和测试classpath有效,但运行时无效。 test:测试依赖范围。 system:需要外在提供相应得元素。通过systemPath来取得. runtime:运行时依赖范围。使用该依赖范围,对于测试和运行classpath有效,但是编译时无效。 --> <optional>true</optional> <!--dependency里面的exclusions:如果X需要A,A包含B依赖,那么X可以声明不要B依赖,只要在exclusions中声明exclusion。optional是不会install或者使用B,而exclusion是将B从依赖树中是删除。例如appfuse不想使用hibernate,但是appfuse是集成hibernate的,所以就排除掉:--> <exclusions> <exclusion> <groupId>org.appfuse</groupId> <artifactId>appfuse-hibernate</artifactId> </exclusion> </exclusions> </dependency> </dependencies> <build> <resource> <directory>src/main/plexus</directory> <includes> <include>configuration.xml</include> </includes> <excludes> <exclude>**/*.java</exclude> <exclude>**/.svn/*</exclude> </excludes> </resource> <!-- includes:指定包含文件的patterns,符合样式并且在directory目录下的文件将会是包含进project的资源文件 excludes:指定不包含在内的patterns,如果includes与excludes有冲突,那么excludes胜利,那些符合冲突样式的文件还是不会包含进来的 --> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-jar-plugin</artifactId> <version>2.0</version> <extensions>false</extensions> <inherited>true</inherited> <configuration> <classifier>test</classifier> </configuration> <dependencies>...</dependencies> <executions>...</executions> </plugin> </plugins> </build> </project>
三、Maven生命周期
Maven强大的一个重要的原因是它有一个十分完善的生命周期模型(lifecycle),这个生命周期可以从两方面来理解,第一,顾名思义,运行Maven的每个步骤都由它来定义的,这种预定义的默认行为使得我们使用Maven变得简单,相比而言,Ant的每个步骤都要你手工去定义。第二,这个模型是一种标准,在不同的项目中,使用Maven的接口是一样的,这样就不用去仔细理解每个项目的构建了,一般情况下,mvn clean install 这样的命令是通用的。我想,一定是吸收了许多项目的经验,Maven才能定义出如此完善的模型。
Maven有三套相互独立的生命周期,请注意这里说的是“三套”,而且“相互独立”,初学者容易将Maven的生命周期看成一个整体,其实不然。这三套生命周期分别是:
- Clean Lifecycle 在进行真正的构建之前进行一些清理工作。
- Default Lifecycle 构建的核心部分,编译,测试,打包,部署等等。
- Site Lifecycle 生成项目报告,站点,发布站点。
我再次强调一下它们是相互独立的,你可以仅仅调用clean来清理工作目录,仅仅调用site来生成站点。当然你也可以直接运行 mvn clean install site运行所有这三套生命周期。
知道了每套生命周期的大概用途和相互关系以后,来逐个详细看一下每套生命周期,Clean和Site相对比较简单,先解释一下。
每套生命周期都由一组阶段(Phase)组成,我们平时在命令行输入的命令总会对应于一个特定的阶段。比如,运行mvn clean,这个的clean是Clean生命周期的一个阶段。有点绕?要知道有Clean生命周期,也有clean阶段。Clean生命周期一共包含了三个阶段:
- pre-clean 执行一些需要在clean之前完成的工作
- clean 移除所有上一次构建生成的文件
- post-clean 执行一些需要在clean之后立刻完成的工作
mvn clean中的clean就是上面的clean,在一个生命周期中,运行某个阶段的时候,它之前的所有阶段都会被运行,也就是说,mvn clean 等同于 mvn pre-clean clean,如果我们运行 mvn post-clean,那么 pre-clean,clean 都会被运行。这是Maven很重要的一个规则,可以大大简化命令行的输入。
下面看一下Site生命周期的各个阶段:
- pre-site 执行一些需要在生成站点文档之前完成的工作
- site 生成项目的站点文档
- post-site 执行一些需要在生成站点文档之后完成的工作,并且为部署做准备
- site-deploy 将生成的站点文档部署到特定的服务器上
这里经常用到的是site阶段和site-deploy阶段,用以生成和发布Maven站点,这可是Maven相当强大的功能,Manager比较喜欢,文档及统计数据自动生成,很好看。
最后,来看一下Maven的最重要的Default生命周期,绝大部分工作都发生在这个生命周期中,这里,我只解释一些比较重要和常用的阶段:
- validate
- generate-sources
- process-sources
- generate-resources
- process-resources 复制并处理资源文件,至目标目录,准备打包。
- compile 编译项目的源代码。
- process-classes
- generate-test-sources
- process-test-sources
- generate-test-resources
- process-test-resources 复制并处理资源文件,至目标测试目录。
- test-compile 编译测试源代码。
- process-test-classes
- test 使用合适的单元测试框架运行测试。这些测试代码不会被打包或部署。
- prepare-package
- package 接受编译好的代码,打包成可发布的格式,如 JAR 。
- pre-integration-test
- integration-test
- post-integration-test
- verify
- install 将包安装至本地仓库,以让其它项目依赖。
- deploy 将最终的包复制到远程的仓库,以让其它开发人员与项目共享。
基本上,根据名称我们就能猜出每个阶段的用途,关于其它阶段的解释,请参考 http://maven.apache.org/guides/introduction/introduction-to-the-lifecycle.html
记住,运行任何一个阶段的时候,它前面的所有阶段都会被运行,这也就是为什么我们运行mvn install的时候,代码会被编译,测试,打包。
此外,Maven的插件机制是完全依赖Maven的生命周期的,因此理解生命周期至关重要。
四、Maven常见命令
maven常见命令如下:
五、Maven && Eclipse
六、Maven之乱七八糟
实验室有时候需要把某一个包安装到artifactory的内部仓库里,便于开发与部署。
当用“mvn install”命令的时候,Maven仅仅打包和安装构件到本地仓库,要把它安装到Artifactory内部仓库中,我们需要使用deploy命令。如果直接使用deploy,可能会遇到 Error code 401, User anonymous is not permitted to deploy 的问题,原因是你没有权限访问本地的maven库。
这时候就需要在settings.xml中添加一条额外的配置
<servers> <server> <id>free4lab</id> <username>admin</username> <password>password</password> </server> </servers>
配置完settings.xml之后,如果直接执行deploy命令可能还会报错:Deployment failed: repository element was not specified in the POM inside distributionManagement element or in -DaltDeploymentRepository=id::layout::url parameter -> [Help 1]
这时候还需要配置对应maven工程的pom.xml文件,增加如下配置:
<!--用于配置分发管理,配置相应的产品发布信息,主要用于发布,在执行mvn deploy后表示要发布的位置 -->
<distributionManagement> <repository> <id>free4lab</id> <name>Free4lab Repository</name> <url>http://maven.free4lab.com/artifactory/libs-snapshot-local</url> </repository> </distributionManagement>
Maven项目获取classpath和资源文件路径:
在maven项目中,配置文件放在maven工程的src/main/resources资源文件夹下,java文件在src/main/java下,如何在java文件中加载配置文件。使用如下代码:
MyClass.class.getClassLoder().getResource(FILE_NAME).getPath();