Apollo配置中心核心概念：Namespace深度解析-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00863/article/details/148360478

Apollo配置中心核心概念：Namespace深度解析

apollo apolloconfig/apollo: 是一个分布式配置管理平台，可以方便地实现配置的统一管理和发布。该项目提供了一个简单易用的配置管理平台，可以方便地实现配置的统一管理和发布，同时支持多种配置格式和部署方式。项目地址: https://gitcode.com/gh_mirrors/apoll/apollo

什么是Namespace？

在Apollo配置中心中，Namespace（命名空间）是配置项的集合，可以理解为传统开发中的配置文件。Namespace是Apollo进行配置管理的基本单元，通过Namespace可以实现配置的隔离、共享和继承等高级特性。

默认的Application Namespace

每个Apollo项目在创建时都会自动生成一个名为"application"的默认Namespace。这个Namespace类似于Spring Boot项目中的application.yml或application.properties文件，用于存放应用自身的主要配置。

对于大多数应用场景，"application" Namespace已经能够满足日常配置需求。客户端获取这个默认Namespace的代码非常简单：

Config config = ConfigService.getAppConfig();

Namespace的格式支持

Apollo支持多种配置文件格式，包括但不限于：

Properties格式（默认）
XML格式
YAML/YML格式
JSON格式

在Portal界面中，"application" Namespace默认会显示"properties"标签，表示它是Properties格式的。

重要说明：

对于非Properties格式的Namespace，客户端需要使用特定方法获取：

Config config = ConfigService.getConfigFile(namespaceName, configFileFormat);

从1.3.0版本开始，Apollo对YAML/YML格式提供了更好的支持，可以像Properties格式一样直接使用：

Config config = ConfigService.getConfig("application.yml");

Namespace的权限分类

Namespace按照访问权限可以分为两类：

私有权限(Private)

只能被所属应用访问
其他应用尝试访问会收到404错误
"application" Namespace就是私有权限的典型例子

公共权限(Public)

可以被任何应用访问
适用于需要跨应用共享的配置

Namespace的三种类型

1. 私有类型

具有Private权限
归属于特定应用
典型例子就是"application" Namespace

2. 公共类型

具有Public权限
名称必须全局唯一
独立于任何特定应用

使用场景：

部门或团队共享配置
多项目共用配置
中间件客户端配置

3. 关联类型（继承类型）

具有Private权限
继承自公共Namespace
可以覆盖父Namespace的配置

继承机制示例：假设公共Namespace有：

k1 = v1
k2 = v2

应用A的关联Namespace覆盖了k1：

k1 = v3

那么应用A实际获取的配置将是：

k1 = v3 (来自关联Namespace)
k2 = v2 (来自公共Namespace)

实际应用案例

RPC框架配置场景

假设要实现以下需求：

提供全公司默认的RPC配置且可动态调整
允许客户端项目自定义某些配置项且可动态调整

解决方案：

RPC团队维护一个名为"rpc-client"的公共Namespace，存放默认配置
客户端项目可以创建关联类型的"rpc-client" Namespace来覆盖特定配置
RPC客户端代码只需读取"rpc-client" Namespace，Apollo会自动处理继承关系

这种方式既保持了配置的统一性，又允许各项目灵活定制。

配置监听机制

Apollo支持配置变更监听，监听器注册在Config对象上。监听器会在配置发生变化时被触发，实现配置的热更新。

监听示例：

Config config = ConfigService.getConfig("some-namespace");
config.addChangeListener(new ConfigChangeListener() {
  @Override
  public void onChange(ConfigChangeEvent changeEvent) {
    // 处理配置变更
    for (String key : changeEvent.changedKeys()) {
      ConfigChange change = changeEvent.getChange(key);
      System.out.println(String.format(
          "Found change - key: %s, oldValue: %s, newValue: %s, changeType: %s",
          change.getPropertyName(), change.getOldValue(),
          change.getNewValue(), change.getChangeType()));
    }
  }
});