Package org.aoju.bus.setting.magic

Class PopSetting

java.lang.Object

org.aoju.bus.setting.magic.AbstractSetting

org.aoju.bus.setting.magic.PopSetting

All Implemented Interfaces:

Serializable, Map<String,String>, org.aoju.bus.core.getter.GroupedGetter<CharSequence,CharSequence>, org.aoju.bus.core.getter.TypeGetter<CharSequence>

public class PopSetting
extends AbstractSetting
implements Map<String,String>

设置工具类 用于支持设置(配置)文件 用于替换Properties类,提供功能更加强大的配置文件,同时对Properties文件向下兼容

  1、支持变量,默认变量命名为 ${变量名},变量只能识别读入行的变量,例如第6行的变量在第三行无法读取
  2、支持分组,分组为中括号括起来的内容,中括号以下的行都为此分组的内容,无分组相当于空字符分组,若某个key是name,加上分组后的键相当于group.name
  3、注释以#开头,但是空行和不带“=”的行也会被跳过,但是建议加#
  4、store方法不会保存注释内容,慎重使用
 

Since:

Java 17+

Author:

Kimi Liu

See Also:

• Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from interface java.util.Map

Map.Entry<K,V>

Field Summary

Fields

Modifier and Type	Field	Description
protected Charset	charset	本设置对象的字符集
protected boolean	isUseVariable	是否使用变量
protected org.aoju.bus.core.io.resource.Resource	resource	设定文件的资源

Constructor Summary

Constructors

Constructor	Description
PopSetting()	空构造
PopSetting(File configFile, Charset charset, boolean isUseVariable)	构造
PopSetting(String path)	构造
PopSetting(String path, boolean isUseVariable)	构造
PopSetting(String path, Charset charset, boolean isUseVariable)	构造,使用相对于Class文件根目录的相对路径
PopSetting(org.aoju.bus.core.io.resource.Resource resource, Charset charset, boolean isUseVariable)	构造

Method Summary

Modifier and Type	Method	Description
PopSetting	addSetting(PopSetting setting)	添加一个Stting到主配置中
void	autoLoad(boolean autoReload)	在配置文件变更时自动加载
void	autoLoad(boolean autoReload, Consumer<Boolean> callback)	在配置文件变更时自动加载
void	clear()	清空默认分组(空分组)中的所有键值对
PopSetting	clear(String group)	清除指定分组下的所有键值对
boolean	containsKey(Object key)	默认分组(空分组)中是否包含指定key对应的值
boolean	containsKey(String group, String key)	指定分组中是否包含指定key
boolean	containsValue(Object value)	默认分组（空分组）中是否包含指定值
boolean	containsValue(String group, String value)	指定分组中是否包含指定值
Set<Map.Entry<String,String>>	entrySet()	获取默认分组(空分组)中的所有键值对列表
Set<Map.Entry<String,String>>	entrySet(String group)	指定分组下所有键值对
boolean	equals(Object object)
String	get(Object key)	获取默认分组(空分组)中指定key对应的值
String	getAndRemove(String... keys)	获取并删除键值对,当指定键对应值非空时,返回并删除这个值,后边的键对应的值不再查找
GroupMap	getGroupMap()	获取GroupedMap
List<String>	getGroups()	获取所有分组
Map<String,String>	getMap(String group)	获取并删除键值对,当指定键对应值非空时,返回并删除这个值,后边的键对应的值不再查找
Object	getObjectByGroup(CharSequence key, CharSequence group, Object defaultValue)
Properties	getProperties(String group)	获得group对应的子Properties
Properties	getProps(String group)	获得group对应的子Props
PopSetting	getSetting(String group)	获得group对应的子Setting
String	getSettingPath()	获得设定文件的路径
URL	getSettingUrl()	获得设定文件的URL
int	hashCode()
boolean	init(org.aoju.bus.core.io.resource.Resource resource, Charset charset, boolean isUseVariable)	初始化设定文件
boolean	isEmpty()
boolean	isEmpty(String group)	某个分组对应的键值对是否为空
Set<String>	keySet()	获取默认分组(空分组)中的所有键列表
Set<String>	keySet(String group)	指定分组所有键的Set
boolean	load()	重新加载配置文件
static PopSetting	of()	构建一个空的Setting，用于手动加入参数
String	put(String key, String value)	将指定键值对加入到默认分组（空分组）中
PopSetting	putAll(String group, Map<? extends String,? extends String> m)	加入多个键值对到某个分组下
void	putAll(Map<? extends String,? extends String> m)	将键值对Map加入默认分组（空分组）中
String	putByGroup(String key, String group, String value)	将键值对加入到对应分组中
String	remove(Object key)	移除默认分组(空分组)中指定值
String	remove(String group, Object key)	从指定分组中删除指定值
PopSetting	set(String key, String value)	设置值
PopSetting	setByGroup(String key, String group, String value)	将键值对加入到对应分组中 此方法用于与getXXX统一参数顺序
PopSetting	setCharset(Charset charset)	自定义字符编码
PopSetting	setFields(org.aoju.bus.core.lang.function.XSupplier<String>... fields)	通过lambda批量设置值 实际使用时，可以使用getXXX的方法引用来完成键值对的赋值：
PopSetting	setLogIfNull(boolean logIfNull)	设置当获取key对应值为null时是否打印debug日志提示用户
PopSetting	setVarRegex(String regex)	设置变量的正则 正则只能有一个group表示变量本身，剩余为字符 例如 \$\{(name)\}表示${name}变量名为name的一个变量表示
int	size()	键值总数
void	store()	持久化当前设置,会覆盖掉之前的设置 持久化不会保留之前的分组，注意如果配置文件在jar内部或者在exe中，此方法会报错。
void	store(File file)	持久化当前设置，会覆盖掉之前的设置 持久化不会保留之前的分组
void	store(String absolutePath)	持久化当前设置,会覆盖掉之前的设置 持久化不会保留之前的分组
Properties	toProperties()	转换为Properties对象，原分组变为前缀
String	toString()
Collection<String>	values()	获取默认分组(空分组)中的所有值列表
Collection<String>	values(String group)	指定分组下所有值

Methods inherited from class org.aoju.bus.setting.magic.AbstractSetting

get, getByGroupNotEmpty, getObject, getStrs, getStrs, getStrsByGroup, getStrsByGroup, toBean, toBean, toBean, toBean

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.aoju.bus.core.getter.GroupedGetter

getBigDecimalByGroup, getBigDecimalByGroup, getBigIntegerByGroup, getBigIntegerByGroup, getBoolByGroup, getBoolByGroup, getByGroup, getByGroup, getByteByGroup, getByteByGroup, getCharByGroup, getCharByGroup, getDoubleByGroup, getDoubleByGroup, getIntByGroup, getIntByGroup, getLongByGroup, getLongByGroup, getObjectByGroup, getShortByGroup, getShortByGroup, getStringByGroup, getStringByGroup

Methods inherited from interface java.util.Map

compute, computeIfAbsent, computeIfPresent, forEach, getOrDefault, merge, putIfAbsent, remove, replace, replace, replaceAll

Methods inherited from interface org.aoju.bus.core.getter.TypeGetter

get, get, get, getBigDecimal, getBigDecimal, getBigInteger, getBigInteger, getBool, getBool, getByte, getByte, getBytes, getBytes, getChar, getChar, getDate, getDate, getDouble, getDouble, getEnum, getEnum, getFloat, getFloat, getInt, getInt, getLocalDate, getLocalDate, getLocalDateTime, getLocalDateTime, getLocalTime, getLocalTime, getLong, getLong, getNumber, getNumber, getObject, getShort, getShort, getSqlTime, getSqlTime, getSqlTimestamp, getSqlTimestamp, getString, getString

Field Details

charset

protected Charset charset

本设置对象的字符集

isUseVariable

protected boolean isUseVariable

是否使用变量

resource

protected org.aoju.bus.core.io.resource.Resource resource

设定文件的资源

Constructor Details

PopSetting

public PopSetting()

空构造

PopSetting

public PopSetting(String path)

构造

Parameters:

path - 相对路径或绝对路径

PopSetting

public PopSetting(String path,
 boolean isUseVariable)

构造

Parameters:

path - 相对路径或绝对路径

isUseVariable - 是否使用变量

PopSetting

public PopSetting(String path,
 Charset charset,
 boolean isUseVariable)

构造,使用相对于Class文件根目录的相对路径

Parameters:

path - 相对路径或绝对路径

charset - 字符集

isUseVariable - 是否使用变量

PopSetting

public PopSetting(File configFile,
 Charset charset,
 boolean isUseVariable)

构造

Parameters:

configFile - 配置文件对象

charset - 字符集

isUseVariable - 是否使用变量

PopSetting

public PopSetting(org.aoju.bus.core.io.resource.Resource resource,
 Charset charset,
 boolean isUseVariable)

构造

Parameters:

resource - Resource

charset - 字符集

isUseVariable - 是否使用变量

Method Details

of

public static PopSetting of()

构建一个空的Setting，用于手动加入参数

Returns:

this

init

public boolean init(org.aoju.bus.core.io.resource.Resource resource,
 Charset charset,
 boolean isUseVariable)

初始化设定文件

Parameters:

resource - Resource

charset - 字符集

isUseVariable - 是否使用变量

Returns:

成功初始化与否

load

public boolean load()

重新加载配置文件

Returns:

是否加载成功

autoLoad

public void autoLoad(boolean autoReload)

在配置文件变更时自动加载

Parameters:

autoReload - 是否自动加载

autoLoad

public void autoLoad(boolean autoReload,
 Consumer<Boolean> callback)

在配置文件变更时自动加载

Parameters:

autoReload - 是否自动加载

callback - 加载完成回调

getSettingUrl

public URL getSettingUrl()

获得设定文件的URL

Returns:

获得设定文件的路径

getSettingPath

public String getSettingPath()

获得设定文件的路径

Returns:

获得设定文件的路径

size

public int size()

键值总数

Specified by:

size in interface Map<String,String>

Returns:

键值总数

getObjectByGroup

public Object getObjectByGroup(CharSequence key,
 CharSequence group,
 Object defaultValue)

Specified by:

getObjectByGroup in interface org.aoju.bus.core.getter.GroupedGetter<CharSequence,CharSequence>

getAndRemove

public String getAndRemove(String... keys)

获取并删除键值对,当指定键对应值非空时,返回并删除这个值,后边的键对应的值不再查找

Parameters:

keys - 键列表,常用于别名

Returns:

值

getMap

public Map<String,String> getMap(String group)

获取并删除键值对,当指定键对应值非空时,返回并删除这个值,后边的键对应的值不再查找

Parameters:

group - 分组

Returns:

map

getSetting

public PopSetting getSetting(String group)

获得group对应的子Setting

Parameters:

group - 分组

Returns:

PopSetting

getProperties

public Properties getProperties(String group)

获得group对应的子Properties

Parameters:

group - 分组

Returns:

Properties

getProps

public Properties getProps(String group)

获得group对应的子Props

Parameters:

group - 分组

Returns:

Properties

store

public void store()

持久化当前设置,会覆盖掉之前的设置 持久化不会保留之前的分组，注意如果配置文件在jar内部或者在exe中，此方法会报错。

store

public void store(String absolutePath)

持久化当前设置,会覆盖掉之前的设置 持久化不会保留之前的分组

Parameters:

absolutePath - 设置文件的绝对路径

store

public void store(File file)

持久化当前设置，会覆盖掉之前的设置 持久化不会保留之前的分组

Parameters:

file - 设置文件

toProperties

public Properties toProperties()

转换为Properties对象，原分组变为前缀

Returns:

Properties

getGroupMap

public GroupMap getGroupMap()

获取GroupedMap

Returns:

GroupMap

getGroups

public List<String> getGroups()

获取所有分组

Returns:

获得所有分组名

setVarRegex

public PopSetting setVarRegex(String regex)

设置变量的正则 正则只能有一个group表示变量本身，剩余为字符 例如 \$\{(name)\}表示${name}变量名为name的一个变量表示

Parameters:

regex - 正则

Returns:

this

setCharset

public PopSetting setCharset(Charset charset)

自定义字符编码

Parameters:

charset - 字符编码

Returns:

this

setLogIfNull

public PopSetting setLogIfNull(boolean logIfNull)

设置当获取key对应值为null时是否打印debug日志提示用户

Parameters:

logIfNull - 当获取key对应值为null时是否打印debug日志提示用户

Returns:

this

isEmpty

public boolean isEmpty(String group)

某个分组对应的键值对是否为空

Parameters:

group - 分组

Returns:

是否为空

containsKey

public boolean containsKey(String group,
 String key)

指定分组中是否包含指定key

Parameters:

group - 分组

key - 键

Returns:

是否包含key

containsValue

public boolean containsValue(String group,
 String value)

指定分组中是否包含指定值

Parameters:

group - 分组

value - 值

Returns:

是否包含值

putByGroup

public String putByGroup(String key,
 String group,
 String value)

将键值对加入到对应分组中

Parameters:

key - 键

group - 分组

value - 值

Returns:

此key之前存在的值, 如果没有返回null

remove

public String remove(String group,
 Object key)

从指定分组中删除指定值

Parameters:

group - 分组

key - 键

Returns:

被删除的值，如果值不存在，返回null

putAll

public PopSetting putAll(String group,
 Map<? extends String,? extends String> m)

加入多个键值对到某个分组下

Parameters:

group - 分组

m - 键值对

Returns:

this

addSetting

public PopSetting addSetting(PopSetting setting)

添加一个Stting到主配置中

Parameters:

setting - Setting配置

Returns:

this

clear

public PopSetting clear(String group)

清除指定分组下的所有键值对

Parameters:

group - 分组

Returns:

this

keySet

public Set<String> keySet(String group)

指定分组所有键的Set

Parameters:

group - 分组

Returns:

键Set

values

public Collection<String> values(String group)

指定分组下所有值

Parameters:

group - 分组

Returns:

值

entrySet

public Set<Map.Entry<String,String>> entrySet(String group)

指定分组下所有键值对

Parameters:

group - 分组

Returns:

键值对

set

public PopSetting set(String key,
 String value)

设置值

Parameters:

key - 键

value - 值

Returns:

this

setFields

public PopSetting setFields(org.aoju.bus.core.lang.function.XSupplier<String>... fields)

通过lambda批量设置值 实际使用时，可以使用getXXX的方法引用来完成键值对的赋值：

     User user = GenericBuilder.of(User::new).with(User::setUsername, "bus").build();
     PopSetting.of().setFields(user::getNickname, user::getUsername);
 

Parameters:

fields - lambda,不能为空

Returns:

this

setByGroup

public PopSetting setByGroup(String key,
 String group,
 String value)

将键值对加入到对应分组中 此方法用于与getXXX统一参数顺序

Parameters:

key - 键

group - 分组

value - 值

Returns:

此key之前存在的值，如果没有返回null

isEmpty

public boolean isEmpty()

Specified by:

isEmpty in interface Map<String,String>

containsKey

public boolean containsKey(Object key)

默认分组(空分组)中是否包含指定key对应的值

Specified by:

containsKey in interface Map<String,String>

Parameters:

key - 键

Returns:

默认分组中是否包含指定key对应的值

containsValue

public boolean containsValue(Object value)

默认分组（空分组）中是否包含指定值

Specified by:

containsValue in interface Map<String,String>

Parameters:

value - 值

Returns:

默认分组中是否包含指定值

get

public String get(Object key)

获取默认分组(空分组)中指定key对应的值

Specified by:

get in interface Map<String,String>

Parameters:

key - 键

Returns:

默认分组(空分组)中指定key对应的值

put

public String put(String key,
 String value)

将指定键值对加入到默认分组（空分组）中

Specified by:

put in interface Map<String,String>

Parameters:

key - 键

value - 值

Returns:

加入的值

remove

public String remove(Object key)

移除默认分组(空分组)中指定值

Specified by:

remove in interface Map<String,String>

Parameters:

key - 键

Returns:

移除的值

putAll

public void putAll(Map<? extends String,? extends String> m)

将键值对Map加入默认分组（空分组）中

Specified by:

putAll in interface Map<String,String>

Parameters:

m - Map

clear

public void clear()

清空默认分组(空分组)中的所有键值对

Specified by:

clear in interface Map<String,String>

keySet

public Set<String> keySet()

获取默认分组(空分组)中的所有键列表

Specified by:

keySet in interface Map<String,String>

Returns:

默认分组(空分组)中的所有键列表

values

public Collection<String> values()

获取默认分组(空分组)中的所有值列表

Specified by:

values in interface Map<String,String>

Returns:

默认分组(空分组)中的所有值列表

entrySet

public Set<Map.Entry<String,String>> entrySet()

获取默认分组(空分组)中的所有键值对列表

Specified by:

entrySet in interface Map<String,String>

Returns:

默认分组(空分组)中的所有键值对列表

hashCode

public int hashCode()

Specified by:

hashCode in interface Map<String,String>

Overrides:

hashCode in class Object

equals

public boolean equals(Object object)

Specified by:

equals in interface Map<String,String>

Overrides:

equals in class Object

toString

public String toString()

Overrides:

toString in class Object