java.lang.Object
- com.saperion.common.config.manager.DbConfigurationManager<CommonAccessException>

Type Parameters:

CommonAccessException - the common access exception type of the underlying DataSource and so of the DbConfigurationManager to be created.
```
public class DbConfigurationManager<CommonAccessException extends java.lang.Exception>
extends java.lang.Object
```
The DbConfigurationManager manages configuration values in a database table and an in-memory cache.

One must specify a DataSource. One can set a different table name. One can create the table if it does not exist.

A configuration value is basically a String. There are several methods for conversion of other values to string during get() and set() and it is highly recommended to rely on these specialized get()-methods and according objects it set() and not to convert them in the business code by yourself. These classes are supported:
- String
- Guid
- Integer
- Long
- Decimal
- Float
- Double
- Boolean
- Date
- Binary
A configuration value can be null. This is treated as a valid value and it is a difference, whether a configuration value not exists or exists and is set to null. For Strings null and an empty String both are stored as null. All get()-methods will return null in this case. So there is (intentionally) no way to store an empty String.

A configuration value is identified by a key that is a HierarchicalName. It is highly recommended to group your configuration values according to their sense and common usage the same way as you group java-classes into packages. All configuration values that belong to the same sub-tree can be loaded together.

The get()-methods have an optional StorageType-parameter, that controls whether a configuration value should be loaded from the database, from the in-memory cache or from the database only if it is not found in the in-memory cache. The methods without the StorageType-parameter behave like StorageType.DEFAULT, i.e. they use the StorageType that was specified to use as the default during construction of the DbConfigurationManager (@see DbConfigurationManagerConstructorParameters.setDefaultStorageType(StorageType)).

Usual approaches are:
- Simply use the get()-methods with StorageType.DB_IF_NOTHING_IN_MEMORY if there are only a few configuration values at all.
- Load a whole hierarchy of configuration values at some initialization point and use them later with StorageType.MEMORY or StorageType.DB_IF_NOTHING_IN_MEMORY.
A root name can be provided in which case all entry-keys will start with this root name. If the key specified as a method parameter already starts with the root name it will be used unchanged, else the parameter will be added to the root name before use.

The configuration values can be encrypted/decrypted automatically. Simply specify a Cipher and Pair of Keys .

One can fine-tune what should happen if a requested configuration value is not found.

This DbConfigurationManager does no transaction handling. It simple executes its SQL-statements and relies on a suitable surrounding transaction management. If used in a JEE-container this is usually exactly the desired behavior. If used in a stand-alone application, one should care about the transaction around the invocations of methods of this class.

Apart from transactional aspects the methods are synchronized, so an instance of this DbConfigurationManager can be used in several threads concurrently.
Author:

agz

See Also:

DbConfigurationManagerConstructorParameters, StorageType, NotFoundReactionType, DataSource, Cipher

Field Summary

Fields
Modifier and Type	Field	Description
`static int`	`NAME_MAX_LENGTH`	The maximum string length (`toString()`-result) of a `HierarchicalName` to be used as a key by this `DbConfigurationManager`.
`static java.lang.String`	`TABLE_NAME_REGEX`	The regular expression, a table name must match.
`static int`	`VALUE_MAX_LENGTH`	The maximum string length of the serialized (and if encryption is active encrypted) representation of a configuration value to be used by this `DbConfigurationManager`.

Constructor Summary

Constructors
Constructor	Description
`DbConfigurationManager(DbConfigurationManagerConstructorParameters<CommonAccessException> parameters)`	Creates a new `DbConfigurationManager` with the specified `DbConfigurationManagerConstructorParameters`.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method	Description
`void`	`createTableIfNotExistent()`	Tries to find out whether the underlying database table exists and if not so to create it by executing an SQL-CREATE-TABLE-statement.
`int`	`delete(HierarchicalName hierarchicalName, boolean includingSubvalues)`	Deletes the configuration value for the specified `HierarchicalName` from the database and internal cache.
`boolean`	`exists(HierarchicalName hierarchicalName)`	Tests whether a configuration value with the specified `HierarchicalName` exists.
`boolean`	`exists(HierarchicalName hierarchicalName, StorageType storageType)`	Tests whether a configuration value with the specified `HierarchicalName` exists.
`Binary`	`getBinary(HierarchicalName hierarchicalName)`	Gets the configuration value with the specified `HierarchicalName` and converts it to a `Binary`.
`Binary`	`getBinary(HierarchicalName hierarchicalName, StorageType storageType)`	Gets the configuration value with the specified `HierarchicalName` and converts it to a `Binary`.
`java.lang.Boolean`	`getBoolean(HierarchicalName hierarchicalName)`	Gets the configuration value with the specified `HierarchicalName` and converts it to a `Boolean`.
`java.lang.Boolean`	`getBoolean(HierarchicalName hierarchicalName, StorageType storageType)`	Gets the configuration value with the specified `HierarchicalName` and converts it to a `Boolean`.
`java.util.Date`	`getDateTime(HierarchicalName hierarchicalName)`	Gets the configuration value with the specified `HierarchicalName` and converts it to a `Date`.
`java.util.Date`	`getDateTime(HierarchicalName hierarchicalName, StorageType storageType)`	Gets the configuration value with the specified `HierarchicalName` and converts it to a `Date`.
`Decimal`	`getDecimal(HierarchicalName hierarchicalName)`	Gets the configuration value with the specified `HierarchicalName` and converts it to a `Decimal`.
`Decimal`	`getDecimal(HierarchicalName hierarchicalName, StorageType storageType)`	Gets the configuration value with the specified `HierarchicalName` and converts it to a `Decimal`.
`java.lang.Double`	`getDouble(HierarchicalName hierarchicalName)`	Gets the configuration value with the specified `HierarchicalName` and converts it to a `Double`.
`java.lang.Double`	`getDouble(HierarchicalName hierarchicalName, StorageType storageType)`	Gets the configuration value with the specified `HierarchicalName` and converts it to a `Double`.
`java.lang.Float`	`getFloat(HierarchicalName hierarchicalName)`	Gets the configuration value with the specified `HierarchicalName` and converts it to a `Float`.
`java.lang.Float`	`getFloat(HierarchicalName hierarchicalName, StorageType storageType)`	Gets the configuration value with the specified `HierarchicalName` and converts it to a `Float`.
`java.util.Collection<HierarchicalName>`	`getHierarchicalNames(HierarchicalName hierarchicalName)`	Gets a `Collection` of all `HierarchicalName`s that `starts with` the specified `HierarchicalName`.
`java.util.Collection<HierarchicalName>`	`getHierarchicalNames(HierarchicalName hierarchicalName, StorageType storageType)`	Gets a `Collection` of all `HierarchicalName`s that `starts with` the specified `HierarchicalName`.
`Guid`	`getId(HierarchicalName hierarchicalName)`	Gets the configuration value with the specified `HierarchicalName` and converts it to a `Guid`.
`Guid`	`getId(HierarchicalName hierarchicalName, StorageType storageType)`	Gets the configuration value with the specified `HierarchicalName` and converts it to a `Guid`.
`java.lang.Integer`	`getInteger(HierarchicalName hierarchicalName)`	Gets the configuration value with the specified `HierarchicalName` and converts it to an `Integer`.
`java.lang.Integer`	`getInteger(HierarchicalName hierarchicalName, StorageType storageType)`	Gets the configuration value with the specified `HierarchicalName` and converts it to an `Integer`.
`java.lang.Long`	`getLong(HierarchicalName hierarchicalName)`	Gets the configuration value with the specified `HierarchicalName` and converts it to a `Long`.
`java.lang.Long`	`getLong(HierarchicalName hierarchicalName, StorageType storageType)`	Gets the configuration value with the specified `HierarchicalName` and converts it to a `Long`.
`java.lang.String`	`getString(HierarchicalName hierarchicalName)`	Gets the configuration value with the specified `HierarchicalName`.
`java.lang.String`	`getString(HierarchicalName hierarchicalName, StorageType storageType)`	Gets the configuration value with the specified `HierarchicalName`.
`void`	`load(HierarchicalName hierarchicalName)`	Loads the configuration value for the specified `HierarchicalName` from the database and stores it into the internal cache.
`void`	`load(HierarchicalName hierarchicalName, boolean includingSubvalues)`	Loads the configuration value for the specified `HierarchicalName` from the database and stores it into the internal cache.
`void`	`set(HierarchicalName hierarchicalName, java.lang.Object value)`	Sets the configuration value with the specified `HierarchicalName`.
`void`	`set(java.util.Map<HierarchicalName,java.lang.Object> mapHierarchicalName2Value)`	Sets all the specified configuration values (values of the specified map) according to their specified `HierarchicalName`s (keys of the specified map.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - TABLE_NAME_REGEX
```
public static final java.lang.String TABLE_NAME_REGEX
```
    The regular expression, a table name must match.
    
    See Also:
    
    Constant Field Values
  - NAME_MAX_LENGTH
```
public static final int NAME_MAX_LENGTH
```
    The maximum string length (toString()-result) of a HierarchicalName to be used as a key by this DbConfigurationManager.
    
    See Also:
    
    Constant Field Values
  - VALUE_MAX_LENGTH
```
public static final int VALUE_MAX_LENGTH
```
    The maximum string length of the serialized (and if encryption is active encrypted) representation of a configuration value to be used by this DbConfigurationManager.
    
    See Also:
    
    Constant Field Values
- Constructor Detail
  - DbConfigurationManager
```
public DbConfigurationManager(DbConfigurationManagerConstructorParameters<CommonAccessException> parameters)
```
    Creates a new DbConfigurationManager with the specified DbConfigurationManagerConstructorParameters.
    The specified DbConfigurationManagerConstructorParameters must not be null.
    
    Parameters:
    
    parameters - DbConfigurationManagerConstructorParameters
- Method Detail
  - createTableIfNotExistent
```
public void createTableIfNotExistent()
                              throws CommonAccessException extends java.lang.Exception
```
    Tries to find out whether the underlying database table exists and if not so to create it by executing an SQL-CREATE-TABLE-statement.
    This method does not analyze whether an existing database table is correct.
    
    Throws:
    
    java.lang.IllegalStateException - on errors during the existence check
    
    CommonAccessException - on errors during creation of the table
    
    CommonAccessException extends java.lang.Exception
  - delete
```
public int delete(HierarchicalName hierarchicalName,
                  boolean includingSubvalues)
           throws CommonAccessException extends java.lang.Exception
```
    Deletes the configuration value for the specified HierarchicalName from the database and internal cache.
    If specified to include sub-values all configuration values that names start with the specified HierarchicalName are deleted.
    The specified HierarchicalName must not be null.
    
    Parameters:
    
    hierarchicalName - HierarchicalName
    
    includingSubvalues - whether to include sub-values
    
    Returns:
    
    count of manipulated rows
    
    Throws:
    
    CommonAccessException - on errors during db-operations
    
    CommonAccessException extends java.lang.Exception
  - load
```
public void load(HierarchicalName hierarchicalName,
                 boolean includingSubvalues)
          throws CommonAccessException extends java.lang.Exception
```
    Loads the configuration value for the specified HierarchicalName from the database and stores it into the internal cache.
    If specified to include sub-values all configuration values that names start with the specified HierarchicalName are loaded.
    The specified HierarchicalName must not be null.
    
    Parameters:
    
    hierarchicalName - HierarchicalName
    
    includingSubvalues - whether to include sub-values
    
    Throws:
    
    CommonAccessException - on errors during db-operations
    
    CommonAccessException extends java.lang.Exception
  - load
```
public void load(HierarchicalName hierarchicalName)
          throws CommonAccessException extends java.lang.Exception
```
    Loads the configuration value for the specified HierarchicalName from the database and stores it into the internal cache.
    The specified HierarchicalName must not be null.
    
    Parameters:
    
    hierarchicalName - HierarchicalName
    
    Throws:
    
    CommonAccessException - on errors during db-operations
    
    CommonAccessException extends java.lang.Exception
  - exists
```
public boolean exists(HierarchicalName hierarchicalName,
                      StorageType storageType)
               throws CommonAccessException extends java.lang.Exception
```
    Tests whether a configuration value with the specified HierarchicalName exists.
    The operation is executed according to the specified StorageType.
    The specified HierarchicalName must not be null.
    The specified StorageType must not be null.
    
    Parameters:
    
    hierarchicalName - HierarchicalName
    
    storageType - StorageType
    
    Returns:
    
    whether such a configuration value exists
    
    Throws:
    
    CommonAccessException - on errors during db-operations
    
    CommonAccessException extends java.lang.Exception
  - exists
```
public boolean exists(HierarchicalName hierarchicalName)
               throws CommonAccessException extends java.lang.Exception
```
    Tests whether a configuration value with the specified HierarchicalName exists.
    The operation is executed according to the default StorageType configured during construction of this DbConfigurationManager.
    The specified HierarchicalName must not be null.
    
    Parameters:
    
    hierarchicalName - HierarchicalName
    
    Returns:
    
    whether such a configuration value exists
    
    Throws:
    
    CommonAccessException - on errors during db-operations
    
    CommonAccessException extends java.lang.Exception
  - getHierarchicalNames
```
public java.util.Collection<HierarchicalName> getHierarchicalNames(HierarchicalName hierarchicalName,
                                                                   StorageType storageType)
                                                            throws CommonAccessException extends java.lang.Exception
```
    Gets a Collection of all HierarchicalNames that starts with the specified HierarchicalName.
    The operation is executed according to the specified StorageType. StorageType.DB_IF_NOTHING_IN_MEMORY is treated equally to StorageType.DB in this method to avoid incomplete results.
    If no such value is found an empty Collection will be returned.
    The specified HierarchicalName must not be null.
    The specified StorageType must not be null.
    
    Parameters:
    
    hierarchicalName - HierarchicalName all results will start with
    
    storageType - StorageType
    
    Returns:
    
    Collection of HierarchicalNames
    
    Throws:
    
    CommonAccessException - on errors during db-operations
    
    CommonAccessException extends java.lang.Exception
  - getHierarchicalNames
```
public java.util.Collection<HierarchicalName> getHierarchicalNames(HierarchicalName hierarchicalName)
                                                            throws CommonAccessException extends java.lang.Exception
```
    Gets a Collection of all HierarchicalNames that starts with the specified HierarchicalName.
    The operation is executed according to the default StorageType configured during construction of this DbConfigurationManager.
    If no such value is found an empty Collection will be returned.
    The specified HierarchicalName must not be null.
    
    Parameters:
    
    hierarchicalName - HierarchicalName all results will start with
    
    Returns:
    
    Collection of HierarchicalNames
    
    Throws:
    
    CommonAccessException - on errors during db-operations
    
    CommonAccessException extends java.lang.Exception
  - getString
```
public java.lang.String getString(HierarchicalName hierarchicalName,
                                  StorageType storageType)
                           throws CommonAccessException extends java.lang.Exception
```
    Gets the configuration value with the specified HierarchicalName.
    The operation is executed according to the specified StorageType.
    If no such value is found, the behavior is defined by the NotFoundReactionType specified during construction of this DbConfigurationManager.
    The specified HierarchicalName must not be null.
    The specified StorageType must not be null.
    
    Parameters:
    
    hierarchicalName - HierarchicalName
    
    storageType - StorageType
    
    Returns:
    
    the configuration value
    
    Throws:
    
    CommonAccessException - on errors during db-operations
    
    CommonAccessException extends java.lang.Exception
  - getString
```
public java.lang.String getString(HierarchicalName hierarchicalName)
                           throws CommonAccessException extends java.lang.Exception
```
    Gets the configuration value with the specified HierarchicalName.
    The operation is executed according to the default StorageType configured during construction of this DbConfigurationManager.
    If no such value is found, the behavior is defined by the NotFoundReactionType specified during construction of this DbConfigurationManager.
    The specified HierarchicalName must not be null.
    
    Parameters:
    
    hierarchicalName - HierarchicalName
    
    Returns:
    
    the configuration value
    
    Throws:
    
    CommonAccessException - on errors during db-operations
    
    CommonAccessException extends java.lang.Exception
  - getId
```
public final Guid getId(HierarchicalName hierarchicalName,
                        StorageType storageType)
                 throws CommonAccessException extends java.lang.Exception
```
    Gets the configuration value with the specified HierarchicalName and converts it to a Guid.
    The operation is executed according to the specified StorageType.
    If no such value is found, the behavior is defined by the NotFoundReactionType specified during construction of this DbConfigurationManager.
    The specified HierarchicalName must not be null.
    The specified StorageType must not be null.
    
    Parameters:
    
    hierarchicalName - HierarchicalName
    
    storageType - StorageType
    
    Returns:
    
    the configuration value
    
    Throws:
    
    CommonAccessException - on errors during db-operations
    
    CommonAccessException extends java.lang.Exception
  - getId
```
public final Guid getId(HierarchicalName hierarchicalName)
                 throws CommonAccessException extends java.lang.Exception
```
    Gets the configuration value with the specified HierarchicalName and converts it to a Guid.
    The operation is executed according to the default StorageType configured during construction of this DbConfigurationManager.
    If no such value is found, the behavior is defined by the NotFoundReactionType specified during construction of this DbConfigurationManager.
    The specified HierarchicalName must not be null.
    
    Parameters:
    
    hierarchicalName - HierarchicalName
    
    Returns:
    
    the configuration value
    
    Throws:
    
    CommonAccessException - on errors during db-operations
    
    CommonAccessException extends java.lang.Exception
  - getInteger
```
public final java.lang.Integer getInteger(HierarchicalName hierarchicalName,
                                          StorageType storageType)
                                   throws CommonAccessException extends java.lang.Exception
```
    Gets the configuration value with the specified HierarchicalName and converts it to an Integer.
    The operation is executed according to the specified StorageType.
    If no such value is found, the behavior is defined by the NotFoundReactionType specified during construction of this DbConfigurationManager.
    The specified HierarchicalName must not be null.
    The specified StorageType must not be null.
    
    Parameters:
    
    hierarchicalName - HierarchicalName
    
    storageType - StorageType
    
    Returns:
    
    the configuration value
    
    Throws:
    
    CommonAccessException - on errors during db-operations
    
    CommonAccessException extends java.lang.Exception
  - getInteger
```
public final java.lang.Integer getInteger(HierarchicalName hierarchicalName)
                                   throws CommonAccessException extends java.lang.Exception
```
    Gets the configuration value with the specified HierarchicalName and converts it to an Integer.
    The operation is executed according to the default StorageType configured during construction of this DbConfigurationManager.
    If no such value is found, the behavior is defined by the NotFoundReactionType specified during construction of this DbConfigurationManager.
    The specified HierarchicalName must not be null.
    
    Parameters:
    
    hierarchicalName - HierarchicalName
    
    Returns:
    
    the configuration value
    
    Throws:
    
    CommonAccessException - on errors during db-operations
    
    CommonAccessException extends java.lang.Exception
  - getLong
```
public final java.lang.Long getLong(HierarchicalName hierarchicalName,
                                    StorageType storageType)
                             throws CommonAccessException extends java.lang.Exception
```
    Gets the configuration value with the specified HierarchicalName and converts it to a Long.
    The operation is executed according to the specified StorageType.
    If no such value is found, the behavior is defined by the NotFoundReactionType specified during construction of this DbConfigurationManager.
    The specified HierarchicalName must not be null.
    The specified StorageType must not be null.
    
    Parameters:
    
    hierarchicalName - HierarchicalName
    
    storageType - StorageType
    
    Returns:
    
    the configuration value
    
    Throws:
    
    CommonAccessException - on errors during db-operations
    
    CommonAccessException extends java.lang.Exception
  - getLong
```
public final java.lang.Long getLong(HierarchicalName hierarchicalName)
                             throws CommonAccessException extends java.lang.Exception
```
    Gets the configuration value with the specified HierarchicalName and converts it to a Long.
    The operation is executed according to the default StorageType configured during construction of this DbConfigurationManager.
    If no such value is found, the behavior is defined by the NotFoundReactionType specified during construction of this DbConfigurationManager.
    The specified HierarchicalName must not be null.
    
    Parameters:
    
    hierarchicalName - HierarchicalName
    
    Returns:
    
    the configuration value
    
    Throws:
    
    CommonAccessException - on errors during db-operations
    
    CommonAccessException extends java.lang.Exception
  - getDecimal
```
public final Decimal getDecimal(HierarchicalName hierarchicalName,
                                StorageType storageType)
                         throws CommonAccessException extends java.lang.Exception
```
    Gets the configuration value with the specified HierarchicalName and converts it to a Decimal.
    The operation is executed according to the specified StorageType.
    If no such value is found, the behavior is defined by the NotFoundReactionType specified during construction of this DbConfigurationManager.
    The specified HierarchicalName must not be null.
    The specified StorageType must not be null.
    
    Parameters:
    
    hierarchicalName - HierarchicalName
    
    storageType - StorageType
    
    Returns:
    
    the configuration value
    
    Throws:
    
    CommonAccessException - on errors during db-operations
    
    CommonAccessException extends java.lang.Exception
  - getDecimal
```
public final Decimal getDecimal(HierarchicalName hierarchicalName)
                         throws CommonAccessException extends java.lang.Exception
```
    Gets the configuration value with the specified HierarchicalName and converts it to a Decimal.
    The operation is executed according to the default StorageType configured during construction of this DbConfigurationManager.
    If no such value is found, the behavior is defined by the NotFoundReactionType specified during construction of this DbConfigurationManager.
    The specified HierarchicalName must not be null.
    
    Parameters:
    
    hierarchicalName - HierarchicalName
    
    Returns:
    
    the configuration value
    
    Throws:
    
    CommonAccessException - on errors during db-operations
    
    CommonAccessException extends java.lang.Exception
  - getFloat
```
public final java.lang.Float getFloat(HierarchicalName hierarchicalName,
                                      StorageType storageType)
                               throws CommonAccessException extends java.lang.Exception
```
    Gets the configuration value with the specified HierarchicalName and converts it to a Float.
    The operation is executed according to the specified StorageType.
    If no such value is found, the behavior is defined by the NotFoundReactionType specified during construction of this DbConfigurationManager.
    The specified HierarchicalName must not be null.
    The specified StorageType must not be null.
    
    Parameters:
    
    hierarchicalName - HierarchicalName
    
    storageType - StorageType
    
    Returns:
    
    the configuration value
    
    Throws:
    
    CommonAccessException - on errors during db-operations
    
    CommonAccessException extends java.lang.Exception
  - getFloat
```
public final java.lang.Float getFloat(HierarchicalName hierarchicalName)
                               throws CommonAccessException extends java.lang.Exception
```
    Gets the configuration value with the specified HierarchicalName and converts it to a Float.
    The operation is executed according to the default StorageType configured during construction of this DbConfigurationManager.
    If no such value is found, the behavior is defined by the NotFoundReactionType specified during construction of this DbConfigurationManager.
    The specified HierarchicalName must not be null.
    
    Parameters:
    
    hierarchicalName - HierarchicalName
    
    Returns:
    
    the configuration value
    
    Throws:
    
    CommonAccessException - on errors during db-operations
    
    CommonAccessException extends java.lang.Exception
  - getDouble
```
public final java.lang.Double getDouble(HierarchicalName hierarchicalName,
                                        StorageType storageType)
                                 throws CommonAccessException extends java.lang.Exception
```
    Gets the configuration value with the specified HierarchicalName and converts it to a Double.
    The operation is executed according to the specified StorageType.
    If no such value is found, the behavior is defined by the NotFoundReactionType specified during construction of this DbConfigurationManager.
    The specified HierarchicalName must not be null.
    The specified StorageType must not be null.
    
    Parameters:
    
    hierarchicalName - HierarchicalName
    
    storageType - StorageType
    
    Returns:
    
    the configuration value
    
    Throws:
    
    CommonAccessException - on errors during db-operations
    
    CommonAccessException extends java.lang.Exception
  - getDouble
```
public final java.lang.Double getDouble(HierarchicalName hierarchicalName)
                                 throws CommonAccessException extends java.lang.Exception
```
    Gets the configuration value with the specified HierarchicalName and converts it to a Double.
    The operation is executed according to the default StorageType configured during construction of this DbConfigurationManager.
    If no such value is found, the behavior is defined by the NotFoundReactionType specified during construction of this DbConfigurationManager.
    The specified HierarchicalName must not be null.
    
    Parameters:
    
    hierarchicalName - HierarchicalName
    
    Returns:
    
    the configuration value
    
    Throws:
    
    CommonAccessException - on errors during db-operations
    
    CommonAccessException extends java.lang.Exception
  - getBoolean
```
public final java.lang.Boolean getBoolean(HierarchicalName hierarchicalName,
                                          StorageType storageType)
                                   throws CommonAccessException extends java.lang.Exception
```
    Gets the configuration value with the specified HierarchicalName and converts it to a Boolean.
    The operation is executed according to the specified StorageType.
    If no such value is found, the behavior is defined by the NotFoundReactionType specified during construction of this DbConfigurationManager.
    The specified HierarchicalName must not be null.
    The specified StorageType must not be null.
    
    Parameters:
    
    hierarchicalName - HierarchicalName
    
    storageType - StorageType
    
    Returns:
    
    the configuration value
    
    Throws:
    
    CommonAccessException - on errors during db-operations
    
    CommonAccessException extends java.lang.Exception
  - getBoolean
```
public final java.lang.Boolean getBoolean(HierarchicalName hierarchicalName)
                                   throws CommonAccessException extends java.lang.Exception
```
    Gets the configuration value with the specified HierarchicalName and converts it to a Boolean.
    The operation is executed according to the default StorageType configured during construction of this DbConfigurationManager.
    If no such value is found, the behavior is defined by the NotFoundReactionType specified during construction of this DbConfigurationManager.
    The specified HierarchicalName must not be null.
    
    Parameters:
    
    hierarchicalName - HierarchicalName
    
    Returns:
    
    the configuration value
    
    Throws:
    
    CommonAccessException - on errors during db-operations
    
    CommonAccessException extends java.lang.Exception
  - getDateTime
```
public final java.util.Date getDateTime(HierarchicalName hierarchicalName,
                                        StorageType storageType)
                                 throws CommonAccessException extends java.lang.Exception
```
    Gets the configuration value with the specified HierarchicalName and converts it to a Date.
    The operation is executed according to the specified StorageType.
    If no such value is found, the behavior is defined by the NotFoundReactionType specified during construction of this DbConfigurationManager.
    The specified HierarchicalName must not be null.
    The specified StorageType must not be null.
    
    Parameters:
    
    hierarchicalName - HierarchicalName
    
    storageType - StorageType
    
    Returns:
    
    the configuration value
    
    Throws:
    
    CommonAccessException - on errors during db-operations
    
    CommonAccessException extends java.lang.Exception
  - getDateTime
```
public final java.util.Date getDateTime(HierarchicalName hierarchicalName)
                                 throws CommonAccessException extends java.lang.Exception
```
    Gets the configuration value with the specified HierarchicalName and converts it to a Date.
    The operation is executed according to the default StorageType configured during construction of this DbConfigurationManager.
    If no such value is found, the behavior is defined by the NotFoundReactionType specified during construction of this DbConfigurationManager.
    The specified HierarchicalName must not be null.
    
    Parameters:
    
    hierarchicalName - HierarchicalName
    
    Returns:
    
    the configuration value
    
    Throws:
    
    CommonAccessException - on errors during db-operations
    
    CommonAccessException extends java.lang.Exception
  - getBinary
```
public final Binary getBinary(HierarchicalName hierarchicalName,
                              StorageType storageType)
                       throws CommonAccessException extends java.lang.Exception
```
    Gets the configuration value with the specified HierarchicalName and converts it to a Binary.
    The operation is executed according to the specified StorageType.
    If no such value is found, the behavior is defined by the NotFoundReactionType specified during construction of this DbConfigurationManager.
    The specified HierarchicalName must not be null.
    The specified StorageType must not be null.
    
    Parameters:
    
    hierarchicalName - HierarchicalName
    
    storageType - StorageType
    
    Returns:
    
    the configuration value
    
    Throws:
    
    CommonAccessException - on errors during db-operations
    
    CommonAccessException extends java.lang.Exception
  - getBinary
```
public final Binary getBinary(HierarchicalName hierarchicalName)
                       throws CommonAccessException extends java.lang.Exception
```
    Gets the configuration value with the specified HierarchicalName and converts it to a Binary.
    The operation is executed according to the default StorageType configured during construction of this DbConfigurationManager.
    If no such value is found, the behavior is defined by the NotFoundReactionType specified during construction of this DbConfigurationManager.
    The specified HierarchicalName must not be null.
    
    Parameters:
    
    hierarchicalName - HierarchicalName
    
    Returns:
    
    the configuration value
    
    Throws:
    
    CommonAccessException - on errors during db-operations
    
    CommonAccessException extends java.lang.Exception
  - set
```
public void set(HierarchicalName hierarchicalName,
                java.lang.Object value)
         throws CommonAccessException extends java.lang.Exception
```
    Sets the configuration value with the specified HierarchicalName. Saves it both in the database and in the in-memory cache.
    The object must be one of the following:
    
    null
    
    String
    
    Guid
    
    Integer
    
    Long
    
    Decimal
    
    Float
    
    Double
    
    Boolean
    
    Date
    
    Binary
    
    The specified HierarchicalName must not be null.
    Parameters:
    
    hierarchicalName - HierarchicalName
    
    value - the configuration value
    
    Throws:
    
    CommonAccessException - on errors during db-operations
    
    CommonAccessException extends java.lang.Exception
  - set
```
public void set(java.util.Map<HierarchicalName,java.lang.Object> mapHierarchicalName2Value)
         throws CommonAccessException extends java.lang.Exception
```
    Sets all the specified configuration values (values of the specified map) according to their specified HierarchicalNames (keys of the specified map. Saves them both in the database and in the in-memory cache.
    Every value-object must be one of the following:
    
    null
    
    String
    
    Guid
    
    Integer
    
    Long
    
    Decimal
    
    Float
    
    Double
    
    Boolean
    
    Date
    
    Binary
    
    All the specified HierarchicalNames must not be null.
    The specified Map must not be null.
    Parameters:
    
    mapHierarchicalName2Value - Map of configuration values (key = HierarchicalName, value = configuration value ( Object))
    
    Throws:
    
    CommonAccessException - on errors during db-operations
    
    CommonAccessException extends java.lang.Exception

Class DbConfigurationManager<CommonAccessException extends java.lang.Exception>

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

TABLE_NAME_REGEX

NAME_MAX_LENGTH

VALUE_MAX_LENGTH

Constructor Detail

DbConfigurationManager

Method Detail

createTableIfNotExistent

delete

load

load

exists

exists

getHierarchicalNames

getHierarchicalNames

getString

getString

getId

getId

getInteger

getInteger

getLong

getLong

getDecimal

getDecimal

getFloat

getFloat

getDouble

getDouble

getBoolean

getBoolean

getDateTime

getDateTime

getBinary

getBinary

set

set