刨析Maven(对pom.xml配置文件常用标签的解析)

  昨天在阿里云看到了一句话,“当你Learning和Trying之后,如果能尽量把Teaching也做好,会促进我们思考”。共勉!

  这是关于Maven的第三篇博客,这次我们深入了解pom.xml配置文件,它是Maven项目的基础文件,也是最为重要的文件。

  一、对本项目的声明:

  

  如上图所示,这段截取的代码是一个普通项目的配置的开始,是对本项目的声明,其中——

  <modleVersion/>标签:指定了当前pom的版本。

  <groupId/>标签:定义了该项目属于哪个组,这与所在的组织和公司是有关联的,它是该组织域名的倒置。而对于私人来说,比如我,cn代表中国,zuoyu是我在网络世界的ID,account代表这个项目的名字。

  <artifactId/>标签:这个定义了当前Maven项目组中的唯一ID,可以理解为一个大项目中的一个小项目,比如这个,就是account项目中的邮件服务模块。

  <version/>标签:顾名思义,这是版本说明,而SNAPSHOT说明版本不稳定。

  <packaging/>标签:这个是指定打包方式,如果不说明,默认为jar方式。

  <name/>标签:这个是给该项目起一个更友好的名字,方便交流。

  <url/>标签:该项目的主页URL,用于生成Maven文档使用,一般私人写是用不到的。

 

  二、坐标与依赖

  

  如上图所示,这段截取代码是一段对依赖的说明,其中——

  <dependencies/>标签:是依赖的root目录,所有的依赖都要放在这个大标签内。

  <dependency/>标签:代表着一个依赖,里面声明要依赖的信息。

  <groupId/>标签:定义当前Maven项目隶属的实际项目。如果你与之前的本项目声明信息中的groupId联想一下,你就会明白。

   <artifactId/>标签:该元素定义实际项目中的一个Maven项目(模块)。

  <version/>标签:定义当前Maven项目所处的版本。

  <scope/>标签:对依赖范围的说明,这个我们看下面...

  依赖范围说明

  首先我们要清楚,Maven环境里有三个ClassPath:分别为编译ClassPath、测试ClassPath、运行ClassPath。

  依赖范围就是为了控制依赖与这三种ClassPath的关系,在Maven中有以下几种ClassPath:

  

  除此之外,还有一个import的导入依赖范围,与<dependencyManagement/>标签有关。

  三、插件的配置

  

  这是一段对插件描述的截取代码段,这个插件是几乎所有Maven项目都要声明的插件,即编译插件声明,没有此声明,项目就无法编译。其中——

  <build/>标签:是对项目构建声明的大标签,里面所有声明都与项目的构建有关。

  <plugins/>标签:这个是所有插件的root标签。

  <plugin/>标签:此标签代表为一个插件。

  <groupId/>、<artifactId/>和<version/>三个标签声明了该插件的坐标。

  <configuration/>标签:此标签内声明了对该插件的配置,此标签内的子标签随着插件的不同而不同,变化多端,不细说,见多了就会了。

 

  四、资源路径的配置

  

  这段截取的代码段是关于资源路径的配置,是指定资源被打包后所放位置。在这其中——

  <resources/>标签:这个元素描述了项目相关的所有资源路径列表。

  <resource/>标签:其中的一个资源路径配置,例如和项目相关的属性文件,这些资源被包含在最终的打包文件里。

  <directory/>标签:描述存放资源的目录,该路径相对POM路径,用来指定resources插件处理哪个目录下的资源文件。

  <includes/>标签:包含的模式列表,就是该操作都操作哪些文件。

  其中还有一些标签没有用得上,比如——

  <excludes/>标签:与<includes/>标签对立,排除的模式列表。

  <targetPath/>标签:指定打包后该资源所放位置。

  <filtering/>标签:是否使用参数值代替参数名。参数值取自properties元素或者文件里配置的属性,文件在filters元素里列出。

  <filters/>标签:当filtering开关打开时,使用到的过滤器属性文件列表。

 

  五、测试资源路径的配置:

  

  这段截取代码是对测试资源路径的描述,与资源配置路径大同小异,描述了单元测试相关的所有资源路径,例如和单元测试相关的属性文件。

  

  六、全局配置

  

  这个配置非常的自由,你可以声明出任何标签——

  其中的<project.build.sourceEncoding/>声明了该项目构建的字符编码为UTF-8格式。当你在配置build的内容时,它会隐式的起到作用。

  其中的<springframework.version/>声明了该项目的spring依赖包为2.5.6版本,是我声明的标签,当然你必须这样使用才行:

  

 

  O(∩_∩)O,这些都是常用的标签,我给了一下总结,当然Maven的pom.xml还有很多标签,以后用到了再研究吧!

  还有关于Maven的继承与聚合中某些标签的用法,请移步至  我的Maven的多模块博客

  博客中如有不严谨、不恰当的描述,欢迎批评。

  我的邮箱:  zuoyuip@qq.com

 

  

posted @ 2018-04-10 13:03  左羽  阅读(1588)  评论(0编辑  收藏  举报