Spring Boot
初遇 Spring Boot
Spring Boot 是 Spring MVC 的升级版,两者没有必然联系。
Spring Boot 的角色:Spring Framework -> Spring Boot -> Spring Cloud。
Spring Boot 的三大特性:
- 组件自动装配:Web MVC、Web Flux、JDBC 等
- 嵌入式 Web 容器:Tomcat、Jetty 以及 Undertow
- 生产准备特性:指标、健康检查、外部化配置等
组件自动装配
- 激活:
@EnableAutoConfiguration
- 配置:
/META-INF/spring.factories
- 实现:
XXXAutoConfiguration
嵌入式 Web 容器
- Web Servlet:Tomcat、Jetty 和 Undertow
- Web Reactive:Netty Web Serve
生产准备特性
- 指标:/actuator/metrics
- 健康检查:/actuator/health
- 外部化配置:/actuator/configprops
启动方式
- mvn 启动:
mvn spring-boot:run
- 打成 jar 包启动:
# 打包
mvn clean package
# 启动
java -jar target/luckymoney-0.0.1-SNAPSHOT.jar
配置
基本配置
代码语言:javascript复制# 启动端口和路径
server:
port: 3000
servlet:
context-path: /luckymoney
# 数据库和JPA
spring:
datasource:
driver-class-name: com.mysql.cj.jdbc.Driver
username: root
password: 1124nicestar
url: jdbc:mysql://127.0.0.1:3306/sell?characterEncoding=utf-8&useSSL=false&serverTimezone=UTC
jpa:
show-sql: true
自定义配置
- 单个引入
# 自定义配置
minMoney: 1
description: 最少金额${minMoney}元
在程序中引用自定义的配置参数:
代码语言:javascript复制@RestController
public class HelloController {
@Value("${minMoney}")
private BigDecimal minMoney;
@Value("${description}")
private String description;
@GetMapping("/hello")
public String sayHello() {
return description;
}
}
- 多个引入
limit:
minMoney: 1
maxMoney: 10
description: 最少金额${limit.minMoney}元,最大金额${limit.maxMoney}元
提取配置:
代码语言:javascript复制@Data
@Component
@ConfigurationProperties(prefix = "limit")
public class LimitConfig {
private BigDecimal minMoney;
private BigDecimal maxMoney;
private String description;
}
引入配置:
代码语言:javascript复制@RestController
public class HelloController {
@Autowired
private LimitConfig limitConfig;
@GetMapping("/hello")
public String sayHello() {
return limitConfig.getDescription();
}
}
- 区分开发与生产环境
将 application.yml
复制两份文件 application-dev.yml
和 application-prod.yml
,然后再在 application.yml
中引入:
spring:
profiles:
active: dev
开发环境使用 dev,发布到线上时不需要更改,只需启动时加入参数启动:
代码语言:javascript复制java -jar -Dspring.profiles.active=prod target/luckymoney-0.0.1-SNAPSHOT.jar
注解
@RestController
@RestController = @Controller @ResponseBody
@RestController
注解相当于 @Controller
与 @ResponseBody
这两个注解的结合。
在使用 SpringMVC 框架的时候,在处理 json 的时候需要注解 @ResponseBody
或者 @RestController
,这两个注解都会处理返回的数据格式,使用了该类型注解后返回的不再是视图,不会进行转跳,而是返回 json 或 xml 数据格式,输出在页面上。
所以在定义 Controller 的时候如果需要返回 jsp 界面就用 @Controller
注解,只需要返回 string 或 json 的时候就用 @RestController
注解。
两者区别:
@ResponseBody
: 一般是使用在单独的方法上的,需要哪个方法返回 json 数据格式,就在哪个方法上使用,具有针对性。
@RestController
:一般是使用在类上的,它相当于 @Controller
与 @ResponseBody
这两个注解的结合,本质相当于在该类的所有方法上都统一使用了 @ResponseBody
注解。
@GetMapping
注解 @GetMapping
支持数组,多个路径可以访问同一个接口:
@GetMapping({"/hello", "/hi"})
获取路由参数有两种方式,一种是 /hello/200
路径,另外一种是 /hello?id=200
路径,方式分别如下:
// /hello/200
@GetMapping("/hello/{id}")
public String sayHello(@PathVariable("id") Integer id) {
return "id:" id;
}
// /hello?id=200
@GetMapping("/hello")
public String sayHello(@RequestParam("id") Integer id) {
return "id:" id;
}
更细致控制非必传和默认值:
代码语言:javascript复制@GetMapping("/hello")
public String sayHello(@RequestParam(value = "id", required = false, defaultValue = "0") Integer id) {
return "id:" id;
}
@RequestParam
注解可以兼容 @PostMapping
@PostMapping("/hello")
public String sayHello(@RequestParam(value = "id", required = false, defaultValue = "0") Integer id) {
return "id:" id;
}
Spring WebFlux
Spring5.x 是 Java 界首个支持响应式的 Web 框架,新增 Spring WebFlux
模块。
Spring WebFlux
同时支持使用旧的 Spring MVC
注解声明 Reactive Controller
。和传统的 MVC Controller
不同,Reactive Controller
操作的是非阻塞的 ServerHttpRequest
和 ServerHttpResponse
,而不再是 Spring MVC 里的 HttpServletRequest
和 HttpServletResponse
。