您的位置: 首页  >  文章  >  Maven之（七）pom.xml配置文件详解

Maven之（七）pom.xml配置文件详解

分类: 文章 • 2023-12-25 15:30:09

https://blog.csdn.net/u012152619/article/details/51485297


setting.xml主要用于配置maven的运行环境等一系列通用的属性，是全局级别的配置文件；而pom.xml主要描述了项目的maven坐标，依赖关系，开发者需要遵循的规则，缺陷管理系统，组织和licenses，以及其他所有的项目相关因素，是项目级别的配置文件。


基础配置

一个典型的pom.xml文件配置如下：

[html] view plain copy
  1. <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"  
  2.     xsi:schemaLocation="http://maven.apache.org/POM/4.0.0http://maven.apache.org/xsd/maven-4.0.0.xsd">  
  3.   
  4.     <!-- 模型版本。maven2.0必须是这样写，现在是maven2唯一支持的版本 -->  
  5.     <modelVersion>4.0.0</modelVersion>  
  6.   
  7.     <!-- 公司或者组织的唯一标志，并且配置时生成的路径也是由此生成， 如com.winner.trade，maven会将该项目打成的jar包放本地路径：/com/winner/trade -->  
  8.     <groupId>com.winner.trade</groupId>  
  9.   
  10.     <!-- 本项目的唯一ID，一个groupId下面可能多个项目，就是靠artifactId来区分的 -->  
  11.     <artifactId>trade-core</artifactId>  
  12.   
  13.     <!-- 本项目目前所处的版本号 -->  
  14.     <version>1.0.0-SNAPSHOT</version>  
  15.   
  16.     <!-- 打包的机制，如pom,jar, maven-plugin, ejb, war, ear, rar, par，默认为jar -->  
  17.     <packaging>jar</packaging>  
  18.   
  19.     <!-- 帮助定义构件输出的一些附属构件,附属构件与主构件对应，有时候需要加上classifier才能唯一的确定该构件 不能直接定义项目的classifer,因为附属构件不是项目直接默认生成的，而是由附加的插件帮助生成的 -->  
  20.     <classifier>...</classifier>  
  21.   
  22.     <!-- 定义本项目的依赖关系 -->  
  23.     <dependencies>  
  24.   
  25.         <!-- 每个dependency都对应这一个jar包 -->  
  26.         <dependency>  
  27.   
  28.             <!--一般情况下，maven是通过groupId、artifactId、version这三个元素值（俗称坐标）来检索该构件， 然后引入你的工程。如果别人想引用你现在开发的这个项目（前提是已开发完毕并发布到了远程仓库），-->   
  29.             <!--就需要在他的pom文件中新建一个dependency节点，将本项目的groupId、artifactId、version写入， maven就会把你上传的jar包下载到他的本地 -->  
  30.             <groupId>com.winner.trade</groupId>  
  31.             <artifactId>trade-test</artifactId>  
  32.             <version>1.0.0-SNAPSHOT</version>  
  33.   
  34.             <!-- maven认为，程序对外部的依赖会随着程序的所处阶段和应用场景而变化，所以maven中的依赖关系有作用域(scope)的限制。 -->  
  35.             <!--scope包含如下的取值：compile（编译范围）、provided（已提供范围）、runtime（运行时范围）、test（测试范围）、system（系统范围） -->  
  36.             <scope>test</scope>  
  37.   
  38.             <!-- 设置指依赖是否可选，默认为false,即子项目默认都继承:为true,则子项目必需显示的引入，与dependencyManagement里定义的依赖类似  -->  
  39.             <optional>false</optional>  
  40.   
  41.             <!-- 屏蔽依赖关系。 比如项目中使用的libA依赖某个库的1.0版，libB依赖某个库的2.0版，现在想统一使用2.0版，就应该屏蔽掉对1.0版的依赖 -->  
  42.             <exclusions>  
  43.                 <exclusion>  
  44.                     <groupId>org.slf4j</groupId>  
  45.                     <artifactId>slf4j-api</artifactId>  
  46.                 </exclusion>  
  47.             </exclusions>  
  48.   
  49.         </dependency>  
  50.   
  51.     </dependencies>  
  52.   
  53.     <!-- 为pom定义一些常量，在pom中的其它地方可以直接引用 使用方式 如下 ：${file.encoding} -->  
  54.     <properties>  
  55.         <file.encoding>UTF-8</file.encoding>  
  56.         <java.source.version>1.5</java.source.version>  
  57.         <java.target.version>1.5</java.target.version>  
  58.     </properties>  
  59.   
  60.     ...  
  61. </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无法唯一的确定某个构件，需要借助classifier来进一步明确目标。比如JSON-lib，有时候会同一个版本会提供多个jar包，在JDK1.5环境下是一套，在JDK1.3环境下是一套：

Maven之（七）pom.xml配置文件详解

引用它的时候就要注明JDK版本，否则maven不知道你到底需要哪一套jar包


相关推荐