一起来学SpringBoot | 第二篇:SpringBoot配置详解

SpringBoot 是为了简化 Spring 应用的创建、运行、调试、部署等一系列问题而诞生的产物,自动装配的特性让我们可以更好的关注业务本身而不是外部的XML配置,我们只需遵循规范,引入相关的依赖就可以轻易的搭建出一个 WEB 工程

上一篇介绍了 SpringBoot 由来及构建方式,通过第一章的教程我们对 SpringBoot 不在感到陌生,可以发现 SpringBoot 虽然干掉了 XML 但未做到 零配置,它体现出了一种 约定优于配置,也称作按约定编程,是一种软件设计范式,旨在减少软件开发人员需做决定的数量,获得简单的好处,而又不失灵活性。 一般情况下默认的配置足够满足日常开发所需,但在特殊的情况下,我们往往需要用到自定义属性配置、自定义文件配置、多环境配置、外部命令引导等一系列功能。不用担心,这些 SpringBoot 都替我们考虑好了,我们只需要遵循它的规则配置即可

准备前提

为了让 Spring Boot 更好的生成配置元数据文件,我们需要添加如下依赖(该依赖可以不添加,但是在 IDEA 和 STS 中不会有属性提示,没有提示的配置就跟你用记事本写代码一样苦逼,出个问题弄哭你去),该依赖只会在编译时调用,所以不用担心会对生产造成影响…


    org.springframework.boot
    spring-boot-configuration-processor
    true

自定义属性配置
在 application.properties 写入如下配置内容

my1.age=22
my1.name=Janson

其次定义 MyProperties1.java 文件,用来映射我们在 application.properties 中的内容,这样一来我们就可以通过操作对象的方式来获得配置文件的内容了

package com.hjs.springboottest.properties;

import lombok.Data;
import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.stereotype.Component;

@Component
@ConfigurationProperties(prefix = "my1")
@Data
public class MyProperties1 {

    private int age;
    private String name;


    @Override
    public String toString() {
        return "MyProperties1{" +
                "age=" + age +
                ", name='" + name + '\'' +
                '}';
    }
}

接下来就是定义我们的 PropertiesController 用来注入 MyProperties1 测试我们编写的代码,值得注意的是 Spring4.x 以后,推荐使用构造函数的形式注入属性…


@RequestMapping("/properties")
@RestController
public class PropertiesController {

    private static final Logger log = LoggerFactory.getLogger(PropertiesController.class);

    private final MyProperties1 myProperties1;

    private final MyProperties2 myProperties2;

    @Autowired
    public PropertiesController(MyProperties1 myProperties1,MyProperties2 myProperties2) {
        this.myProperties1 = myProperties1;
        this.myProperties2 = myProperties2;
    }

    @GetMapping("/test")
    public MyProperties1 myProperties1() {
        log.info("=================================================================================================");
        log.info(myProperties1.toString());
        log.info("=================================================================================================");
        return myProperties1;
    }
}

打开浏览器,输入如下地址: http://localhost:9091/properties/test,观察控制台,监听到如下内容则表示程序正确

2019-01-29 15:12:24.059  INFO 2368 --- [nio-9091-exec-5] c.h.s.controller.PropertiesController    : =================================================================================================
2019-01-29 15:12:24.059  INFO 2368 --- [nio-9091-exec-5] c.h.s.controller.PropertiesController    : MyProperties1{age=21, name='Janson'}
2019-01-29 15:12:24.059  INFO 2368 --- [nio-9091-exec-5] c.h.s.controller.PropertiesController    : =================================================================================================

自定义文件配置
定义一个名为 my2.properties 的资源文件,自定义配置文件的命名不强制 application 开头

my2.age=22
my2.name=Janson
[email protected]

其次定义 MyProperties2.java 文件,用来映射我们在 my2.properties 中的内容。


@Component
@PropertySource("classpath:my2.properties")
@ConfigurationProperties(prefix = "my2")
@Data
@ToString
public class MyProperties2 {
   private int age;
   private String name;
   private String email;

}

接下来在 PropertiesController 用来注入 MyProperties2 测试我们编写的代码

    @GetMapping("/test2")
    public MyProperties2 myProperties2() {
        log.info("=================================================================================================");
        log.info(myProperties2.toString());
        log.info("=================================================================================================");
        return myProperties2;
    }

打开浏览器,输入如下地址: http://localhost:9091/properties/test2,观察控制台,监听到如下内容则表示程序正确

2019-01-29 15:19:32.078  INFO 2368 --- [nio-9091-exec-2] c.h.s.controller.PropertiesController    : =================================================================================================
2019-01-29 15:19:32.078  INFO 2368 --- [nio-9091-exec-2] c.h.s.controller.PropertiesController    : MyProperties2(age=22, name=Janson, [email protected])
2019-01-29 15:19:32.078  INFO 2368 --- [nio-9091-exec-2] c.h.s.controller.PropertiesController    : =================================================================================================

但是一般来说,我们喜欢采用注解的方式去注入配置。
如在controller里面加入:

    @Value("${my1.age}")
    private  String age;

    @GetMapping("/test3")
    public String myProperties3() {
        log.info("=================================================================================================");
        log.info(age);
        log.info("=================================================================================================");
        return age;
    }

运行项目,访问http://localhost:9091/properties/test3,控制台打印如下则代表正确:

2019-01-29 16:40:14.627  INFO 11416 --- [nio-9091-exec-6] c.h.s.controller.PropertiesController    : =================================================================================================
2019-01-29 16:40:14.627  INFO 11416 --- [nio-9091-exec-6] c.h.s.controller.PropertiesController    : 21
2019-01-29 16:40:14.628  INFO 11416 --- [nio-9091-exec-6] c.h.s.controller.PropertiesController    : =================================================================================================

多环境化配置

在真实的应用中,常常会有多个环境(如:开发,测试,生产等),不同的环境数据库连接都不一样,这个时候就需要用到spring.profile.active 的强大功能了,它的格式为 application-{profile}.properties,这里的 application 为前缀不能改,{profile} 是我们自己定义的。

创建 application-dev.properties、application-test.properties、application-prod.properties,内容分别如下

application-dev.properties

server.servlet.context-path=/dev 

application-test.properties

server.servlet.context-path=/test

application-prod.properties

server.servlet.context-path=/prod

application.properties 配置文件中写入 spring.profiles.active=dev,这个时候我们在次访问 http://localhost:9091/properties/test 就没用处了,因为我们设置了它的context-path=/dev,所以新的路径就是 http://localhost:9091/dev/properties/test ,由此可以看出来我们激活不同的配置读取的属性值是不一样的

外部命令引导

前面三种方式都是基于配置文件层面的,那么有没有办法外部引导呢,假设这样的场景,我们对已经开发完成的代码打包发布,期间在测试环境测试通过了,那么即可发布上生产,这个时候是修改application.properties的配置方便还是直接在命令参数配置方便呢,毫无疑问是后者更有说服力。默认情况下,SpringApplication 会将命令行选项参数(即:–property,如–server.port=9000)添加到Environment,命令行属性始终优先于其他属性源。

如何测试?

  • 进入到项目目录,此处以我本地目录为主:E:\projects\springboot-test
  • 然后打开 cmd 程序,不会在当前目录打开 cmd 的请自行百度,输入:mvn package
  • 打包完毕后进入到:E:\projects\springboot-test/target 目录中去,我们可以发现一个名为springboot-test-0.0.1-SNAPSHOT 的包
  • 接着在打开 cmd 程序,输入:java -jar springboot-test-0.0.1-SNAPSHOT.jar --spring.profiles.active=test --my1.age=32。仔细观察spring.profiles.active=testmy1.age=21 这俩配置的键值是不是似曾相识(不认识的请从开头认真阅读)
  • 最后输入测试地址:http://localhost:9091/test/properties/test 我们可以发现返回的JSON变成了 {"age":32,"name":"Janson"}表示正确

总结

掌握@ConfigurationProperties、@PropertySource 等注解的用法及作用
掌握编写自定义配置
掌握外部命令引导配置的方式

目前很多大佬都写过关于 SpringBoot 的教程了,如有雷同,请多多包涵,本教程基于最新的 spring-boot-starter-parent:v2.1.2编写,包括新版本的特性都会一起介绍…

你可能感兴趣的:(一起来学SpringBoot | 第二篇:SpringBoot配置详解)