容器

公共类 Container

提供对容器值的访问权限的对象。容器对象必须通过 openContainer(String, Container.Callback) 或 ContainerOpener 创建。创建容器后，可以查询该容器是否有键值对，这些值可能取决于为容器建立的规则。 容器会定期（每 12 小时）自动刷新，但您也可以使用 refresh() 手动刷新。

嵌套类摘要

接口	Container.Callback		回调将在资源成功加载后调用。
接口	Container.FunctionCallMacroHandler		应用提供的处理程序，用于计算自定义宏的值。
接口	Container.FunctionCallTagHandler		应用提供的处理程序，用于执行自定义代码。
枚举	Container.RefreshFailure		刷新失败的原因。
枚举	Container.RefreshType		容器刷新的来源。

公共方法摘要

已同步 void void	close()
布尔值	getBoolean(String 键)
字符串	getContainerId()
双精度浮点数	getDouble(String 键)
已同步 Container.FunctionCallMacroHandler	getFunctionCallMacroHandler(String customMacroName)
已同步 Container.FunctionCallTagHandler	getFunctionCallTagHandler(String customTagName)
长整型值	getLastRefreshTime()
长整型值	getLong(String 键)
字符串	getString(String 键)
布尔值	isDefault()
已同步 void void	refresh()
已同步 void void	registerFunctionCallMacroHandler(String customMacroName, Container.FunctionCallMacroHandler customMacroName)
已同步 void void	registerFunctionCallTagHandler(String customTagName, Container.FunctionCallTagHandler customTagHandler)，

公共方法

public sync void close ()

关闭此容器，使其不再刷新。关闭后，请勿使用。

public 布尔值 getBoolean (String key)

返回一个布尔值，表示给定键的配置值。 如果容器没有此键的值，将返回 false。

public 字符串 getContainerId ()

返回容器 ID。

public double getDouble (String key)

返回一个双精度浮点值，表示给定键的配置值。 如果容器没有此键的值，将返回 0。

public sync Container.FunctionCallMacroHandler getFunctionCallMacroHandler (String customMacroName)

返回为指定函数调用宏注册的宏处理程序。

public sync Container.FunctionCallTagHandler getFunctionCallTagHandler (String customTagName)

返回为指定函数调用标记注册的代码处理程序。

public long getLastRefreshTime ()

返回此容器最后一次从网络刷新的时间（以自世界协调时间 (UTC) 1970 年 1 月 1 日午夜以来的毫秒数表示）。

public getLong (String key)

返回一个长整型值，表示给定键的配置值。 如果容器没有此键的值，将返回 0。

public 字符串 getString (String key)

返回一个字符串，该字符串表示给定键的配置值。 如果容器没有此键的值，将返回空字符串。

public boolean isDefault ()

返回此容器是默认容器还是从服务器刷新的容器。

public sync void refresh ()

请求从网络中刷新此容器。 此调用是异步进行的，因此刷新将在另一个线程上进行。

调用 refresh() 后，您需要等待至少 15 分钟才能再次尝试调用此方法，否则后续调用可能为空操作。

public public void registerFunctionCallMacroHandler (String customMacroName, Container.FunctionCallMacroHandler customMacroHandler)

注册指定的宏处理程序，以处理指定的函数调用宏。

参数

customMacroName	所注册的宏的名称
customMacroHandler	处理脚本。如果为 null，则取消注册该宏的所有现有处理程序。

public sync void registerFunctionCallTagHandler (String customTagName, Container.FunctionCallTagHandler customTagHandler)

注册用于处理指定函数调用标记的代码处理程序。

参数

customTagName	要注册的代码的名称
customTagHandler	处理脚本。如果为 null，则取消注册该代码的所有现有处理程序。