Maven之l配置⽂件详解
此⽂⾮原创,摘⾃:
POM介绍
POM是项⽬对象模型(Project Object Model)的简称,它是Maven项⽬中的⽂件,使⽤XML表⽰,名称叫做l。作⽤类似ant的l ⽂件,功能更强⼤。该⽂件⽤于管理:源代码、配置⽂件、开发者的信息和⾓⾊、问题追踪系统、组织信息、项⽬授权、项⽬的url、项⽬的依赖关系等等。事实上,在Maven世界中,project可以什么都没有,甚⾄没有代码,但是必须包含l⽂件。
基础配置
⼀个典型的l⽂件配置如下,注意,其中的modelVersion是4.0.0,这是当前仅有的可以被Maven2&3同时⽀持的POM版本,它是必须的。
<project xmlns="/POM/4.0.0"
xmlns:xsi="/2001/XMLSchema-instance"
xsi:schemaLocation="/POM/4.0.0
/xsd/maven-4.0.0.xsd">
<!--
模型版本。maven2.0必须是这样写,现在是maven2唯⼀⽀持的版本
-->
<modelVersion>4.0.0</modelVersion>
<!--
公司或者组织的唯⼀标志,并且配置时⽣成的路径也是由此⽣成,如ade,maven会将该项⽬打成的jar包放本地路径:/com/winner/trade
含义:组织标识,定义了项⽬属于哪个组,风向标,坐标,或者说若把本项⽬打包
⽤途:此名称则是本地仓库中的路径,列如:ade,在M2_REPO⽬录下,将是: /com/winner/trade⽬录
命名规范:项⽬名称,模块,⼦模块
-->
<groupId>ade</groupId>
<!--
本项⽬的唯⼀ID,⼀个groupId下⾯可能多个项⽬,就是靠artifactId来区分的
含义:项⽬名称也可以说你所模块名称,定义当⾯Maven项⽬在组中唯⼀的ID
⽤途:例如:trade-core,在M2_REPO⽬录下,将是:/com/winner/trade/trade-core⽬录
命名规范:唯⼀就好
-->
<artifactId>trade-core</artifactId>
<!--
本项⽬⽬前所处的版本号
含义:项⽬当前的版本号
⽤途:例如:0.0.1-SNAPSHOT,在M2_REPO⽬录下,将是:/com/winner/trade/trade-core/0.0.1-SNAPSHOT⽬录
-->
<version>1.0.0-SNAPSHOT</version>
<!-- 打包的机制,如pom,jar, maven-plugin, ejb, war, ear, rar, par,默认为jar -->
<packaging>jar</packaging>
<!-- 元素声明了⼀个对⽤户更为友好的项⽬名称 -->
<name>maven</name>
<!--
帮助定义构件输出的⼀些附属构件,附属构件与主构件对应,有时候需要加上classifier才能唯⼀的确定该构件
不能直接定义项⽬的classifer,因为附属构件不是项⽬直接默认⽣成的,⽽是由附加的插件帮助⽣成的
-->
<classifier>...</classifier>
<!-- 定义本项⽬的依赖关系 -->
<dependencies>
<!-- 每个dependency都对应这⼀个jar包 -->
<dependency>
<!--
⼀般情况下,maven是通过groupId、artifactId、version这三个元素值(俗称坐标)来检索该构
件,
然后引⼊你的⼯程。如果别⼈想引⽤你现在开发的这个项⽬(前提是已开发完毕并发布到了远程仓库),
-->
<!--
就需要在他的pom⽂件中新建⼀个dependency节点,将本项⽬的groupId、artifactId、version写⼊,
maven就会把你上传的jar包下载到他的本地
-->
<groupId>ade</groupId>
<artifactId>trade-test</artifactId>
<version>1.0.0-SNAPSHOT</version>
<!-- maven认为,程序对外部的依赖会随着程序的所处阶段和应⽤场景⽽变化,所以maven中的依赖关系有作⽤域(scope)的限制。 -->
<!--scope包含如下的取值:compile(编译范围)、provided(已提供范围)、runtime(运⾏时范围)、test(测试范围)、system(系统范围) -->
<scope>test</scope>
<!-- 设置指依赖是否可选,默认为false,即⼦项⽬默认都继承:为true,则⼦项⽬必需显⽰的引⼊,与dependencyManagement⾥定义的依赖类似 -->
<optional>false</optional>properties是什么文件
<!-- 屏蔽依赖关系。⽐如项⽬中使⽤的libA依赖某个库的1.0版,libB依赖某个库的2.0版,现在想统⼀使⽤2.0版,就应该屏蔽掉对1.0版的依赖 -->
<exclusions>
<exclusion>
<groupId>org.slf4j</groupId>
ppt主题模板<artifactId>slf4j-api</artifactId>
</exclusion>
</exclusions>
</dependency>
</dependencies>
<!-- 为pom定义⼀些常量,在pom中的其它地⽅可以直接引⽤使⽤⽅式如下:${ding} -->
<properties>
&ding>UTF-8</ding>
<java.source.version>1.5</java.source.version>
<java.target.version>1.5</java.target.version>
</properties>
.
..
</project>
⼀般来说,上⾯的⼏个配置项对任何项⽬都是必不可少的,定义了项⽬的基本属性。
这⾥有必要对⼀个不太常⽤的属性classifier做⼀下解释,因为有时候引⽤某个jar包,classifier不写的话会报错。
classifier元素⽤来帮助定义构件输出的⼀些附属构件。附属构件与主构件对应,⽐如主构件是 kimi-app-2.0.0.jar,该项⽬可能还会通过使⽤⼀些插件⽣成如kimi-app-2.0.0-javadoc.jar (Java⽂档)、 kimi-app-2.0.0-sources.jar(Java源代码)这样两个附属构件。这时
候,javadoc、sources就是这两个附属构件的classifier,这样附属构件也就拥有了⾃⼰唯⼀的坐标。
classifier的⽤途在于:
1. maven download javadoc / sources jar包的时候,需要借助classifier指明要下载那个附属构件
2. 引⼊依赖的时候,有时候仅凭groupId、artifactId、version⽆法唯⼀的确定某个构件,需要借助clas
sifier来进⼀步明确⽬标。⽐如JSON-lib,有时候会同⼀个版本会提供多个jar包,在JDK1.5环境下是⼀套,在JDK1.3环境下是⼀套:
引⽤它的时候就要注明JDK版本,否则maven不知道你到底需要哪⼀套jar包:
<dependency>
<groupId>net.sf.json-lib</groupId>
<artifactId>json-lib</artifactId>
<version>2.4</version>
<classifier>jdk15</classifier>
</dependency>
构建配置
<build>
<!-- 产⽣的构件的⽂件名,默认值是${artifactId}-${version}。 -->
<finalName>myPorjectName</finalName>
<!-- 构建产⽣的所有⽂件存放的⽬录,默认为${basedir}/target,即项⽬根⽬录下的target -->
<directory>${basedir}/target</directory>
<!--当项⽬没有规定⽬标(Maven2叫做阶段(phase))时的默认值, -->
<!--必须跟命令⾏上的参数相同例如jar:jar,或者与某个阶段(phase)相同例如install、compile等 -->
<defaultGoal>install</defaultGoal>
<!--当filtering开关打开时,使⽤到的过滤器属性⽂件列表。 -->
<!--项⽬配置信息中诸如${spring.version}之类的占位符会被属性⽂件中的实际值替换掉 -->
<filters>
<filter>../filter.properties</filter>
</filters>
<!--项⽬相关的所有资源路径列表,例如和项⽬相关的配置⽂件、属性⽂件,这些资源被包含在最终的打包⽂件⾥。 -->
<resources>
<resource>
<!--描述了资源的⽬标路径。该路径相对target/classes⽬录(例如${project.build.outputDirectory})。 -->
<!--举个例⼦,如果你想资源在特定的包⾥(org.ssages),你就必须该元素设置为org/apache/maven/messages。 -->
<!--然⽽,如果你只是想把资源放到源码⽬录结构⾥,就不需要该配置。 -->
<targetPath>resources</targetPath>
<!--是否使⽤参数值代替参数名。参数值取⾃properties元素或者⽂件⾥配置的属性,⽂件在filters元素⾥列出。 -->
<filtering>true</filtering>
<!--描述存放资源的⽬录,该路径相对POM路径 -->
<directory>src/main/resources</directory>
<!--包含的模式列表 -->
<includes>
<include>**/*.properties</include>
<include>**/*.xml</include>
</includes>
<!--排除的模式列表如果<include>与<exclude>划定的范围存在冲突,以<exclude>为准 -->
<excludes>
<exclude>jdbc.properties</exclude>
</excludes>
</resource>
</resources>
<!--单元测试相关的所有资源路径,配制⽅法与resources类似 -->
<testResources>
<testResource>
<targetPath />
<filtering />
<directory />
<includes />
网络编程技术pdf下载<excludes />
</testResource>
</testResources>
<!--项⽬源码⽬录,当构建项⽬的时候,构建系统会编译⽬录⾥的源码。该路径是相对于l的相对路径。 -->
<sourceDirectory>${basedir}\src\main\java</sourceDirectory>
<!--项⽬脚本源码⽬录,该⽬录和源码⽬录不同, <!-- 绝⼤多数情况下,该⽬录下的内容会被拷贝到输出⽬录(因为脚本是被解释的,⽽不是被编译的)。 --> <scriptSourceDirectory>${basedir}\src\main\scripts
</scriptSourceDirectory>
<!--项⽬单元测试使⽤的源码⽬录,当测试项⽬的时候,构建系统会编译⽬录⾥的源码。该路径是相对于l的相对路径。 -->
<testSourceDirectory>${basedir}\src\test\java</testSourceDirectory>
<!--被编译过的应⽤程序class⽂件存放的⽬录。 -->
<outputDirectory>${basedir}\target\classes</outputDirectory>
<!--被编译过的测试class⽂件存放的⽬录。 -->
<testOutputDirectory>${basedir}\target\test-classes
</testOutputDirectory>
<!--项⽬的⼀系列构建扩展,它们是⼀系列build过程中要使⽤的产品,会包含在running bulid‘s classpath⾥⾯。 -->
<!--他们可以开启extensions,也可以通过提供条件来激活plugins。 -->
<!--简单来讲,extensions是在build过程被激活的产品 -->
<extensions>
<!--例如,通常情况下,程序开发完成后部署到线上Linux服务器,可能需要经历打包、 -->
<!--将包⽂件传到服务器、SSH连上服务器、敲命令启动程序等⼀系列繁琐的步骤。 -->
<!--实际上这些步骤都可以通过Maven的⼀个插件 wagon-maven-plugin 来⾃动完成 -->
<!--下⾯的扩展插件wagon-ssh⽤于通过SSH的⽅式连接远程服务器, -->
<!--类似的还有⽀持ftp⽅式的wagon-ftp插件 -->
<extension>
<groupId>org.apache.maven.wagon</groupId>
<artifactId>wagon-ssh</artifactId>
<version>2.8</version>
</extension>
</extensions>
<!--使⽤的插件列表。 -->
<plugins>
<plugin>
<groupId></groupId>
<artifactId>maven-assembly-plugin</artifactId>
<version>2.5.5</version>
<!--在构建⽣命周期中执⾏⼀组⽬标的配置。每个⽬标可能有不同的配置。 -->
<executions>
<execution>
<!--执⾏⽬标的标识符,⽤于标识构建过程中的⽬标,或者匹配继承过程中需要合并的执⾏⽬标 -->
<id>assembly</id>
<!--绑定了⽬标的构建⽣命周期阶段,如果省略,⽬标会被绑定到源数据⾥配置的默认阶段 -->
<phase>package</phase>
<!--配置的执⾏⽬标 -->
<goals>
<goal>single</goal>
</goals>
<!--配置是否被传播到⼦POM -->
<inherited>false</inherited>
</execution>
</executions>
<!--作为DOM对象的配置,配置项因插件⽽异 -->
<configuration>
<finalName>${finalName}</finalName>
<appendAssemblyId>false</appendAssemblyId>
<descriptor&l</descriptor>
</configuration>
<!--是否从该插件下载Maven扩展(例如打包和类型处理器), -->
<!--由于性能原因,只有在真需要下载时,该元素才被设置成true。 -->
<extensions>false</extensions>
手机论坛app源码<!--项⽬引⼊插件所需要的额外依赖 -->bower安装
<dependencies>
<dependency>...</dependency>
</dependencies>
<!--任何配置是否被传播到⼦项⽬ -->
<inherited>true</inherited>
</plugin>
</plugins>
<!--主要定义插件的共同元素、扩展元素集合,类似于dependencyManagement, -->
系统全套源码<!--所有继承于此项⽬的⼦项⽬都能使⽤。该插件配置项直到被引⽤时才会被解析或绑定到⽣命周期。 -->
<!--给定插件的任何本地配置都会覆盖这⾥的配置 -->
<pluginManagement>
<plugins>...</plugins>
</pluginManagement>
</build>
pom⾥⾯的仓库与l⾥的仓库功能是⼀样的。主要的区别在于,pom⾥的仓库是个性化的。⽐如⼀家⼤公司⾥的setting⽂件是公⽤的,所有项⽬都⽤⼀个setting⽂件,但各个⼦项⽬却会引⽤不同的第三⽅库,所以就需要在pom⾥设置⾃⼰需要的仓库地址。
分发配置
<!--项⽬分发信息,在执⾏mvn deploy后表⽰要发布的位置。 -->
<!--有了这些信息就可以把⽹站部署到远程服务器或者把构件部署到远程仓库。 -->
<distributionManagement>
<!--部署项⽬产⽣的构件到远程仓库需要的信息 -->
<repository>
<!--是分配给快照⼀个唯⼀的版本号(由时间戳和构建流⽔号),还是每次都使⽤相同的版本号 -->
<!--参见repositories/repository元素 -->
<uniqueVersion>true</uniqueVersion>
<id> repo-id </id>
<name> repo-name</name>
<url>file://${basedir}/target/deploy </url>
<layout />
</repository>
<!--构件的快照部署到哪⾥,如果没有配置该元素,默认部署到repository元素配置的仓库 -->
<snapshotRepository>
<uniqueVersion />
<id />
<name />
<url />
<layout />
</snapshotRepository>
<!--部署项⽬的⽹站需要的信息 -->
<site>
<!--部署位置的唯⼀标识符,⽤来匹配站点和l⽂件⾥的配置 -->
<id> site-id </id>
<!--部署位置的名称 -->
<name> site-name</name>
<!--部署位置的URL,按protocol://hostname/path形式 -->
<url>scp://svn.baidu/banseon:/var/www/localhost/banseon-web </url>
</site>
<!--项⽬下载页⾯的URL。如果没有该元素,⽤户应该参考主页。 -->
<!--使⽤该元素的原因是:帮助定位那些不在仓库⾥的构件(由于license限制)。 -->
<downloadUrl />
<!--如果构件有了新的groupID和artifact ID(构件移到了新的位置),这⾥列出构件的重定位信息。 -->
<relocation>
<!--构件新的group ID -->
<groupId />
<!--构件新的artifact ID -->
<artifactId />
<!--构件新的版本号 -->
<version />
<!--显⽰给⽤户的,关于移动的额外信息,例如原因。 -->
<message />
</relocation>
<!--给出该构件在远程仓库的状态。不得在本地项⽬中设置该元素,因为这是⼯具⾃动更新的。 -->
<!--有效的值有:none(默认),converted(仓库管理员从Maven 1 POM转换过来), -->
<!--partner(直接从伙伴Maven 2仓库同步过来),deployed(从Maven 2实例部署),verified(被核实时正确的和最终的)。 --> <status />
</distributionManagement>
仓库配置
<!--发现依赖和扩展的远程仓库列表。 -->
<repositories>
<!--包含需要连接到远程仓库的信息 -->
<repository>
<!--如何处理远程仓库⾥发布版本的下载 -->
<releases>
<!--true或者false表⽰该仓库是否为下载某种类型构件(发布版,快照版)开启。 -->
<enabled />
<!--该元素指定更新发⽣的频率。Maven会⽐较本地POM和远程POM的时间戳。 -->
<!--这⾥的选项是:always(⼀直),daily(默认,每⽇), -->
<!--interval:X(这⾥X是以分钟为单位的时间间隔),或者never(从不)。 -->
<updatePolicy />
<!--当Maven验证构件校验⽂件失败时该怎么做: -->
<!--ignore(忽略),fail(失败),或者warn(警告)。 -->
<checksumPolicy />
</releases>
版权声明:本站内容均来自互联网,仅供演示用,请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198,我们将在24小时内删除。
发表评论