Configuration API Reference - 版本历史

1216500866：/* 实现获取 */

2019-10-11T19:35:08Z

实现获取

←上一版本		2019年10月11日 (五) 19:35的版本
第191行：		第191行：
	===== 实现获取 =====		===== 实现获取 =====
	Next, you need to write the getter method. Check if ''customConfig'' is null, if it is load from disk.		Next, you need to write the getter method. Check if ''customConfig'' is null, if it is load from disk.
			接下来，您需要编写getter方法。如果customconfig是从磁盘加载，请检查它是否为null。


第201行：		第202行：
	}		}
	</source>		</source>


	===== 实现保存 =====		===== 实现保存 =====

Tdiant：/* 默认值 */

2017-08-01T11:46:44Z

默认值

←上一版本		2017年8月1日 (二) 11:46的版本
第56行：		第56行：
	=== 默认值 ===		=== 默认值 ===

	~~你的插件jar里应该为用户准备一个默认的~~''config.yml''~~。当config~~.~~yml丢失或是不完整的情况出现时，将会访问jar内的~~ ''config.yml''~~来获取默认值。准备好的文件必须被命名为~~ ''config.yml'' ，且应当放在与 [[Plugin YAML\|plugin.yml]]~~相同的目录。你应该在jar里的~~''config.yml''里准备一个完整的基本结构。你可以在插件主类的适当的地方使用 saveDefaultConfig() 方法把jar里的config.yml文件从jar中复制到插件配置文件夹里。		你的插件jar中应该为用户准备一个默认的''config.yml''文件。当''config.yml''丢失或是不完整的情况发生时，要获取的值将会从jar内的 ''config.yml''文件来获取。被准备的文件必须被命名为 ''config.yml'' ，且应当放在与 [[Plugin YAML\|plugin.yml]]相同目录下。你应该在jar里的''config.yml''里准备一个完整的基本结构。你可以在插件主类的适当的地方使用 saveDefaultConfig() 方法把jar里的config.yml文件从jar中复制到插件配置文件夹里。
	<blockquote><source lang="java">this.saveDefaultConfig()</source></blockquote>		<blockquote><source lang="java">this.saveDefaultConfig()</source></blockquote>

	如果你想动态的把一对键值作为默认值，你可以利用''addDefault(String, Object)'' 方法和 ''addDefaults(Map<String,Object>)'' 方法。		如果你想动态的把一对键值作为默认值，你可以利用''addDefault(String, Object)'' 方法和 ''addDefaults(Map<String,Object>)'' 方法。

	~~在某些情况下，如果你想附加一对新的键值给一个现存的~~ config.yml 文件，你可以通过通过传参布尔值 true给ConfigurationOptions对象里的copyDefaults方法来实现这一目的。		有时如果你想添加一对新的键值给一个现存的 config.yml 文件，你可以通过通过传参布尔值 true给ConfigurationOptions对象里的copyDefaults方法来实现这一目的。
	<blockquote><source lang="java">this.getConfig().options().copyDefaults(true)</source></blockquote>		<blockquote><source lang="java">this.getConfig().options().copyDefaults(true)</source></blockquote>

Tdiant：/* 路径 */

2017-08-01T11:42:21Z

路径

←上一版本		2017年8月1日 (二) 11:42的版本
第29行：		第29行：
	=== 路径 ===		=== 路径 ===

	Configuration API ~~使用路径来形成独立的键值组合.路径是键的集合用来将其与值关联的.每层都被路径分隔符区分开来,默认的分隔符是~~ '.' (段落)~~.举例来说，下面的YAML文件就有着一个路径的集合.~~		Configuration API 中使用路径（Path）来构成一个独立的键值对。一个路径是一层层的键的组合，被用来联系所对应的值。每一层都用路径分隔符区分开来，路径分隔符通常是 '.' (段落)。举个例子，下面的YMAL文件有着下面这些组路径。
	<blockquote><source lang="yaml">key: value		<blockquote><source lang="yaml">key: value
	one:		one:

Tdiant：更正了“键”部分的译制内容

2017-08-01T11:32:43Z

更正了“键”部分的译制内容

←上一版本		2017年8月1日 (二) 11:32的版本
第13行：		第13行：

	=== 配置文件对象 ===		=== 配置文件对象 ===
	~~<ref>key 键 value 值</ref>~~
	当你的插件主类继承 [http://jd.bukkit.org/doxygen/d7/deb/classorg_1_1bukkit_1_1plugin_1_1java_1_1JavaPlugin.html JavaPlugin] 类时也会继承父类 JavaPlugin 类的方法和属性。在被继承的方法中, ''[http://jd.bukkit.org/doxygen/d7/deb/classorg_1_1bukkit_1_1plugin_1_1java_1_1JavaPlugin.html#a79493f3bc9db2acbf9405c3a33e0acfd getConfig()]'' 返回的是一个 [http://jd.bukkit.org/doxygen/dd/d7c/classorg_1_1bukkit_1_1configuration_1_1file_1_1FileConfiguration.html FileConfiguration]类型的对象。这个对象就代表你插件数据文件夹里的''config.yml'' 文件。		当你的插件主类继承 [http://jd.bukkit.org/doxygen/d7/deb/classorg_1_1bukkit_1_1plugin_1_1java_1_1JavaPlugin.html JavaPlugin] 类时也会继承父类 JavaPlugin 类的方法和属性。在被继承的方法中, ''[http://jd.bukkit.org/doxygen/d7/deb/classorg_1_1bukkit_1_1plugin_1_1java_1_1JavaPlugin.html#a79493f3bc9db2acbf9405c3a33e0acfd getConfig()]'' 返回的是一个 [http://jd.bukkit.org/doxygen/dd/d7c/classorg_1_1bukkit_1_1configuration_1_1file_1_1FileConfiguration.html FileConfiguration]类型的对象。这个对象就代表你插件数据文件夹里的''config.yml'' 文件。

第24行：		第23行：
	=== 键 ===		=== 键 ===

	~~配置文件由键值组合构成，所有的键都是字符串。值对于其他键来说可能是一个~~''~~FileConfigurationSection~~''~~或是独立的数据~~. ''getKeys(boolean)'' ~~方法会返回现有~~''FileConfigurationSection''~~集合的值.布尔值决定返回的集合是不是递归的,如果为true，其将返回指定节点的键与子键, 如果为false则只会返回指定节点的键.为了获得特定节点的键~~, ''getKeys(boolean)'' ~~方法必须加载在特定节点. 你可以通过~~''getConfigurationSection(String)''~~方法来获取这个部分.~~		一个配置文件由键值对构成，键是一个字符串。键对应的值可能是一个 ''ConfigurationSection'' 对象或是其他形式的数据. ''getKeys(boolean)'' 方法会返回一个存有当前''FileConfigurationSection''所有键的集合，布尔值决定着是否递归地返回集合，如果值为true，将返回指定部分的所有键与所有对应子键, 如果为false则只会返回指定部分的所有键（不含子键）。若要获取特定部分的所有键，需调用特定部分''ConfigurationSection''对象的 ''getKeys(boolean)'' 方法。你可使用''getConfigurationSection(String)''方法来获取这个部分。

	{{warning\| getKeys(boolean)~~方法返回的是这里的字符串~~[http://download.oracle.com/javase/1,5.0/docs/api/java/util/Set.html 集合]}}		{{warning\| getKeys(boolean)方法返回的是一个字符串[http://download.oracle.com/javase/1,5.0/docs/api/java/util/Set.html 集合]}}

	=== 路径 ===		=== 路径 ===

Tdiant：/* Serializing and Deserializing Objects */

2017-08-01T11:21:10Z

Serializing and Deserializing Objects

←上一版本		2017年8月1日 (二) 11:21的版本
第234行：		第234行：
	</source>		</source>

	=== ~~Serializing and Deserializing Objects~~ ===		=== 序列化与反序列化对象 ===

	~~The~~ Configuration API~~, as mentioned above can store Java objects that implement the~~ ''ConfigurationSerializable'' ~~Interface. Object serialization facilitates easy saving and loading so plugin authors can focus on other parts of their plugin. It greatly simplifies tasks such as storing a~~ ''[http://jd.bukkit.org/doxygen/da/dac/classorg_1_1bukkit_1_1Location.html Location]'' ~~in YAML, a developer can serialize a wrapper class, which provide methods to retrieve a~~ ''Location''.<br>		在 Configuration API 中，上面提及的可以存储的对象均实现（implements）了 ''ConfigurationSerializable'' 接口。对象序列化可以有助我们保存和读取数据，来让插件开发者集中开发插件的其他部分。它真正的使一些任务变得简单明了了，就例如存储一个 ''[http://jd.bukkit.org/doxygen/da/dac/classorg_1_1bukkit_1_1Location.html Location]'' 对象到YAML文件当中，开发者可以序列化一个包装类，用以提供取用 ''Location'' 对象的方法。<br>

	Classes, ~~in addition to implementing~~ the ''ConfigurationSerializable'' interface must also implment one of the following as noted in the Javadoc, so that they can be serialized by the API:		Classes, 除了implementing the ''ConfigurationSerializable'' interface must also implment one of the following as noted in the Javadoc, so that they can be serialized by the API:

	*A constructor that accepts a single ''Map''.		*A constructor that accepts a single ''Map''.

Tdiant：更正了几处不当错误，做了简单的汉化工作

2017-08-01T11:10:09Z

更正了几处不当错误，做了简单的汉化工作

←上一版本		2017年8月1日 (二) 11:10的版本
第2行：		第2行：
	{{待翻译}}		{{待翻译}}

	Configuration API是一个帮助程序员们更快地解析与编辑配置文件的设置工具，让人们觉得配置文件更简单更容易编辑。不管是什么，这个API可以帮助你更容易的存储你插件的信息。目前只有这个 [http://en.wikipedia.org/wiki/YAML YAML] configurations ~~可以用。然而，有了这个API，设计的能有更多的扩展空间，还能允许你实现其他的东西。~~		Configuration API是一个能够帮助开发者快速解析与编辑配置文件的工具，它让配置文件更简单、更容易读写。无论是什么，这个API可以帮助你更容易的存储你插件的配置信息。目前只有这个 [http://en.wikipedia.org/wiki/YAML YAML] configurations 可以用。然而这个API被设计有广泛的拓展性，这意味着它允许你实现其他需要实现的东西。

	Configuration ~~API可以在~~ org.bukkit.configuration 和 org.bukkit.configuration.file ~~这俩包里找到。插件的版本如果创建在~~ 1.1-~~R5之前，就只能用老的并且与此不同的方法了，这些东西在org~~.bukkit.util.~~configuration这个包里。这些实现方法彼此不兼容并且老的方法因为太过时了，在新版中被删去了。~~		Configuration API存在于 org.bukkit.configuration 和 org.bukkit.configuration.file 这两个包中。如果是创建在 1.1-R5 版本之前的插件，就只能用老版本并且与本文截然不同的API了，这些老版API在老版本的org.bukkit.util.configuration包中。这些内容彼此互不兼容，并且因为老的方法太过时了，所以在新版中已被删去。

	~~This introduction assumes that you have some knowledge about proper object oriented design, Java, and the core design of Bukkit plugins. This page is not a substitute for the JavaDocs for the~~ [~~http~~://jd.~~bukkit~~.org/~~apidocs~~/index.html?org/bukkit/configuration/file/FileConfiguration.html FileConfiguration Class]		本文假定你对面向对象思想、Java与Bukkit插件编写的核心思想有着相当深的了解与认识。本文并非JavaDoc[https://hub.spigotmc.org/javadocs/bukkit/index.html?org/bukkit/configuration/file/FileConfiguration.html FileConfiguration Class]的替代品。

			（译者注：上方链接因过时，已经替换到了最新的新版链接当中，内容稍微与原文有所不符，但影响不大）

	== 基本论述 ==		== 基本论述 ==
第12行：		第14行：
	=== 配置文件对象 ===		=== 配置文件对象 ===
	<ref>key 键 value 值</ref>		<ref>key 键 value 值</ref>
	~~当你的插件主类继承了~~ [http://jd.bukkit.org/doxygen/d7/deb/classorg_1_1bukkit_1_1plugin_1_1java_1_1JavaPlugin.html JavaPlugin]~~的时候, 这个类也会继承JavaPlugin这个父类的的方法和属性。在被继承的方法其中~~, ''[http://jd.bukkit.org/doxygen/d7/deb/classorg_1_1bukkit_1_1plugin_1_1java_1_1JavaPlugin.html#a79493f3bc9db2acbf9405c3a33e0acfd getConfig()]'' 返回的是一个 [http://jd.bukkit.org/doxygen/dd/d7c/classorg_1_1bukkit_1_1configuration_1_1file_1_1FileConfiguration.html FileConfiguration]类型的对象。这个对象就代表你插件数据文件夹里的''config.yml'' 。		当你的插件主类继承 [http://jd.bukkit.org/doxygen/d7/deb/classorg_1_1bukkit_1_1plugin_1_1java_1_1JavaPlugin.html JavaPlugin] 类时也会继承父类 JavaPlugin 类的方法和属性。在被继承的方法中, ''[http://jd.bukkit.org/doxygen/d7/deb/classorg_1_1bukkit_1_1plugin_1_1java_1_1JavaPlugin.html#a79493f3bc9db2acbf9405c3a33e0acfd getConfig()]'' 返回的是一个 [http://jd.bukkit.org/doxygen/dd/d7c/classorg_1_1bukkit_1_1configuration_1_1file_1_1FileConfiguration.html FileConfiguration]类型的对象。这个对象就代表你插件数据文件夹里的''config.yml'' 文件。

	~~你的插件在第一次使用~~''getConfig()''~~的时候，会从你插件的jar文件中读取相应的~~''config.yml'' ~~，同时从jar中的~~''config.yml''~~加载相应的默认值。需要注意的是，第一次使用之后再调用~~''getConfig()''~~只会返回内存中保存的~~''FileConfiguration'' ~~对象，而并非磁盘上保存的最新的。除非你手动保存了，否则你对这个对象进行的修改并不会被保存。同理，在第一次调用~~''getConfig()''~~之后，对磁盘上的config~~.~~yml文件的修改不会被反映在这个对象里。如果在plugins文件夹中对应的插件文件夹里不存在~~ ''config.yml'' ，这时会等价于存在一个空的''config.yml'', 也会加载一个空的''FileConfiguration''。		你的插件在第一次调用''getConfig()''方法时，会从你插件的jar文件中读取相应的''config.yml'' 文件，同时从jar中的''config.yml''文件里加载相应的默认数据。需要注意的是，在第一次使用之后若再次调用''getConfig()''方法，只会返回内存中保存的''FileConfiguration'' 对象，而并非磁盘上保存的最新的，并且你对这个对象进行的修改并不会被保存，除非你手动保存。同理，在第一次调用''getConfig()''方法之后，对磁盘上的config.yml文件的修改不会被同步给这个对象。如果在 plugins 文件夹中对应的插件文件夹里不存在 ''config.yml'' ，这时会等价于存在一个空的''config.yml''文件, 也会加载一个空的''FileConfiguration''对象。

	{{warning\| 如果你在利用''getConfig()''的返回值，请不要把它赋给一个变量来使用}}<br />		{{warning\| 如果你在利用''getConfig()''的返回值，请不要把它赋给一个变量来使用}}<br />
	{{warning\| 如果需要这样的话，一定要记住在重载配置文件后，再把 ''getConfig()'' ~~分配给那个变量~~}} <br />		{{warning\| 如果需要这样的话，一定要记住在重载配置文件后，再把 ''getConfig()'' 方法的返回值分配给那个变量}} <br />
	{{warning\| 保险起见，推荐你尽可能的直接用''getConfig()''~~，而不是将其分配给一个变量~~}}		{{warning\| 保险起见，推荐你尽可能的直接用''getConfig()''方法，而不是将其分配给一个变量}}

	=== 键值 ===		=== 键 ===

	~~配置文件由键值组合构成，所有的键都是字符串.值对于其他键来说可能是一个~~''FileConfigurationSection''或是独立的数据. ''getKeys(boolean)'' 方法会返回现有''FileConfigurationSection''集合的值.布尔值决定返回的集合是不是递归的,如果为true，其将返回指定节点的键与子键, 如果为false则只会返回指定节点的键.为了获得特定节点的键, ''getKeys(boolean)'' 方法必须加载在特定节点. 你可以通过''getConfigurationSection(String)''方法来获取这个部分.		配置文件由键值组合构成，所有的键都是字符串。值对于其他键来说可能是一个''FileConfigurationSection''或是独立的数据. ''getKeys(boolean)'' 方法会返回现有''FileConfigurationSection''集合的值.布尔值决定返回的集合是不是递归的,如果为true，其将返回指定节点的键与子键, 如果为false则只会返回指定节点的键.为了获得特定节点的键, ''getKeys(boolean)'' 方法必须加载在特定节点. 你可以通过''getConfigurationSection(String)''方法来获取这个部分.

	{{warning\| getKeys(boolean)方法返回的是这里的字符串[http://download.oracle.com/javase/1,5.0/docs/api/java/util/Set.html 集合]}}		{{warning\| getKeys(boolean)方法返回的是这里的字符串[http://download.oracle.com/javase/1,5.0/docs/api/java/util/Set.html 集合]}}
第255行：		第257行：
	== 使用样例 ==		== 使用样例 ==

	Below is the an example plugin that uses the new Configuration API to be display messages as an MOTD as players join, and for the player to retrieve the rules on command. It does not follow proper style and plugin layout to keep the number of lines to a minimum.		下面是一个使用了新版Configuration API的样例插件，它可以显示MOTD信息给进入服务器的玩家，并且可以让玩家使用指令获取规则（rule）。''此处为了让代码行数达到最佳，代码没有采用适当的风格和插件布局''。

	<blockquote><source lang="java">import java.util.*;		<blockquote><source lang="java">import java.util.*;
第268行：		第270行：
	@Override		@Override
	public void onEnable() {		public void onEnable() {
	// ~~Save a copy of the default~~ config.yml ~~if one is not there~~		// 如果没有默认 config.yml 文件，保存一个默认配置副本
	this.saveDefaultConfig();		this.saveDefaultConfig();

	// ~~Register a new listener~~		// 注册新的监听器
	getServer().getPluginManager().registerEvents(new Listener() {		getServer().getPluginManager().registerEvents(new Listener() {

	@EventHandler		@EventHandler
	public void playerJoin(PlayerJoinEvent event) {		public void playerJoin(PlayerJoinEvent event) {
	// ~~On player join send them the message from~~ config.yml		// 当玩家进入服务器时发送 config.yml 文件里的信息
	event.getPlayer().sendMessage(this.getConfig().getString("message"));		event.getPlayer().sendMessage(this.getConfig().getString("message"));
	}		}
	}, this);		}, this);

	// ~~Set the command executor for the rules command~~		// 给获取规则指令（rules）设置命令执行器（Command Executor）
	this.getCommand("rules").setExecutor(new CommandExecutor() {		this.getCommand("rules").setExecutor(new CommandExecutor() {

	public boolean onCommand(CommandSender sender, Command command, String label, String[] args) {		public boolean onCommand(CommandSender sender, Command command, String label, String[] args) {
	// ~~On command send the rules from~~ config.yml ~~to the sender of the command~~		// 当指令被执行，发送 config.yml 里的规则信息给输入指令的人
	List<String> rules = this.getConfig().getStringList("rules");		List<String> rules = this.getConfig().getStringList("rules");
	for (String s : rules){		for (String s : rules){
第294行：		第296行：
	});		});
	}		}
	}</source></blockquote> ~~The default~~ config.yml ~~that is in the plugin's jar~~		}</source></blockquote> 插件jar文件中的默认 config.yml 文件
	<source lang="yaml"># default config.yml		<source lang="yaml"># default config.yml
	message: Hello World and Welcome! :)		message: Hello World and Welcome! :)

Tdiant：/* 自定义配置文件 */

2016-08-15T13:51:13Z

自定义配置文件

←上一版本		2016年8月15日 (一) 13:51的版本
第155行：		第155行：
	=== 自定义配置文件 ===		=== 自定义配置文件 ===

	~~如果你需要额外的YAML文件，用于存储配置信息或坚持额外的游戏信息你需要访问额外的配置文件，写下你自己的方法。仿照~~ <big>JavaPlugin</big> 里的 getConfig，reloadConfig，saveConfig方法，下面是一个例子，如何编写你自己的方法来读取和保存自定义配置文件。由于这些配置文件，属于你的插件，你可以把这个方法在你的主类，这样你可以有相同的访问，你有config.yml 。你必须为每个YAML文件写的一套方法。这里的优势是，你可以使用都以相同的方式设置为默认设置的方法config.yml 。另外，添加额外的方法可以保持较低的计数方法，并允许访问多个文件。		如果你需要额外的YAML文件来存储其他的配置信息，或储存额外的游戏信息配置文件等，你可以自己写一个你自己的方法，来仿照 <big>JavaPlugin</big> 类里的 getConfig，reloadConfig，saveConfig 方法实现这一目的。下面是一个例子，可以告诉你如何编写一个方法，来读取和保存自定义配置文件。由于这些配置文件属于你的插件，你可以把这个方法放在你的主类，这样用起来跟原来一样。你必须为每个YAML文件写的一套方法。不过你可以使用以相同的方式设置为默认设置的方法config.yml 。另外，添加额外的方法可以保持较低的计数方法，并允许访问多个文件。

	==== JavaPlugin 镜像的实现 ====		==== JavaPlugin 镜像的实现 ====

Tdiant：/* 保存文件 */

2016-08-15T13:46:48Z

保存文件

←上一版本		2016年8月15日 (一) 13:46的版本
第122行：		第122行：
	=== 保存文件 ===		=== 保存文件 ===

	~~If make any changes to the~~''FileConfiguration'' ~~with set methods, or mutate any~~ ''Lists''~~, you will need to save the changes to disk if you wish to keep these changes after the plugin is disabled. To save the file to disk invoke the~~ saveConfig ~~method for your plugin, it will overwrite the file already there.~~ <blockquote><source lang="java">this.saveConfig();</source></blockquote>		如果你对一个 ''FileConfiguration'' 对象进行了修改操作，或者改变了某些 ''Lists''，如果你想保存你的修改，让插件被卸载了这些数据也能得以保存的话，你可以把你修改的数据保存到硬盘里。保存文件到硬盘里，你可以借助 saveConfig 方法。这会重写硬盘里的那份配置文件。 <blockquote><source lang="java">this.saveConfig();</source></blockquote>

	=== 从磁盘中重载配置文件 ===		=== 从磁盘中重载配置文件 ===

Tdiant：/* 从磁盘中重载配置文件 */

2016-08-15T13:43:47Z

从磁盘中重载配置文件

←上一版本		2016年8月15日 (一) 13:43的版本
第126行：		第126行：
	=== 从磁盘中重载配置文件 ===		=== 从磁盘中重载配置文件 ===

	~~If you suspect that users have made changes to the~~ ''config.yml'' ~~in the data folder, those changes are not reflected in memory. Invoke the~~ ''reloadConfig()'' ~~method of your plugin to load from the disk again. It will destroy all changes in memory.~~ <blockquote><source lang="java">this.reloadConfig();</source></blockquote>		如果你怀疑用户在插件数据文件夹里修改了''config.yml''，并且那些数据并没有更新在内存里。你可以用 ''reloadConfig()'' 方法重新读取插件文件夹中最新的配置文件信息，来更新内存中的数据，但这会把你内存中保存的那份数据删除，这可能会让你丢失一部分数据。 <blockquote><source lang="java">this.reloadConfig();</source></blockquote>
	<references />		<references />

Tdiant：/* 获得值 */

2016-08-15T13:41:22Z

获得值

←上一版本		2016年8月15日 (一) 13:41的版本
第68行：		第68行：
	=== 获得值 ===		=== 获得值 ===

	~~Reading values from the configuration involves invoking one of the many~~ getter ~~methods. A complete list of getters can be found~~ [http://jd.bukkit.org/doxygen/dd/d7c/classorg_1_1bukkit_1_1configuration_1_1file_1_1FileConfiguration.html ~~here~~]~~. Every~~ getter ~~method~~ takes a configuration path detailed above. ~~Some of the commonly used~~ getter ~~methods are as follows~~		你可以使用一堆 getter 方法来获取配置文件中的值。这些 getter 方法你可以在[http://jd.bukkit.org/doxygen/dd/d7c/classorg_1_1bukkit_1_1configuration_1_1file_1_1FileConfiguration.html 这里]找到。每个 getter 方法 takes a configuration path detailed above. 一般条件下你应该需要这些 getter 来获取值：

	*getBoolean(String)		*getBoolean(String) 获取键对应的类型为boolean的值
	*getInt(String)		*getInt(String) 获取键对应的类型为 int 的值
	*getString(String)		*getString(String) 获取键对应的类型为 String 的值
	*getList(String)		*getList(String) 获取键对应的类型为 List 的值
	*getStringList(String)		*getStringList(String)

	==== HashMaps ====		==== HashMaps ====

Configuration API Reference - 版本历史

1216500866：​/* 实现获取 */

Tdiant：​/* 默认值 */

Tdiant：​/* 路径 */

Tdiant：​更正了“键”部分的译制内容

Tdiant：​/* Serializing and Deserializing Objects */

Tdiant：​更正了几处不当错误，做了简单的汉化工作

Tdiant：​/* 自定义配置文件 */

Tdiant：​/* 保存文件 */

Tdiant：​/* 从磁盘中重载配置文件 */

Tdiant：​/* 获得值 */