griffon.util

Class ConfigUtils

java.lang.Object

griffon.util.ConfigUtils

public final class ConfigUtils
extends java.lang.Object

Utility class for reading configuration properties.

Author:

Andres Almiray

Method Summary

Modifier and Type	Method and Description
static java.util.Set<java.lang.String>	collectKeys(java.util.Map<java.lang.String,java.lang.Object> map)
static boolean	containsKey(java.util.Map<java.lang.String,java.lang.Object> config, java.lang.String key) Returns true if there's a non-null value for the specified key.
static boolean	containsKey(java.util.ResourceBundle config, java.lang.String key) Returns true if there's a non-null value for the specified key.
static <T> T	getConfigValue(java.util.Map<java.lang.String,java.lang.Object> config, java.lang.String key) Returns the value for the specified key with an optional default value if no match is found.
static <T> T	getConfigValue(java.util.Map<java.lang.String,java.lang.Object> config, java.lang.String key, T defaultValue) Returns the value for the specified key with an optional default value if no match is found.
static <T> T	getConfigValue(java.util.ResourceBundle config, java.lang.String key) Returns the value for the specified key with an optional default value if no match is found.
static <T> T	getConfigValue(java.util.ResourceBundle config, java.lang.String key, T defaultValue) Returns the value for the specified key with an optional default value if no match is found.
static boolean	getConfigValueAsBoolean(java.util.Map<java.lang.String,java.lang.Object> config, java.lang.String key) Returns the value for the specified key coerced to a boolean.
static boolean	getConfigValueAsBoolean(java.util.Map<java.lang.String,java.lang.Object> config, java.lang.String key, boolean defaultValue) Returns the value for the specified key with an optional default value if no match is found.
static double	getConfigValueAsDouble(java.util.Map<java.lang.String,java.lang.Object> config, java.lang.String key) Returns the value for the specified key coerced to a double.
static double	getConfigValueAsDouble(java.util.Map<java.lang.String,java.lang.Object> config, java.lang.String key, double defaultValue) Returns the value for the specified key with an optional default value if no match is found.
static float	getConfigValueAsFloat(java.util.Map<java.lang.String,java.lang.Object> config, java.lang.String key) Returns the value for the specified key coerced to a float.
static float	getConfigValueAsFloat(java.util.Map<java.lang.String,java.lang.Object> config, java.lang.String key, float defaultValue) Returns the value for the specified key with an optional default value if no match is found.
static int	getConfigValueAsInt(java.util.Map<java.lang.String,java.lang.Object> config, java.lang.String key) Returns the value for the specified key coerced to an int.
static int	getConfigValueAsInt(java.util.Map<java.lang.String,java.lang.Object> config, java.lang.String key, int defaultValue) Returns the value for the specified key with an optional default value if no match is found.
static long	getConfigValueAsLong(java.util.Map<java.lang.String,java.lang.Object> config, java.lang.String key) Returns the value for the specified key coerced to a long.
static long	getConfigValueAsLong(java.util.Map<java.lang.String,java.lang.Object> config, java.lang.String key, long defaultValue) Returns the value for the specified key with an optional default value if no match is found.
static java.lang.Number	getConfigValueAsNumber(java.util.Map<java.lang.String,java.lang.Object> config, java.lang.String key) Returns the value for the specified key coerced to a Number.
static java.lang.Number	getConfigValueAsNumber(java.util.Map<java.lang.String,java.lang.Object> config, java.lang.String key, java.lang.Number defaultValue) Returns the value for the specified key with an optional default value if no match is found.
static java.lang.String	getConfigValueAsString(java.util.Map<java.lang.String,java.lang.Object> config, java.lang.String key) Returns the value for the specified key converted to a String.
static java.lang.String	getConfigValueAsString(java.util.Map<java.lang.String,java.lang.Object> config, java.lang.String key, java.lang.String defaultValue) Returns the value for the specified key with an optional default value if no match is found.
static java.lang.String	getFilenameExtension(java.lang.String path) Extract the filename extension from the given path, e.g.
static boolean	isValueDefined(java.util.Map<java.lang.String,java.lang.Object> config, java.lang.String key) Returns true if there's a non-null value for the specified key.
static boolean	isValueDefined(java.util.ResourceBundle config, java.lang.String key) Returns true if there's a non-null value for the specified key.
static java.lang.String	stripFilenameExtension(java.lang.String path) Strip the filename extension from the given path, e.g.
static java.util.Properties	toProperties(java.util.ResourceBundle resourceBundle) Converts a ResourceBundle instance into a Properties instance.

Methods inherited from class java.lang.Object

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

Method Detail

toProperties

@Nonnull
public static java.util.Properties toProperties(@Nonnull
                                                         java.util.ResourceBundle resourceBundle)

Converts a ResourceBundle instance into a Properties instance.

Parameters:

resourceBundle - the ResourceBundle to be converted. Must not be null.

Returns:

a newly created Properties with all key/value pairs from the given ResourceBundle.

Since:

2.10.0

containsKey

public static boolean containsKey(@Nonnull
                                  java.util.Map<java.lang.String,java.lang.Object> config,
                                  @Nonnull
                                  java.lang.String key)

Returns true if there's a non-null value for the specified key.

Parameters:

config - the configuration object to be searched upon

key - the key to be searched

Returns:

true if there's a value for the specified key, false otherwise

Since:

2.2.0

containsKey

public static boolean containsKey(@Nonnull
                                  java.util.ResourceBundle config,
                                  @Nonnull
                                  java.lang.String key)

Returns true if there's a non-null value for the specified key.

Parameters:

config - the configuration object to be searched upon

key - the key to be searched

Returns:

true if there's a value for the specified key, false otherwise

Since:

2.2.0

isValueDefined

public static boolean isValueDefined(@Nonnull
                                     java.util.Map<java.lang.String,java.lang.Object> config,
                                     @Nonnull
                                     java.lang.String key)

Returns true if there's a non-null value for the specified key.

Parameters:

config - the configuration object to be searched upon

key - the key to be searched

Returns:

true if there's a value for the specified key, false otherwise

isValueDefined

public static boolean isValueDefined(@Nonnull
                                     java.util.ResourceBundle config,
                                     @Nonnull
                                     java.lang.String key)

Returns true if there's a non-null value for the specified key.

Parameters:

config - the configuration object to be searched upon

key - the key to be searched

Returns:

true if there's a value for the specified key, false otherwise

getConfigValue

@Nullable
public static <T> T getConfigValue(@Nonnull
                                             java.util.Map<java.lang.String,java.lang.Object> config,
                                             @Nonnull
                                             java.lang.String key,
                                             @Nullable
                                             T defaultValue)

Returns the value for the specified key with an optional default value if no match is found.

Parameters:

config - the configuration object to be searched upon

key - the key to be searched

defaultValue - the value to send back if no match is found

Returns:

the value of the key or the default value if no match is found

getConfigValue

@Nullable
public static <T> T getConfigValue(@Nonnull
                                             java.util.ResourceBundle config,
                                             @Nonnull
                                             java.lang.String key,
                                             @Nullable
                                             T defaultValue)

Returns the value for the specified key with an optional default value if no match is found.

Parameters:

config - the configuration object to be searched upon

key - the key to be searched

defaultValue - the value to send back if no match is found

Returns:

the value of the key or the default value if no match is found

getConfigValue

@Nullable
public static <T> T getConfigValue(@Nonnull
                                             java.util.Map<java.lang.String,java.lang.Object> config,
                                             @Nonnull
                                             java.lang.String key)
                                      throws java.util.MissingResourceException

Returns the value for the specified key with an optional default value if no match is found.

Parameters:

config - the configuration object to be searched upon

key - the key to be searched

Returns:

the value of the key or the default value if no match is found

Throws:

java.util.MissingResourceException

getConfigValue

@Nullable
public static <T> T getConfigValue(@Nonnull
                                             java.util.ResourceBundle config,
                                             @Nonnull
                                             java.lang.String key)
                                      throws java.util.MissingResourceException

Returns the value for the specified key with an optional default value if no match is found.

Parameters:

config - the configuration object to be searched upon

key - the key to be searched

Returns:

the value of the key or the default value if no match is found

Throws:

java.util.MissingResourceException

getConfigValueAsBoolean

public static boolean getConfigValueAsBoolean(@Nonnull
                                              java.util.Map<java.lang.String,java.lang.Object> config,
                                              @Nonnull
                                              java.lang.String key)

Returns the value for the specified key coerced to a boolean.

Parameters:

config - the configuration object to be searched upon

key - the key to be searched

Returns:

the value of the key. Returns false if no match.

getConfigValueAsBoolean

public static boolean getConfigValueAsBoolean(@Nonnull
                                              java.util.Map<java.lang.String,java.lang.Object> config,
                                              @Nonnull
                                              java.lang.String key,
                                              boolean defaultValue)

Returns the value for the specified key with an optional default value if no match is found.

Parameters:

config - the configuration object to be searched upon

key - the key to be searched

defaultValue - the value to send back if no match is found

Returns:

the value of the key or the default value if no match is found

getConfigValueAsInt

public static int getConfigValueAsInt(@Nonnull
                                      java.util.Map<java.lang.String,java.lang.Object> config,
                                      @Nonnull
                                      java.lang.String key)

Returns the value for the specified key coerced to an int.

Parameters:

config - the configuration object to be searched upon

key - the key to be searched

Returns:

the value of the key. Returns 0 if no match.

getConfigValueAsInt

public static int getConfigValueAsInt(@Nonnull
                                      java.util.Map<java.lang.String,java.lang.Object> config,
                                      @Nonnull
                                      java.lang.String key,
                                      int defaultValue)

Returns the value for the specified key with an optional default value if no match is found.

Parameters:

config - the configuration object to be searched upon

key - the key to be searched

defaultValue - the value to send back if no match is found

Returns:

the value of the key or the default value if no match is found

getConfigValueAsLong

public static long getConfigValueAsLong(@Nonnull
                                        java.util.Map<java.lang.String,java.lang.Object> config,
                                        @Nonnull
                                        java.lang.String key)

Returns the value for the specified key coerced to a long.

Parameters:

config - the configuration object to be searched upon

key - the key to be searched

Returns:

the value of the key. Returns 0L if no match.

getConfigValueAsLong

public static long getConfigValueAsLong(@Nonnull
                                        java.util.Map<java.lang.String,java.lang.Object> config,
                                        @Nonnull
                                        java.lang.String key,
                                        long defaultValue)

Returns the value for the specified key with an optional default value if no match is found.

Parameters:

config - the configuration object to be searched upon

key - the key to be searched

defaultValue - the value to send back if no match is found

Returns:

the value of the key or the default value if no match is found

getConfigValueAsDouble

public static double getConfigValueAsDouble(@Nonnull
                                            java.util.Map<java.lang.String,java.lang.Object> config,
                                            @Nonnull
                                            java.lang.String key)

Returns the value for the specified key coerced to a double.

Parameters:

config - the configuration object to be searched upon

key - the key to be searched

Returns:

the value of the key. Returns 0d if no match.

getConfigValueAsDouble

public static double getConfigValueAsDouble(@Nonnull
                                            java.util.Map<java.lang.String,java.lang.Object> config,
                                            @Nonnull
                                            java.lang.String key,
                                            double defaultValue)

Returns the value for the specified key with an optional default value if no match is found.

Parameters:

config - the configuration object to be searched upon

key - the key to be searched

defaultValue - the value to send back if no match is found

Returns:

the value of the key or the default value if no match is found

getConfigValueAsFloat

public static float getConfigValueAsFloat(@Nonnull
                                          java.util.Map<java.lang.String,java.lang.Object> config,
                                          @Nonnull
                                          java.lang.String key)

Returns the value for the specified key coerced to a float.

Parameters:

config - the configuration object to be searched upon

key - the key to be searched

Returns:

the value of the key. Returns 0f if no match.

getConfigValueAsFloat

public static float getConfigValueAsFloat(@Nonnull
                                          java.util.Map<java.lang.String,java.lang.Object> config,
                                          @Nonnull
                                          java.lang.String key,
                                          float defaultValue)

Returns the value for the specified key with an optional default value if no match is found.

Parameters:

config - the configuration object to be searched upon

key - the key to be searched

defaultValue - the value to send back if no match is found

Returns:

the value of the key or the default value if no match is found

getConfigValueAsNumber

@Nullable
public static java.lang.Number getConfigValueAsNumber(@Nonnull
                                                                java.util.Map<java.lang.String,java.lang.Object> config,
                                                                @Nonnull
                                                                java.lang.String key)

Returns the value for the specified key coerced to a Number.

Parameters:

config - the configuration object to be searched upon

key - the key to be searched

Returns:

the value of the key. Returns null if no match.

getConfigValueAsNumber

@Nullable
public static java.lang.Number getConfigValueAsNumber(@Nonnull
                                                                java.util.Map<java.lang.String,java.lang.Object> config,
                                                                @Nonnull
                                                                java.lang.String key,
                                                                @Nullable
                                                                java.lang.Number defaultValue)

Returns the value for the specified key with an optional default value if no match is found.

Parameters:

config - the configuration object to be searched upon

key - the key to be searched

defaultValue - the value to send back if no match is found

Returns:

the value of the key or the default value if no match is found

getConfigValueAsString

@Nullable
public static java.lang.String getConfigValueAsString(@Nonnull
                                                                java.util.Map<java.lang.String,java.lang.Object> config,
                                                                @Nonnull
                                                                java.lang.String key)

Returns the value for the specified key converted to a String.

Parameters:

config - the configuration object to be searched upon

key - the key to be searched

Returns:

the value of the key. Returns "" if no match.

getConfigValueAsString

@Nullable
public static java.lang.String getConfigValueAsString(@Nonnull
                                                                java.util.Map<java.lang.String,java.lang.Object> config,
                                                                @Nonnull
                                                                java.lang.String key,
                                                                @Nullable
                                                                java.lang.String defaultValue)

Returns the value for the specified key with an optional default value if no match is found.

Parameters:

config - the configuration object to be searched upon

key - the key to be searched

defaultValue - the value to send back if no match is found

Returns:

the value of the key or the default value if no match is found

getFilenameExtension

public static java.lang.String getFilenameExtension(java.lang.String path)

Extract the filename extension from the given path, e.g. "mypath/myfile.txt" -> "txt".

Parameters:

path - the file path (may be null)

Returns:

the extracted filename extension, or null if none

stripFilenameExtension

public static java.lang.String stripFilenameExtension(java.lang.String path)

Strip the filename extension from the given path, e.g. "mypath/myfile.txt" -> "mypath/myfile".

Parameters:

path - the file path (may be null)

Returns:

the path with stripped filename extension, or null if none

collectKeys

@Nonnull
public static java.util.Set<java.lang.String> collectKeys(@Nonnull
                                                                   java.util.Map<java.lang.String,java.lang.Object> map)