Module io.inverno.mod.configuration

Package io.inverno.mod.configuration.source

Class RedisConfigurationSource

java.lang.Object

io.inverno.mod.configuration.AbstractConfigurationSource<RedisConfigurationSource.RedisConfigurationQuery,RedisConfigurationSource.RedisExecutableConfigurationQuery,RedisConfigurationSource.RedisListConfigurationQuery,String>

io.inverno.mod.configuration.AbstractConfigurableConfigurationSource<RedisConfigurationSource.RedisConfigurationQuery,RedisConfigurationSource.RedisExecutableConfigurationQuery,RedisConfigurationSource.RedisListConfigurationQuery,RedisConfigurationSource.RedisConfigurationUpdate,RedisConfigurationSource.RedisExecutableConfigurationUpdate,String>

io.inverno.mod.configuration.source.RedisConfigurationSource

All Implemented Interfaces:

ConfigurableConfigurationSource<RedisConfigurationSource.RedisConfigurationQuery,RedisConfigurationSource.RedisExecutableConfigurationQuery,RedisConfigurationSource.RedisListConfigurationQuery,RedisConfigurationSource.RedisConfigurationUpdate,RedisConfigurationSource.RedisExecutableConfigurationUpdate>, ConfigurationSource<RedisConfigurationSource.RedisConfigurationQuery,RedisConfigurationSource.RedisExecutableConfigurationQuery,RedisConfigurationSource.RedisListConfigurationQuery>, DefaultableConfigurationSource<RedisConfigurationSource.RedisConfigurationQuery,RedisConfigurationSource.RedisExecutableConfigurationQuery,RedisConfigurationSource.RedisListConfigurationQuery,RedisConfigurationSource>

public class RedisConfigurationSource
extends AbstractConfigurableConfigurationSource<RedisConfigurationSource.RedisConfigurationQuery,RedisConfigurationSource.RedisExecutableConfigurationQuery,RedisConfigurationSource.RedisListConfigurationQuery,RedisConfigurationSource.RedisConfigurationUpdate,RedisConfigurationSource.RedisExecutableConfigurationUpdate,String>
implements DefaultableConfigurationSource<RedisConfigurationSource.RedisConfigurationQuery,RedisConfigurationSource.RedisExecutableConfigurationQuery,RedisConfigurationSource.RedisListConfigurationQuery,RedisConfigurationSource>

A configurable configuration source that stores and looks up properties in a Redis data store.

Configuration are stored as string entries, the property key is of the form: keyPrefix ":PROP:" propertyName "[" [ key "=" value [ "," key "=" value ]* "]".

Since:

1.5

Author:

Jeremy Kuhn

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	RedisConfigurationSource.RedisConfigurationQuery	The configuration query used by the Redis configuration source.
static class	RedisConfigurationSource.RedisConfigurationUpdate	The configuration update used by the Redis configuration source.
static class	RedisConfigurationSource.RedisExecutableConfigurationQuery	The executable configuration query used by the Redis configuration source.
static class	RedisConfigurationSource.RedisExecutableConfigurationUpdate	The executable configuration update used by the Redis configuration source.
static class	RedisConfigurationSource.RedisListConfigurationQuery	The list configuration query used by the Redis configuration source.

Field Summary

Fields

Modifier and Type	Field	Description
static final String	DEFAULT_KEY_PREFIX	The default key prefix.

Fields inherited from class io.inverno.mod.configuration.AbstractConfigurableConfigurationSource

encoder

Fields inherited from class io.inverno.mod.configuration.AbstractConfigurationSource

decoder

Constructor Summary

Constructors

Constructor	Description
RedisConfigurationSource(RedisClient<String,String> redisClient)	Creates a redis configuration source with the specified redis client.
RedisConfigurationSource(RedisClient<String,String> redisClient, JoinablePrimitiveEncoder<String> encoder, SplittablePrimitiveDecoder<String> decoder)	Creates a redis configuration source with the specified redis client, string value encoder and decoder.

Method Summary

Modifier and Type	Method	Description
RedisConfigurationSource.RedisExecutableConfigurationQuery	get(String... names)	Creates a configuration query to retrieve the specified properties.
final String	getKeyPrefix()	Returns the prefix that is prepended to configuration property keys.
RedisConfigurationSource.RedisListConfigurationQuery	list(String name)	Creates a list configuration query to list configuration properties defined with the specified property name.
RedisConfigurationSource.RedisExecutableConfigurationUpdate	set(Map<String,Object> values)	Creates a configuration update to set the configuration properties extracted from the specified values.
final void	setKeyPrefix(String keyPrefix)	Sets the prefix that is prepended to configuration property keys.
RedisConfigurationSource	unwrap()	Returns the original configuration source.
RedisConfigurationSource	withDefaultingStrategy(DefaultingStrategy defaultingStrategy)	Returns a proxy of the defaultable configuration source instance using the specified defaulting strategy.

Methods inherited from class io.inverno.mod.configuration.AbstractConfigurableConfigurationSource

getEncoder, setEncoder

Methods inherited from class io.inverno.mod.configuration.AbstractConfigurationSource

getDecoder, setDecoder

Methods inherited from class java.lang.Object

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

Methods inherited from interface io.inverno.mod.configuration.ConfigurableConfigurationSource

set, set, set, set, set, set, set, set, set, set

Field Details

DEFAULT_KEY_PREFIX

public static final String DEFAULT_KEY_PREFIX

The default key prefix.

See Also:

• Constant Field Values

Constructor Details

RedisConfigurationSource

public RedisConfigurationSource(RedisClient<String,String> redisClient)

Creates a redis configuration source with the specified redis client.

Parameters:

redisClient - a redis client

RedisConfigurationSource

public RedisConfigurationSource(RedisClient<String,String> redisClient,
 JoinablePrimitiveEncoder<String> encoder,
 SplittablePrimitiveDecoder<String> decoder)

Creates a redis configuration source with the specified redis client, string value encoder and decoder.

Parameters:

redisClient - a redis client

encoder - a string encoder

decoder - a string decoder

Method Details

getKeyPrefix

public final String getKeyPrefix()

Returns the prefix that is prepended to configuration property keys.

A configuration property key is of the form: keyPrefix ":PROP:" propertyName "[" [ key "=" value [ "," key "=" value ]* "]".

Returns:

the key prefix

setKeyPrefix

public final void setKeyPrefix(String keyPrefix)

Sets the prefix that is prepended to configuration property keys.

A configuration property key is of the form: keyPrefix ":PROP:" propertyName "[" [ key "=" value [ "," key "=" value ]* "]".

Parameters:

keyPrefix - the key prefix to set

withDefaultingStrategy

public RedisConfigurationSource withDefaultingStrategy(DefaultingStrategy defaultingStrategy)

Description copied from interface: DefaultableConfigurationSource

Returns a proxy of the defaultable configuration source instance using the specified defaulting strategy.

Specified by:

withDefaultingStrategy in interface DefaultableConfigurationSource<RedisConfigurationSource.RedisConfigurationQuery,RedisConfigurationSource.RedisExecutableConfigurationQuery,RedisConfigurationSource.RedisListConfigurationQuery,RedisConfigurationSource>

Parameters:

defaultingStrategy - a defaulting strategy

Returns:

a new defaultable configuration source

unwrap

public RedisConfigurationSource unwrap()

Description copied from interface: DefaultableConfigurationSource

Returns the original configuration source.

Specified by:

unwrap in interface DefaultableConfigurationSource<RedisConfigurationSource.RedisConfigurationQuery,RedisConfigurationSource.RedisExecutableConfigurationQuery,RedisConfigurationSource.RedisListConfigurationQuery,RedisConfigurationSource>

Returns:

a configuration source

get

public RedisConfigurationSource.RedisExecutableConfigurationQuery get(String... names)
                                                               throws IllegalArgumentException

Description copied from interface: ConfigurationSource

Creates a configuration query to retrieve the specified properties.

Specified by:

get in interface ConfigurationSource<RedisConfigurationSource.RedisConfigurationQuery,RedisConfigurationSource.RedisExecutableConfigurationQuery,RedisConfigurationSource.RedisListConfigurationQuery>

Parameters:

names - an array of property names

Returns:

an executable configuration query

Throws:

IllegalArgumentException - if the array of names is null or empty

list

public RedisConfigurationSource.RedisListConfigurationQuery list(String name)
                                                          throws IllegalArgumentException

Description copied from interface: ConfigurationSource

Creates a list configuration query to list configuration properties defined with the specified property name.

Specified by:

list in interface ConfigurationSource<RedisConfigurationSource.RedisConfigurationQuery,RedisConfigurationSource.RedisExecutableConfigurationQuery,RedisConfigurationSource.RedisListConfigurationQuery>

Parameters:

name - a property name

Returns:

a list configuration query

Throws:

IllegalArgumentException - if the name is null or empty

set

public RedisConfigurationSource.RedisExecutableConfigurationUpdate set(Map<String,Object> values)
                                                                throws IllegalArgumentException

Description copied from interface: ConfigurableConfigurationSource

Creates a configuration update to set the configuration properties extracted from the specified values.

Specified by:

set in interface ConfigurableConfigurationSource<RedisConfigurationSource.RedisConfigurationQuery,RedisConfigurationSource.RedisExecutableConfigurationQuery,RedisConfigurationSource.RedisListConfigurationQuery,RedisConfigurationSource.RedisConfigurationUpdate,RedisConfigurationSource.RedisExecutableConfigurationUpdate>

Parameters:

values - a map containing properties keys and values to set in the configuration source

Returns:

an executable configuration update

Throws:

IllegalArgumentException - if the map of properties is null or empty