springcloud情操陶冶-bootstrapContext(三)

本文则将重点阐述context板块的自动配置类，观察其相关的特性并作相应的总结

自动配置类

直接查看cloudcontext板块下的spring.factories对应的EnableAutoConfiguration键值对

# AutoConfiguration
org.springframework.boot.autoconfigure.EnableAutoConfiguration=
org.springframework.cloud.autoconfigure.ConfigurationPropertiesRebinderAutoConfiguration,
org.springframework.cloud.autoconfigure.LifecycleMvcEndpointAutoConfiguration,
org.springframework.cloud.autoconfigure.RefreshAutoConfiguration,
org.springframework.cloud.autoconfigure.RefreshEndpointAutoConfiguration,
org.springframework.cloud.autoconfigure.WritableEnvironmentEndpointAutoConfiguration

除了第一个自动配置类在前文有所提及，其余的四个可以分为步骤来进行一一的解析

MVC生命周期端点自动配置类-刷新属性

管理MVC的整个生命周期而暴露给外部的端点，LifecycleMvcEndpointAutoConfiguration的内部源码还是很简单的

// 排在MVC配置类之后
@Configuration
@AutoConfigureAfter(WebMvcAutoConfiguration.class)
public class LifecycleMvcEndpointAutoConfiguration {

	// 注册环境管理器EnvironmentManager
	@Bean
	@ConditionalOnMissingBean
	public EnvironmentManager environmentManager(ConfigurableEnvironment environment) {
		return new EnvironmentManager(environment);
	}

}

EnvironmentManager类内含上下文环境变量ConfigurableEnvironment和事件分发器publisher，同时内部也暴露了JMX接口供外部调用。
总的来说也就是通过该类变更上下文属性便会触发EnvironmentChangeEvent事件，其中变更的属性都将存入名为manager的属性集合中

刷新自动配置类-刷新Bean

此处的刷新与前者的刷新属性不同，其针对的是bean。并通过相应的刷新操作触发RefreshScopeRefreshedEvent事件

@Configuration
@ConditionalOnClass(RefreshScope.class)
// 可通过更改spring.cloud.refresh.enabled值来确定是否让该配置生效。默认为true
@ConditionalOnProperty(name = RefreshAutoConfiguration.REFRESH_SCOPE_ENABLED, matchIfMissing = true)
@AutoConfigureBefore(HibernateJpaAutoConfiguration.class)
public class RefreshAutoConfiguration {

	// 主要bean类
	@Bean
	@ConditionalOnMissingBean(RefreshScope.class)
	public static RefreshScope refreshScope() {
		return new RefreshScope();
	}
}

其余的代码没贴出来，因为发现关键类就是此RefreshScope，其也暴露了JMX接口供外部调用来刷新bean(销毁指定的bean)

刷新端点自动配置类-刷新context

此处的刷新针对的不是bean对象了，而是整个上下文context。

@Configuration
@ConditionalOnClass({EndpointAutoConfiguration.class, Health.class})
// 排在前者配置之后
@AutoConfigureAfter({ LifecycleMvcEndpointAutoConfiguration.class,
		RefreshAutoConfiguration.class})
// 导入类
@Import({ RestartEndpointWithIntegrationConfiguration.class,
		RestartEndpointWithoutIntegrationConfiguration.class,
		PauseResumeEndpointsConfiguration.class })
public class RefreshEndpointAutoConfiguration {
}

优先对导入类作简单的查看把

---

1.前两个类其实都是为了创建RestartEndpoint对象

	// 端点名为restart
	@Bean
	@ConditionalOnEnabledEndpoint
	@ConditionalOnMissingBean
	public RestartEndpoint restartEndpointWithoutIntegration() {
		return new RestartEndpoint();
	}

而RestartEndpoint端点也暴露了JMX接口供外界调用直接刷新context，但无事件触发，且其头上有一个注解

@Endpoint(id = "restart", enableByDefault = false)
public class RestartEndpoint implements ApplicationListener<ApplicationPreparedEvent> {
}

可通过配置management.endpoint.${id}.enabled属性来开关指定的端点，
也可以通过@Endpoint注解中的属性enableByDefault来指定(默认为true)；
全局的话也可通过环境属性management.endpoints.enabled-by-default来指定。
由此得知RestartEndPoint端点默认是不开启的

不过笔者发现此端点是ApplicationListener接口的实现类，但据笔者的认知范围，只有在spring.factories文件中定义才会被spring调用，那其又是怎么被调用，确保其内部的context是有值的呢？待商榷！

---

2.PauseEndpoint端点和ResumeEndpoint端点的使用，但彼此都依赖RestartEndPoint端点，均是它的内部类。

@Configuration
class PauseResumeEndpointsConfiguration {

	// 端点名为pause
	@Bean
	@ConditionalOnBean(RestartEndpoint.class)
	@ConditionalOnMissingBean
	@ConditionalOnEnabledEndpoint
	public RestartEndpoint.PauseEndpoint pauseEndpoint(RestartEndpoint restartEndpoint) {
		return restartEndpoint.getPauseEndpoint();
	}

	// 端点名为resume
	@Bean
	@ConditionalOnBean(RestartEndpoint.class)
	@ConditionalOnMissingBean
	@ConditionalOnEnabledEndpoint
	public RestartEndpoint.ResumeEndpoint resumeEndpoint(
			RestartEndpoint restartEndpoint) {
		return restartEndpoint.getResumeEndpoint();
	}

}

通过这两个端点来控制上下文的启动与关闭，于是官方也暴露了相应的JMX接口供外部调用

---

---

然后对内部的Bean作下简单的介绍

	// 健康检查类
	// 可通过management.health.${id}.enable属性来控制
	@Bean
	@ConditionalOnMissingBean
	@ConditionalOnEnabledHealthIndicator("refresh")
	RefreshScopeHealthIndicator refreshScopeHealthIndicator(ObjectProvider<RefreshScope> scope,
															ConfigurationPropertiesRebinder rebinder) {
		return new RefreshScopeHealthIndicator(scope, rebinder);
	}

可写环境端点自动配置类

对环境变量的属性可更改的端点则通过WritableEnvironmentEndpointAutoConfiguration来实现

@Configuration
@ConditionalOnClass({ EnvironmentEndpoint.class, EnvironmentEndpointProperties.class })
@ConditionalOnBean(EnvironmentManager.class)
@AutoConfigureBefore(EnvironmentEndpointAutoConfiguration.class)
@AutoConfigureAfter(LifecycleMvcEndpointAutoConfiguration.class)
@EnableConfigurationProperties({ EnvironmentEndpointProperties.class })
// 可通过management.endpoint.env.post.enabled属性开关，默认为true
@ConditionalOnProperty(value = "management.endpoint.env.post.enabled", matchIfMissing = true)
public class WritableEnvironmentEndpointAutoConfiguration {
}

内部的Bean对象也就是暴露属性的更改权限，有JMX方式也有MVC方式。

---

JMX方式

	// 端点名为env
	@Bean
	@ConditionalOnMissingBean
	@ConditionalOnEnabledEndpoint
	public WritableEnvironmentEndpoint environmentEndpoint(Environment environment) {
		WritableEnvironmentEndpoint endpoint = new WritableEnvironmentEndpoint(environment);
		String[] keysToSanitize = this.properties.getKeysToSanitize();
		if (keysToSanitize != null) {
			endpoint.setKeysToSanitize(keysToSanitize);
		}
		return endpoint;
	}

---

MVC方式则引用了上文提到的EnvironmentManager对象。并且也引用了JMX方式中的WritableEnvironmentEndpoint对象，具体的使用则属于cloud-actuator板块，有兴趣的读者可自行分析

	// 该端点以/env作为端点入口
	@Bean
	@ConditionalOnEnabledEndpoint
	public WritableEnvironmentEndpointWebExtension environmentEndpointWebExtension(
			WritableEnvironmentEndpoint endpoint, EnvironmentManager environment) {
		// 调用EnvironmentManager对象来操作上下文的环境变量
		return new WritableEnvironmentEndpointWebExtension(endpoint, environment);
	}

不管是哪种方式的调用，作用的对象是属性。包含了单个属性的更改、某个Environment的变量集合查看等等，范围更为宽广。

小结

cloudcontext板块提供了针对环境属性、bean对象、上下文等方式的刷新操作，均暴露JMX方式供外界调用；至于MVC方式有兴趣的读者可自行分析。

也就是刷新的入口在context板块中已经得到了相应的补充，至于扩展与相应的使用便是其余cloud板块的范畴了。明白此点比较有利于后续对cloud的深入了解