在项目中常常使用 maven
来管理项目,可是有时候对于 maven
的细节仍是了解的不是很清楚,所以今天复习下。java
首先开始创建一个最简单的 maven
项目,其配置以下图:web
能够看到最上面一行是 xml
的文件描述符,而后再是 project
,在这里引入 xsd 文件。spring
XSD(XML Schemas Definition)XML Schema,描述了 xml 文档的结构,用于判断其是否符合
xml
的格式要求
而后下面就是 groupId
,一般是公司的域名,artifactId
一般指的是项目名称。shell
按照官方的指导,在项目中首先引用 spring-boot-starter-parent
,修改后的 pom.xml
以下:apache
<?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 http://maven.apache.org/xsd/maven-4.0.0.xsd"> <modelVersion>4.0.0</modelVersion> <groupId>org.example</groupId> <artifactId>maven-test</artifactId> <version>1.0-SNAPSHOT</version> <parent> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-parent</artifactId> <version>2.2.2.RELEASE</version> <relativePath/> <!-- lookup parent from repository --> </parent> <build> <plugins> <plugin> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-maven-plugin</artifactId> </plugin> </plugins> <finalName>maven-test</finalName> </build> </project>
当准备在启动类上加 @SpringBootApplication
注解的时候,此时 IDEA 会提示找不到这个注解。这是正常的,由于 parent
只是把这个项目的配置和依赖信息统一化了,使得 子pom
就不用关心版本问题,例如在项目中引入spring-boot-starter-web
,当配置了 parent
以后,只须要在 子pom
中以下配置:springboot
<dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency>
那么它的配置信息就会自动的从 parent
中读取。例如刚刚的spring-boot-starter-web
信息,它的版本信息以下:maven
tips:使用命令
mvn -Dverbose dependency:tree
就能够像这样打印 jar 的依赖
那么 springboot 又是怎样来自动识别版本号的呢,此时就就涉及到了spring-boot-dependencies
spring-boot
spring-boot-dependencies
是 spring-boot-starter-parent
的一个 parent,能够在 spring-boot-starter-parent
的 pom
文件中看到。
打开 spring-boot-dependencies
文件,你会发现它里面几乎所有都是一些配置信息,而刚刚的spring-boot-dependencies
版本号就是来自于此。ui
到目前为止,能够基本理清 springboot
的依赖关系了。spa
在工程中,随便写一个 controller
,而后执行mvn package
,此时会在 target
目录下出现一个 jar 包,而后运行 jar 包,正常启动OK。
既然 spring-boot-starter-parent
是依赖于 spring-boot-dependencies
的,那么可不能够直接将parent
设置为spring-boot-dependencies
呢,修改 pom 文件以下:
而后执行mvn package
,执行的时候是成功的,可是当你用 java -jar maven-test.jar
的时候,你会发现提示以下:
target java -jar maven-test.jar maven-test.jar中没有主清单属性
首先分析下两个的 maven
log。
能够看到第二次的打包插件是 maven-jar-plugin
,也就是说 springboot 的项目一些资源并无打包进来,查看 spring-boot-maven-plugin
插件,发现它是来自于 spring-boot-starter-parent
里面的,可是在文章的开头部分,是已经手动的将其引入到了 pom 文件,那么修改 parent 之后未执行的话,最有可能就是版本号的缺失致使的,因而修改pom:
<plugins> <plugin> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-maven-plugin</artifactId> <version>2.1.11.RELEASE</version> </plugin> </plugins> <finalName>maven-test</finalName>
而后运行mvn package
:
[INFO] --- spring-boot-maven-plugin:2.1.11.RELEASE:repackage (repackage) @ maven-test --- [INFO] Replacing main artifact with repackaged archive [INFO] ------------------------------------------------------------------------ [INFO] BUILD SUCCESS
你会发现此时打包出来的 jar 文件已经能够运行了。
那么假设项目已经有了本身的 parent
,若是还想用 spring-boot-dependencies
来进行统一的一个全局版本控制,那么有以下的解决办法
在本身的parent
中设置parent为 spring-boot-starter-parent
,那么根据 maven 的继承属性,全部的 子pom
也就顺带继承了 spring-boot-starter-parent