当前位置：首页 > news >正文

SpringBoot：手动创建应用

news 2025/9/14 14:16:11

Spring提供了在线的Spring Initialzr在线创建Spring Boot项目，为了更好的理解Spring Boot项目，这里我们选择手动创建。

1.新建Web应用

1.1 生成工程

首先要做是创建一个Java项目，这里我们选择使用Maven来支持，使用archetype:generate生成一个项目。

mvn archetype:generate -DarchetypeGroupId=org.apache.maven.archetypes -DarchetypeArtifactId=maven-archetype-quickstart -DarchetypeVersion=1.4 -DgroupId=com.keyniu.dis -DartifactId=DiveInSpring -Dversion=0.1 -Dpackage=com.keyniu.dis -DinteractiveMode=false

生成的项目结构很简单，整个目录结果如下图，根目录下存放pom.xml、src目录，src目录下又分为主目录(main)和测试目录(test)

1.2 添加Spring Boot依赖

为了让应用支持SpringBoot，只需要在pom.xml里添加Spring Boot依赖即可。这里我们目标是让项目支持Spring Boot提供Web接口。首先是设置项目的parent

<project>...<parent><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-parent</artifactId><version>3.3.0</version></parent>....
</project>

然后是添加spring-boot-starter-web依赖，支持Web接口开发

<project><dependencies><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId></dependency></dependencies>
</project>

为了支持当前项目的启动，需要定义SpringBootApplication注解，使用SpringApplication.run执行当前工程，我们创建一个引导类

package com.keyniu.dis;import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;@SpringBootApplication
@RestController
public class DiveInMain {@GetMapping("/hello")public String hello(@RequestParam("name") String name) {return "hello," + name;}public static void main(String[] args) {SpringApplication.run(DiveInMain.class);}
}

通过DiveInMain.main方法启动后，我们通过curl查看/hello调用已经正常工作了。

randy@Randy:~$ curl -s http://192.168.31.52:8080/hello?name=randy
hello,randy

2. 不依赖<parent>

将pom.xml的parent设置为spring-boot-starter-parent确实很方便，然而有的时候，组织内部会有自己的parent pom定义，pom是单根继承，无法额外再加一个。我们需要拆解一下spring-boot-starter-parent的定义，它主要分为3部分：

依赖的版本管理，通过spring-boot-dependencies的dependencyManagement定义各个依赖的推荐版本
插件的使用管理，通过pluginManagement定义推荐的插件版本
自定义的profile，在spring-boot-starter-parent里定义了各种各样的profile实现特定场景定制的能力

2.1 依赖的版本管理

上面提到spring-boot-starter-parent提供了3个能力，分别是依赖的版本管理、插件的版本管理、自定义的Profile。想要在工程能不依赖spring-boot-starter-parent，通过引入spring-boot-dependencies，我们能做到继续使用Spring官方推荐的依赖版本，看如下的pom.xml定义，相比之前的版本，唯一的差异就是在dependencyManagement中使用了spring-boot-dependencies。

<?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>com.keyniu.dis</groupId><artifactId>DiveInSpring</artifactId><version>0.1</version><name>DiveInSpring</name><properties><project.build.sourceEncoding>UTF-8</project.build.sourceEncoding><maven.compiler.source>17</maven.compiler.source><maven.compiler.target>17</maven.compiler.target></properties><dependencyManagement><dependencies><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-dependencies</artifactId><version>3.3.0</version></dependency></dependencies></dependencyManagement><dependencies><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId><version>3.3.0</version></dependency><dependency><groupId>junit</groupId><artifactId>junit</artifactId><version>4.11</version><scope>test</scope></dependency></dependencies></project>

2.2 插件的使用管理

使用spring-boot-dependencies能实依赖的版本管理，通过IDEA执行DiveInMain看起来一切正常，直到我们脱离IDEA运行的时候，执行java -jar发现执行报错

PS D:\Workspace\DiveInSpring\target> java -jar .\DiveInSpring-0.1.jar
.\DiveInSpring-0.1.jar中没有主清单属性

我们知道java -jar执行的时候会查找MANIFEST.MF文件里定义的Main-Class配置，解压jar文件还发现MANIFEST.MF并没有设置Main-Class启动类，jar文件并不是FatJar，没有包含被依赖的组件

这个操作是由spring-boot-maven-plugin这个Maven插件完成的，不适用parent的话，我们要手动这个插件，配置start-class作为mainClass，startClass可能是JarLauncher、WarLauncher，它们定义在spring-boot-loader模块中。添加插件后，重新打包并使用java -jar执行，这个时候工程就能正常运行了。

<properties><spring-boot.run.main-class>${start-class}</spring-boot.run.main-class>
</properties><build><plugins><plugin><groupId>org.springframework.boot</groupId><artifactId>spring-boot-maven-plugin</artifactId><executions><execution><id>repackage</id><goals><goal>repackage</goal></goals></execution></executions><configuration><mainClass>${spring-boot.run.main-class}</mainClass></configuration></plugin></plugins>
</build>

3. <parent>的完整能力

通过使用spring-boot-maven-plugin，我们的jar已经能够正常执行了。不过spring-boot-starter-parent提供的能力要比这个多得多。

3.1 资源文件处理

spring-boot-starter-parent默认会将src/main/resource下的所有文件当成资源文件，这些资源文件会被分成两类处理:

application*，做变量引用(${变量名})替换，然后包含在资源文件中
其他，不做处理，直接复制进资源文件

<build><resources><resource><directory>${basedir}/src/main/resources</directory><filtering>true</filtering><includes><include>**/application*.yml</include><include>**/application*.yaml</include><include>**/application*.properties</include></includes></resource><resource><directory>${basedir}/src/main/resources</directory><excludes><exclude>**/application*.yml</exclude><exclude>**/application*.yaml</exclude><exclude>**/application*.properties</exclude></excludes></resource></resources>
</build>

3.2 插件默认配置

此外spring-boot-starter-parent对插件还做了额外的配置，这里我们捡紧要的说

插件	配置	作用
maven-compiler-plugin	配置parameters=true，在编译的时候调用javac -parameters	在.class文件里保留参数名，供反射时读取
maven-jar-plugin	配置mainClass为start-class的值，JarLauncher	设置可执行jar的启动引导类
maven-war-plugin	配置mainClass为start-class的值，WarLauncher	设置可执行jar的启动引导类
git-commit-id-maven-plugin	配置git信息存储的文件，git.properties	获取打包时git仓库的版本号/分支等
spring-boot-maven-plugin	打包SpringBoot项目结构，包括第3方依赖	BOOT-INF/classes和BOOT-INF/lib
maven-shade-plugin	创建uber jar，资源的合并处理，创建可执行jar	META-INF下配置文件的合并处理，比如spring.handles
native-maven-plugin	使用GraalVM构建Spring成为native应用