org.apache.jackrabbit.oak.spi.security

Class ConfigurationParameters

java.lang.Object

org.apache.jackrabbit.oak.spi.security.ConfigurationParameters

All Implemented Interfaces:

java.util.Map<java.lang.String,java.lang.Object>

public final class ConfigurationParameters
extends java.lang.Object
implements java.util.Map<java.lang.String,java.lang.Object>

ConfigurationParameters is a convenience class that allows typed access to configuration properties. It implements the Map interface but is immutable.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ConfigurationParameters.Milliseconds Helper class for configuration parameters that denote a "duration", such as a timeout or expiration time.

Nested classes/interfaces inherited from interface java.util.Map

java.util.Map.Entry<K,V>

Field Summary

Fields

Modifier and Type	Field and Description
static ConfigurationParameters	EMPTY An empty configuration parameters

Method Summary

Modifier and Type	Method and Description
void	clear()
boolean	contains(java.lang.String key) Returns true if this instance contains a configuration entry with the specified key irrespective of the defined value; false otherwise.
boolean	containsKey(java.lang.Object key)
boolean	containsValue(java.lang.Object value)
java.util.Set<java.util.Map.Entry<java.lang.String,java.lang.Object>>	entrySet()
java.lang.Object	get(java.lang.Object key)
<T> T	getConfigValue(java.lang.String key, T defaultValue) Returns the value of the configuration entry with the given key applying the following rules: If this instance doesn't contain a configuration entry with that key, or if the entry is null, the specified defaultValue will be returned. If the configured value is not null an attempt is made to convert the configured value to match the type of the default value.
<T> T	getConfigValue(java.lang.String key, T defaultValue, java.lang.Class<T> targetClass) Returns the value of the configuration entry with the given key applying the following rules: If this instance doesn't contain a configuration entry with that key the specified defaultValue will be returned. If defaultValue is null the original value will be returned. If the configured value is null this method will always return null. If neither defaultValue nor the configured value is null an attempt is made to convert the configured value to match the type of the default value.
boolean	isEmpty()
java.util.Set<java.lang.String>	keySet()
static ConfigurationParameters	of(ConfigurationParameters... params) Creates a new configuration parameters instance by merging all params sequentially.
static ConfigurationParameters	of(java.util.Dictionary<java.lang.String,java.lang.Object> properties) Creates new a configuration parameters instance by copying the given properties.
static ConfigurationParameters	of(java.util.Map<?,?> map) Creates new a configuration parameters instance by copying the given map.
static ConfigurationParameters	of(java.util.Properties properties) Creates new a configuration parameters instance by copying the given properties.
static ConfigurationParameters	of(java.lang.String key, java.lang.Object value) Creates new a single valued configuration parameters instance from the given key and value.
static ConfigurationParameters	of(java.lang.String key1, java.lang.Object value1, java.lang.String key2, java.lang.Object value2) Creates new a configuration parameters instance from the given key and value pairs.
java.lang.Object	put(java.lang.String key, java.lang.Object value)
void	putAll(java.util.Map<? extends java.lang.String,?> m)
java.lang.Object	remove(java.lang.Object key)
int	size()
java.util.Collection<java.lang.Object>	values()

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.util.Map

compute, computeIfAbsent, computeIfPresent, equals, forEach, getOrDefault, hashCode, merge, putIfAbsent, remove, replace, replace, replaceAll

Field Detail

EMPTY

public static final ConfigurationParameters EMPTY

An empty configuration parameters

Method Detail

of

public static ConfigurationParameters of(ConfigurationParameters... params)

Creates a new configuration parameters instance by merging all params sequentially. I.e. property define in subsequent arguments overwrite the ones before.

Parameters:

params - source parameters to merge

Returns:

merged configuration parameters or EMPTY if all source params were empty.

of

public static ConfigurationParameters of(java.util.Properties properties)

Creates new a configuration parameters instance by copying the given properties.

Parameters:

properties - source properties

Returns:

configuration parameters or EMPTY if the source properties were empty.

of

public static ConfigurationParameters of(java.util.Dictionary<java.lang.String,java.lang.Object> properties)

Creates new a configuration parameters instance by copying the given properties.

Parameters:

properties - source properties

Returns:

configuration parameters or EMPTY if the source properties were empty.

of

public static ConfigurationParameters of(java.util.Map<?,?> map)

Creates new a configuration parameters instance by copying the given map.

Parameters:

map - source map

Returns:

configuration parameters or EMPTY if the source map was empty.

of

public static ConfigurationParameters of(java.lang.String key,
                                         java.lang.Object value)

Creates new a single valued configuration parameters instance from the given key and value.

Parameters:

key - The key

value - The value

Returns:

a new instance of configuration parameters.

of

public static ConfigurationParameters of(java.lang.String key1,
                                         java.lang.Object value1,
                                         java.lang.String key2,
                                         java.lang.Object value2)

Creates new a configuration parameters instance from the given key and value pairs.

Parameters:

key1 - The key of the first pair.

value1 - The value of the first pair

key2 - The key of the second pair.

value2 - The value of the second pair.

Returns:

a new instance of configuration parameters.

contains

public boolean contains(java.lang.String key)

Returns true if this instance contains a configuration entry with the specified key irrespective of the defined value; false otherwise.

Parameters:

key - The key to be tested.

Returns:

true if this instance contains a configuration entry with the specified key irrespective of the defined value; false otherwise.

getConfigValue

public <T> T getConfigValue(java.lang.String key,
                            T defaultValue,
                            java.lang.Class<T> targetClass)

Returns the value of the configuration entry with the given key applying the following rules:

• If this instance doesn't contain a configuration entry with that key the specified defaultValue will be returned.
• If defaultValue is null the original value will be returned.
• If the configured value is null this method will always return null.
• If neither defaultValue nor the configured value is null an attempt is made to convert the configured value to match the type of the default value.

Parameters:

key - The name of the configuration option.

defaultValue - The default value to return if no such entry exists or to use for conversion.

targetClass - The target class

Returns:

The original or converted configuration value or null.

getConfigValue

public <T> T getConfigValue(java.lang.String key,
                            T defaultValue)

Returns the value of the configuration entry with the given key applying the following rules:

• If this instance doesn't contain a configuration entry with that key, or if the entry is null, the specified defaultValue will be returned.
• If the configured value is not null an attempt is made to convert the configured value to match the type of the default value.

Parameters:

key - The name of the configuration option.

defaultValue - The default value to return if no such entry exists or to use for conversion.

Returns:

The original or converted configuration value or null.

size

public int size()

Specified by:

size in interface java.util.Map<java.lang.String,java.lang.Object>

isEmpty

public boolean isEmpty()

Specified by:

isEmpty in interface java.util.Map<java.lang.String,java.lang.Object>

containsKey

public boolean containsKey(java.lang.Object key)

Specified by:

containsKey in interface java.util.Map<java.lang.String,java.lang.Object>

containsValue

public boolean containsValue(java.lang.Object value)

Specified by:

containsValue in interface java.util.Map<java.lang.String,java.lang.Object>

get

public java.lang.Object get(java.lang.Object key)

Specified by:

get in interface java.util.Map<java.lang.String,java.lang.Object>

put

public java.lang.Object put(java.lang.String key,
                            java.lang.Object value)

Specified by:

put in interface java.util.Map<java.lang.String,java.lang.Object>

remove

public java.lang.Object remove(java.lang.Object key)

Specified by:

remove in interface java.util.Map<java.lang.String,java.lang.Object>

putAll

public void putAll(java.util.Map<? extends java.lang.String,?> m)

Specified by:

putAll in interface java.util.Map<java.lang.String,java.lang.Object>

clear

public void clear()

Specified by:

clear in interface java.util.Map<java.lang.String,java.lang.Object>

keySet

public java.util.Set<java.lang.String> keySet()

Specified by:

keySet in interface java.util.Map<java.lang.String,java.lang.Object>

values

public java.util.Collection<java.lang.Object> values()

Specified by:

values in interface java.util.Map<java.lang.String,java.lang.Object>

entrySet

public java.util.Set<java.util.Map.Entry<java.lang.String,java.lang.Object>> entrySet()

Specified by:

entrySet in interface java.util.Map<java.lang.String,java.lang.Object>