Maven(一) pom 文件介绍及 parent、properties 标签详解

pom.xml 介绍

pom 作为项目对象模型。通过 xml 表示 maven 项目,使用 pom.xml 来实现。主要描述了项目:包括配置文件;开发者需要遵循的规则,缺陷管理系统,组织和licenses,项目的url,项目的依赖性,以及其他所有的项目相关因素。

pom 中的描述信息都是用xml标签的方式,其中包含双标签和单标签,最顶部用于描述 xml 得版本和编码,其次是以 project 开头得双标签并表示为一个项目,定义了该项目可用内容及规范。

# 双标签
<project></project>

# 单标签
<project/>

对于 pom 可用内容较多,一级标签有如下表所示,但常用的都会有对应的描述

标签 描述
                       modelVersion                        当前模型使用的版本
parent 继承某个pom,部分是不可继承的
groupId 公司或组织着唯一标识,如 org.springframework.boot 第一段是域(org、com 非盈利组织、商业组织),第二段是公司名称,第三段是应用名称
artifactId 项目的唯一ID
version 项目所属的版本号
name 项目名称
description 项目描述信息
properties 配置信息描述,更多的是描述依赖jar版本、项目版本等
dependencies 所要依赖的jar都需要在这里描述
build 构建信息,包括插件,资源文件信息等
profiles 作用于项目环境的切换(dev、test、produce)
packaging 描述项目的类型,可选pom、jar、war
repositories 用是用来配置maven项目的远程仓库,可以是私服(nexus)
modules 用来配置子项目
dependencyManagement 用来提供了一种管理依赖版本号的方式。通常会在项目的最顶层的父POM 中看到该元素。使用pom.xml 中的dependencyManagement 元素能让所有在子项目中引用一个依赖而不用显式的列出版本号
distributionManagement 用于分发构件到远程仓库;mvn install 会将项目生成的构件安装到本地Maven仓库,mvn deploy 用来将项目生成的构件分发到远程Maven仓库。本地Maven仓库的构件只能供当前用户使用,在分发到远程Maven仓库之后,所有能访问该仓库的用户都能使用你的构件。
pluginRepositories 配置Maven从什么地方下载插件
scm 集成了软件配置管理的,他可以支持我们常用SVN、CVS等
developers 配置开发者信息,例如:一个开发者可以有多个roles,properties
issueManagement bug跟踪管理系统,定义defect tracking system缺陷跟踪系统
reporting 包含site生成阶段的一些元素,某些maven plugin可以生成 reports 并且在 reporting 下配置
url 开发团队的网站,无关紧要可选
licenses 许可证信息配置
organization 配置组织信息
ciManagement ?
contributors ?
inceptionYear ?
mailingLists ?
prerequisites ?
reports ?

以一个 spring boot 常规项目做为示例:

<?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 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <!-- 继承spring-boot使用他的相关依赖 -->
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.6.9</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>
    <!-- 组织,应用 -->
    <groupId>com.xxx.boot</groupId>
    <!-- 项目ID,一般都喜欢是名称 -->
    <artifactId>framework</artifactId>
    <!-- 版本 -->
    <version>0.0.1-SNAPSHOT</version>
    <!-- 项目名称 -->
    <name>newFramework</name>
    <description>Demo project for Spring Boot</description>
    <!-- 配置描述 -->
    <properties>
        <!-- java版本,但这个实际没什么用,单做一种描述信息看 -->
        <java.version>17</java.version>
        <!-- 实际指定编译版本可以使用如下 -->
        <maven.complier.source>17</maven.complier.source>
        <maven.complier.target>17</maven.complier.target>
    </properties>
    
    <!-- 依赖 -->
    <dependencies>
        <!-- 具体依赖 -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
    </dependencies>
    <!-- 构建信息 -->
    <build>
        <!-- 插件 -->
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>
</project>

parent 标签详解

<parent></parent> 标签用于继承父项目的各类依赖及其他配置信息,如版本,构建信息,配置描述等,具体范围包括:

# 可以继承部分
groupId、version、description、url、inceptionYear、organization、licenses、developers、contributors、mailingLists、scm、issueManagement、ciManagement、properties、dependencyManagement、dependencies、repositories、pluginRepositories、build、reporting、profiles

# 不可继承部分
artifactId、name、prerequisites

一个 parent 里所包含全部内容有:

<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>2.6.9</version>
    <relativePath/>
</parent>

<relativePath/> 元素,它可以单标签也可以是双标签<relativePath>../my-parent</relativePath>。它不是必需的,但可以用作 Maven 的指示符,然后先搜索该项目的父级的给定路径,然后再搜索本地和远程存储库,单标签为默认从当前pom.xml的父级目录查找。

properties 标签详解

<properties></properties>没有提供什么实质性的内容供我们使用,检查下来在里面最多可以在描述一个<project></project>标签可用,但作用并不是不大。实际作用更多在于描述我们依赖jar的版本等。

<properties>
    <!-- java版本,但这个实际没什么用,单做一种描述信息看 -->
    <java.version>17</java.version>
    <!-- 实际指定编译版本可以使用如下 -->
    <maven.complier.source>17</maven.complier.source>
    <maven.complier.target>17</maven.complier.target>
    <!-- 定义lombok版本 -->
    <lombok.version>1.18.24</lombok.version>
    <project.version>0.0.1-SNAPSHOT</project.version>
</properties>
<!-- 项目版本 -->
<version>${project.version}</version>
<!-- 依赖 -->
<dependencies>
    <dependency>
        <groupId>org.projectlombok</groupId>
        <artifactId>lombok</artifactId>
        <version>${lombok.version}</version>
    </dependency>
</dependencies>
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 203,271评论 5 476
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,275评论 2 380
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,151评论 0 336
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,550评论 1 273
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,553评论 5 365
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,559评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,924评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,580评论 0 257
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,826评论 1 297
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,578评论 2 320
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,661评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,363评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,940评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,926评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,156评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,872评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,391评论 2 342

推荐阅读更多精彩内容