docs: 优化文档展示,适配部分无目录文档,适配非结构体的类型定义,增加测试用例文档
This commit is contained in:
@@ -1,19 +1,20 @@
|
||||
# Configuration
|
||||
|
||||
configuration 基于配置导表功能实现的配置加载及刷新功能
|
||||
|
||||
[](https://pkg.go.dev/github.com/kercylan98/minotaur/configuration)
|
||||

|
||||
|
||||
## 目录
|
||||
列出了该 `package` 下所有的函数,可通过目录进行快捷跳转 ❤️
|
||||
configuration 基于配置导表功能实现的配置加载及刷新功能
|
||||
|
||||
|
||||
## 目录导航
|
||||
列出了该 `package` 下所有的函数及类型定义,可通过目录导航进行快捷跳转 ❤️
|
||||
<details>
|
||||
<summary>展开 / 折叠目录</summary
|
||||
<summary>展开 / 折叠目录导航</summary>
|
||||
|
||||
|
||||
> 包级函数定义
|
||||
|
||||
|函数|描述
|
||||
|函数名称|描述
|
||||
|:--|:--
|
||||
|[Init](#Init)|配置初始化
|
||||
|[Load](#Load)|加载配置
|
||||
@@ -24,54 +25,66 @@ configuration 基于配置导表功能实现的配置加载及刷新功能
|
||||
|[OnConfigRefreshEvent](#OnConfigRefreshEvent)|暂无描述...
|
||||
|
||||
|
||||
> 结构体定义
|
||||
> 类型定义
|
||||
|
||||
|结构体|描述
|
||||
|:--|:--
|
||||
|[RefreshEventHandle](#refresheventhandle)|配置刷新事件处理函数
|
||||
|[Loader](#loader)|配置加载器
|
||||
|类型|名称|描述
|
||||
|:--|:--|:--
|
||||
|`STRUCT`|[RefreshEventHandle](#refresheventhandle)|配置刷新事件处理函数
|
||||
|`INTERFACE`|[Loader](#loader)|配置加载器
|
||||
|
||||
</details>
|
||||
|
||||
|
||||
***
|
||||
## 详情信息
|
||||
#### func Init(loader ...Loader)
|
||||
<span id="Init"></span>
|
||||
> 配置初始化
|
||||
> - 在初始化后会立即加载配置
|
||||
|
||||
***
|
||||
#### func Load()
|
||||
<span id="Load"></span>
|
||||
> 加载配置
|
||||
> - 加载后并不会刷新线上配置,需要执行 Refresh 函数对线上配置进行刷新
|
||||
|
||||
***
|
||||
#### func Refresh()
|
||||
<span id="Refresh"></span>
|
||||
> 刷新配置
|
||||
|
||||
***
|
||||
#### func WithTickerLoad(ticker *timer.Ticker, interval time.Duration)
|
||||
<span id="WithTickerLoad"></span>
|
||||
> 通过定时器加载配置
|
||||
> - 通过定时器加载配置后,会自动刷新线上配置
|
||||
> - 调用该函数后不会立即刷新,而是在 interval 后加载并刷新一次配置,之后每隔 interval 加载并刷新一次配置
|
||||
|
||||
***
|
||||
#### func StopTickerLoad()
|
||||
<span id="StopTickerLoad"></span>
|
||||
> 停止通过定时器加载配置
|
||||
|
||||
***
|
||||
#### func RegConfigRefreshEvent(handle RefreshEventHandle)
|
||||
<span id="RegConfigRefreshEvent"></span>
|
||||
> 当配置刷新时将立即执行被注册的事件处理函数
|
||||
|
||||
***
|
||||
#### func OnConfigRefreshEvent()
|
||||
<span id="OnConfigRefreshEvent"></span>
|
||||
|
||||
***
|
||||
### RefreshEventHandle
|
||||
### RefreshEventHandle `STRUCT`
|
||||
配置刷新事件处理函数
|
||||
```go
|
||||
type RefreshEventHandle struct{}
|
||||
type RefreshEventHandle func()
|
||||
```
|
||||
### Loader
|
||||
### Loader `INTERFACE`
|
||||
配置加载器
|
||||
```go
|
||||
type Loader struct{}
|
||||
type Loader interface {
|
||||
Load()
|
||||
Refresh()
|
||||
}
|
||||
```
|
||||
|
||||
Reference in New Issue
Block a user