江帅帅:Spring Boot 底层级探索系列 03 - 简单配置

简介: 江帅帅:Spring Boot 底层级探索系列 03 - 简单配置

江帅帅,微信公众号【江帅帅】作者 ,擅长系统架构设计,大数据,运维、机器学习等技术领域;对大中后台技术有丰富经验(交易平台、基础服务、智能客服、基础架构、智能运维、数据库、安全、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.propertiesapplication-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


目录
相关文章
|
3月前
|
安全 Java API
深入解析 Spring Security 配置中的 CSRF 启用与 requestMatchers 报错问题
本文深入解析了Spring Security配置中CSRF启用与`requestMatchers`报错的常见问题。针对CSRF,指出默认已启用,无需调用`enable()`,只需移除`disable()`即可恢复。对于`requestMatchers`多路径匹配报错,分析了Spring Security 6.x中方法签名的变化,并提供了三种解决方案:分次调用、自定义匹配器及降级使用`antMatchers()`。最后提醒开发者关注版本兼容性,确保升级平稳过渡。
345 2
|
4月前
|
缓存 Java API
微服务——SpringBoot使用归纳——Spring Boot集成 Swagger2 展现在线接口文档——Swagger2 的配置
本文介绍了在Spring Boot中配置Swagger2的方法。通过创建一个配置类,添加`@Configuration`和`@EnableSwagger2`注解,使用Docket对象定义API文档的详细信息,包括标题、描述、版本和包路径等。配置完成后,访问`localhost:8080/swagger-ui.html`即可查看接口文档。文中还提示了可能因浏览器缓存导致的问题及解决方法。
140 0
微服务——SpringBoot使用归纳——Spring Boot集成 Swagger2 展现在线接口文档——Swagger2 的配置
|
5月前
|
XML Java 测试技术
Spring IOC—基于注解配置和管理Bean 万字详解(通俗易懂)
Spring 第三节 IOC——基于注解配置和管理Bean 万字详解!
358 26
|
4月前
|
Java 关系型数据库 数据库
微服务——SpringBoot使用归纳——Spring Boot事务配置管理——Spring Boot 事务配置
本文介绍了 Spring Boot 中的事务配置与使用方法。首先需要导入 MySQL 依赖,Spring Boot 会自动注入 `DataSourceTransactionManager`,无需额外配置即可通过 `@Transactional` 注解实现事务管理。接着通过创建一个用户插入功能的示例,展示了如何在 Service 层手动抛出异常以测试事务回滚机制。测试结果表明,数据库中未新增记录,证明事务已成功回滚。此过程简单高效,适合日常开发需求。
196 0
|
4月前
|
Java 测试技术 微服务
微服务——SpringBoot使用归纳——Spring Boot中的项目属性配置——少量配置信息的情形
本课主要讲解Spring Boot项目中的属性配置方法。在实际开发中,测试与生产环境的配置往往不同,因此不应将配置信息硬编码在代码中,而应使用配置文件管理,如`application.yml`。例如,在微服务架构下,可通过配置文件设置调用其他服务的地址(如订单服务端口8002),并利用`@Value`注解在代码中读取这些配置值。这种方式使项目更灵活,便于后续修改和维护。
67 0
|
4月前
|
SQL Java 数据库连接
微服务——SpringBoot使用归纳——Spring Boot使用slf4j进行日志记录—— application.yml 中对日志的配置
在 Spring Boot 项目中,`application.yml` 文件用于配置日志。通过 `logging.config` 指定日志配置文件(如 `logback.xml`),实现日志详细设置。`logging.level` 可定义包的日志输出级别,例如将 `com.itcodai.course03.dao` 包设为 `trace` 级别,便于开发时查看 SQL 操作。日志级别从高到低为 ERROR、WARN、INFO、DEBUG,生产环境建议调整为较高级别以减少日志量。本课程采用 yml 格式,因其层次清晰,但需注意格式要求。
247 0
|
4月前
|
Java 数据库连接 数据库
微服务——SpringBoot使用归纳——Spring Boot集成MyBatis——MyBatis 介绍和配置
本文介绍了Spring Boot集成MyBatis的方法,重点讲解基于注解的方式。首先简述MyBatis作为持久层框架的特点,接着说明集成时的依赖导入,包括`mybatis-spring-boot-starter`和MySQL连接器。随后详细展示了`properties.yml`配置文件的内容,涵盖数据库连接、驼峰命名规范及Mapper文件路径等关键设置,帮助开发者快速上手Spring Boot与MyBatis的整合开发。
214 0
|
4月前
|
缓存 Java 应用服务中间件
微服务——SpringBoot使用归纳——Spring Boot集成Thymeleaf模板引擎——依赖导入和Thymeleaf相关配置
在Spring Boot中使用Thymeleaf模板,需引入依赖`spring-boot-starter-thymeleaf`,并在HTML页面标签中声明`xmlns:th=&quot;http://www.thymeleaf.org&quot;`。此外,Thymeleaf默认开启页面缓存,开发时建议关闭缓存以实时查看更新效果,配置方式为`spring.thymeleaf.cache: false`。这可避免因缓存导致页面未及时刷新的问题。
103 0
|
4月前
|
Java 数据库 微服务
微服务——SpringBoot使用归纳——Spring Boot中的项目属性配置——指定项目配置文件
在实际项目中,开发环境和生产环境的配置往往不同。为简化配置切换,可通过创建 `application-dev.yml` 和 `application-pro.yml` 分别管理开发与生产环境配置,如设置不同端口(8001/8002)。在 `application.yml` 中使用 `spring.profiles.active` 指定加载的配置文件,实现环境快速切换。本节还介绍了通过配置类读取参数的方法,适用于微服务场景,提升代码可维护性。课程源码可从 [Gitee](https://gitee.com/eson15/springboot_study) 下载。
112 0
|
4月前
|
Java 微服务 Spring
微服务——SpringBoot使用归纳——Spring Boot中的项目属性配置——少量配置信息的情形
在微服务架构中,随着业务复杂度增加,项目可能需要调用多个微服务。为避免使用`@Value`注解逐一引入配置的繁琐,可通过定义配置类(如`MicroServiceUrl`)并结合`@ConfigurationProperties`注解实现批量管理。此方法需在配置文件中设置微服务地址(如订单、用户、购物车服务),并通过`@Component`将配置类纳入Spring容器。最后,在Controller中通过`@Resource`注入配置类即可便捷使用,提升代码可维护性。
64 0