org.hibernate.search.util.configuration.impl
Class ConfigurationParseHelper

java.lang.Object
  org.hibernate.search.util.configuration.impl.ConfigurationParseHelper

public abstract class ConfigurationParseHelper
extends Object

Helper class: - to avoid managing NumberFormatException and similar code - ensure consistent error messages across Configuration parsing problems - locate resources

Author:

Sanne Grinovero, Steve Ebersole, Emmanuel Bernard

Constructor Summary

ConfigurationParseHelper()

Method Summary

static URL	findAsResource(String path) Try to locate a local URL representing the incoming path.
static boolean	getBooleanValue(Properties cfg, String key, boolean defaultValue) Extracts a boolean value from configuration properties
static int	getIntValue(Properties cfg, String key, int defValue) Looks for a numeric value in the Properties, returning defValue if not found or if an empty string is found.
static String	getString(Properties cfg, String key, String defaultValue) Get the string property or defaults if not present
static URL	locateConfig(String path) Try to locate a local URL representing the incoming path.
static boolean	parseBoolean(String value, String errorMsgOnParseFailure) Parses a string to recognize exactly either "true" or "false".
static int	parseInt(String value, int defValue, String errorMsgOnParseFailure) In case value is null or an empty string the defValue is returned
static int	parseInt(String value, String errorMsgOnParseFailure) Parses a String to get an int value.

Methods inherited from class java.lang.Object

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

Constructor Detail

ConfigurationParseHelper

public ConfigurationParseHelper()

Method Detail

locateConfig

public static URL locateConfig(String path)

Try to locate a local URL representing the incoming path. The first attempt assumes that the incoming path is an actual URL string (file://, etc). If this does not work, then the next attempts try to locate this UURL as a java system resource.

Parameters:

path - The path representing the config location.

Returns:

An appropriate URL or null.

findAsResource

public static URL findAsResource(String path)

Try to locate a local URL representing the incoming path. This method only attempts to locate this URL as a java system resource.

Parameters:

path - The path representing the config location.

Returns:

An appropriate URL or null.

parseInt

public static final int parseInt(String value,
                                 String errorMsgOnParseFailure)

Parses a String to get an int value.

Parameters:

value - A string containing an int value to parse

errorMsgOnParseFailure - message being wrapped in a SearchException if value is null or not correct.

Returns:

the parsed value

Throws:

SearchException - both for null values and for Strings not containing a valid int.

parseInt

public static final int parseInt(String value,
                                 int defValue,
                                 String errorMsgOnParseFailure)

In case value is null or an empty string the defValue is returned

Parameters:

value -

defValue -

errorMsgOnParseFailure -

Returns:

the converted int.

Throws:

SearchException - if value can't be parsed.

getIntValue

public static final int getIntValue(Properties cfg,
                                    String key,
                                    int defValue)

Looks for a numeric value in the Properties, returning defValue if not found or if an empty string is found. When the key the value is found but not in valid format a standard error message is generated.

Parameters:

cfg -

key -

defValue -

Returns:

the converted int.

Throws:

SearchException - for invalid format.

parseBoolean

public static final boolean parseBoolean(String value,
                                         String errorMsgOnParseFailure)

Parses a string to recognize exactly either "true" or "false".

Parameters:

value - the string to be parsed

errorMsgOnParseFailure - the message to be put in the exception if thrown

Returns:

true if value is "true", false if value is "false"

Throws:

SearchException - for invalid format or values.

getBooleanValue

public static final boolean getBooleanValue(Properties cfg,
                                            String key,
                                            boolean defaultValue)

Extracts a boolean value from configuration properties

Parameters:

cfg - configuration Properties

key - the property key

defaultValue -

Returns:

the defaultValue if the property was not defined

Throws:

SearchException - for invalid format or values.

getString

public static final String getString(Properties cfg,
                                     String key,
                                     String defaultValue)

Get the string property or defaults if not present