ONE源码剖析之Core包Settings类

Settings类

存储在设置文件中的模拟设置界面。 设置类应在使用前初始化 init（String）。 如果未初始化“设置”，则仅读取default_setting中的设置。 通常，在初始化之后，给定文件中的设置可以覆盖默认设置文件中定义的任何设置。
所有设置都是键值对。值可以是单个值或逗号分隔的值列表。 使用CSV值时，必须使用CSV方法（例如getCsvInts（String，int））。 设置值不应以括号开头和结尾，因为它们是针对特定于运行的值保留的。 在文件路径中，目录分隔符应始终为正斜杠（“/”）。

1、定义了属性对象，该属性对象包含了一系列配置属性。
2、定义default_setting的关键字，用于向外界读取配置文件

设置所有读取设置的文件名。如果设置为空字符串，则使用标准输出。默认情况下，不会写入任何位置。

字符串中请求值的分隔符。用于在配置文件中分割关键字。

所有读取设置写入的流。

1、运行设置特定的索引。
2、设置的命名空间，用于区分设置
3、旧命名空间
4、辅助命名空间

使用命名空间创建设置对象。 命名空间是所有后续设置请求的前缀。

创建没有命名空间的设置对象。 所有设置请求都必须以有效的命名空间为前缀。

设置设置的运行索引（仅对运行数组的设置有效）。 可以使用语法[settingFor1stRun; settingFor2ndRun; SettingFor3rdRun] 。 设置放在括号中并用分号分隔。当索引为0时返回第一次运行的设置，当索引为1时返回第二次设置等。如果运行索引大于运行数组的长度，则索引在运行数组中回绕（即返回值是 runIndex％arrayLength </ CODE>）。 要禁用整个run-index-thing，请将index设置为小于零的值（例如-1）。 禁用时，run-arrays将作为普通值返回，包括括号。

检查给定的整数数组是否包含有效范围。 即数组的长度必须为2，并且first_value <= second_value 。参数：数组范围、设置名称（错误消息）

确保给定的设置值为正。参数：值，配置文件名字

将命名空间设置为当前命名空间以外的其他名称。可以使用restoreNameSpace（）方法还原此更改。

将给定的命名空间附加到当前命名空间，用于主命名空间和辅助命名空间</ strong>。可以使用restoreNameSpace（）和restoreSecondaryNamespace（）恢复此更改。

返回设置名称前缀为将从中检索所请求设置的命名空间的完全限定名称，如果未从任何当前命名空间找到该设置，则为null。

返回设置对象的命名空间。

返回设置对象的辅助命名空间。

设置辅助命名空间，辅助命名空间可以作为“默认”空间，如果未设置特定设置，则从中查看设置。可以使用restoreSecondaryNamespace（）还原此更改。

在调用设置Secondary NameSpace之前恢复正在使用的辅助命名空间。

恢复使用setSubNameSpace（String）方法所做的更改，即恢复主命名空间和辅助命名空间。

初始化所有设置对象。 应在任何设置请求之前调用此方法。 后续调用将替换所有旧设置，然后“设置”仅包含新设置。文件default_setting（如果存在）始终处于读取状态。

读取另一个设置文件，并将键值对添加到当前设置，覆盖已使用相同键存在的任何值。

将给定的设置字符串写入设置输出文件（如果有）

如果存在具有已定义名称的设置，并且具有某个值（不仅仅是空），则返回true。

返回设置的完整（名称空间前缀）属性名称。

返回字符串值设置。 首先从设置的命名空间（如果有）然后从辅助命名空间（如果有）查看设置。 所有其他getter也使用此方法作为第一步。

返回给定的设置（如果存在），如果设置不存在则返回defaultValue。参数：设置的名称、如果给定的设置不存在，则返回的值。

从String值解析特定于运行的设置。参数：要解析的String。返回运行索引％数组长度，其中包含运行数组的值。

返回附加到字符类型的命名空间的设置（用于错误消息）

返回double类型值的设置。

返回double类型值的设置，如果给定的设置不存在，则返回默认值。

从String值设置中解析double值。 支持千（k），兆（M）和千兆（G）后缀。参数：要解析的字符串值、此值所在的设置、

返回CSV设置。 设置的值部分必须是逗号分隔值的列表。 值之间的空格会被去掉。参数：设置名称。返回：以逗号分隔的值数组。

返回包含预期数值的CSV设置。 设置的值部分必须是逗号分隔值的列表。 值之间的空格会被去掉。