org.hibernate.internal.util.config

Class ConfigurationHelper

java.lang.Object

org.hibernate.internal.util.config.ConfigurationHelper

public final class ConfigurationHelper
extends java.lang.Object

Collection of helper methods for dealing with configuration settings.

Method Summary

Modifier and Type	Method and Description
static java.util.Map	clone(java.util.Map<?,?> configurationValues) Make a clone of the configuration values.
static java.lang.String	extractPropertyValue(java.lang.String propertyName, java.util.Map properties) Extract a property value by name from the given properties object.
static java.lang.String	extractPropertyValue(java.lang.String propertyName, java.util.Properties properties) Extract a property value by name from the given properties object.
static boolean	getBoolean(java.lang.String name, java.util.Map values) Get the config value as a boolean (default of false)
static boolean	getBoolean(java.lang.String name, java.util.Map values, boolean defaultValue) Get the config value as a boolean.
static java.lang.Boolean	getBooleanWrapper(java.lang.String name, java.util.Map values, java.lang.Boolean defaultValue) Get the config value as a boolean (default of false)
static int	getInt(java.lang.String name, java.util.Map values, int defaultValue) Get the config value as an int
static java.lang.Integer	getInteger(java.lang.String name, java.util.Map values) Get the config value as an Integer
static long	getLong(java.lang.String name, java.util.Map values, int defaultValue)
static java.lang.String	getString(java.lang.String name, java.util.Map values) Get the config value as a String
static java.lang.String	getString(java.lang.String name, java.util.Map values, java.lang.String defaultValue) Get the config value as a String
static java.lang.String	getString(java.lang.String name, java.util.Map values, java.lang.String defaultValue, java.lang.String... otherSupportedValues) Get the config value as a String.
static java.util.Properties	maskOut(java.util.Properties props, java.lang.String key) replace a property by a starred version
static java.lang.String	resolvePlaceHolder(java.lang.String property) Handles interpolation processing for a single property.
static void	resolvePlaceHolders(java.util.Map<?,?> configurationValues) Handles interpolation processing for all entries in a properties object.
static java.util.Map	toMap(java.lang.String propertyName, java.lang.String delim, java.util.Map properties) Constructs a map from a property value.
static java.util.Map	toMap(java.lang.String propertyName, java.lang.String delim, java.util.Properties properties) Constructs a map from a property value.
static java.lang.String[]	toStringArray(java.lang.String stringForm, java.lang.String delim) Convert a string to an array of strings.
static java.lang.String[]	toStringArray(java.lang.String propertyName, java.lang.String delim, java.util.Properties properties) Get a property value as a string array.

Methods inherited from class java.lang.Object

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

Method Detail

getString

public static java.lang.String getString(java.lang.String name,
                                         java.util.Map values)

Get the config value as a String

Parameters:

name - The config setting name.

values - The map of config values

Returns:

The value, or null if not found

getString

public static java.lang.String getString(java.lang.String name,
                                         java.util.Map values,
                                         java.lang.String defaultValue)

Get the config value as a String

Parameters:

name - The config setting name.

values - The map of config values

defaultValue - The default value to use if not found

Returns:

The value.

getString

public static java.lang.String getString(java.lang.String name,
                                         java.util.Map values,
                                         java.lang.String defaultValue,
                                         java.lang.String... otherSupportedValues)

Get the config value as a String.

Parameters:

name - The config setting name.

values - The map of config parameters.

defaultValue - The default value to use if not found.

otherSupportedValues - List of other supported values. Does not need to contain the default one.

Returns:

The value.

Throws:

ConfigurationException - Unsupported value provided.

getBoolean

public static boolean getBoolean(java.lang.String name,
                                 java.util.Map values)

Get the config value as a boolean (default of false)

Parameters:

name - The config setting name.

values - The map of config values

Returns:

The value.

getBoolean

public static boolean getBoolean(java.lang.String name,
                                 java.util.Map values,
                                 boolean defaultValue)

Get the config value as a boolean.

Parameters:

name - The config setting name.

values - The map of config values

defaultValue - The default value to use if not found

Returns:

The value.

getBooleanWrapper

public static java.lang.Boolean getBooleanWrapper(java.lang.String name,
                                                  java.util.Map values,
                                                  java.lang.Boolean defaultValue)

Get the config value as a boolean (default of false)

Parameters:

name - The config setting name.

values - The map of config values

Returns:

The value.

getInt

public static int getInt(java.lang.String name,
                         java.util.Map values,
                         int defaultValue)

Get the config value as an int

Parameters:

name - The config setting name.

values - The map of config values

defaultValue - The default value to use if not found

Returns:

The value.

getInteger

public static java.lang.Integer getInteger(java.lang.String name,
                                           java.util.Map values)

Get the config value as an Integer

Parameters:

name - The config setting name.

values - The map of config values

Returns:

The value, or null if not found

getLong

public static long getLong(java.lang.String name,
                           java.util.Map values,
                           int defaultValue)

clone

public static java.util.Map clone(java.util.Map<?,?> configurationValues)

Make a clone of the configuration values.

Parameters:

configurationValues - The config values to clone

Returns:

The clone

maskOut

public static java.util.Properties maskOut(java.util.Properties props,
                                           java.lang.String key)

replace a property by a starred version

Parameters:

props - properties to check

key - proeprty to mask

Returns:

cloned and masked properties

extractPropertyValue

public static java.lang.String extractPropertyValue(java.lang.String propertyName,
                                                    java.util.Properties properties)

Extract a property value by name from the given properties object.

Both null and empty string are viewed as the same, and return null.

Parameters:

propertyName - The name of the property for which to extract value

properties - The properties object

Returns:

The property value; may be null.

extractPropertyValue

public static java.lang.String extractPropertyValue(java.lang.String propertyName,
                                                    java.util.Map properties)

Extract a property value by name from the given properties object.

Both null and empty string are viewed as the same, and return null.

Parameters:

propertyName - The name of the property for which to extract value

properties - The properties object

Returns:

The property value; may be null.

toMap

public static java.util.Map toMap(java.lang.String propertyName,
                                  java.lang.String delim,
                                  java.util.Properties properties)

Constructs a map from a property value.

The exact behavior here is largely dependant upon what is passed in as the delimiter.

Parameters:

propertyName - The name of the property for which to retrieve value

delim - The string defining tokens used as both entry and key/value delimiters.

properties - The properties object

Returns:

The resulting map; never null, though perhaps empty.

See Also:

extractPropertyValue(String, java.util.Properties)

toMap

public static java.util.Map toMap(java.lang.String propertyName,
                                  java.lang.String delim,
                                  java.util.Map properties)

Constructs a map from a property value.

The exact behavior here is largely dependant upon what is passed in as the delimiter.

Parameters:

propertyName - The name of the property for which to retrieve value

delim - The string defining tokens used as both entry and key/value delimiters.

properties - The properties object

Returns:

The resulting map; never null, though perhaps empty.

See Also:

extractPropertyValue(String, java.util.Properties)

toStringArray

public static java.lang.String[] toStringArray(java.lang.String propertyName,
                                               java.lang.String delim,
                                               java.util.Properties properties)

Get a property value as a string array.

Parameters:

propertyName - The name of the property for which to retrieve value

delim - The delimiter used to separate individual array elements.

properties - The properties object

Returns:

The array; never null, though may be empty.

See Also:

extractPropertyValue(String, java.util.Properties), toStringArray(String, String)

toStringArray

public static java.lang.String[] toStringArray(java.lang.String stringForm,
                                               java.lang.String delim)

Convert a string to an array of strings. The assumption is that the individual array elements are delimited in the source stringForm param by the delim param.

Parameters:

stringForm - The string form of the string array.

delim - The delimiter used to separate individual array elements.

Returns:

The array; never null, though may be empty.

resolvePlaceHolders

public static void resolvePlaceHolders(java.util.Map<?,?> configurationValues)

Handles interpolation processing for all entries in a properties object.

Parameters:

configurationValues - The configuration map.

resolvePlaceHolder

public static java.lang.String resolvePlaceHolder(java.lang.String property)

Handles interpolation processing for a single property.

Parameters:

property - The property value to be processed for interpolation.

Returns:

The (possibly) interpolated property value.