【玩转SpringBoot】看似复杂的Environment其实很简单


喜欢写代码,讨厌配环境



我相信这十个字的小标题代表了大多数码农的心声。

十年前读大学时,学校开设了C语言还有C++。但是学习这两种语言,对于新手来说非常没有成就感。

于是我就在校门口买个光盘,装个VS(宇宙第一IDE),还有离线中文版MSDN(最牛的帮助文档),万事已俱备。

学习C#语法,看类的API,然后从WinForm(窗口)开始,用鼠标拖拽控件,设置控件属性,观察自动生成的代码,开启人生的编程之路。

大四的时候接触到Java,首先就是配置环境变量,那时觉得是一个巨复杂的东西,每次都要网上搜好一会儿才能配好。

我学习微软的东西从来就不要配什么环境变量,心里很讨厌这个Java的环境变量,这就导致十年后的今天,我依然要去网上搜如何配置,惭愧惭愧,哈哈。

后来发现,基本上软件都要配置一些环境变量,只不过有的是在安装时已经自动配好了而已,但是对于免安装版(直接解压)的则需要自己配。


我们也来尝试下抽象


熟悉Java的都知道,Java里面有两个内置的配置集合,就是System.getenv()System.getProperties()

它们分别是系统环境和系统属性,如下图01:

【玩转SpringBoot】看似复杂的Environment其实很简单_第1张图片


一个是Map类型,一个是Properties类型,说明它们都是一些key-value形式的值。

而且Properties类型是Java里的标准配置方式,它就对应于*.properties文件。

至此,我们已经发现两个问题:

1)配置项都是以key-value形式存在的。

2)配置项的来源是多样化的,如现在的系统环境、系统属性、配置文件等,后期还可能会有其它。

对于配置项的多来源问题,有以下两种方式解决:

1)可以把所有来源都暴露给用户,这样使用起来更加精细,但是也会带来困扰,可能用户也会迷糊到底该去哪个来源取值。

2)在所有来源前面加一个“门面”,只把它暴露出去,用户看到的只是“单一来源”,就从这里取值,其它的啥也不用知道。

Spring选择的是第二种方案,拿到key后,只需依次去每个来源中查找,这时只需规定下多个来源之间的优先级顺序即可。

整体可以用一个图形表示,如下图02:

【玩转SpringBoot】看似复杂的Environment其实很简单_第2张图片


这整体也是一种封装变化的思想,底层的多来源问题被封装起来,对用户不可见。

最终用户传过来一个key,我给返回一个和它对应的value就行了。


来来来,认识两个朋友


配置项在Java中通常叫做属性,即Property。每一个来源其实就是一个源泉,即Source。

所以在Spring中就用PropertySource类来表示一个来源,如下图03:

【玩转SpringBoot】看似复杂的Environment其实很简单_第3张图片


注意两个字段,name和source,name就是为每个源起个名字。source表示真正的资源,是能从中取出value的东西。

然后需要一个门面把多个来源封装起来,如下图04:

【玩转SpringBoot】看似复杂的Environment其实很简单_第4张图片


可以看到它里面有一个来源的列表。这就是封装。而且还是有顺序的。

根据key取值就依次遍历所有源即可,如下图05:

【玩转SpringBoot】看似复杂的Environment其实很简单_第5张图片


如果所有源中都没找到,返回null就行了。

这样配置项(或配置属性)的问题就已经解决了,很简单吧。


除了配置属性外,还有Profile


配置属性是一个很泛化的概念,说白了它就表示以非写代码的方式从外界向程序中传递特定的值。

它的好处就是修改起来很容易,只需修改下配置文件或命令行参数,然后最多重启一下就可以了。

不用修改代码,自然不用重新编译,当然也不用重新打包发布。

泛化其实就表示囊括所有的意思,但是总会有一些特殊情形,值得单独拿出来特别对待。

如每个软件都会至少经历开发、测试、上线这三个阶段,同样也会有三套环境,即开发环境、测试环境、生产环境。

这里的“环境”其实就是一个特殊情况,我们把它单独拿出来,就叫做Profile。

对不同的环境设置不同的Profile,程序中可以读取到Profile,这样程序就可以适应不同的Profile,展示不同的特性。

最终就可以一套代码打天下。就像华为的一套操作系统适应所有的终端设备。就像Java的一份字节码运行在不同的操作系统上。

在不指定Profile时,通常应该有一个默认的Profile。就像汽车默认是运行在城市道路上一样。

在Spring中,默认的Profile就叫做default。如下图06:


这个default可能没有什么意义,所以Spring提供了修改它的机会,如下图07:


可以使用图中的参数名称去指定默认的Profile,以符合自己的使用习惯。

比如对于汽车这种情况,可以这样:

spring.profiles.default=city

我们也可以为不同的环境激活不同的Profile,Spring也提供了方法,如下图08:


比如汽车上了高速,我们想狂野一下,可以激活运动模式:

spring.profiles.active=sports


最后要说的就是,这个Profile可以指定多个,用逗号分隔即可。

因为Spring是用集合存储的,所以支持多个,如下图09:


程序在判断哪些Profile被激活时,可以使用逻辑表达式,这样就更加灵活了。

支持与、或、非、括号,如下图10:

【玩转SpringBoot】看似复杂的Environment其实很简单_第6张图片


比如我们让程序运行在单节点debug模式,可以这样设置:

spring.profiles.active=standalone,debug


那么下面这些判断将都返回true:

standalone -> true

debug -> true

standalone | debug -> true

standalone & debug -> true

!other -> true

!unknown -> true


下面这些将都返回false:

!standalone -> false

!debug -> false

standalone & other -> false

debug & unknown -> false

(standalone & other) | (debug & unknown) -> false

(standalone | debug) & other & unknown -> false


:当同时出现与(&)、或(|)时,一定要使用括号。


那什么是Environment呢?


很简单,就是这个公式:

Environment = Properties + Profiles


表示Properties的接口,主要就是处理一些key-value,如下图11:

【玩转SpringBoot】看似复杂的Environment其实很简单_第7张图片


Environment继承了这个接口,又加入处理Profile的内容,如下图12:

【玩转SpringBoot】看似复杂的Environment其实很简单_第8张图片


由于要支持key-value数据类型的转换和${..}表达式的解析,所以需要能够配置,如下图13:

【玩转SpringBoot】看似复杂的Environment其实很简单_第9张图片


由于需要能够以编程的方式激活Profile或设置默认Profile,所以也需要能够配置,如下图14:

【玩转SpringBoot】看似复杂的Environment其实很简单_第10张图片


所以,这四个接口就是Spring环境的全部了。


在SpringBoot中Environment的真面目


下面是非web环境:

StandardEnvironment {activeProfiles=[], defaultProfiles=[default], 
propertySources=[
ConfigurationPropertySourcesPropertySource {name='configurationProperties'}, 
SimpleCommandLinePropertySource {name='commandLineArgs'}, 
PropertiesPropertySource {name='systemProperties'}, 
OriginAwareSystemEnvironmentPropertySource {name='systemEnvironment'}, 
RandomValuePropertySource {name='random'}, 
OriginTrackedMapPropertySource {name='applicationConfig: [classpath:/application.yml]'}, 
ResourcePropertySource {name='class path resource [mode.properties]'}, 
ResourcePropertySource {name='class path resource [greeting.properties]'}]}


可以看到配置属性有多个来源,包括命令行参数,系统属性,系统环境,随机数,yml配置文件,properties配置文件等。

--开头的参数会出现在命令行参数这个源里,如下图15:


-D开头的参数会出现在系统属性这个源里,如下图16:


这些源在上面的顺序就是它们的优先级,可见命令行的最高,properties文件的最低。

注意源中的第一个,即名称为configurationProperties的,主要是为了适应SpringBoot的属性名的“松散”绑定而专门用来处理属性名称的。

它并不真正提供属性值,它的值来源于除它之外的其它源。

如果不明白什么是属性名的松散绑定的,看这个示例:

user-name, user_name, userName


这三个属性名称都可以绑定到一个类的userName属性上。

下面是基于Servlet的web环境:

StandardServletEnvironment {activeProfiles=[], defaultProfiles=[default], 
propertySources=[
ConfigurationPropertySourcesPropertySource {name='configurationProperties'}, 
SimpleCommandLinePropertySource {name='commandLineArgs'}, 
StubPropertySource {name='servletConfigInitParams'}, 
ServletContextPropertySource {name='servletContextInitParams'}, 
PropertiesPropertySource {name='systemProperties'}, 
OriginAwareSystemEnvironmentPropertySource {name='systemEnvironment'}, 
RandomValuePropertySource {name='random'}, 
OriginTrackedMapPropertySource {name='applicationConfig: [classpath:/application.yml]'}, 
ResourcePropertySource {name='class path resource [mode.properties]'}, 
ResourcePropertySource {name='class path resource [greeting.properties]'}]}


和上面的唯一区别就是多了两个和web相关的源,就是ServletConfigServletContext

可以从它们两个里面取出初始化参数,而且它们的优先级仅次于命令行参数。

备注:还有一种基于Reactive(响应式)的web环境。暂时先不讨论了。

每一个源里面其实都是key-value,内容较多,不再展示。可以自己运行下试试。

本文示例代码

https://github.com/coding-new-talking/playing-spring.git

 

>>> 玩转SpringBoot系列文章 <<<

 

【玩转SpringBoot】配置文件yml的正确打开姿势

【玩转SpringBoot】用好条件相关注解,开启自动配置之门

【玩转SpringBoot】给自动配置来个整体大揭秘

 

>>> 品Spring系列文章 <<<

 

品Spring:帝国的基石

品Spring:bean定义上梁山

品Spring:实现bean定义时采用的“先进生产力”

品Spring:注解终于“成功上位”

品Spring:能工巧匠们对注解的“加持”

品Spring:SpringBoot和Spring到底有没有本质的不同?

品Spring:负责bean定义注册的两个“排头兵”

品Spring:SpringBoot轻松取胜bean定义注册的“第一阶段”

品Spring:SpringBoot发起bean定义注册的“二次攻坚战”

品Spring:注解之王@Configuration和它的一众“小弟们”

品Spring:bean工厂后处理器的调用规则

品Spring:详细解说bean后处理器

品Spring:对@PostConstruct和@PreDestroy注解的处理方法

品Spring:对@Resource注解的处理方法

品Spring:对@Autowired和@Value注解的处理方法

品Spring:真没想到,三十步才能完成一个bean实例的创建

品Spring:关于@Scheduled定时任务的思考与探索,结果尴尬了

 

>>> 热门文章集锦 <<<

 

毕业10年,我有话说

【面试】我是如何面试别人List相关知识的,深度有点长文

我是如何在毕业不久只用1年就升为开发组长的

爸爸又给Spring MVC生了个弟弟叫Spring WebFlux

【面试】我是如何在面试别人Spring事务时“套路”对方的

【面试】Spring事务面试考点吐血整理(建议珍藏)

【面试】我是如何在面试别人Redis相关知识时“软怼”他的

【面试】吃透了这些Redis知识点,面试官一定觉得你很NB(干货 | 建议珍藏)

【面试】如果你这样回答“什么是线程安全”,面试官都会对你刮目相看(建议珍藏)

【面试】迄今为止把同步/异步/阻塞/非阻塞/BIO/NIO/AIO讲的这么清楚的好文章(快快珍藏)

【面试】一篇文章帮你彻底搞清楚“I/O多路复用”和“异步I/O”的前世今生(深度好文,建议珍藏)

【面试】如果把线程当作一个人来对待,所有问题都瞬间明白了

Java多线程通关———基础知识挑战

品Spring:帝国的基石

 

 

作者是工作超过10年的码农,现在任架构师。喜欢研究技术,崇尚简单快乐。追求以通俗易懂的语言解说技术,希望所有的读者都能看懂并记住。下面是公众号的二维码,欢迎关注!

【玩转SpringBoot】看似复杂的Environment其实很简单_第11张图片 

你可能感兴趣的:(【玩转SpringBoot】看似复杂的Environment其实很简单)