env

type CommandLinePropertySource struct {
	MapPropertySource
}

type Environment interface {
	PropertyResolver

	/**
	获取激活的配置列表，返回文件的绝对路径
	*/
	GetActiveProfiles() []string

	/**
	获取一个可变的属性来源对象
	*/
	GetPropertySources() *MutablePropertySources

	/**
	合并父环境信息，子环境属性优先生效，只有子环境中不存在的才会在父环境中使用，比如假设父子环境中都有相同的配置key，那么将会使用子环境的优先
	*/
	Merge(parent Environment)

	/**
	订阅变更, keyPattern: 等值、正则匹配，如果为空字符串或者 * 那么表示所有，如果是个合法的正则，那么就按照正则匹配
	*/
	Subscribe(keyPattern string, handler func(event *KeyChangeEvent))

	/**
	绑定配置项到某个模型对象，注意传进来的必须是指针类型, keyPrefix key前缀，会直接和配置struct的属性直接拼接，如果有.的话要注意了
	@param name 名称，唯一
	@param cfgPtr 配置指针
	@param changedListen 是否需要进行监听
	*/
	BindProperties(keyPrefix string, cfgPtr interface{}) (beanPtr interface{}, err error)

	BindPropertiesListen(keyPrefix string, cfgPtr interface{}, changedListen bool) (beanPtr interface{}, err error)

	/**
	获取属性对象
	@param typeTemplate 类型模板，可以提供属性类型的指针类型，也可以直接提供 reflect.Type 类型
	*/
	GetProperties(typeTemplate interface{}) (beanPtr interface{})

	IsDev() bool
	IsTest() bool
	IsFat() bool
	IsProd() bool
	/**
	当前环境
	*/
	GetEnv() deploy.Env
	/**
	部署集合
	*/
	GetSet() string
}

type KeyChangeEvent struct {
	Key        string        // 变更的配置 key
	Ov         string        // 旧值
	Nv         string        // 新值
	ChangeType KeyChangeType // 变更类型
}

type KeyChangeType string

type MapPropertySource struct {
	// contains filtered or unexported fields
}

type MutablePropertySources struct {
	// contains filtered or unexported fields
}

type Option func(environment *StandardEnvironment)

type Options struct {
	// contains filtered or unexported fields
}

type PollingPropertySource struct {
	Name            string         // 名称
	PropertyReader  PropertyReader // 配置读取实现
	PollingInterval int64          // 轮询间隔，单位：秒
	// contains filtered or unexported fields
}

type PropertyChangeListener struct {
	KeyPattern string                      // 等值、正则匹配，如果为空字符串或者 * 那么表示所有，如果是个合法的正则，那么就按照正则匹配
	Regex      *regexp.Regexp              // 正则表达式
	Handler    func(event *KeyChangeEvent) // 处理器
}

type PropertyPlaceholderHelper struct {
	// contains filtered or unexported fields
}

type PropertyReader interface {
	/**
	读取所有的配置项, key-value 结构
	*/
	ReadAll() (kvs map[string]string, err error)
}

type PropertyReaderWrapper struct {
	/**
	读取配置的方法
	*/
	Reader func() (kvs map[string]string, err error)
}

type PropertyResolver interface {

	/**
	 * 判断当前环境中是否配置了 key，注意，给定的 key 不允许为空字符串
	 */
	ContainsProperty(key string) bool

	/**
	获取配置项的字符串值，返回的值中，====不包含占位符====
	@param key 配置 key
	@return value 对应配置项的值
	@return exists 配置项是否存在，即 @ContainsProperty(key string) 的返回值一样意义
	*/
	GetProperty(key string) (value string, exists bool)

	/**
	获取指定配置项的值，如果对应配置项没有配置，那么返回 默认值，====不包含占位符====
	*/
	GetPropertyWithDef(key string, def string) string

	/**
	获取配置项，如果配置项没有配置的话，那么会直接 panic（通常是在项目启动的时候使用，避免项目非正常状态下启动），====不包含占位符====
	*/
	GetRequiredProperty(key string) string

	/**
	处理类似 ${...} 这种占位符， 替换对应的配置项，如果 ${...}中的配置项不存在，则不进行替换，但是也不会抛异常
	*/
	ResolvePlaceholders(text string) string

	/**
	处理类似 ${...} 这种占位符， 替换对应的配置项，如果 ${...}中的配置项不存在，则直接 panic，这是为了防止非正常启动
	*/
	ResolveRequiredPlaceholders(text string) string
}

type PropertySource interface {
	/**
	配置源名称
	*/
	GetName() string

	/**
	获取配置项的字符串值，返回的值中，包含占位符
	@param key 配置 key
	@return value 对应配置项的值
	@return exists 配置项是否存在，即 @ContainsProperty(key string) 的返回值一样意义
	*/
	GetProperty(key string) (value string, exists bool)

	/**
	获取指定配置项的值，如果对应配置项没有配置，那么返回 默认值
	*/
	GetPropertyWithDef(key string, def string) string

	/**
	遍历所有的配置项&值, consumer 处理过程中如果返回 stop=true则停止遍历
	*/
	Each(consumer func(key, value string) (stop bool))

	/**
	订阅变更, keyPattern: 等值、正则匹配，如果为空字符串或者 * 那么表示所有，如果是个合法的正则，那么就按照正则匹配
	*/
	Subscribe(keyPattern string, handler func(event *KeyChangeEvent))
}

type PropertySources interface {

	/**
	是否包含指定名称的配置来源
	*/
	Contains(name string) bool

	/**
	获取指定名称的配置来源
	@return source 如果存在则返回
	@return exists 是否存在
	*/
	Get(name string) (source PropertySource, exists bool)

	/**
	遍历配置来源, index 从 0开始，数字越小，优先级越高, consumer 变量过程中，如果 stop 返回true则停止遍历
	*/
	Each(consumer func(index int, source PropertySource) (stop bool))
}

type PropertySourcesPropertyResolver struct {
	// contains filtered or unexported fields
}

type StandardEnvironment struct {
	// contains filtered or unexported fields
}

type SystemEnvironmentPropertySource struct {
	MapPropertySource
}