org.apache.dubbo.common.config.configcenter.wrapper

Class CompositeDynamicConfiguration

java.lang.Object

org.apache.dubbo.common.config.configcenter.wrapper.CompositeDynamicConfiguration

All Implemented Interfaces:

AutoCloseable, DynamicConfiguration, Configuration

public class CompositeDynamicConfiguration
extends Object
implements DynamicConfiguration

support multiple config center, simply iterating each concrete config center.

Field Summary

Fields

Modifier and Type	Field and Description
static String	NAME

Fields inherited from interface org.apache.dubbo.common.config.configcenter.DynamicConfiguration

DEFAULT_GROUP

Constructor Summary

Constructors

Constructor and Description
CompositeDynamicConfiguration()

Method Summary

Modifier and Type	Method and Description
void	addConfiguration(DynamicConfiguration configuration)
void	addListener(String key, String group, ConfigurationListener listener) Register a configuration listener for a specified key The listener only works for service governance purpose, so the target group would always be the value user specifies at startup or 'dubbo' by default.
String	getConfig(String key, String group, long timeout) Get the configuration mapped to the given key and the given group.
SortedSet<String>	getConfigKeys(String group) Get the config keys by the specified group
Object	getInternalProperty(String key)
String	getProperties(String key, String group, long timeout) This method are mostly used to get a compound config file, such as a complete dubbo.properties file.
boolean	publishConfig(String key, String group, String content) Publish Config mapped to the given key and the given group.
void	removeListener(String key, String group, ConfigurationListener listener) Stops one listener from listening to value changes in the specified key.

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.dubbo.common.config.configcenter.DynamicConfiguration

addListener, close, getConfig, getDefaultGroup, getDefaultTimeout, getDynamicConfiguration, getDynamicConfiguration, getProperties, getRuleKey, publishConfig, removeListener

Methods inherited from interface org.apache.dubbo.common.config.Configuration

containsKey, convert, getBoolean, getBoolean, getBoolean, getInt, getInt, getInteger, getProperty, getProperty, getString, getString, toBooleanObject

Field Detail

NAME

public static final String NAME

See Also:

Constant Field Values

Constructor Detail

CompositeDynamicConfiguration

public CompositeDynamicConfiguration()

Method Detail

addConfiguration

public void addConfiguration(DynamicConfiguration configuration)

addListener

public void addListener(String key,
                        String group,
                        ConfigurationListener listener)

Description copied from interface: DynamicConfiguration

Register a configuration listener for a specified key The listener only works for service governance purpose, so the target group would always be the value user specifies at startup or 'dubbo' by default. This method will only register listener, which means it will not trigger a notification that contains the current value.

Specified by:

addListener in interface DynamicConfiguration

Parameters:

key - the key to represent a configuration

group - the group where the key belongs to

listener - configuration listener

removeListener

public void removeListener(String key,
                           String group,
                           ConfigurationListener listener)

Description copied from interface: DynamicConfiguration

Stops one listener from listening to value changes in the specified key.

Specified by:

removeListener in interface DynamicConfiguration

Parameters:

key - the key to represent a configuration

group - the group where the key belongs to

listener - configuration listener

getConfig

public String getConfig(String key,
                        String group,
                        long timeout)
                 throws IllegalStateException

Description copied from interface: DynamicConfiguration

Get the configuration mapped to the given key and the given group. If the configuration fails to fetch after timeout exceeds, IllegalStateException will be thrown.

Specified by:

getConfig in interface DynamicConfiguration

Parameters:

key - the key to represent a configuration

group - the group where the key belongs to

timeout - timeout value for fetching the target config

Returns:

target configuration mapped to the given key and the given group, IllegalStateException will be thrown if timeout exceeds.

Throws:

IllegalStateException

getProperties

public String getProperties(String key,
                            String group,
                            long timeout)
                     throws IllegalStateException

Description copied from interface: DynamicConfiguration

This method are mostly used to get a compound config file, such as a complete dubbo.properties file.

Specified by:

getProperties in interface DynamicConfiguration

Throws:

IllegalStateException

getInternalProperty

public Object getInternalProperty(String key)

Specified by:

getInternalProperty in interface Configuration

publishConfig

public boolean publishConfig(String key,
                             String group,
                             String content)
                      throws UnsupportedOperationException

Description copied from interface: DynamicConfiguration

Publish Config mapped to the given key and the given group.

Specified by:

publishConfig in interface DynamicConfiguration

Parameters:

key - the key to represent a configuration

group - the group where the key belongs to

content - the content of configuration

Returns:

true if success, or false

Throws:

UnsupportedOperationException - If the under layer does not support

getConfigKeys

public SortedSet<String> getConfigKeys(String group)
                                throws UnsupportedOperationException

Description copied from interface: DynamicConfiguration

Get the config keys by the specified group

Specified by:

getConfigKeys in interface DynamicConfiguration

Parameters:

group - the specified group

Returns:

the read-only non-null sorted set of config keys

Throws:

UnsupportedOperationException - If the under layer does not support