江帅帅,微信公众号【江帅帅】作者 ,擅长系统架构设计,大数据,运维、机器学习等技术领域;对大中后台技术有丰富经验(交易平台、基础服务、智能客服、基础架构、智能运维、数据库、安全、IT 等方向);曾担任怀致科技 CTO,并还在东软集团、中国移动、多迪集团等企业中任职过相关技术负责人。
1、关闭指定的自动配置
通过上面的 @EnableAutoConfiguration 注解就能根据指定的依赖,自动进行配置。但如果你想关闭某一项自动配置,就需要使用 @SpringBootApplication 下的 exclude 参数
来设置。比如,我想关闭 DataSource,代码具体如下:
@SpringBootApplication(exclude = {DataSourceAutoConfiguration.class})
2、自定义启动 banner
能满足企业定制 logo 或项目启动图案。比如,可以借助如下几个网站来生成:
http://patorjk.com/software/taag http://www.network-science.de/ascii/ http://www.kammerl.de/ascii/AsciiSignature.php
生成之后,直接将复制好的图案,放到新建的 banner.txt
文件中。运行程序之后,具体显示效果如下:
3、全局配置文件
一般使用 application.properties
或者 application.yml
文件来当作全局配置文件。它能被添加在下面几个目录下,区别是加载的顺序是不同的,具体如下:
1)项目根目录的 /config 目录下 2)项目根目录下 3)类路径的 /config 目录下 4)类路径下
比如,可以在 application.properties 配置文件中,设置端口、请求后缀等内容。
具体的配置参数可以参考:官网文档第 10 章 Appendices
4、配置 Web 容器
在 Spring Boot 应用中,可以内置 Tomcat、Netty、Jetty 等容器。
4.1 配置 Tomcat
如果添加了 spring-boot-starter-web 依赖,则项目会默认使用 Tomcat 作为 Web 容器。
针对 Tomcat 可以添加一些配置,具体配置如下:
# 端口 server.port # 错误跳转路径 server.error.path # session 失效时间 server.servlet.session.timeout # 项目名称 server.servlet.context-path # 编码,一般 utf-8 server.tomcat.uri-encoding # ...
4.2 配置 Jetty
在 Spring Boot 应用中嵌入 Jetty 的配置很简单,把 spring-boot-starter-web 中的 Tomcat 改成 Jetty 即可,具体配置如下:
<!-- 去掉 Tomcat --> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> <exclusions> <exclusion> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-tomcat</artifactId> </exclusion> </exclusions> </dependency> <!-- Jetty 容器 --> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-jetty</artifactId> </dependency>
4.3 配置 Undertow
Undertow 是红帽公司开发的一款基于 NIO 的高性能 Web 嵌入式服务器,拥有非常好的性能。配置方式具体如下:
<!-- 去掉 Tomcat --> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> <exclusions> <exclusion> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-tomcat</artifactId> </exclusion> </exclusions> </dependency> <!-- undertow 容器 --> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-undertow</artifactId> </dependency>
5、HTTPS 配置
使用 JDK 提供的 keytool 工具,可以生成一个数字证书,具体命令如下:
keytool -genkey -alias httpskey -keyalg RSA -keysize 2048 -keystore hello.p12 -validity 365
- -genkey 表示创建一个密钥
- -alias httpskey 设置密钥的别名
- -keyalg RSA 表示使用的加密算法是 RSA
- -keysize 2048 设置密钥的长度
- -keystore hello.p12 设置密钥存放位置
- -validity 365 设置密钥的有效时间
然后在 application.properties
文件中编辑,具体配置如下:
server.ssl.key-store=hello.p12 server.ssl.key-alias=httpskey server.ssl.key-store-password=123456
6、类型安全配置
前面也说过,我们的配置文件可以使用 properties 配置和 yaml 配置,项目启动后,它们都会被加载到 Spring 的环境中,如果你要用配置信息的话,直接使用 @Value
注解即可。
但数据注入到属性中,需要注意安全。Spring Boot 使用类型安全配置属性,即使在数据量非常庞大的情况下,将配置文件中的数据注入到 Bean
里也是很方便的。
user.name=翠花 user.age=18 user.address=北京
添加对应的 Bean 类,使用 @ConfigurationProperties
注解来使用配置,通过 prefix 属性
来描述要加载的配置文件的前缀,具体如下:
@Component @ConfigurationProperties(prefix="user") public class User { private String name; private Integer age; private String address; // get 和 set 方法... }
7、YAML 配置
YAML 是专门用来写配置文件的语言,非常简洁、强大,类似 JSON。它可用来替换 application.properties 文件。YAML 主要是由 spring-boot-starter-web 依赖模块中的 snakeyaml 依赖进行解析。但它不能使用 @propertySource
注解加载 YAML 文件,否则还要使用 Properties 配置。
举个小案例,具体写法如下:
server: port:80 servlet: context-path:/hello tomcat: uri-encoding:utf-8
还可以自定义配置,具体写法如下:
user: name:翠花 age:18
对应的代码,跟前面的 User 类一样,具体源码如下:
@Component @ConfigurationProperties(prefix="user") public class User { private String name; private Integer age; // get 和 set 方法... }
还能设置成集合的样式,集合中是单个值,具体写法如下:
user: name:翠花 age:18 aihao: - 烫头 - 捏脚 - Reading
对应的代码,具体源码如下:
@Component @ConfigurationProperties(prefix="user") public class User { private String name; private Integer age; private List<String> aihao; // get 和 set 方法... }
也能先设置成集合的样式,但集合中是对象,具体写法如下:
shop: users: - name:翠花 age:18 aihao: - 烫头 - 捏脚 - Reading - name:小强 age:18 aihao: - 烫头 - 捏脚 - Reading
对应的代码,具体源码如下:
@Component @ConfigurationProperties(prefix="shop") public class Users { private List<User> users; // get 和 set 方法... }
public class User { private String name; private Integer age; private List<String> aihao; // get 和 set 方法... }
8、Profile 配置
如果我们在项目中,需要频繁在开发环境、测试环境和生产环境中更改大量的配置,会让你怀疑人生,所以我们使用 @Profile 注解来更加简洁进行处理。
具体的命名规则:application-{xxx}.properties
,这样就能在不同环境下进行区别配置信息。具体使用步骤如下:
第一步,添加配置文件
在 resources 目录中,创建 application-dev.properties
和 application-prod.properties
文件,代表开发和生产环境中的配置。
# 开发环境 server.port=8080
# 生产环境 server.port=80
第二步,指定对应模式
1)在 application.properties 中指定
# 开发时用 dev,生产时用 prod spring.profiles.active=dev
2)在启动类 main 方法中指定
SpringApplicationBuilder builder = new SpringApplicationBuilder(SpringBootApp.class); builder.application().setAdditionalProfiles("prod"); builder.run(args);
3)也可以在项目启动时配置
在我们将项目打成 jar 文件再启动,具体的操作命令如下:
java -jar springdemo-xxx.jar --spring.profiles.active=prod