com.tangosol.coherence.config

Class Config

java.lang.Object

com.tangosol.coherence.config.Config

public abstract class Config
extends Object

Config is a helper class for processing a Coherence configuration system properties.

As of Coherence 12.2.1, all Coherence system properties start with coherence.. There is backwards compatibility support that if the property is not found, then the property is looked up again with tansogol. prepended and lastly by replacing the coherence. in the system property name to support Coherence system property naming conventions prior to Coherence 12.2.1.

Note: These methods should only be used when the system property name may begin with "coherence.*" or "tangosol.*". The native method for looking up a system or environment property should be used to lookup up a OS/Language native property.

Since:

Coherence 12.2.1

Author:

jf 2015.04.21

Constructor Summary

Constructors

Constructor and Description
Config()

Method Summary

Modifier and Type	Method and Description
static boolean	getBoolean(String sName) Returns true if coherence system property sName exists and value is equal to string true.
static boolean	getBoolean(String sName, boolean fDefault) Return true if property sName exists and its value is string true.
static Double	getDouble(String sName) Return Coherence system property value as a Double.
static Double	getDouble(String sName, double dDefault) Return Coherence system property value as a double.
static com.oracle.coherence.common.util.Duration	getDuration(String sName) Return Coherence system property value as a Duration.
static com.oracle.coherence.common.util.Duration	getDuration(String sName, com.oracle.coherence.common.util.Duration dDefault) Return Coherence system property value as a Duration.
static String	getenv(String sName) Coherence enhanced system environment getter Use instead of System.getenv(String).
static Float	getFloat(String sName) Return Coherence system property value as a Float.
static Float	getFloat(String sName, float fDefault) Return Coherence system property value as a float.
static Integer	getInteger(String sName) Return Coherence system property value as an Integer.
static Integer	getInteger(String sName, int iDefault) Return Coherence system property value as an Integer.
static Long	getLong(String sName) Return Coherence system property value as a Long.
static Long	getLong(String sName, long lDefault) Return Coherence system property value as a long.
static String	getProperty(String sName) Get the value of Coherence property sName This implementation differs from System.getProperty(String) that a SecurityException is handled and logged as a warning and null is returned as the property's value.
static String	getProperty(String sName, String sDefault) Get a Coherence property value, return default if property lookup fails.
static String	getProperty(String sName, Supplier<String> supDefault) Get a Coherence property value, returning the value provided by the supplier if property lookup fails.

Methods inherited from class java.lang.Object

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

Constructor Detail

Config

public Config()

Method Detail

getProperty

public static String getProperty(String sName)

Get the value of Coherence property sName

This implementation differs from System.getProperty(String) that a SecurityException is handled and logged as a warning and null is returned as the property's value.

Backwards compatibility support is described in Config.

Parameters:

sName - Coherence system property name beginning with coherence.

Returns:

value of property sName or null if property lookup fails or property does not exist

getProperty

public static String getProperty(String sName,
                                 String sDefault)

Get a Coherence property value, return default if property lookup fails.

Backwards compatibility support is described in Config.

Parameters:

sName - Coherence system property name beginning with coherence.

sDefault - default value returned if property lookup fails

Returns:

value of property sName, or sDefault if property lookup fails or no property defined

getProperty

public static String getProperty(String sName,
                                 Supplier<String> supDefault)

Get a Coherence property value, returning the value provided by the supplier if property lookup fails.

Backwards compatibility support is described in Config.

Parameters:

sName - Coherence system property name beginning with coherence.

supDefault - the supplier that provides a default value if property lookup fails

Returns:

value of property sName, or value provided by the supDefault if property lookup fails or no property defined

getBoolean

public static boolean getBoolean(String sName)

Returns true if coherence system property sName exists and value is equal to string true.

Backwards compatibility support is described in Config.

Parameters:

sName - Coherence system property name beginning with coherence.

Returns:

true if system property exists and equal to true

getBoolean

public static boolean getBoolean(String sName,
                                 boolean fDefault)

Return true if property sName exists and its value is string true.

Backwards compatibility support is described in Config.

Parameters:

sName - Coherence system property name beginning with coherence.

fDefault - default value if property value lookup or conversion fails.

Returns:

true if sName exists and its value is string true; otherwise, return sDefault.

getInteger

public static Integer getInteger(String sName)

Return Coherence system property value as an Integer.

Backwards compatibility support is described in Config.

Parameters:

sName - Coherence system property name beginning with coherence.

Returns:

property value as integer if property lookup and conversion of the String value to integer succeeds; otherwise, return null

getInteger

public static Integer getInteger(String sName,
                                 int iDefault)

Return Coherence system property value as an Integer.

Backwards compatibility support is described in Config.

Parameters:

sName - Coherence system property name beginning with coherence.

iDefault - integer default value

Returns:

property value as integer if property lookup and conversion of the String value to integer succeeds; otherwise, return iDefault

getLong

public static Long getLong(String sName)

Return Coherence system property value as a Long.

Backwards compatibility support is described in Config.

Parameters:

sName - Coherence system property name beginning with coherence.

Returns:

property value as long if property lookup and conversion of the String value to long succeeds; otherwise, return null

getLong

public static Long getLong(String sName,
                           long lDefault)

Return Coherence system property value as a long.

Backwards compatibility support is described in Config.

Parameters:

sName - Coherence system property name beginning with coherence.

lDefault - long default value

Returns:

property value as long if property lookup and conversion of the String value to long succeeds; otherwise, return lDefault

getFloat

public static Float getFloat(String sName)

Return Coherence system property value as a Float.

Backwards compatibility support is described in Config.

Parameters:

sName - Coherence system property name beginning with coherence.

Returns:

property value as float if property lookup and conversion of the String value to float succeeds; otherwise, return null

getFloat

public static Float getFloat(String sName,
                             float fDefault)

Return Coherence system property value as a float.

Backwards compatibility support is described in Config.

Parameters:

sName - Coherence system property name beginning with coherence.

fDefault - float default value

Returns:

property value as long if property lookup and conversion of the String value to float succeeds; otherwise, return fDefault

getDouble

public static Double getDouble(String sName)

Return Coherence system property value as a Double.

Backwards compatibility support is described in Config.

Parameters:

sName - Coherence system property name beginning with coherence.

Returns:

property value as double if property lookup and conversion of the String value to double succeeds; otherwise, return null

getDouble

public static Double getDouble(String sName,
                               double dDefault)

Return Coherence system property value as a double.

Backwards compatibility support is described in Config.

Parameters:

sName - Coherence system property name beginning with coherence.

dDefault - double default value

Returns:

property value as double if property lookup and conversion of the String value to double succeeds; otherwise, return dDefault

getDuration

public static com.oracle.coherence.common.util.Duration getDuration(String sName)

Return Coherence system property value as a Duration.

Backwards compatibility support is described in Config.

Parameters:

sName - Coherence system property name beginning with coherence.

Returns:

property value as Duration if property lookup and conversion of the String value to Duration succeeds; otherwise, return null

getDuration

public static com.oracle.coherence.common.util.Duration getDuration(String sName,
                                                                    com.oracle.coherence.common.util.Duration dDefault)

Return Coherence system property value as a Duration.

Backwards compatibility support is described in Config.

Parameters:

sName - Coherence system property name beginning with coherence.

dDefault - default Duration value

Returns:

property value as Duration if property lookup and conversion of the String value to Duration succeeds; otherwise, return dDefault

getenv

public static String getenv(String sName)

Coherence enhanced system environment getter Use instead of System.getenv(String).

Parameters:

sName - Coherence system environment property name

Returns:

value for system environment property if it exists or null