com.bstek.dorado.data.config

Class ReloadableDataConfigManagerSupport

java.lang.Object

com.bstek.dorado.data.config.DataConfigManagerSupport

com.bstek.dorado.data.config.ReloadableDataConfigManagerSupport

All Implemented Interfaces:

DataConfigManager

Direct Known Subclasses:

ConfigurableDataConfigManager

public abstract class ReloadableDataConfigManagerSupport
extends DataConfigManagerSupport

支持数据配置文件自动重装载的管理器的抽象支持类。

该管理器在initialize()之后会启动一个定时线程，定期的验证所有已装载的配置文件的有效性和时间戳。 如果某文件已发生了改变或已不存在，那么管理器会重新装载或卸载相应的配置文件。
注意：该管理器不会自动装载符合通配路径的新配置文件，要支持新配置文件的自动装载需要使用 ConfigurableDataConfigManager。

Since:

Dec 10, 2007

Author:

Benny Bao (mailto:benny.bao@bstek.com)

See Also:

ConfigurableDataConfigManager

Field Summary

Fields inherited from class com.bstek.dorado.data.config.DataConfigManagerSupport

dataProviderManager, dataResolverManager, dataTypeManager

Constructor Summary

Constructors

Constructor and Description
ReloadableDataConfigManagerSupport()

Method Summary

Methods

Modifier and Type	Method and Description
long	getMinResourceValidateSeconds() 返回最短的执行配置文件时间戳验证的时间间隔。
protected java.util.Set<RefreshableResource>	getRefreshableResources() 将当前已装载的配置文件资源描述对象包装成可支持资源重装载的资源描述对象并返回。 如果某个资源本身已是可支持资源重装载的资源描述对象，那么此函数会跳过对这个对象的处理。
long	getValidateThreadIntervalSeconds() 返回检查所有配置文件是否需要重新装载的线程的执行间隔。
boolean	isAutoReloadEnabled() 返回是否启用配置文件的自动重装载。
boolean	isUseAutoReloadThread()
void	loadConfigs(Resource[] resources, boolean throwOnError) 装载一组数据配置文件中配置信息。
void	setAutoReloadEnabled(boolean autoReloadEnabled) 设置是否启用配置文件的自动重装载。
void	setMinResourceValidateSeconds(long minResourceValidateSeconds) 设置最短的执行配置文件时间戳验证的时间间隔。
void	setUseAutoReloadThread(boolean useAutoReloadThread)
void	setValidateThreadIntervalSeconds(long validateThreadIntervalSeconds) 设置检查所有配置文件是否需要重新装载的线程的执行间隔。
protected void	startValidateThead() 启动验证并执行配置文件动态装载的线程。
protected void	stopValidateThead() 终止验证并执行配置文件动态装载的线程。
void	unloadConfigs(Resource[] resources) 从已装载的信息中卸载与传入的配置文件相关的那部分配置信息。
boolean	validateAndReloadConfigs() 验证所有当前已装载的配置文件的有效性，如有文件被改变或被移除将重新装载或卸载该配置文件。

Methods inherited from class com.bstek.dorado.data.config.DataConfigManagerSupport

addConfigManagerListener, fireOnConfigChanged, getResources, internalLoadConfig, internalUnloadConfigs, removeConfigManagerListener, setDataProviderManager, setDataResolverManager, setDataTypeManager

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface com.bstek.dorado.data.config.DataConfigManager

initialize

Constructor Detail

ReloadableDataConfigManagerSupport

public ReloadableDataConfigManagerSupport()

Method Detail

isAutoReloadEnabled

public boolean isAutoReloadEnabled()

返回是否启用配置文件的自动重装载。

setAutoReloadEnabled

public void setAutoReloadEnabled(boolean autoReloadEnabled)

设置是否启用配置文件的自动重装载。

isUseAutoReloadThread

public boolean isUseAutoReloadThread()

setUseAutoReloadThread

public void setUseAutoReloadThread(boolean useAutoReloadThread)

getValidateThreadIntervalSeconds

public long getValidateThreadIntervalSeconds()

返回检查所有配置文件是否需要重新装载的线程的执行间隔。

setValidateThreadIntervalSeconds

public void setValidateThreadIntervalSeconds(long validateThreadIntervalSeconds)

设置检查所有配置文件是否需要重新装载的线程的执行间隔。

getMinResourceValidateSeconds

public long getMinResourceValidateSeconds()

返回最短的执行配置文件时间戳验证的时间间隔。

setMinResourceValidateSeconds

public void setMinResourceValidateSeconds(long minResourceValidateSeconds)

设置最短的执行配置文件时间戳验证的时间间隔。

loadConfigs

public void loadConfigs(Resource[] resources,
               boolean throwOnError)
                 throws java.lang.Exception

Description copied from interface: DataConfigManager

装载一组数据配置文件中配置信息。

注意：使用此方法时ConfigManager总是会首先清除所有的配置信息，然后再执行配置文件的装载。 即loadConfigs方法相当于重新装载所有的配置。

Specified by:

loadConfigs in interface DataConfigManager

Overrides:

loadConfigs in class DataConfigManagerSupport

Parameters:

resources - 用于表示一组配置文件的资源描述数组

Throws:

java.lang.Exception

unloadConfigs

public void unloadConfigs(Resource[] resources)
                   throws java.lang.Exception

Description copied from interface: DataConfigManager

从已装载的信息中卸载与传入的配置文件相关的那部分配置信息。

Specified by:

unloadConfigs in interface DataConfigManager

Overrides:

unloadConfigs in class DataConfigManagerSupport

Parameters:

resources - 用于表示一组配置文件的资源描述数组

Throws:

java.lang.Exception

getRefreshableResources

protected java.util.Set<RefreshableResource> getRefreshableResources()
                                                              throws java.io.IOException

将当前已装载的配置文件资源描述对象包装成可支持资源重装载的资源描述对象并返回。 如果某个资源本身已是可支持资源重装载的资源描述对象，那么此函数会跳过对这个对象的处理。

Throws:

java.io.IOException

validateAndReloadConfigs

public boolean validateAndReloadConfigs()

验证所有当前已装载的配置文件的有效性，如有文件被改变或被移除将重新装载或卸载该配置文件。

Returns:

返回的逻辑值表示此过程是否实际发生了重新装载或卸载的动作。

startValidateThead

protected void startValidateThead()

启动验证并执行配置文件动态装载的线程。

stopValidateThead

protected void stopValidateThead()

终止验证并执行配置文件动态装载的线程。