上一篇文章介绍了如何疾速搭建一个 Spring Web 我的项目,本文重点聊聊我的项目的依赖是如何引入的。

咱们后面提到,搭建 Spring Web 我的项目时,只须要继承 spring-boot-starter-parent 并指定它的版本,接着引入 spring-boot-starter-web ,且无需指定 spring-boot-starter-web 的版本,即可把 Spring Web 我的项目所须要的全副依赖引进来,具体是如何做到的呢?

这里会波及到 Maven 的 parent 和 dependencyManagement 标签,咱们先讲讲这两个标签的作用。

Maven 标签

parent

在 Maven 我的项目中,能够通过继承的形式,让子项目继承父我的项目所定义的内容,如:继承 groupId、version、properties、dependencies 等。

上面的例子中,my-app-child 只须要继承 my-app-parent ,即可引入父我的项目的全副依赖。即父我的项目 my-app-parent 引入了 maven-artifactmaven-core 两个依赖,并指定了它们的版本。

<!-- my-app-parent --><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 http://maven.apache.org/xsd/maven-4.0.0.xsd">    <modelVersion>4.0.0</modelVersion>    <groupId>com.mycompany.app</groupId>    <artifactId>my-app-parent</artifactId>    <version>1.0-SNAPSHOT</version>    <name>my-app-parent</name>    <url>http://www.example.com</url>    <properties>        <mavenVersion>3.0</mavenVersion>    </properties>    <dependencies>        <dependency>            <groupId>org.apache.maven</groupId>            <artifactId>maven-artifact</artifactId>            <version>${mavenVersion}</version>        </dependency>        <dependency>            <groupId>org.apache.maven</groupId>            <artifactId>maven-core</artifactId>            <version>${mavenVersion}</version>        </dependency>    </dependencies></project>

子项目只需继承 my-app-parent 并指定它的版本,就引入了这两个依赖,并且依赖的版本也跟父我的项目所指定的版本一样。

<!-- my-app-child --><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 http://maven.apache.org/xsd/maven-4.0.0.xsd">    <modelVersion>4.0.0</modelVersion>    <parent>        <groupId>com.mycompany.app</groupId>        <artifactId>my-app-parent</artifactId>        <version>1.0-SNAPSHOT</version>    </parent>    <artifactId>my-app-child</artifactId></project>

dependencyManagement

有时候子项目并不需要引入父我的项目的全副依赖,只须要引入局部依赖,但又心愿在父我的项目中对立定义依赖的版本,dependencyManagement 标签能够帮咱们实现这个事件。

上面的例子中,my-app-child 引入了 maven-core 依赖,父我的项目仅仅只是预约义了依赖的版本。也就是说,父我的项目指定了 maven-artifactmaven-core 两个依赖的版本,但并没有引入这两个依赖。

<!-- my-app-parent --><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 http://maven.apache.org/xsd/maven-4.0.0.xsd">    <modelVersion>4.0.0</modelVersion>    <groupId>com.mycompany.app</groupId>    <artifactId>my-app-parent</artifactId>    <version>1.0-SNAPSHOT</version>    <name>my-app-parent</name>    <url>http://www.example.com</url>    <properties>        <mavenVersion>3.0</mavenVersion>    </properties>    <dependencyManagement>        <dependencies>            <dependency>                <groupId>org.apache.maven</groupId>                <artifactId>maven-artifact</artifactId>                <version>${mavenVersion}</version>            </dependency>            <dependency>                <groupId>org.apache.maven</groupId>                <artifactId>maven-core</artifactId>                <version>${mavenVersion}</version>            </dependency>        </dependencies>    </dependencyManagement></project>

在子项目中只引入了 maven-core 依赖,即 maven-artifact 是没有被引入的,且子项目无需指定 maven-core 依赖的版本,该依赖的版本就与父我的项目所指定的版本一样。

<!-- my-app-child --><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 http://maven.apache.org/xsd/maven-4.0.0.xsd">    <modelVersion>4.0.0</modelVersion>    <parent>        <groupId>com.mycompany.app</groupId>        <artifactId>my-app-parent</artifactId>        <version>1.0-SNAPSHOT</version>    </parent>    <artifactId>my-app-child</artifactId>    <dependencies>        <dependency>            <groupId>org.apache.maven</groupId>            <artifactId>maven-core</artifactId>        </dependency>    </dependencies></project>

Spring Web 依赖的引入

spring-boot-starter-parent

2.7.2 版本的 spring-boot-starter-parent 继承自父我的项目 spring-boot-dependencies

<!-- spring-boot-starter-parent --><project xmlns="http://maven.apache.org/POM/4.0.0"         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">    <modelVersion>4.0.0</modelVersion>    <parent>        <groupId>org.springframework.boot</groupId>        <artifactId>spring-boot-dependencies</artifactId>        <version>2.7.2</version>    </parent>    <!-- ... --></project>

spring-boot-dependencies 通过 dependencyManagement 标签预先指定了各个 starter 和其它各个依赖的版本。尤其是,将 spring-boot-starter-web 的版本指定为 2.7.2 。

<!-- spring-boot-dependencies --><project xmlns="http://maven.apache.org/POM/4.0.0"         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">    <modelVersion>4.0.0</modelVersion>    <groupId>org.springframework.boot</groupId>    <artifactId>spring-boot-dependencies</artifactId>    <version>2.7.2</version>    <packaging>pom</packaging>    <name>spring-boot-dependencies</name>    <!-- ... -->    <dependencyManagement>        <dependencies>            <dependency>                <groupId>org.apache.activemq</groupId>                <artifactId>activemq-amqp</artifactId>                <version>${activemq.version}</version>            </dependency>            <dependency>                <groupId>org.apache.activemq</groupId>                <artifactId>activemq-blueprint</artifactId>                <version>${activemq.version}</version>            </dependency>            <!-- ... -->            <dependency>                <groupId>org.springframework.boot</groupId>                <artifactId>spring-boot-starter-web</artifactId>                <version>2.7.2</version>            </dependency>            <dependency>                <groupId>org.springframework.boot</groupId>                <artifactId>spring-boot-starter-webflux</artifactId>                <version>2.7.2</version>            </dependency>            <dependency>                <groupId>org.springframework.boot</groupId>                <artifactId>spring-boot-starter-websocket</artifactId>                <version>2.7.2</version>            </dependency>            <!-- ... -->        </dependencies>    </dependencyManagement>    <!-- ... --></project>

spring-boot-starter-web

2.7.2 版本的 spring-boot-starter-web 将 Spring Web 我的项目须要的全副依赖,如 spring-web 等引入了进来,并指定了它们的版本:

<!-- spring-boot-starter-web --><project xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"         xmlns="http://maven.apache.org/POM/4.0.0"         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">    <modelVersion>4.0.0</modelVersion>    <groupId>org.springframework.boot</groupId>    <artifactId>spring-boot-starter-web</artifactId>    <version>2.7.2</version>    <name>spring-boot-starter-web</name>    <!-- ... -->    <dependencies>        <dependency>            <groupId>org.springframework.boot</groupId>            <artifactId>spring-boot-starter</artifactId>            <version>2.7.2</version>            <scope>compile</scope>        </dependency>        <dependency>            <groupId>org.springframework.boot</groupId>            <artifactId>spring-boot-starter-json</artifactId>            <version>2.7.2</version>            <scope>compile</scope>        </dependency>        <dependency>            <groupId>org.springframework.boot</groupId>            <artifactId>spring-boot-starter-tomcat</artifactId>            <version>2.7.2</version>            <scope>compile</scope>        </dependency>        <dependency>            <groupId>org.springframework</groupId>            <artifactId>spring-web</artifactId>            <version>5.3.22</version>            <scope>compile</scope>        </dependency>        <dependency>            <groupId>org.springframework</groupId>            <artifactId>spring-webmvc</artifactId>            <version>5.3.22</version>            <scope>compile</scope>        </dependency>    </dependencies></project>

因而,在咱们继承 2.7.2 版本的 spring-boot-starter-parent ,并引入 spring-boot-starter-web 之后,就相当于引入了 2.7.2 版本的 spring-boot-starter-web ,2.7.2 版本的 spring-boot-starter-web 又将该版本所须要的特定版本的依赖引入了进来,从而 Spring Web 我的项目就可能在 spring-boot-starter-parentspring-boot-starter-web 的独特作用下,将我的项目所须要的依赖和依赖版本全副定义好。并且,在这个过程中,咱们不须要的依赖,如 spring-boot-starter-webflux 等,是没有被引入进来的,这样就达到了既不便又灵便的成果。

读到这里,不晓得读者有没有这样的疑难:我继承的是 spring-boot-starter-parent 我的项目,为什么却把 spring-boot-dependencies 的内容也继承了?这其实是由继承的传递性造成的,即继承的个性导致了子项目除了会继承父我的项目的内容,同时也会继承所有其它先人我的项目的内容。