配置类型

Spring Cloud Alibaba Nacos Config 目前提供了三种配置能力从 Nacos 拉取相关的配置。

  • A: 通过 spring.cloud.nacos.config.shared-configs[n].data-id 支持多个共享 Data Id 的配置。
  • B: 通过 spring.cloud.nacos.config.extension-configs[n].data-id 的方式支持多个扩展Data Id 的配置。
  • C: 通过内部相关规则(应用名、应用名+ Profile )自动生成相关的 Data Id 配置。

当三种方式共同使用时,他们的一个优先级关系是:A < B < C。

基于dataid为 yaml 的文件扩展配置

spring-cloud-starter-alibaba-nacos-config 默认支持的文件格式是 properties, 如果我们想用其他格式的文件,可以只需要完成以下两步:

1、在应用的 bootstrap.properties 配置文件中显示的声明 dataid 文件扩展名。如下所示 bootstrap.properties

  1. spring.cloud.nacos.config.file-extension=yaml

2、在Nacos控制台,修改配置文件的类型,改成yml。

针对profile粒度配置

spring-cloud-starter-alibaba-nacos-config 在加载配置的时候,不仅仅加载了以 dataid 为 Nacos配置中心源码分析 - 图1{file-extension:properties} 为前缀的基础配置,还加载了dataid为 Nacos配置中心源码分析 - 图2{profile}.${file-extension:properties} 的基础配置。在日常开发中如果遇到多套环境下的不同配置,可以通过Spring 提供的

${spring.profiles.active} 这个配置项来配置。

1.在bootstrap.properties中添加profile

  1. spring.profiles.active=develop
  1. Nacos 上新增一个dataid为:wuzz-nacos-dubbo-consumer-develop.yaml 的基础配置,如下所示:

Nacos配置中心源码分析 - 图3

如果需要切换到生产环境,只需要更改 ${spring.profiles.active} 参数配置即可。如下所示:

  1. spring.profiles.active=product

此案例中我们通过 spring.profiles.active= 的方式写死在配置文件中,而在真正的项目实施过程中这个变量的值是需要不同环境而有不同的值。这个时候通常的做法是通过 -Dspring.profiles.active= 参数指定其配置来达到环境间灵活的切换。

Nacos 中的Namespace和Group

在nacos中提供了namespace和group命名空间和分组的机制。,它是Nacos提供的一种数据模型,也就是我们要去定位到一个配置,需要基于namespace- > group ->dataid来实现。

namespace可以解决多环境以及多租户数据的隔离问题。比如在多套环境下,可以根据指定环境创建不同的namespace,实现多环境隔离。或者在多租户的场景中,每个用户可以维护自己的namespace,实现每个用户的配置数据和注册数据的隔离。

group是分组机制,它的纬度是实现服务注册信息或者DataId的分组管理机制,对于group的用法,没有固定的规则,它也可以实现不同环境下的分组,也可以实现同一个应用下不同配置类型或者不同业务类型的分组。

官方建议是,namespace用来区分不同环境,group可以专注在业务层面的数据分组。实际上在使用过程中,最重要的是提前定要统一的口径和规定,避免不同的项目团队混用导致后期维护混乱的问题。

自定义namespace

在没有明确指定 ${spring.cloud.nacos.config.namespace} 配置的情况下, 默认使用的是 Nacos上 Public 这个namespae。如果需要使用自定义的命名空间,可以通过以下配置来实现:

  1. spring.cloud.nacos.config.namespace=b3404bc0-d7dc-4855-b519-570ed34b62d7

该配置必须放在 bootstrap.properties 文件中。此外 spring.cloud.nacos.config.namespace 的值是 namespace 对应的 id,id 值可以在 Nacos的控制台获取。并且在添加配置时注意不要选择其他的 namespae,否则将会导致读取不到正确的配置。

Nacos配置中心源码分析 - 图4

自定义group

在没有明确指定 ${spring.cloud.nacos.config.group} 配置的情况下, 默认使用的是DEFAULT_GROUP 。如果需要自定义自己的 Group,可以通过以下配置来实现:

  1. spring.cloud.nacos.config.group=DEVELOP_GROUP

该配置必须放在 bootstrap.properties 文件中。并且在添加配置时 Group 的值一定要和spring.cloud.nacos.config.group 的配置值一致

自定义扩展的DataId

Spring Cloud Alibaba Nacos Config 从 0.2.1 版本后,可支持自定义 Data Id 的配置。关于这部分详细的设计可参考 这里。 一个完整的配置案例如下所示:

  1. # config external configuration
  2. # 1Data Id 在默认的组 DEFAULT_GROUP,不支持配置的动态刷新
  3. spring.cloud.nacos.config.extension-configs[0].data-id=ext-config-
  4. common01.properties
  5. # 2Data Id 不在默认的组,不支持动态刷新
  6. spring.cloud.nacos.config.extension-configs[1].data-id=ext-config-
  7. common02.properties
  8. spring.cloud.nacos.config.extension-configs[1].group=GLOBALE_GROUP
  9. # 3Data Id 既不在默认的组,也支持动态刷新
  10. spring.cloud.nacos.config.extension-configs[2].data-id=ext-config-
  11. common03.properties
  12. spring.cloud.nacos.config.extension-configs[2].group=REFRESH_GROUP
  13. spring.cloud.nacos.config.extension-configs[2].refresh=true

可以看到:

  1. 通过 spring.cloud.nacos.config.extension-configs[n].data-id 的配置方式来支持多个Data Id 的配置。
  2. 通过 spring.cloud.nacos.config.extension-configs[n].group 的配置方式自定义 Data Id所在的组,不明确配置的话,默认是 DEFAULT_GROUP。
  3. 通过 spring.cloud.nacos.config.extension-configs[n].refresh 的配置方式来控制该Data Id 在配置变更时,是否支持应用中可动态刷新, 感知到最新的配置值。默认是不支持的。

多个 Data Id 同时配置时,他的优先级关系是 spring.cloud.nacos.config.extension-configs[n].data-id 其中 n 的值越大,优先级越高。

spring.cloud.nacos.config.extension-configs[n].data-id 的值必须带文件扩展名,文件扩展名既可支持 properties,又可以支持 yaml/yml。 此时spring.cloud.nacos.config.file-extension 的配置对自定义扩展配置的 Data Id 文件扩展名没有影响。

通过自定义扩展的 Data Id 配置,既可以解决多个应用间配置共享的问题,又可以支持一个应用有多个配置文件。

为了更加清晰的在多个应用间配置共享的 Data Id ,你可以通过以下的方式来配置:通过自定义扩展的 Data Id 配置,既可以解决多个应用间配置共享的问题,又可以支持一个应用有多个配置文件。

  1. # 配置支持共享的 Data Id
  2. spring.cloud.nacos.config.shared-configs[0].data-id=common.yaml
  3. # 配置 Data Id 所在分组,缺省默认 DEFAULT_GROUP
  4. spring.cloud.nacos.config.shared-configs[0].group=GROUP_APP1
  5. # 配置Data Id 在配置变更时,是否动态刷新,缺省默认 false
  6. spring.cloud.nacos.config.shared-configs[0].refresh=true

可以看到:

  1. 通过 spring.cloud.nacos.config.shared-configs[n].data-id 来支持多个共享 Data Id 的配置。
  2. 通过 spring.cloud.nacos.config.shared-configs[n].group 来配置自定义 Data Id 所在的组,不明确配置的话,默认是 DEFAULT_GROUP。
  3. 通过 spring.cloud.nacos.config.shared-configs[n].refresh 来控制该Data Id在配置变更时,是否支持应用中动态刷新,默认false。

Nacos 源码分析

Environment,这个是非常重要的类,他负责管理spring的运行相关的配置信息,其中就包含application.properties。

而在Spring Cloud中,如果集成Nacos作为配置中心的话,那么意味着这部分配置是属于远程配置,也会作为配置源保存到Environment中,这样我们才能通过@value注解来注入配置中的属性。

Environment中所有外部化配置,针对不同类型的配置都会有与之对应的PropertySource,比如(SystemEnvironmentPropertySource、CommandLinePropertySource)。以及PropertySourcesPropertyResolver来进行解析。

那NacosClient在启动的时候,必然也会需要从远程服务器上获取配置加载到Environment中,这样才能使得应用程序通过@value进行属性的注入,而且我们一定可以猜测到的是,这块的工作一定又和spring中某个机制有关系。

在spring boot项目启动时,有一个prepareContext的方法,它会回调所有实现了 ApplicationContextInitializer 的实例,来做一些初始化工作。

  1. public ConfigurableApplicationContext run(String... args) {
  2. //省略代码...
  3. prepareContext(context, environment, listeners, applicationArguments,
  4. printedBanner);
  5. //省略代码
  6. return context;
  7. }

PropertySourceBootstrapConfiguration 实现了 ApplicationContextInitializer 接口,其目的就是在应用程序上下文初始化的时候做一些额外的操作.,根据默认的 AnnotationAwareOrderComparator 排序规则对propertySourceLocators数组进行排序,获取运行的环境上下文ConfigurableEnvironment。遍历propertySourceLocators时

  • 调用 locate 方法,传入获取的上下文environment。
  • 将source添加到PropertySource的链表中。
  • 设置source是否为空的标识标量empty。

source不为空的情况,才会设置到environment中

  • 返回Environment的可变形式,可进行的操作如addFirst、addLast。
  • 移除propertySources中的bootstrapProperties。
  • 根据config server覆写的规则,设置propertySources。
  • 处理多个active profiles的配置信息。
  1. public void initialize(ConfigurableApplicationContext applicationContext) {
  2. CompositePropertySource composite = new CompositePropertySource(
  3. BOOTSTRAP_PROPERTY_SOURCE_NAME);
  4. //对propertySourceLocators数组进行排序,根据默认的AnnotationAwareOrderComparator
  5. AnnotationAwareOrderComparator.sort(this.propertySourceLocators);
  6. boolean empty = true;
  7. //获取运行的环境上下文
  8. ConfigurableEnvironment environment = applicationContext.getEnvironment();
  9. for (PropertySourceLocator locator : this.propertySourceLocators) {
  10. //回调所有实现PropertySourceLocator接口实例的locate方法,
  11. PropertySource<?> source = null;
  12. source = locator.locate(environment);
  13. if (source == null) {
  14. continue;
  15. }
  16. logger.info("Located property source: " + source);
  17. composite.addPropertySource(source);//将source添加到数组
  18. empty = false;//表示propertysource不为空
  19. }
  20. if (!empty) {//只有propertysource不为空的情况,才会设置到environment中
  21. MutablePropertySources propertySources = environment.getPropertySources();
  22. String logConfig = environment.resolvePlaceholders("${logging.config:}");
  23. LogFile logFile = LogFile.get(environment);
  24. if (propertySources.contains(BOOTSTRAP_PROPERTY_SOURCE_NAME)) {
  25. propertySources.remove(BOOTSTRAP_PROPERTY_SOURCE_NAME);
  26. }
  27. insertPropertySources(propertySources, composite);
  28. reinitializeLoggingSystem(environment, logConfig, logFile);
  29. setLogLevels(applicationContext, environment);
  30. handleIncludedProfiles(environment);
  31. }
  32. }

locator.locate(environment):这个方法会调用子类的locate方法,来获得一个PropertySource,然后将PropertySource集合返回。接着它会调用 ConfigServicePropertySourceLocator 的locate方法。
1383365-20200910135654108-2057062834.png
我们可以看到 spring-cloud-config也是实现了这个接口,Nacos 也是一样的。

NacosPropertySourceLocator.locate :这个就是Nacos 配置中心加载的的关键实现了,分别调用三个方法来加载配置

Nacos配置加载顺序:共享配置 —> 扩展配置 —> 自身配置(后面优先级高) , 这三个配置在前面的内容中我们已经讲过了.

  1. public PropertySource<?> locate(Environment env) {
  2. nacosConfigProperties.setEnvironment(env);
  3. ConfigService configService = nacosConfigManager.getConfigService();
  4. if (null == configService) {
  5. log.warn("no instance of config service found, can't load config from nacos");
  6. return null;
  7. }
  8. long timeout = nacosConfigProperties.getTimeout();
  9. nacosPropertySourceBuilder = new NacosPropertySourceBuilder(configService,
  10. timeout);
  11. String name = nacosConfigProperties.getName();
  12. String dataIdPrefix = nacosConfigProperties.getPrefix();
  13. if (StringUtils.isEmpty(dataIdPrefix)) {
  14. dataIdPrefix = name;
  15. }
  16. if (StringUtils.isEmpty(dataIdPrefix)) {
  17. dataIdPrefix = env.getProperty("spring.application.name");
  18. }
  19. CompositePropertySource composite = new CompositePropertySource(
  20. NACOS_PROPERTY_SOURCE_NAME);
  21.      //加载共享配置
  22. loadSharedConfiguration(composite);
  23.      //加载扩展配置
  24. loadExtConfiguration(composite);
  25.      //加载自身配置
  26. loadApplicationConfiguration(composite, dataIdPrefix, nacosConfigProperties, env);
  27. return composite;
  28. }

loadApplicationConfiguration:我们可以先不管加载共享配置、扩展配置的方法,最终本质上都是去远程服务上读取配置,只是传入的参数不一样。

  • fileExtension,表示配置文件的扩展名
  • nacosGroup表示分组
  • 加载 dataid=项目名称 的配置
  • 加载 dataid=项目名称+扩展名 的配置
  • 遍历当前配置的激活点(profile),分别循环加载带有profile的dataid配置
  1. private void loadApplicationConfiguration(
  2. CompositePropertySource compositePropertySource, String dataIdPrefix,
  3. NacosConfigProperties properties, Environment environment) {
  4. //获取配置文件的扩展名
  5. String fileExtension = properties.getFileExtension();
  6. // 获取配置的分组
  7. String nacosGroup = properties.getGroup();
  8. // load directly once by default 加载存在的配置信息 可以发现这里会加载带跟不带prefix的配置
  9. loadNacosDataIfPresent(compositePropertySource, dataIdPrefix, nacosGroup,
  10. fileExtension, true);
  11. // load with suffix, which have a higher priority than the default
  12. loadNacosDataIfPresent(compositePropertySource,
  13. dataIdPrefix + DOT + fileExtension, nacosGroup, fileExtension, true);
  14. // Loaded with profile, which have a higher priority than the suffix
  15. for (String profile : environment.getActiveProfiles()) {
  16. String dataId = dataIdPrefix + SEP1 + profile + DOT + fileExtension;
  17. loadNacosDataIfPresent(compositePropertySource, dataId, nacosGroup,
  18. fileExtension, true);
  19. }
  20. }

loadNacosDataIfPresent:调用 loadNacosPropertySource 加载存在的配置信息。把加载之后的配置属性保存到CompositePropertySource中。

  1. private void loadNacosDataIfPresent(final CompositePropertySource composite,
  2. final String dataId, final String group, String fileExtension,
  3. boolean isRefreshable) {
  4. if (null == dataId || dataId.trim().length() < 1) {
  5. return;
  6. }
  7. if (null == group || group.trim().length() < 1) {
  8. return;
  9. }
  10. NacosPropertySource propertySource = this.loadNacosPropertySource(dataId, group,
  11. fileExtension, isRefreshable);
  12. this.addFirstPropertySource(composite, propertySource, false);
  13. }

做一些简单的校验,然后进入 loadNacosPropertySource

  1. private NacosPropertySource loadNacosPropertySource(final String dataId,
  2. final String group, String fileExtension, boolean isRefreshable) {
  3. //是否支持自动刷新,// 如果不支持自动刷新配置则自动从缓存获取返回
  4. if (NacosContextRefresher.getRefreshCount() != 0) {
  5. if (!isRefreshable) {
  6. return NacosPropertySourceRepository.getNacosPropertySource(dataId,
  7. group);
  8. }
  9. }
  10. //构造器从配置中心获取数据
  11. return nacosPropertySourceBuilder.build(dataId, group, fileExtension,
  12. isRefreshable);
  13. }
  14. NacosPropertySource build(String dataId, String group, String fileExtension,
  15. boolean isRefreshable) {
  16.   //调用loadNacosData加载远程数据
  17.   Map<String, Object> p = loadNacosData(dataId, group, fileExtension);
  18.   NacosPropertySource nacosPropertySource = new NacosPropertySource(group, dataId,
  19. p, new Date(), isRefreshable);
  20.   NacosPropertySourceRepository.collectNacosPropertySource(nacosPropertySource);
  21.   return nacosPropertySource;
  22. }

loadNacosData :加载Nacos的数据

  1. private Map<String, Object> loadNacosData(String dataId, String group,
  2. String fileExtension) {
  3. String data = null;
  4. try {// http远程访问配置中心,获取配置数据
  5. data = configService.getConfig(dataId, group, timeout);
  6. if (StringUtils.isEmpty(data)) {//如果为空,则提示日志
  7. log.warn(
  8. "Ignore the empty nacos configuration and get it based on dataId[{}] & group[{}]",
  9. dataId, group);
  10. return EMPTY_MAP;
  11. }
  12. if (log.isDebugEnabled()) {
  13. log.debug(String.format(
  14. "Loading nacos data, dataId: '%s', group: '%s', data: %s", dataId,
  15. group, data));
  16. }//根据扩展名进行数据的解析
  17. Map<String, Object> dataMap = NacosDataParserHandler.getInstance()
  18. .parseNacosData(data, fileExtension);
  19. return dataMap == null ? EMPTY_MAP : dataMap;
  20. }
  21. catch (NacosException e) {
  22. log.error("get data from Nacos error,dataId:{}, ", dataId, e);
  23. }
  24. catch (Exception e) {
  25. log.error("parse data from Nacos error,dataId:{},data:{},", dataId, data, e);
  26. }
  27. return EMPTY_MAP;
  28. }

继续往下跟踪,最终进入到getConfigInner方法,主要有几个逻辑

  1. 先从本地磁盘中加载配置,因为应用在启动时,会加载远程配置缓存到本地,如果本地文件的内容不为空,直接返回。
  2. 如果本地文件的内容为空,则调用worker.getServerConfig加载远程配置
  3. 如果出现异常,则调用本地快照文件加载配置
  1. private String getConfigInner(String tenant, String dataId, String group, long timeoutMs) throws NacosException {
  2. group = null2defaultGroup(group); // 获取group
  3. ParamUtils.checkKeyParam(dataId, group);
  4. ConfigResponse cr = new ConfigResponse();
  5. cr.setDataId(dataId);//dataID
  6. cr.setTenant(tenant);
  7. cr.setGroup(group);
  8. // 优先使用本地配置
  9. String content = LocalConfigInfoProcessor.getFailover(agent.getName(), dataId, group, tenant);
  10. if (content != null) {
  11. LOGGER.warn("[{}] [get-config] get failover ok, dataId={}, group={}, tenant={}, config={}", agent.getName(),
  12. dataId, group, tenant, ContentUtils.truncateContent(content));
  13. cr.setContent(content);
  14. configFilterChainManager.doFilter(null, cr);
  15. content = cr.getContent();
  16. return content;
  17. }
  18. try {//获取远程配置
  19. content = worker.getServerConfig(dataId, group, tenant, timeoutMs);
  20. cr.setContent(content);
  21. configFilterChainManager.doFilter(null, cr);
  22. content = cr.getContent();
  23. return content;
  24. } catch (NacosException ioe) {
  25. if (NacosException.NO_RIGHT == ioe.getErrCode()) {
  26. throw ioe;
  27. }
  28. LOGGER.warn("[{}] [get-config] get from server error, dataId={}, group={}, tenant={}, msg={}",
  29. agent.getName(), dataId, group, tenant, ioe.toString());
  30. }
  31. LOGGER.warn("[{}] [get-config] get snapshot ok, dataId={}, group={}, tenant={}, config={}", agent.getName(),
  32. dataId, group, tenant, ContentUtils.truncateContent(content));
  33. //获取快照配置,返回兜底数据
  34. content = LocalConfigInfoProcessor.getSnapshot(agent.getName(), dataId, group, tenant);
  35. cr.setContent(content);
  36. configFilterChainManager.doFilter(null, cr);
  37. content = cr.getContent();
  38. return content;
  39. }

worker.getServerConfig:通过agent.httpGet发起http请求,获取远程服务的配置。这个agent的创建在NacosConfigService类的构造方法:

  1. public NacosConfigService(Properties properties) throws NacosException {
  2. String encodeTmp = properties.getProperty(PropertyKeyConst.ENCODE);
  3. if (StringUtils.isBlank(encodeTmp)) {
  4. encode = Constants.ENCODE;
  5. } else {
  6. encode = encodeTmp.trim();
  7. }//初始化命名空间
  8. initNamespace(properties);
  9. agent = new MetricsHttpAgent(new ServerHttpAgent(properties));
  10. agent.start();
  11. worker = new ClientWorker(agent, configFilterChainManager, properties);
  12. }

客户端配置的动态感知

在上述 NacosConfigService的构造方法中,当这个类被实例化以后,有做一些事情初始化一个HttpAgent,这里又用到了装饰起模式,实际工作的类是ServerHttpAgent,MetricsHttpAgent内部也是调用了ServerHttpAgent的方法,增加了监控统计的信息ClientWorker, 客户端的一个工作类,agent作为参数传入到clientworker,可以基本猜测到里面会用到agent做一些远程相关的事情

这一步主要初始化了 agent 与 worker 两个实例。这里又看到熟悉的包装器模式,将ServerHttpAgent 包装成MetricsHttpAgent,这里我们需要知道,其中MetricsHttpAgent是对ServerHttpAgent功能的拓展,核心功能还是由ServerHttpAgent去实现,接下去我们来看一下 worker 的初始化,从名字上看能知道 最后真的工作的是他:

  1. public ClientWorker(final HttpAgent agent, final ConfigFilterChainManager configFilterChainManager, final Properties properties) {
  2. this.agent = agent;
  3. this.configFilterChainManager = configFilterChainManager;
  4. // Initialize the timeout parameter
  5. // 初始化一些参数
  6. init(properties);
  7. //创建了一个定时任务的线程池第一个线程池是只拥有一个线程用来执行定时任务的 executor,executor
  8. //每隔 10ms 就会执行一次checkConfigInfo() 方法,从方法名上可以知道是每 10 ms 检查一次配置信息。
  9. executor = Executors.newScheduledThreadPool(1, new ThreadFactory() {
  10. @Override
  11. public Thread newThread(Runnable r) {
  12. Thread t = new Thread(r);
  13. t.setName("com.alibaba.nacos.client.Worker." + agent.getName());
  14. t.setDaemon(true);
  15. return t;
  16. }
  17. });
  18. //创建了一个保持长连接的线程池
  19. executorService = Executors.newScheduledThreadPool(Runtime.getRuntime().availableProcessors(), new ThreadFactory() {
  20. @Override
  21. public Thread newThread(Runnable r) {
  22. Thread t = new Thread(r);
  23. t.setName("com.alibaba.nacos.client.Worker.longPolling." + agent.getName());
  24. t.setDaemon(true);
  25. return t;
  26. }
  27. });
  28. //创建了一个延迟任务线程池来每隔10ms来检查配置信息的线程池
  29. executor.scheduleWithFixedDelay(new Runnable() {
  30. @Override
  31. public void run() {
  32. try {
  33. checkConfigInfo();
  34. } catch (Throwable e) {
  35. LOGGER.error("[" + agent.getName() + "] [sub-check] rotate check error", e);
  36. }
  37. }
  38. }, 1L, 10L, TimeUnit.MILLISECONDS);
  39. }

这一步创建了两个线程池,第一个线程池负责与配置中心进行数据的交互,并且启动后延迟1ms,之后每隔10ms对配置信息进行定时检查,第二个线程池则是负责保持一个长连接。我们再服务启动之后便会执行 checkConfigInfo(),跟进去看看:

  1. public void checkConfigInfo() {
  2. // 分任务(解决大数据量的传输问题)
  3. int listenerSize = cacheMap.get().size();
  4. // 向上取整为批数,分批次进行检查
  5. // ParamUtil.getPerTaskConfigSize() =3000
  6. int longingTaskCount = (int) Math.ceil(listenerSize / ParamUtil.getPerTaskConfigSize());
  7. // currentLongingTaskCount =0
  8. if (longingTaskCount > currentLongingTaskCount) {
  9. for (int i = (int) currentLongingTaskCount; i < longingTaskCount; i++) {
  10. // 要判断任务是否在执行 这块需要好好想想。 任务列表现在是无序的。变化过程可能有问题
  11. executorService.execute(new LongPollingRunnable(i));
  12. }
  13. currentLongingTaskCount = longingTaskCount;
  14. }
  15. }

这个方法主要的目的是用来检查服务端的配置信息是否发生了变化。如果有变化,则触发listener通知 cacheMap: AtomicReference> cacheMap 用来存储监听变更的缓存集合。key是根据dataID/group/tenant(租户) 拼接的值。Value是对应存储在nacos服务器上的配置文件的内容。默认情况下,每个长轮训LongPullingRunnable任务默认处理3000个监听配置集。如果超过3000, 则需要启动多个LongPollingRunnable去执行。

初始化new LongPollingRunnable()丢给 executorService线程池来处理,所以我们可以找到LongPollingRunnable里面的run方法这个方法传递了一个taskid, tasked用来区分cacheMap中的任务批次, 保存到cacheDatas这个集合中。cacheData.isUseLocalConfigInfo 这个值的变化来自于checkLocalConfig这个方法

  1. public void run() {
  2. List<CacheData> cacheDatas = new ArrayList<CacheData>();
  3. List<String> inInitializingCacheList = new ArrayList<String>();
  4. try {
  5. // check failover config tasked用来区分cacheMap中的任务批次, 保存到cacheDatas这个集合中
  6. for (CacheData cacheData : cacheMap.get().values()) {
  7. if (cacheData.getTaskId() == taskId) {
  8. cacheDatas.add(cacheData);
  9. try {
  10. //检查本地配置,通过本地文件中缓存的数据和cacheData集合中的数据进行比对,判断是否出现数据变化
  11. checkLocalConfig(cacheData);
  12. if (cacheData.isUseLocalConfigInfo()) {//这里表示数据有变化,需要通知监听器
  13.                    //检查缓存的MD5
  14. cacheData.checkListenerMd5();
  15. }
  16. } catch (Exception e) {
  17. LOGGER.error("get local config info error", e);
  18. }
  19. }
  20. }
  21. //检查服务端配置
  22. List<String> changedGroupKeys = checkUpdateDataIds(cacheDatas, inInitializingCacheList);
  23. for (String groupKey : changedGroupKeys) {
  24. String[] key = GroupKey.parseKey(groupKey);
  25. String dataId = key[0];
  26. String group = key[1];
  27. String tenant = null;
  28. if (key.length == 3) {
  29. tenant = key[2];
  30. }
  31. try {
  32. String content = getServerConfig(dataId, group, tenant, 3000L);
  33. //将配置设置进缓存
  34. CacheData cache = cacheMap.get().get(GroupKey.getKeyTenant(dataId, group, tenant));
  35. cache.setContent(content);
  36. LOGGER.info("[{}] [data-received] dataId={}, group={}, tenant={}, md5={}, content={}",
  37. agent.getName(), dataId, group, tenant, cache.getMd5(),
  38. ContentUtils.truncateContent(content));
  39. } catch (NacosException ioe) {
  40. String message = String.format(
  41. "[%s] [get-update] get changed config exception. dataId=%s, group=%s, tenant=%s",
  42. agent.getName(), dataId, group, tenant);
  43. LOGGER.error(message, ioe);
  44. }
  45. }
  46. for (CacheData cacheData : cacheDatas) {
  47. if (!cacheData.isInitializing() || inInitializingCacheList
  48. .contains(GroupKey.getKeyTenant(cacheData.dataId, cacheData.group, cacheData.tenant))) {
  49. cacheData.checkListenerMd5();
  50. cacheData.setInitializing(false);
  51. }
  52. }
  53. inInitializingCacheList.clear();
  54. executorService.execute(this);
  55. } catch (Throwable e) {
  56. // If the rotation training task is abnormal, the next execution time of the task will be punished
  57. LOGGER.error("longPolling error : ", e);
  58. executorService.schedule(this, taskPenaltyTime, TimeUnit.MILLISECONDS);
  59. }
  60. }

总的来说,该方法主要流程是先检查本地缓存,再检查服务端的配置,由改变最后再回写到本地及加载到缓存。

checkLocalConfig检查本地配置,这里面有三种情况

  1. 如果isUseLocalConfigInfo为false,但是本地缓存路径的文件是存在的,那么把isUseLocalConfigInfo设置为true,并且更新cacheData的内容以及文件的更新时间
  2. 如果isUseLocalCOnfigInfo为true,但是本地缓存文件不存在,则设置为false,不通知监听器
  3. isUseLocalConfigInfo为true,并且本地缓存文件也存在,但是缓存的的时间和文件的更新时间不一致,则更新cacheData中的内容,并且isUseLocalConfigInfo设置为true
  1. private void checkLocalConfig(CacheData cacheData) {
  2. final String dataId = cacheData.dataId;
  3. final String group = cacheData.group;
  4. final String tenant = cacheData.tenant;
  5.      //本地文件缓存
  6. File path = LocalConfigInfoProcessor.getFailoverFile(agent.getName(), dataId, group, tenant);
  7. // 没有 -> 有
  8. //不使用本地配置,但是持久化文件存在,需要读取文件加载至内存
  9. if (!cacheData.isUseLocalConfigInfo() && path.exists()) {
  10. String content = LocalConfigInfoProcessor.getFailover(agent.getName(), dataId, group, tenant);
  11. String md5 = MD5.getInstance().getMD5String(content);
  12. cacheData.setUseLocalConfigInfo(true);
  13. cacheData.setLocalConfigInfoVersion(path.lastModified());
  14. cacheData.setContent(content);
  15. LOGGER.warn("[{}] [failover-change] failover file created. dataId={}, group={}, tenant={}, md5={}, content={}",
  16. agent.getName(), dataId, group, tenant, md5, ContentUtils.truncateContent(content));
  17. return;
  18. }
  19. // 有 -> 没有。不通知业务监听器,从server拿到配置后通知。
  20. //使用本地配置,但是持久化文件不存在
  21. if (cacheData.isUseLocalConfigInfo() && !path.exists()) {
  22. cacheData.setUseLocalConfigInfo(false);
  23. LOGGER.warn("[{}] [failover-change] failover file deleted. dataId={}, group={}, tenant={}", agent.getName(),
  24. dataId, group, tenant);
  25. return;
  26. }
  27. // 有变更
  28. //使用本地配置,持久化文件存在,缓存跟文件最后修改时间不一致
  29. if (cacheData.isUseLocalConfigInfo() && path.exists()
  30. && cacheData.getLocalConfigInfoVersion() != path.lastModified()) {
  31. String content = LocalConfigInfoProcessor.getFailover(agent.getName(), dataId, group, tenant);
  32. String md5 = MD5.getInstance().getMD5String(content);
  33. cacheData.setUseLocalConfigInfo(true);
  34. cacheData.setLocalConfigInfoVersion(path.lastModified());
  35. cacheData.setContent(content);
  36. LOGGER.warn("[{}] [failover-change] failover file changed. dataId={}, group={}, tenant={}, md5={}, content={}",
  37. agent.getName(), dataId, group, tenant, md5, ContentUtils.truncateContent(content));
  38. }
  39. }

本地检查主要是通过是否使用本地配置,继而寻找持久化缓存文件,再通过判断文件的最后修改事件与本地缓存的版本是否一致来判断是否由变更。本地检查完毕,如果使用本地配置会进入下列代码:

  1. if (cacheData.isUseLocalConfigInfo()) {
  2.    //检查缓存的MD5
  3. cacheData.checkListenerMd5();
  4. }
  5. ```Java
  6. ```Java
  7. void checkListenerMd5() {
  8. for (ManagerListenerWrap wrap : listeners) {
  9.      //MD5由变更,说明数据变更
  10. if (!md5.equals(wrap.lastCallMd5)) {
  11.         //执行回调
  12. safeNotifyListener(dataId, group, content, md5, wrap);
  13. }
  14. }
  15. }

检查服务端配置

在LongPollingRunnable.run中,先通过本地配置的读取和检查来判断数据是否发生变化从而实现变化的通知。

接着,当前的线程还需要去远程服务器上获得最新的数据,检查哪些数据发生了变化

  • 通过checkUpdateDataIds获取远程服务器上数据变更的dataid
  • 遍历这些变化的集合,然后调用getServerConfig从远程服务器获得对应的内容
  • 更新本地的cache,设置为服务器端返回的内容
  • 最后遍历cacheDatas,找到变化的数据进行通知
  1. //检查服务端配置
  2. List<String> changedGroupKeys = checkUpdateDataIds(cacheDatas, inInitializingCacheList);

这里会去获取一个发生变化的GroupKeys 集合:

  1. /**
  2. * 从Server获取值变化了的DataID列表。返回的对象里只有dataId和group是有效的。 保证不返回NULL。
  3. */
  4. List<String> checkUpdateDataIds(List<CacheData> cacheDatas, List<String> inInitializingCacheList) throws IOException {
  5. StringBuilder sb = new StringBuilder();
  6. for (CacheData cacheData : cacheDatas) {
  7. if (!cacheData.isUseLocalConfigInfo()) {
  8. sb.append(cacheData.dataId).append(WORD_SEPARATOR);
  9. sb.append(cacheData.group).append(WORD_SEPARATOR);
  10. if (StringUtils.isBlank(cacheData.tenant)) {
  11. sb.append(cacheData.getMd5()).append(LINE_SEPARATOR);
  12. } else {
  13. sb.append(cacheData.getMd5()).append(WORD_SEPARATOR);
  14. sb.append(cacheData.getTenant()).append(LINE_SEPARATOR);
  15. }
  16. if (cacheData.isInitializing()) {
  17. // cacheData 首次出现在cacheMap中&首次check更新
  18. inInitializingCacheList
  19. .add(GroupKey.getKeyTenant(cacheData.dataId, cacheData.group, cacheData.tenant));
  20. }
  21. }
  22. }
  23. boolean isInitializingCacheList = !inInitializingCacheList.isEmpty();
  24. return checkUpdateConfigStr(sb.toString(), isInitializingCacheList);
  25. }

通过长轮训的方式,从远程服务器获得变化的数据进行返回。这里将可能发生变化的配置信息封装成一个 StringBuilder ,继而调用 checkUpdateConfigStr:

  1.   /**
  2. * 从Server获取值变化了的DataID列表。返回的对象里只有dataId和group是有效的。 保证不返回NULL。
  3. */
  4. List<String> checkUpdateConfigStr(String probeUpdateString, boolean isInitializingCacheList) throws IOException {
  5. List<String> params = Arrays.asList(Constants.PROBE_MODIFY_REQUEST, probeUpdateString);
  6. List<String> headers = new ArrayList<String>(2);
  7. headers.add("Long-Pulling-Timeout");
  8. headers.add("" + timeout);
  9. // told server do not hang me up if new initializing cacheData added in
  10. if (isInitializingCacheList) {
  11. headers.add("Long-Pulling-Timeout-No-Hangup");
  12. headers.add("true");
  13. }
  14. if (StringUtils.isBlank(probeUpdateString)) {
  15. return Collections.emptyList();
  16. }
  17. try {//发起一个Post请求
  18. HttpResult result = agent.httpPost(Constants.CONFIG_CONTROLLER_PATH + "/listener", headers, params,
  19. agent.getEncode(), timeout);
  20. if (HttpURLConnection.HTTP_OK == result.code) {
  21. setHealthServer(true);
  22. return parseUpdateDataIdResponse(result.content);
  23. } else {
  24. setHealthServer(false);
  25. LOGGER.error("[{}] [check-update] get changed dataId error, code: {}", agent.getName(), result.code);
  26. }
  27. } catch (IOException e) {
  28. setHealthServer(false);
  29. LOGGER.error("[" + agent.getName() + "] [check-update] get changed dataId exception", e);
  30. throw e;
  31. }
  32. return Collections.emptyList();
  33. }

就这样从Server获取值变化了的DataID列表。返回的对象里只有dataId和group是有效的。 保证不返回NULL。获取到这个列表以后就便利这个列表,去服务器端获取对应变更后的配置:

  1. for (String groupKey : changedGroupKeys) {
  2. String[] key = GroupKey.parseKey(groupKey);
  3. String dataId = key[0];
  4. String group = key[1];
  5. String tenant = null;
  6. if (key.length == 3) {
  7. tenant = key[2];
  8. }
  9. try {//遍历有变换的groupkey,发起远程请求获得指定groupkey的内容
  10. String content = getServerConfig(dataId, group, tenant, 3000L);
  11. //将配置设置进缓存
  12. CacheData cache = cacheMap.get().get(GroupKey.getKeyTenant(dataId, group, tenant));
  13. cache.setContent(content);
  14. LOGGER.info("[{}] [data-received] dataId={}, group={}, tenant={}, md5={}, content={}",
  15. agent.getName(), dataId, group, tenant, cache.getMd5(),
  16. ContentUtils.truncateContent(content));
  17. } catch (NacosException ioe) {
  18. String message = String.format(
  19. "[%s] [get-update] get changed config exception. dataId=%s, group=%s, tenant=%s",
  20. agent.getName(), dataId, group, tenant);
  21. LOGGER.error(message, ioe);
  22. }
  23. }

这里会发起请求从服务器端获取配置:getServerConfig:

  1. public String getServerConfig(String dataId, String group, String tenant, long readTimeout)
  2. throws NacosException {
  3. if (StringUtils.isBlank(group)) {
  4. group = Constants.DEFAULT_GROUP;
  5. }
  6. HttpResult result = null;
  7. try {
  8. List<String> params = null;
  9. if (StringUtils.isBlank(tenant)) {
  10. params = Arrays.asList("dataId", dataId, "group", group);
  11. } else {
  12. params = Arrays.asList("dataId", dataId, "group", group, "tenant", tenant);
  13. }
  14. result = agent.httpGet(Constants.CONFIG_CONTROLLER_PATH, null, params, agent.getEncode(), readTimeout);
  15. } catch (IOException e) {
  16. String message = String.format(
  17. "[%s] [sub-server] get server config exception, dataId=%s, group=%s, tenant=%s", agent.getName(),
  18. dataId, group, tenant);
  19. LOGGER.error(message, e);
  20. throw new NacosException(NacosException.SERVER_ERROR, e);
  21. }
  22. switch (result.code) {
  23. case HttpURLConnection.HTTP_OK:
  24. LocalConfigInfoProcessor.saveSnapshot(agent.getName(), dataId, group, tenant, result.content);
  25. return result.content;
  26. case HttpURLConnection.HTTP_NOT_FOUND:
  27. LocalConfigInfoProcessor.saveSnapshot(agent.getName(), dataId, group, tenant, null);
  28. return null;
  29. case HttpURLConnection.HTTP_CONFLICT: {
  30. LOGGER.error(
  31. "[{}] [sub-server-error] get server config being modified concurrently, dataId={}, group={}, "
  32. + "tenant={}", agent.getName(), dataId, group, tenant);
  33. throw new NacosException(NacosException.CONFLICT,
  34. "data being modified, dataId=" + dataId + ",group=" + group + ",tenant=" + tenant);
  35. }
  36. case HttpURLConnection.HTTP_FORBIDDEN: {
  37. LOGGER.error("[{}] [sub-server-error] no right, dataId={}, group={}, tenant={}", agent.getName(), dataId,
  38. group, tenant);
  39. throw new NacosException(result.code, result.content);
  40. }
  41. default: {
  42. LOGGER.error("[{}] [sub-server-error] dataId={}, group={}, tenant={}, code={}", agent.getName(), dataId,
  43. group, tenant, result.code);
  44. throw new NacosException(result.code,
  45. "http error, code=" + result.code + ",dataId=" + dataId + ",group=" + group + ",tenant=" + tenant);
  46. }
  47. }
  48. }

通过初始化时候的 agent.httpGet 去发起一个Get请求,就这样变更本例的配置,当从远程服务器获取玩配置以后还有一个循环:

  1. for (CacheData cacheData : cacheDatas) {//再遍历CacheData这个集合,找到发生变化的数据进行通知
  2. if (!cacheData.isInitializing() || inInitializingCacheList
  3. .contains(GroupKey.getKeyTenant(cacheData.dataId, cacheData.group, cacheData.tenant))) {
  4. cacheData.checkListenerMd5();
  5. cacheData.setInitializing(false);
  6. }
  7. }

这个循环主要是对有变化的配置进行监听回调。整个流程就差不都完成了,最后来一张流程图:

1383365-20190820194339587-338045048.png

长轮训的时间间隔

我们知道客户端会有一个长轮训的任务去检查服务器端的配置是否发生了变化,如果发生了变更,那么客户端会拿到变更的 groupKey 再根据 groupKey 去获取配置项的最新值更新到本地的缓存以及文件中,那么这种每次都靠客户端去请求,那请求的时间间隔设置多少合适呢?

如果间隔时间设置的太长的话有可能无法及时获取服务端的变更,如果间隔时间设置的太短的话,那么频繁的请求对于服务端来说无疑也是一种负担,所以最好的方式是客户端每隔一段长度适中的时间去服务端请求,而在这期间如果配置发生变更,服务端能够主动将变更后的结果推送给客户端,这样既能保证客户端能够实时感知到配置的变化,也降低了服务端的压力。 我们来看看nacos设置的间隔时间是多久。

长轮训的概念

客户端发起一个请求到服务端,服务端收到客户端的请求后,并不会立刻响应给客户端,而是先把这个请求hold住,然后服务端会在hold住的这段时间检查数据是否有更新,如果有,则响应给客户端,如果一直没有数据变更,则达到一定的时间(长轮训时间间隔)才返回。

长轮训典型的场景有: 扫码登录、扫码支付。

1383365-20190821162738238-1047715941.png

客户端长轮训

在ClientWorker这个类里面,找到 checkUpdateConfigStr 这个方法,这里面就是去服务器端查询发生变化的groupKey。

  1. /**
  2. * 从Server获取值变化了的DataID列表。返回的对象里只有dataId和group是有效的。 保证不返回NULL。
  3. */
  4. List<String> checkUpdateConfigStr(String probeUpdateString, boolean isInitializingCacheList) throws IOException {
  5. List<String> params = Arrays.asList(Constants.PROBE_MODIFY_REQUEST, probeUpdateString);
  6. List<String> headers = new ArrayList<String>(2);
  7. headers.add("Long-Pulling-Timeout");
  8. headers.add("" + timeout);
  9. // told server do not hang me up if new initializing cacheData added in
  10. if (isInitializingCacheList) {
  11. headers.add("Long-Pulling-Timeout-No-Hangup");
  12. headers.add("true");
  13. }
  14. if (StringUtils.isBlank(probeUpdateString)) {
  15. return Collections.emptyList();
  16. }
  17. try {//客户端发送的请求地址是: /v1/cs/configs/listener
  18. HttpResult result = agent.httpPost(Constants.CONFIG_CONTROLLER_PATH + "/listener", headers, params,
  19. agent.getEncode(), timeout);
  20. if (HttpURLConnection.HTTP_OK == result.code) {
  21. setHealthServer(true);
  22. return parseUpdateDataIdResponse(result.content);
  23. } else {
  24. setHealthServer(false);
  25. LOGGER.error("[{}] [check-update] get changed dataId error, code: {}", agent.getName(), result.code);
  26. }
  27. } catch (IOException e) {
  28. setHealthServer(false);
  29. LOGGER.error("[" + agent.getName() + "] [check-update] get changed dataId exception", e);
  30. throw e;
  31. }
  32. return Collections.emptyList();
  33. }

这个方法最终会发起http请求,注意这里面有一个 timeout 的属性,

  1. HttpResult result = agent.httpPost(Constants.CONFIG_CONTROLLER_PATH + "/listener", headers, params,
  2. agent.getEncode(), timeout);

timeout是在init这个方法中赋值的,默认情况下是30秒,可以通过configLongPollTimeout进行修改

  1. private void init(Properties properties) {
  2. // 默认长轮询的事件就是30S
  3. timeout = Math.max(NumberUtils.toInt(properties.getProperty(PropertyKeyConst.CONFIG_LONG_POLL_TIMEOUT),
  4. //public static final int CONFIG_LONG_POLL_TIMEOUT = 30000;
  5. //public static final int MIN_CONFIG_LONG_POLL_TIMEOUT = 10000;
  6. Constants.CONFIG_LONG_POLL_TIMEOUT), Constants.MIN_CONFIG_LONG_POLL_TIMEOUT);
  7. taskPenaltyTime = NumberUtils.toInt(properties.getProperty(PropertyKeyConst.CONFIG_RETRY_TIME), Constants.CONFIG_RETRY_TIME);
  8. enableRemoteSyncConfig = Boolean.parseBoolean(properties.getProperty(PropertyKeyConst.ENABLE_REMOTE_SYNC_CONFIG));
  9. }

所以从这里得出的一个基本结论是:客户端发起一个轮询请求,超时时间是30s。 那么客户端为什么要等待30s才超时呢?不是越快越好吗? 我们可以在nacos的日志目录下 $NACOS_HOME/nacos/logs/config-client-request.log 文件.
1383365-20190821164041443-1657536861.png

可以看到一个现象,在配置没有发生变化的情况下,客户端会等29.5s以上,才请求到服务器端的结果。然后客户端拿到服务器端的结果之后,在做后续的操作。当服务器端频繁的修改,那么服务器端频繁客户端进行推送.

服务端的处理

服务端是如何处理客户端的请求的?那么同样,我们需要思考几个问题:

  • 客户端的长轮训响应时间受到哪些因素的影响
  • 客户端的超时时间为什么要设置30s
  • 客户端发送的请求地址是: /v1/cs/configs/listener 找到服务端对应的方法

nacos是使用spring mvc提供的rest api,其中有个类是 ConfigController ,我们在其中找到了Post 请求的 listener 路径的接口方法:

  1. /**
  2. * 比较MD5
  3. */
  4. @RequestMapping(value = "/listener", method = RequestMethod.POST)
  5. public void listener(HttpServletRequest request, HttpServletResponse response)
  6. throws ServletException, IOException {
  7. request.setAttribute("org.apache.catalina.ASYNC_SUPPORTED", true);
  8. String probeModify = request.getParameter("Listening-Configs");
  9. if (StringUtils.isBlank(probeModify)) {
  10. throw new IllegalArgumentException("invalid probeModify");
  11. }
  12. probeModify = URLDecoder.decode(probeModify, Constants.ENCODE);
  13. Map<String, String> clientMd5Map;
  14. try {
  15. clientMd5Map = MD5Util.getClientMd5Map(probeModify);
  16. } catch (Throwable e) {
  17. throw new IllegalArgumentException("invalid probeModify");
  18. }
  19. // do long-polling
  20. inner.doPollingConfig(request, response, clientMd5Map, probeModify.length());
  21. }

先是获取了客户端的MD5集合,这里面会调用inner.doPollingConfig进行处理,这个方法中,兼容了长轮训和短轮询的逻辑,我们只需要关注长轮训的部分:

  1. /**
  2. * 轮询接口
  3. */
  4. public String doPollingConfig(HttpServletRequest request, HttpServletResponse response,
  5. Map<String, String> clientMd5Map, int probeRequestSize)
  6. throws IOException, ServletException {
  7. // 长轮询
  8. if (LongPollingService.isSupportLongPolling(request)) {
  9. longPollingService.addLongPollingClient(request, response, clientMd5Map, probeRequestSize);
  10. return HttpServletResponse.SC_OK + "";
  11. }
  12.     ......//省略代码
  13.   }

这里我们进入长轮询的代码块:

  1. public void addLongPollingClient(HttpServletRequest req, HttpServletResponse rsp, Map<String, String> clientMd5Map,
  2. int probeRequestSize) {
  3.      //超时时间
  4. String str = req.getHeader(LongPollingService.LONG_POLLING_HEADER);
  5. String noHangUpFlag = req.getHeader(LongPollingService.LONG_POLLING_NO_HANG_UP_HEADER);
  6. String appName = req.getHeader(RequestUtil.CLIENT_APPNAME_HEADER);
  7. String tag = req.getHeader("Vipserver-Tag");
  8. int delayTime = SwitchService.getSwitchInteger(SwitchService.FIXED_DELAY_TIME, 500);
  9. /**
  10. * 提前500ms返回响应,为避免客户端超时 @qiaoyi.dingqy 2013.10.22改动 add delay time for LoadBalance
  11. */
  12. long timeout = Math.max(10000, Long.parseLong(str) - delayTime);
  13. if (isFixedPolling()) {
  14. timeout = Math.max(10000, getFixedPollingInterval());
  15. // do nothing but set fix polling timeout
  16. } else {
  17. long start = System.currentTimeMillis();
  18. List<String> changedGroups = MD5Util.compareMd5(req, rsp, clientMd5Map);
  19. if (changedGroups.size() > 0) {
  20. generateResponse(req, rsp, changedGroups);
  21. LogUtil.clientLog.info("{}|{}|{}|{}|{}|{}|{}",
  22. System.currentTimeMillis() - start, "instant", RequestUtil.getRemoteIp(req), "polling",
  23. clientMd5Map.size(), probeRequestSize, changedGroups.size());
  24. return;
  25. } else if (noHangUpFlag != null && noHangUpFlag.equalsIgnoreCase(TRUE_STR)) {
  26. LogUtil.clientLog.info("{}|{}|{}|{}|{}|{}|{}", System.currentTimeMillis() - start, "nohangup",
  27. RequestUtil.getRemoteIp(req), "polling", clientMd5Map.size(), probeRequestSize,
  28. changedGroups.size());
  29. return;
  30. }
  31. }
  32. String ip = RequestUtil.getRemoteIp(req);
  33. // 一定要由HTTP线程调用,否则离开后容器会立即发送响应
  34. final AsyncContext asyncContext = req.startAsync();
  35. // AsyncContext.setTimeout()的超时时间不准,所以只能自己控制
  36. asyncContext.setTimeout(0L);
  37. scheduler.execute(
  38. new ClientLongPolling(asyncContext, clientMd5Map, ip, probeRequestSize, timeout, appName, tag));
  39. }

这个方法是把客户端的长轮训请求添加到任务中去。

  1. 获得客户端传递过来的超时时间,并且进行本地计算,提前500ms返回响应,这就能解释为什么客户端响应超时时间是29.5+了。当然如果 isFixedPolling=true 的情况下,不会提前返回响应
  2. 根据客户端请求过来的md5和服务器端对应的group下对应内容的md5进行比较,如果不一致,则通过 generateResponse 将结果返回
  3. 如果配置文件没有发生变化,则通过 scheduler.execute 启动了一个定时任务,将客户端的长轮询请求封装成一个叫 ClientLongPolling 的任务,交给 scheduler 去执行

那么接下去一定会进入ClientLongPolling 的Run 方法:

  1. public void run() {
  2. asyncTimeoutFuture = scheduler.schedule(new Runnable() {
  3. @Override
  4. public void run() {
  5. try {
  6. getRetainIps().put(ClientLongPolling.this.ip, System.currentTimeMillis());
  7. /**
  8. * 删除订阅关系
  9. */
  10. allSubs.remove(ClientLongPolling.this);
  11. if (isFixedPolling()) {
  12. LogUtil.clientLog.info("{}|{}|{}|{}|{}|{}",
  13. (System.currentTimeMillis() - createTime),
  14. "fix", RequestUtil.getRemoteIp((HttpServletRequest)asyncContext.getRequest()),
  15. "polling",
  16. clientMd5Map.size(), probeRequestSize);
  17. List<String> changedGroups = MD5Util.compareMd5(
  18. (HttpServletRequest)asyncContext.getRequest(),
  19. (HttpServletResponse)asyncContext.getResponse(), clientMd5Map);
  20.                  //有变化立即执行返回
  21. if (changedGroups.size() > 0) {
  22. sendResponse(changedGroups);
  23. } else {
  24. sendResponse(null);
  25. }
  26. } else {
  27. LogUtil.clientLog.info("{}|{}|{}|{}|{}|{}",
  28. (System.currentTimeMillis() - createTime),
  29. "timeout", RequestUtil.getRemoteIp((HttpServletRequest)asyncContext.getRequest()),
  30. "polling",
  31. clientMd5Map.size(), probeRequestSize);
  32. sendResponse(null);
  33. }
  34. } catch (Throwable t) {
  35. LogUtil.defaultLog.error("long polling error:" + t.getMessage(), t.getCause());
  36. }
  37. }
  38.          //延迟29.5秒后执行
  39. }, timeoutTime, TimeUnit.MILLISECONDS);
  40. allSubs.add(this);
  41. }

这个任务要阻塞29.5s才能执行,因为立马执行没有任何意义,毕竟前面已经执行过一次了如果在29.5s+之内,数据发生变化,需要提前通知。需要有一种监控机制

在run方法中,通过scheduler.schedule实现了一个定时任务,它的delay时间正好是前面计算的29.5s。在这个任务中,会通过MD5Util.compareMd5来进行计算那另外一个,当数据发生变化以后,肯定不能等到29.5s之后才通知呀,那怎么办呢?我们发现有一个allSubs 的东西,它似乎和发布订阅有关系。那是不是有可能当前的clientLongPolling订阅了数据变化的事件呢?allSubs是一个队列,队列里面放了ClientLongPolling这个对象。这个队列似乎和配置变更有某种关联关系:

  1. /**
  2. * 长轮询订阅关系
  3. */
  4. final Queue<ClientLongPolling> allSubs;

注释里写明了他是和长轮询订阅相关的,接着我们先来看一下他所归属的类的类图:

1383365-20190821170000574-838362216.png

那么这里必须要实现的是,当用户在nacos 控制台修改了配置之后,必须要从这个订阅关系中取出关注的客户端长连接,然后把变更的结果返回。于是我们去看LongPollingService的构造方法查找订阅关系发现LongPollingService集成了AbstractEventListener,事件监听.

AbstractEventListener:

  1. static public abstract class AbstractEventListener {
  2. public AbstractEventListener() {
  3. /**
  4. * automatic register
  5. */
  6. EventDispatcher.addEventListener(this);
  7. }
  8. /**
  9. * 感兴趣的事件列表
  10. *
  11. * @return event list
  12. */
  13. abstract public List<Class<? extends Event>> interest();
  14. /**
  15. * 处理事件
  16. *
  17. * @param event event
  18. */
  19. abstract public void onEvent(Event event);
  20. }

这里面有一个抽象的onEvent方法,明显是用来处理事件的方法,而抽象方法必须由子类实现,所以意味着LongPollingService里面肯定实现了onEvent方法,我们可以在其构造方法中发现。

  1. public void onEvent(Event event) {
  2. if (isFixedPolling()) {
  3. // ignore
  4. } else {
  5. if (event instanceof LocalDataChangeEvent) {
  6. LocalDataChangeEvent evt = (LocalDataChangeEvent)event;
  7. scheduler.execute(new DataChangeTask(evt.groupKey, evt.isBeta, evt.betaIps));
  8. }
  9. }
  10. }

所以到了这里,肯定是修改了配置之后会有一个触发点去出发该事件,当匹配上事件类型,那么就会去执行这个回调,这个事件的实现方法中判断事件类型是否为LocalDataChangeEvent,通过scheduler.execute执行DataChangeTask这个任务。

从名字可以看出来,这个是数据变化的任务,最让人兴奋的应该是,它里面有一个循环迭代器,从allSubs里面获得ClientLongPolling。

  1. public void run() {
  2. try {
  3. ConfigService.getContentBetaMd5(groupKey);
  4. for (Iterator<ClientLongPolling> iter = allSubs.iterator(); iter.hasNext(); ) {
  5. ClientLongPolling clientSub = iter.next();
  6. if (clientSub.clientMd5Map.containsKey(groupKey)) {
  7. // 如果beta发布且不在beta列表直接跳过
  8. if (isBeta && !betaIps.contains(clientSub.ip)) {
  9. continue;
  10. }
  11. // 如果tag发布且不在tag列表直接跳过
  12. if (StringUtils.isNotBlank(tag) && !tag.equals(clientSub.tag)) {
  13. continue;
  14. }
  15. getRetainIps().put(clientSub.ip, System.currentTimeMillis());
  16. iter.remove(); // 删除订阅关系
  17. LogUtil.clientLog.info("{}|{}|{}|{}|{}|{}|{}",
  18. (System.currentTimeMillis() - changeTime),
  19. "in-advance",
  20. RequestUtil.getRemoteIp((HttpServletRequest)clientSub.asyncContext.getRequest()),
  21. "polling",
  22. clientSub.clientMd5Map.size(), clientSub.probeRequestSize, groupKey);
  23. clientSub.sendResponse(Arrays.asList(groupKey));
  24. }
  25. }
  26. } catch (Throwable t) {
  27. LogUtil.defaultLog.error("data change error:" + t.getMessage(), t.getCause());
  28. }
  29. }

这个是数据变化的任务,最让人兴奋的应该是,它里面有一个循环迭代器,从allSubs里面获得ClientLongPolling最后通过clientSub.sendResponse把数据返回到客户端。所以,这也就能够理解为何数据变化能够实时触发更新了。

那么接下来还有一个疑问是,数据变化之后是如何触发事件的呢? 所以我们定位到数据变化的请求类中,在 https://github.com/alibaba/nacos/tree/develop/config/src/main/java/com/alibaba/nacos/config/server/controller 中 ConfigController这个类中,找到POST请求的方法找到配置变更的位置:

  1. /**
  2. * 增加或更新非聚合数据。
  3. *
  4. * @throws NacosException
  5. */
  6. @RequestMapping(method = RequestMethod.POST)
  7. @ResponseBody
  8. public Boolean publishConfig(HttpServletRequest request, HttpServletResponse response,
  9. @RequestParam("dataId") String dataId, @RequestParam("group") String group,
  10. @RequestParam(value = "tenant", required = false, defaultValue = StringUtils.EMPTY)
  11. String tenant,
  12. @RequestParam("content") String content,
  13. @RequestParam(value = "tag", required = false) String tag,
  14. @RequestParam(value = "appName", required = false) String appName,
  15. @RequestParam(value = "src_user", required = false) String srcUser,
  16. @RequestParam(value = "config_tags", required = false) String configTags,
  17. @RequestParam(value = "desc", required = false) String desc,
  18. @RequestParam(value = "use", required = false) String use,
  19. @RequestParam(value = "effect", required = false) String effect,
  20. @RequestParam(value = "type", required = false) String type,
  21. @RequestParam(value = "schema", required = false) String schema)
  22. throws NacosException {
  23. final String srcIp = RequestUtil.getRemoteIp(request);
  24. String requestIpApp = RequestUtil.getAppName(request);
  25. ParamUtils.checkParam(dataId, group, "datumId", content);
  26. ParamUtils.checkParam(tag);
  27. Map<String, Object> configAdvanceInfo = new HashMap<String, Object>(10);
  28.      ......//省略代码
  29. final Timestamp time = TimeUtils.getCurrentTime();
  30. String betaIps = request.getHeader("betaIps");
  31. ConfigInfo configInfo = new ConfigInfo(dataId, group, tenant, appName, content);
  32. if (StringUtils.isBlank(betaIps)) {
  33. if (StringUtils.isBlank(tag)) {
  34. persistService.insertOrUpdate(srcIp, srcUser, configInfo, time, configAdvanceInfo, false);
  35. EventDispatcher.fireEvent(new ConfigDataChangeEvent(false, dataId, group, tenant, time.getTime()));
  36. } else {
  37. persistService.insertOrUpdateTag(configInfo, tag, srcIp, srcUser, time, false);
  38. EventDispatcher.fireEvent(new ConfigDataChangeEvent(false, dataId, group, tenant, tag, time.getTime()));
  39. }
  40. } else { // beta publish
  41. persistService.insertOrUpdateBeta(configInfo, betaIps, srcIp, srcUser, time, false);
  42. EventDispatcher.fireEvent(new ConfigDataChangeEvent(true, dataId, group, tenant, time.getTime()));
  43. }
  44. ConfigTraceService.logPersistenceEvent(dataId, group, tenant, requestIpApp, time.getTime(),
  45. LOCAL_IP, ConfigTraceService.PERSISTENCE_EVENT_PUB, content);
  46. return true;
  47. }

发现数据持久化之后,会通过EventDispatcher进行事件发布EventDispatcher.fireEvent 但是这个事件似乎不是我们所关心的时间,原因是这里发布的事件是ConfigDataChangeEvent , 而LongPollingService感兴趣的事件是 LocalDataChangeEvent。

在Nacos中有一个com.alibaba.nacos.config.server.service.dump.DumpService,它会定时把变更后的数据dump到磁盘上,DumpService在spring启动之后,会调用init方法启动几个dump任务。然后在任务执行结束之后,会触发一个LocalDataChangeEvent 的事件:

  1. @PostConstruct
  2. public void init() {
  3. LogUtil.defaultLog.warn("DumpService start");
  4. DumpProcessor processor = new DumpProcessor(this);
  5. DumpAllProcessor dumpAllProcessor = new DumpAllProcessor(this);
  6. DumpAllBetaProcessor dumpAllBetaProcessor = new DumpAllBetaProcessor(this);
  7. DumpAllTagProcessor dumpAllTagProcessor = new DumpAllTagProcessor(this);
  8.   ......//省略代码
  9. }

其中在 DumpProcessor的 process方法中会调用 ConfigService 的相关API对数据进行操作,其中调用 remove 后会传播这么一个事件:

  1. /**
  2. * 删除配置文件,删除缓存。
  3. */
  4. static public boolean remove(String dataId, String group, String tenant) {
  5. final String groupKey = GroupKey2.getKey(dataId, group, tenant);
  6. final int lockResult = tryWriteLock(groupKey);
  7. /**
  8. * 数据不存在
  9. */
  10. if (0 == lockResult) {
  11. dumpLog.info("[remove-ok] {} not exist.", groupKey);
  12. return true;
  13. }
  14. /**
  15. * 加锁失败
  16. */
  17. if (lockResult < 0) {
  18. dumpLog.warn("[remove-error] write lock failed. {}", groupKey);
  19. return false;
  20. }
  21. try {
  22. if (!STANDALONE_MODE || PropertyUtil.isStandaloneUseMysql()) {
  23. DiskUtil.removeConfigInfo(dataId, group, tenant);
  24. }
  25. CACHE.remove(groupKey);
  26. EventDispatcher.fireEvent(new LocalDataChangeEvent(groupKey));
  27. return true;
  28. } finally {
  29. releaseWriteLock(groupKey);
  30. }
  31. }

简单总结一下刚刚分析的整个过程。

  • 客户端发起长轮训请求,
  • 服务端收到请求以后,先比较服务端缓存中的数据是否相同,如果不通,则直接返回
  • 如果相同,则通过schedule延迟29.5s之后再执行比较
  • 为了保证当服务端在29.5s之内发生数据变化能够及时通知给客户端,服务端采用事件订阅的方式来监听服务端本地数据变化的事件,一旦收到事件,则触发DataChangeTask的通知,并且遍历allStubs队列中的ClientLongPolling,把结果写回到客户端,就完成了一次数据的推送
  • 如果 DataChangeTask 任务完成了数据的 “推送” 之后,ClientLongPolling 中的调度任务又开始执行了怎么办呢?很简单,只要在进行 “推送” 操作之前,先将原来等待执行的调度任务取消掉就可以了,这样就防止了推送操作写完响应数据之后,调度任务又去写响应数据,这时肯定会报错的。所以,在ClientLongPolling方法中,最开始的一个步骤就是删除订阅事件

所以总的来说,Nacos采用推+拉的形式,来解决最开始关于长轮训时间间隔的问题。当然,30s这个时间是可以设置的,而之所以定30s,应该是一个经验值。