1.查看初始化的 Spring Boot 新项目
整个项目结构都遵循传统Maven或Gradle项目的布局,即主要应用程序代码位于src/main/java 目录里;资源都在src/main/resources 目录里;测试代码都在src/test/java目录里。如果有测试资源的话,要放在src/test/resources里。
- pom.xml:Maven构建说明文件
- ReadingListApplication.java:应用程序的启动引导类(bootstrap class),也是主要的Spring配置类
- application.properties:用于配置应用程序和Spring Boot的属性
- ReadingListApplicationTests.java:一个基本的集成测试类
- 启动引导Spring
ReadingListApplication.java在Spring Boot应用程序里有两个作用:配置和启动引导。
package com.jasonper.readinglist;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
@SpringBootApplication
public class ReadinglistApplication {
public static void main(String[] args) {
SpringApplication.run(ReadinglistApplication.class, args);
}
}
@SpringBootApplication开起了Spring的组件扫描和Spring Boot的自动配置功能。实际上,@SpringBootApplication将三个有用的注解组合到了一起。
- Spring 的@Configuration:标明该类使用Spring基于Java的配置
- Spring 的@ComponentScan:启用组件扫描,这样你写的Web控制器类和其他的组件才能自动发现并注册为Spring应用程序上下文里的Bean
- Spring Boot 的@EnableAutoConfiguration:这一行配置开起了Spring Boot自动配置,让你不再写成篇的配置了
在mian方法中,向SpringApplication.run()传递了一个ReadingListApplication类的引用,还有命令行参数,通过这些东西来启动该应用程序。
Tips:如果你的应用程序需要Spring Boot自动配置外的其他Spring配置,一般来说,最好把它写到一个单独的@Configuration标注的类里(组件扫描会发现并使用这些类的)
- 测试Spring Boot应用程序
package com.jasonper.readinglist;
import org.junit.Test;
import org.junit.runner.RunWith;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.test.context.junit4.SpringRunner;
@RunWith(SpringRunner.class)
@SpringBootTest
public class ReadinglistApplicationTests {
@Test
public void contextLoads() {
}
}
ReadingListApplicationTests里有个空方法:contextLoads()。这个空方法足以证明应用程序的上下文加载没有问题。如果存在问题,测试就会失败。
- 配置应用程序的属性
application.properties文件是一个空文件,这个文件是可选的,可以删除,这不会对应用程序有任何影响,但留着也没什么问题。
通过application.properties我们也可细粒度的调整Spring Boot的自动配置,可以用它来指定应用程序代码所需的配置项。
你完全不用告诉Spring Boot为你加载application.properties,只要它存在就会被加载,Spring和应用程序代码都能获取其中的属性。
2.Spring Boot 项目构建解析
选择使用Maven来构建应用程序,Initializr会替你生成一个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 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>2.1.6.RELEASE</version>
<relativePath/> <!-- lookup parent from repository -->
</parent>
<groupId>com.jasonper</groupId>
<artifactId>readinglist</artifactId>
<version>0.0.1-SNAPSHOT</version>
<name>readinglist</name>
<description>Demo project for Spring Boot</description>
<properties>
<java.version>1.8</java.version>
</properties>
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-data-jpa</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-thymeleaf</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
<groupId>com.h2database</groupId>
<artifactId>h2</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>:这一部分是从spring-boot-starter-parent继承过来的版本号
<dependencies>...</dependencies>:起步依赖配置
<build>...<build>:运用Spring Boot 插件
构建插件的主要功能是把项目打包成一个可执行的jar包,包括把应用程序的所有依赖打入JAR文件类,并为JAR文件添加一个描述文件,你可以使用java -jar 命令来运行应用程序
除了构建插件,代码里Maven还将spring-boot-starter-parent作为上一级,这样一来就能利用Maven的依赖管理功能,继承很多常用库的依赖版本,在声明依赖的时候就不用指定版本号了。如这个pom.xml里的依赖都没有指定版本。
Tips:Artifact ID带有 spring-boot-starter- 前缀的都是Spring Boot的起步依赖。
3.使用起步依赖
使用起步依赖很简单:
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-data-jpa</artifactId>
</dependency>
覆盖起步依赖引入的传递依赖:
以Spring Boot的Web起步依赖为例,它传递了Jackson JSON库。如果你的项目用不上Jackson JSON库,在Maven里可以使用<exclusions>元素去除Jackson:
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
<exclusions>
<exclusion>
<groupId>com.fasterxml.jackson.core</groupId>
</exclusion>
<exclusions>
</dependency>
4.使用自动配置
Spring Boot 的自动配置是一个运行时(准确来说,是应用程序启动时)的过程,它考虑了诸多因素,才决定Spring配置该用哪个和不该用哪个。