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

本文链接：https://blog.youkuaiyun.com/gitblog_00078/article/details/148360227

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

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

一、Namespace基础概念

Namespace（命名空间）是Apollo配置中心的核心概念之一，它类似于传统开发中的配置文件概念，但提供了更强大的管理能力。在Apollo中，Namespace是配置项的集合，可以理解为配置的逻辑分组单元。

1.1 默认Namespace：application

每个Apollo项目创建时都会自动生成一个名为application的默认Namespace，这类似于Spring Boot项目中的application.yml/properties文件。对于大多数应用场景，这个默认Namespace已经足够满足日常配置需求。

客户端获取application Namespace的代码示例：

Config config = ConfigService.getAppConfig();

获取非application Namespace的代码示例：

Config config = ConfigService.getConfig(namespaceName);

二、Namespace格式支持

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

Properties格式
XML格式
YAML/YML格式
JSON格式

在管理界面中，可以看到每个Namespace都有对应的格式标识。对于非properties格式的Namespace，客户端需要使用特定的API进行获取。

重要说明：

对于非properties格式的Namespace，需要使用ConfigService.getConfigFile方法获取
从1.3.0版本开始，对YAML/YML格式的支持更加完善，使用方式与properties格式一致

三、Namespace权限分类

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

3.1 私有权限(Private)

只能被所属应用访问
其他应用尝试访问时会返回404错误
默认Namespace application就是私有权限

3.2 公共权限(Public)

可以被任何应用访问
名称必须全局唯一
适用于共享配置场景

四、Namespace类型详解

Apollo中的Namespace分为三种类型，每种类型有不同的特性和使用场景。

4.1 私有类型(Private)

具有私有权限
只能被所属应用访问
最常见的类型，application Namespace就是私有类型

4.2 公共类型(Public)

特性

具有公共权限
名称全局唯一
可以被任何应用访问

使用场景

部门级共享配置
小组级共享配置
多项目共享配置
中间件客户端配置

4.3 关联类型(Associated/继承类型)

特性

具有私有权限
继承自公共类型Namespace
可以覆盖公共Namespace中的配置项

工作原理

假设公共Namespace有配置：

k1 = v1
k2 = v2

应用A创建关联类型Namespace并覆盖k1为v3，则实际运行时获取的配置为：

k1 = v3
k2 = v2

典型应用场景：RPC框架配置

公司级默认配置（公共Namespace）
项目级自定义配置（关联Namespace）
两者结合实现灵活配置

五、实战示例分析

考虑以下三个应用场景：

应用A：拥有私有类型application和NS-Private，以及关联类型NS-Public
应用B：拥有私有类型application和公共类型NS-Public
应用C：仅拥有私有类型application

5.1 配置获取示例代码

应用A获取配置：

// 获取application配置
Config appConfig = ConfigService.getAppConfig();
appConfig.getProperty("k1", null); // k1 = v11

// 获取私有Namespace
Config privateConfig = ConfigService.getConfig("NS-Private");
privateConfig.getProperty("k1", null); // k1 = v3

// 获取关联Namespace（会覆盖公共配置）
Config publicConfig = ConfigService.getConfig("NS-Public");
publicConfig.getProperty("k4", null); // k4 = v6 (覆盖值)

应用B获取配置：

// 获取公共Namespace原始值
Config publicConfig = ConfigService.getConfig("NS-Public");
publicConfig.getProperty("k4", null); // k4 = v5 (原始值)

5.2 配置变更监听

Apollo支持对Namespace配置变更的监听，通过Config对象注册监听器：

Config config = ConfigService.getConfig("NS-Public");
config.addChangeListener(new ConfigChangeListener() {
  public void onChange(ConfigChangeEvent changeEvent) {
    // 处理配置变更逻辑
  }
});