使用pom 配置 repositories pom.xml配置了哪些信息

转载

epeppanda 2024-04-05 00:02:09

文章标签 maven springboot springcloud 微服务 xml 文章分类 架构后端开发

1.pom简介

-POM简介：项目对象模型(Project Object Model)的简称。通过xml可扩展标记语言(EXtensible Markup Language)格式保存的pom.xml文件，功能十分强大。
pom.xml用于管理：源代码、配置文件、开发者的信息和角色、问题追踪系统、组织信息、项目授权、项目的url、项目的依赖关系等等，是maven项目中必不可少的一个文件。

-基本配置：maven在建立项目的时候是基于maven项目下的pom.xml进行的，我们项目依赖的信息和一些基本信息都是在这个文件里面定义的，一个最简单的pom.xml的定义必须包含modelVersion、groupId、artifactId和version这四个元素，当然这其中的元素也是可以从它的父项目中继承的。在maven中，使用groupId、artifactId和version组成groupId:artifactId:version的形式来唯一确定一个项目，就相当于每个地方的经纬坐标一样。
-POM之间的关系：继承、聚合和依赖
-下面一起解析pom.xml的详细配置.

2.头部信息

格式：<project …> …< /project>
相关字段：
xmlns：命名空间，类似包名，因为xml的标签可自定义，需要命名空间来
xmlns:xsi：xml遵循的标签规范
xsi:schemaLocation：用来定义xmlschema的地址，也就是xml书写时需要遵循的语法

<?xml version="1.0" encoding="UTF-8"?>
<!--第一行声明xml文件的版本号和编码格式-->
<!--xml头信息:xmlns==>命名空间，类似于包名，odelVersion是4.0.0，这是当前仅有的可以被Maven2&3同时支持的POM版本，它是必须的。
             xmlns:xsi==>xml遵循的标签规范
             xsi:schemaLocation==>定义xmlschema的地址，也就是xml书写时需要遵循的语法-->
<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">

3.Maven的基本信息

-相关字段：
modelVersion：声明项目描述符遵循哪一个POM模型版本。模型本身的版本很少改变，虽然如此，但它仍然是必不可少的，这是为了当Maven引入了新的特性或者其他模型变更的时候，确保稳定性。
parent：父项目的坐标。如果项目中没有规定某个元素的值，那么父项目中的对应值即为项目的默认值。坐标包括group ID，artifact ID和version。
groupId：公司或者组织的唯一标志，并且配置时生成的路径也是由此生成。
artifactId：项目的全球唯一标识符，一个groupId下面可能多个项目，就是靠artifactId来区分的。
version：本项目目前所处的版本号。
packaging：打包类型，可取值：pom , jar , maven-plugin , ejb , war , ear , rar , par等等。
name：项目的名称, Maven产生的文档用，可省略。
url：项目主页的URL, Maven产生的文档用，可省略。
version：声明项目描述符遵循哪一个POM模型版本。模型本身的版本很少改变，虽然如此，但
它仍然是必不可少的，这是为了当Maven引入了新的特性或者其他模型变更的时候，确保
稳定性。
description：项目的详细描述, Maven 产生的文档用。描述, Maven 产生的文档用。当这个元素能够用HTML格式描述时（例如，CDATA中的文本会被解析器忽略，就可以包含HTML标签），不鼓励使用纯文本描述。如果你需要修改产生的web站点的索引页面，你应该修改你自己的索引页文件，
而不是调整这里的文档。

最基础的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 https://maven.apache.org/xsd/maven-4.0.0.xsd">
	<!--基础信息-->
    <modelVersion>4.0.0</modelVersion>
    <groupId>com.hippo</groupId>
    <artifactId>docker</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>hippo_docker</name>
    <url>http://maven.apache.org</url>
    <description>hippo_docker</description>
</project>

3.Pom之间的关系–依赖

相关字段：
groupId ：依赖项的组织名。
artifactId ：依赖项的子项目名。
version ：依赖项的版本。
type ：依赖类型一般省略，默认类型是jar，其他还有jar，war，ejb-client和test-jar。
scope ：依赖项的适用范围，包括compile，provided，runtime，test，system，exclusions
optiona ：可选依赖，如果你在项目B中把C依赖声明为可选，你就需要在依赖于B的项目（例如项目A）中显式的引用对C的依赖。
exclusions：排除项目中的依赖冲突时使用，不依赖该项目。

依赖代码如下：

<dependencies>
    <!--springboot依赖-->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter</artifactId>
    </dependency>
    <!--lombok依赖-->
    <dependency>
        <groupId>org.projectlombok</groupId>
        <artifactId>lombok</artifactId>
        <optional>true</optional>
    </dependency>
    <!--springboot测试依赖-->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-test</artifactId>
        <scope>test</scope>
    </dependency>
</dependencies>

依赖版本声明管理

在properties下声明相应的版本信息，然后在dependency下引用的时候用${spring-version}就可以引入该版本jar包了

<properties>
    <java.version>1.8</java.version>
    <spring.version>2.6.7.RELEASE</spring.version>
</properties>

4.Pom之间的关系–继承

使用情景：聚合项目中，有很多重复的配置，其中有很多有相同的groupId和version，有相同的依赖，可以搭建POM的父子结构，在父POM中声明一些配置供子POM继承。
相关字段：
parent：父项目的坐标。如果项目中没有规定某个元素的值，那么父项目中的对应值即为项目的默认值。坐标包括group ID，artifact ID和version。
artifactId：被继承的父项目的构件标识符。
groupId：被继承的父项目的全球唯一标识符。
version：被继承的父项目的版本。
relativePath：父项目的pom.xml文件的相对路径。相对路径允许你选择一个不同的路径。默认值是…/pom.xml。Maven首先在构建当前项目的地方寻找父项目的pom，其次在文件系统的这个位置（relativePath位置），然后在本地仓库，最后在远程仓库寻找父项目的pom。

父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 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <groupId>com.gd</groupId>
    <artifactId>gd_plan</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>${project.artifactId}</name>
    <packaging>pom</packaging>
    <description>xxxxx系统</description>
    <!--继承springboot的依赖-->
	<parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.5.2</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>
    <!--项目内的子模块-->
    <modules>
        <module>gd_base</module>
        <module>gd_service</module>
    </modules>
    <!--依赖版本统一管理-->
     <properties>
        <java.version>1.8</java.version>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
        <spring-boot.version>2.3.7.RELEASE</spring-boot.version>
        。。。。。。
      </properties>
<!--项目所有公共依赖-->
    <dependencies>
    <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <!--springboot-jdbc-->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-jdbc</artifactId>
            <exclusions>
                <!-- 排除Tomcat-JDBC依赖 -->
                <exclusion>
                    <groupId>org.apache.tomcat</groupId>
                    <artifactId>tomcat-jdbc</artifactId>
                </exclusion>
            </exclusions>
        </dependency>
        <!-- 添加HikariCP依赖 -->
        <dependency>
            <groupId>com.zaxxer</groupId>
            <artifactId>HikariCP</artifactId>
        </dependency>
        。。。。。。。
	</dependencies>
</project>

子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 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <!--项目-->
    <groupId>com.gd</groupId>
    <artifactId>gd_service</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>${project.artifactId}</name>
    <packaging>jar</packaging>
    <description>系统服务模块</description>

	<!--继承父项目-->
    <parent>
        <groupId>com.gd</groupId>
        <artifactId>gd_plan</artifactId>
        <version>0.0.1-SNAPSHOT</version>
        <!--这里可能不是这个路径根据自己的调整-->
        <relativePath>../pom.xml</relativePath> 
    </parent>

	<!--依赖版本统一管理-->
    <properties>	
    	。。。。。。
    </properties>
    
    <!--当前模块独有的依赖，如果里面的依赖父POM中也有，默认将采用子模块里面的-->
    <dependencies>
		。。。。。。。
    </dependencies>
    <!--当前模块构建打包配置-->
    <build>
    	<plugins>
    		。。。。。。。
    	</plugins>
    </build>
</project>

5.Pom之间的关系–聚合

聚合项目：当一个大的maven项目里面包含多个小的maven项目，小的maven项目就是聚合到外面大的maven项目，就比如说如果projectA聚合到projectB，那么我们就可以说projectA是projectB的子模块， projectB是被聚合项目，也可以类似于继承那样称为父项目。
聚合项目的pom.xml中的packaging元素的值为pom；
聚合项目的pom.xml中的modules元素下指定它的子模块项目；

6.Pom实用配置

6.1pom.xml中配置跳过测试

在maven项目的pom.xml文件中添加下列插件配置，构建包时自动跳过测试类

<build>
  <plugins>
           <!-- maven 打包时跳过测试 -->
			<plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-surefire-plugin</artifactId>
                <configuration>
                    <skip>true</skip>
                </configuration>
            </plugin>
       </plugins>
   <build>