Maven使用入门
通过上一节的学习,我们已经了解和配置好了Maven,接下来需要编写代码了
1.POM(Project Object Model,项目对象模型)
和Make的Makefile类似,Maven项目的核心是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>team.kirohuji</groupId>
<artifactId>Test</artifactId>
<version>0.0.1-SNAPSHOT</version>
<name>Test</name>
<packaging>war</packaging>
</project>
这是一个基本的pom.xml文件的内容
groupId,artifactId和version这三行,这三个元素定义了一项目的基本的坐标(Coordinate),
groupId:定义当前Maven项目的实际项目
artifactId:定义实际项目中的一个实际的Maven项目(模块)
version: 当前版本号,直接回车,默认是1.0-SNAPSHOT
packaging:Maven项目的打包方式
name元素声明了一个Maven项目的项目名称,这个不是必要的
classifier:用来帮助定义构建输出的一些附属构件,不能直接定义项目的classifier,因为附属构件不是项目直接默认生成的,而是由附加的插件帮助生成
项目的名称的一般规律也是:artifactId-version [-classifier].packing,[-classifier]表示可选
2.依赖的配置
<?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>team.kirohuji</groupId> <artifactId>tset3</artifactId> <version>1.0-SNAPSHOT</version> <packaging>war</packaging> <name>tset3</name> <dependencies> <dependency> <groupId>javax</groupId> <artifactId>javaee-web-api</artifactId> <version>7.0</version> <scope>provided</scope> </dependency> </dependencies> </project>
一个依赖一般可以包含以下一些元素
<project> ... <dependencies> <dependency> <groupId>...</groupId> <artifactId>... </artifactId> <version>...</version> <type>...</type> <scope>...</scope> <optional>...</optional> <exelusions> <exclusion> ... </exclusion> ... </exelusions> </dependency> </dependencies>
groupId,artifactId和version:依赖的坐标
type:依赖的类型,对应项目坐标定义的packing,一般不必声明,其默认值是jar
scope:依赖的范围
optional:标记依赖是否可选
exclusions:用来排除传递性依赖
大部分依赖声明只包含基本坐标即可
(1).依赖的范围
Maven在编译项目主代码的时候需要使用一套classpath,其次Maven在编译和执行测试的时候会使用另一套calsspath
依赖范围就是用来控制这三种classpath(编译,测试,运行)的关系,Maven有以下几种依赖范围:
a. compile:编译依赖范围,默认使用此依赖范围,使用此依赖,对编译,测试,运行三种classpath都有效
b. test:测试依赖范围,即对测试classpath有效
c. provided:已提供依赖范围.对于编译和测试classpath有效,但运行时无效
d. runtime:运行时依赖范围:使用此依赖范围的Maven依赖,对于测试和运行classpath有效,但在编译主代码时无效
e. system:系统依赖范围:该依赖和provided依赖范围完全一直,但是,使用system范围的依赖时必须通过systemPath元素显式地指定依赖文件的路径,由于此类依赖不是通过Maven仓库解析的,而且往往与本机系统绑定,可能造成构建的不可移植,因此谨慎使用,systemPath元素可以引用环境变量
f.import(Maven 2.0.9及以上):导入依赖范围
(2).传递性依赖
1.假设 A 依赖 B , B 依赖 C ,我们称 A 对 B 是第一直接依赖, B 对 C 是第二直接依赖, A 对 C 是传递依赖
2.依赖调解:两个原则:路径最近优先原则和第一声明者优先
3.<optiona>可以声明是否实现依赖特性true或false
4.排除依赖即使用<exclusions>元素进行配置
5.Maven会自动解析所有项目的直接依赖和传递性依赖,进行一系列的配置,最后得到的那些依赖称为已解析依赖(Resolved Dependency),可以运行
mvn dependency:list
命令查看已解析依赖
3.仓库
Maven通过仓库来统一管理这些文件,在Maven的世界中,任何一个依赖,插件或者项目构建的输出,都可以称为构件,任何一个构建都有唯一的一个坐标,这便是Maven的仓库布局方式,Maven仓库是基于简单文件系统存储的
(1)本地仓库和远程仓库
对于Maven来说,仓库分为两种:本地仓库和远程仓库,首先Maven会根据坐标寻找构件,首先查看本地仓库,如果没有此构件,则会在远程仓库中寻找,有的话,就会下载到本地仓库,还有其它特殊的仓库:中央仓库和私服,其他公共库
(2)本地仓库
在每个用户的目录下都有一个路径名为.m2/repository/仓库路径,可以在~/.m2/settings.xml中设置localRepository元素的值为想要的仓库地址:
<settings> <localRepository>/home/zyd/Desktop/Repository</localRepository> </settings>
一般~/.m2/中没有settings.xml的,用户需要从Maven安装目录复制/conf/settings.xml文件到~/.m2/下,再进行文件配置
一个构件只有在本地仓库中之后,才能由其他Maven项目使用,最常见的方式是从远程仓库下载到本地仓库,还有方式是把本地项目的构件安装到Maven仓库中,比如本地项目A在项目中执行
mvn clean instal
首先是清理target文件夹,二进制文件就不需要加入仓库中,然后Install插件的install目标将项目的构建输出文件安装到本地仓库
(3)远程仓库
安装好Maven后,一般本地仓库目录是不存在的,当用户使用了第一条Maven命令之后,Maven才会创建本地仓库,然后根据配置和需要,从远程仓库中下载构件到本地仓库
(4)中央仓库
由于原始的本地仓库是空的,Maven必须知道至少一个可用的远程仓库,才能执行Maven命令,中央仓库就是一个默认的远程仓库,Maven 的安装文件自带了中央仓库的配置,在Maven文件夹的lib里的maven-model-builder-3.5.0.jar,打开访问路径/org/apache/maven/model/pom-4.0.0.xml,文件配置如下:
<repositories> <repository> <id>central</id> <name>Central Repository</name> <url>https://repo.maven.apache.org/maven2</url> <layout>default</layout> <snapshots> <enabled>false</enabled> </snapshots> </repository> </repositories>
包括这段配置的文件是所有Maven项目都会继承的超级POM
(5)私服
私服是一种特殊的远程仓库,它是架设在局域网内的仓库服务,私服代理广域网上的远程仓库,供局域网内的Maven用户使用
(6)远程仓库的配置
很多时候,默认的中央仓库无法满足项目的需求,可能项目需要的构件存于另外一个远程仓库,比如JBoss Maven仓库,这时可以在POM中配置该仓库,代码如下:
<project> ... <repositories> <repository> <id>jboss</id> <name>JBoss Repository</name> <url>http://repository.jboss.com/maven2/</url> <releases> <enabled>true</enabled> </releases> <snapshots> <enabled>false</enabled> </snapshots> <layout>default</layout> </repository> </repositories> ... </project>
在repositories元素下,可以使用repository子元素声明一个或多个远程仓库,release和snapshots元素比较重要,它们用来控制Maven对于发布版构件和快照版构件的下载,表示开启JBoss仓库的发布版本下载支持
对于releases和snapshots来说,除了enabled,它们还包含另外两个子元素updatePolicy和checksumPolicy:
<snapshots> <enabled>true</enabled> <updatePolicy>daily</updatePolicy> <checksumPolicy>ignore</checksumPolicy> </snapshots>
元素updatePolicy用来配置Maven从远程仓库检查更新的频率,默认的值是daliy,表示Maven每天检查一次,其他的可用值包括:never--从不检查;always--每次构建都检查更新;interval:
X--每隔X分钟检查一次更新(X为任意整数)
元素checksumPolicy用来配置Maven检查检验和文件的策略,checksumPolicy的值默认的warn时,Maven会在执行构建输出警告信息,其他可用的值包括:fail--Maven遇到校验和错误就让构建失败;ignore--使Maven完全忽略校验和错误
(7)远程仓库的认证
大部分远程仓库无须认证就可以访问,但有时候出于安全考虑,我们需要提供认证信息才能访问一些远程仓库,管理员可以为每个仓库提供了一组用户名以及密码,认证是在settings.xml文件中
<settings> ... <servers> <server> <id>my-proj</id> <username>repo-user</username> <password>repo-pwd</password> </server> </servers> ... </settings>
Maven使用settings.xml文件中并不显而易见的servers元素以及其server子元素配置仓库认证信息
(8)部署至远程仓库
私服的一大作用是部署第三方构件,包括组织内部生成构件以及一些无法从外部仓库直接获取的构件,无论是日常开发中生成的构件,还是证实版本发布的构件,都需要部署到仓库中,供其他团队成员使用.Maven除了能对项目进行编译,测试,打包之外,还能将项目生成的构建部署到仓库中,首先,需要编辑项目的pom.xml文件,配置distributionManagement元素
<project> ... <distributionManagement> <repository> <id>proj-releases</id> <name>Proj Release Repository</name> <url>http://192.168.1.100/content/repositories/proj-releases</url> </repository> <snapshotRepository> <id>proj-snapshots</id> <name>Proj Snapshot Repository</name> <url>http://192.168.1.100/content/repositories/proj-snapshots</url> </snapshotRepository> </distributionManagement> ... </project>
前者表示发布版本构件的仓库,后者表示快照版本的仓库,配置完成
mvn clean deploy
Maven就会将项目构件部署到配置对应的远程仓库,如果项目当前的版本是快照版本,则会部署到快照版本仓库地址
(9)镜像
如果仓库A可以提供仓库B存储的所有内容,那么就可以认为A是B的一个镜像,就是任何一个可以从仓库A获得的构件,都能从它的镜像中获得,比如中央仓库和国内仓库的镜像,由于地理位置的因素,该镜像往往能够提供比中央仓库更快的服务,因此可以配置Maven使用该镜像来代替中央仓库,编辑settings.xml
<settings> ... <mirrors> <mirror> <id>maven.net.cn</id> <name>one of the central mirrors in China</name> <url>http://maven.net.cn/content/groups/public/</url> <mirrorOf>central</mirrorOf> </mirror> </mirrors> ... </settings>
该<mirrorOf>的值为central,表示改配置为中央仓库的镜像