org.apache.jackrabbit.oak.spi.security

Class ConfigurationParameters

java.lang.Object

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

All Implemented Interfaces:

Map<String,Object>

public final class ConfigurationParameters
extends Object
implements Map<String,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

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(String key) Returns true if this instance contains a configuration entry with the specified key irrespective of the defined value; false otherwise.
boolean	containsKey(Object key)
boolean	containsValue(Object value)
Set<Map.Entry<String,Object>>	entrySet()
Object	get(Object key)
<T> T	getConfigValue(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(String key, T defaultValue, 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()
Set<String>	keySet()
static ConfigurationParameters	of(ConfigurationParameters... params) Creates a new configuration parameters instance by merging all params sequentially.
static ConfigurationParameters	of(Dictionary<String,Object> properties) Creates new a configuration parameters instance by copying the given properties.
static ConfigurationParameters	of(Map<?,?> map) Creates new a configuration parameters instance by copying the given map.
static ConfigurationParameters	of(Properties properties) Creates new a configuration parameters instance by copying the given properties.
static ConfigurationParameters	of(String key, Object value) Creates new a single valued configuration parameters instance from the given key and value.
static ConfigurationParameters	of(String key1, Object value1, String key2, Object value2) Creates new a configuration parameters instance from the given key and value pairs.
Object	put(String key, Object value)
void	putAll(Map<? extends String,?> m)
Object	remove(Object key)
int	size()
Collection<Object>	values()

Methods inherited from class java.lang.Object

clone, equals, finalize, 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

@Nonnull
public static ConfigurationParameters of(@Nonnull
                                                  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

@Nonnull
public static ConfigurationParameters of(@Nonnull
                                                  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

@Nonnull
public static ConfigurationParameters of(@Nonnull
                                                  Dictionary<String,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

@Nonnull
public static ConfigurationParameters of(@Nonnull
                                                  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

@Nonnull
public static ConfigurationParameters of(@Nonnull
                                                  String key,
                                                  @Nonnull
                                                  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

@Nonnull
public static ConfigurationParameters of(@Nonnull
                                                  String key1,
                                                  @Nonnull
                                                  Object value1,
                                                  @Nonnull
                                                  String key2,
                                                  @Nonnull
                                                  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(@Nonnull
                        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

@CheckForNull
public <T> T getConfigValue(@Nonnull
                                          String key,
                                          @Nullable
                                          T defaultValue,
                                          @Nullable
                                          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

@Nonnull
public <T> T getConfigValue(@Nonnull
                                     String key,
                                     @Nonnull
                                     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 Map<String,Object>

isEmpty

public boolean isEmpty()

Specified by:

isEmpty in interface Map<String,Object>

containsKey

public boolean containsKey(Object key)

Specified by:

containsKey in interface Map<String,Object>

containsValue

public boolean containsValue(Object value)

Specified by:

containsValue in interface Map<String,Object>

get

public Object get(Object key)

Specified by:

get in interface Map<String,Object>

put

public Object put(String key,
                  Object value)

Specified by:

put in interface Map<String,Object>

remove

public Object remove(Object key)

Specified by:

remove in interface Map<String,Object>

putAll

public void putAll(@Nonnull
                   Map<? extends String,?> m)

Specified by:

putAll in interface Map<String,Object>

clear

public void clear()

Specified by:

clear in interface Map<String,Object>

keySet

@Nonnull
public Set<String> keySet()

Specified by:

keySet in interface Map<String,Object>

values

@Nonnull
public Collection<Object> values()

Specified by:

values in interface Map<String,Object>

entrySet

@Nonnull
public Set<Map.Entry<String,Object>> entrySet()

Specified by:

entrySet in interface Map<String,Object>