# config-center

**Repository Path**: awakedreaming/config-center

## Basic Information

- **Project Name**: config-center
- **Description**: 简易配置中心
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 0
- **Created**: 2021-09-21
- **Last Updated**: 2025-11-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

### 配置中心使用

##### 1.引入maven依赖

```xml
<dependency>
    <groupId>cn.ac.aircas</groupId>
    <artifactId>config-center-spring-boot-starter</artifactId>
    <version>1.0.0</version>
</dependency>
```

##### 2.配置项说明

配置中心功能目前基于zk实现, 因此需要在springboot的配置文件中配置zk连接相关配置, 配置项如下:

```properties
# zk集群的服务器插口列表, 多个以逗号隔开
center.config.zoo.servers=127.0.0.1:2181
# 客户端连接zk集群的连接超时时间
center.config.zoo.connection-timeout=3500
# 客户端连接zk集群的最大重试次数
center.config.zoo.retry.max-retry=3
# 客户端连接zk集群失败后的基准睡眠时间
center.config.zoo.retry.base-sleep-time=1000
# 客户端连接zk集群失败后的最大睡眠时间
center.config.zoo.retry.max-sleep-time=2000
# 客户端与zk之间的session超时时间
center.config.zoo.session-timeout=5000
```

> 具体使用示例参考类**TestConfig**

##### 3.注解说明

配置中心的核心注解为@CenterConfig, 该注解有两个属性, **key** 和 **allowMiss**:

+ **key**: 必须配置, 指明当前配置项的key
+ **allowMiss**: 非必须配置, 代表当服务启动时, 若没有从配置中心拉取到当前key指定的配置项, 是否报错停止启动, 对一些允许服务启动后再在配置中心进行配置的配置项, 可将该属性设为true

##### 4.使用注意事项

注意, @CenterConfig可应用于SpringBean的成员变量和方法上, 它有以下限制条件:

+ 应用于成员变量时, 变量数据类型必须为Integer, Long, Float, Double, String, Boolean之一, 不能为基础类型
+ 应用于方法时, 方法必须有且仅有一个参数, 且参数的数据类型必须为Integer, Long, Float, Double, String, Boolean之一, 不能为基础类型
+ 当在配置中心删除某个配置时, 配置中心会将null值下发给业务集群, 所以在删除某个业务配置时, 务必保证已上线剔除依赖该配置的业务逻辑