de.ipcon.tools

Class TypeDistiller

java.lang.Object

de.ipcon.tools.TypeDistiller

public class TypeDistiller
extends java.lang.Object

This utility class provides methods for converting strings to various data types. All methods are static and throw IParsedValueException if the input string cannot be converted.

Method Summary

Modifier and Type	Method and Description
static java.lang.Number	convertNumberTo(java.lang.Number number, java.lang.Class<?> targetType) Converts the given number to the specified target type.
static boolean	getBool(java.lang.String s) Deprecated. Use parseBoolean(String) instead.
static boolean	getBool(java.lang.String s, boolean defaultValue) Deprecated. Use parseBoolean(String, Boolean) instead.
static boolean	getBool(java.lang.String s, java.lang.Boolean defaultValue) Deprecated. Use parseBoolean(String, Boolean) instead.
static java.lang.Boolean	getBoolObject(java.lang.String s) Deprecated. Use parseBooleanObject(String) instead.
static java.lang.Boolean	getBoolObject(java.lang.String s, java.lang.Boolean defaultValue) Deprecated. Use parseBooleanObject(String, Boolean) instead.
static java.lang.Boolean	getBoolObject(java.lang.String s, java.lang.Boolean defaultValue, boolean useDefaultValue) Deprecated. Use parseBooleanObject(String) or parseBooleanObject(String, Boolean) instead.
static java.math.BigDecimal	getDecimalObject(java.lang.String s) Deprecated. Use parseBigDecimal(String) instead.
static java.math.BigDecimal	getDecimalObject(java.lang.String s, java.math.BigDecimal defaultValue) Deprecated. Use parseBigDecimal(String, BigDecimal) instead.
static double	getDouble(java.lang.String s) Deprecated. Use parseDouble(String) instead.
static double	getDouble(java.lang.String s, double defaultValue) Deprecated. Use parseDouble(String, double) instead.
static java.lang.Double	getDoubleObject(java.lang.String s) Deprecated. Use parseDoubleObject(String) instead.
static java.lang.Double	getDoubleObject(java.lang.String s, java.lang.Double defaultValue) Deprecated. Use parseDoubleObject(String, Double) instead.
static float	getFloat(java.lang.String s) Deprecated. Use parseFloat(String) instead.
static float	getFloat(java.lang.String s, float defaultValue) Deprecated. Use parseFloat(String, float) instead.
static java.lang.Float	getFloatObject(java.lang.String s) Deprecated. Use parseFloatObject(String) instead.
static java.lang.Float	getFloatObject(java.lang.String s, java.lang.Float defaultValue) Deprecated. Use parseFloatObject(String, Float) instead.
static int	getInt(java.lang.String s) Deprecated. Use parseInt(String) instead.
static int	getInt(java.lang.String s, int defaultValue) Deprecated. Use parseInt(String, int) instead.
static java.lang.Integer	getIntObject(java.lang.String s) Deprecated. Use parseInteger(String) instead.
static java.lang.Integer	getIntObject(java.lang.String s, java.lang.Integer defaultValue) Deprecated. Use parseInteger(String, Integer) instead.
static long	getLong(java.lang.String s) Deprecated. Use parseLong(String) instead.
static long	getLong(java.lang.String s, long defaultValue) Deprecated. Use parseLong(String, long) instead.
static java.lang.Long	getLongObject(java.lang.String s) Deprecated. Use parseLongObject(String) instead.
static java.lang.Long	getLongObject(java.lang.String s, java.lang.Long defaultValue) Deprecated. Use parseLongObject(String, Long) instead.
static int	getRoundingMode(java.lang.String s) Deprecated. Use parseRoundingMode(String) instead.
static java.util.List<java.lang.String>	getValidBooleanStrings() Returns a list of all valid boolean strings (case-insensitive).
static java.util.List<java.lang.String>	getValidRoundingModeStrings() Returns a list of all valid rounding mode strings (case-insensitive).
static java.math.BigDecimal	parseBigDecimal(java.lang.String s) Parses a BigDecimal from the given string.
static java.math.BigDecimal	parseBigDecimal(java.lang.String s, java.math.BigDecimal defaultValue) Parses a BigDecimal from the given string.
static boolean	parseBoolean(java.lang.String s) Parses a boolean value from a string representation (case-insensitive).
static boolean	parseBoolean(java.lang.String s, java.lang.Boolean defaultValue) Parses a boolean value from a string representation (case-insensitive), with a default value for null input.
static java.lang.Boolean	parseBooleanObject(java.lang.String s) Parses a boolean value from a string representation (case-insensitive), returning a Boolean object.
static java.lang.Boolean	parseBooleanObject(java.lang.String s, java.lang.Boolean defaultValue) Parses a boolean value from a string representation (case-insensitive), with a default value for null input, returning a Boolean object.
static double	parseDouble(java.lang.String s) Parses a double from the given string.
static double	parseDouble(java.lang.String s, double defaultValue) Parses a double from the given string.
static java.lang.Double	parseDoubleObject(java.lang.String s) Parses a double from the given string.
static java.lang.Double	parseDoubleObject(java.lang.String s, java.lang.Double defaultValue) Parses a double from the given string.
static float	parseFloat(java.lang.String s) Parses a float from the given string.
static float	parseFloat(java.lang.String s, float defaultValue) Parses a float from the given string.
static java.lang.Float	parseFloatObject(java.lang.String s) Parses a float from the given string.
static java.lang.Float	parseFloatObject(java.lang.String s, java.lang.Float defaultValue) Parses a float from the given string.
static int	parseInt(java.lang.String s) Parses an integer from the given string, ignoring decimal places.
static int	parseInt(java.lang.String s, int defaultValue) Parses an integer from the given string, ignoring decimal places.
static java.lang.Integer	parseInteger(java.lang.String str) Parses an integer from the given string, ignoring decimal places.
static java.lang.Integer	parseInteger(java.lang.String s, java.lang.Integer defaultValue) Parses an integer from the given string, ignoring decimal places.
static long	parseLong(java.lang.String s) Parses a long from the given string, ignoring decimal places.
static long	parseLong(java.lang.String s, long defaultValue) Parses a long from the given string, ignoring decimal places.
static java.lang.Long	parseLongObject(java.lang.String s) Parses a long from the given string, ignoring decimal places.
static java.lang.Long	parseLongObject(java.lang.String s, java.lang.Long defaultValue) Parses a long from the given string, ignoring decimal places.
static java.time.Period	parsePeriod(java.lang.String s) Parses a Period from a string representation.
static int	parseRoundingMode(java.lang.String s) Parses a rounding mode from a string representation.

Methods inherited from class java.lang.Object

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

Method Detail

getValidBooleanStrings

public static java.util.List<java.lang.String> getValidBooleanStrings()

Returns a list of all valid boolean strings (case-insensitive).

Returns:

the list of valid boolean strings

getValidRoundingModeStrings

public static java.util.List<java.lang.String> getValidRoundingModeStrings()

Returns a list of all valid rounding mode strings (case-insensitive).

Returns:

the list of valid rounding mode strings

parseInt

public static int parseInt(java.lang.String s)

Parses an integer from the given string, ignoring decimal places.

Parameters:

s - the string to parse

Returns:

the parsed integer value

Throws:

IParsedValueException - if the string is null, empty, or not a valid integer

parseInt

public static int parseInt(java.lang.String s,
                           int defaultValue)

Parses an integer from the given string, ignoring decimal places. Returns the default value if the string is null or empty.

Parameters:

s - the string to parse

defaultValue - the default value to return if the string is null or empty

Returns:

the parsed integer value, or the default value if the string is null or empty

Throws:

IParsedValueException - if the string is not a valid integer

parseInteger

public static java.lang.Integer parseInteger(java.lang.String str)

Parses an integer from the given string, ignoring decimal places.

Parameters:

str - the string to parse

Returns:

the parsed integer value as an Integer object

Throws:

IParsedValueException - if the string is null, empty, or not a valid integer

parseInteger

public static java.lang.Integer parseInteger(java.lang.String s,
                                             java.lang.Integer defaultValue)

Parses an integer from the given string, ignoring decimal places. Returns the default value if the string is null or empty.

Parameters:

s - the string to parse

defaultValue - the default value to return if the string is null or empty

Returns:

the parsed integer value as an Integer object, or the default value if the string is null or empty

Throws:

IParsedValueException - if the string is not a valid integer

getInt

@Deprecated
public static int getInt(java.lang.String s)

Deprecated. Use parseInt(String) instead.

getInt

@Deprecated
public static int getInt(java.lang.String s,
                                     int defaultValue)

Deprecated. Use parseInt(String, int) instead.

getIntObject

@Deprecated
public static java.lang.Integer getIntObject(java.lang.String s)

Deprecated. Use parseInteger(String) instead.

getIntObject

@Deprecated
public static java.lang.Integer getIntObject(java.lang.String s,
                                                         java.lang.Integer defaultValue)

Deprecated. Use parseInteger(String, Integer) instead.

parseLong

public static long parseLong(java.lang.String s)

Parses a long from the given string, ignoring decimal places.

Parameters:

s - the string to parse

Returns:

the parsed long value

Throws:

IParsedValueException - if the string is null, empty, or not a valid long

parseLong

public static long parseLong(java.lang.String s,
                             long defaultValue)

Parses a long from the given string, ignoring decimal places. Returns the default value if the string is null or empty.

Parameters:

s - the string to parse

defaultValue - the default value to return if the string is null or empty

Returns:

the parsed long value, or the default value if the string is null or empty

Throws:

IParsedValueException - if the string is not a valid long

parseLongObject

public static java.lang.Long parseLongObject(java.lang.String s)

Parses a long from the given string, ignoring decimal places.

Parameters:

s - the string to parse

Returns:

the parsed long value as a Long object

Throws:

IParsedValueException - if the string is null, empty, or not a valid long

parseLongObject

public static java.lang.Long parseLongObject(java.lang.String s,
                                             java.lang.Long defaultValue)

Parses a long from the given string, ignoring decimal places. Returns the default value if the string is null or empty.

Parameters:

s - the string to parse

defaultValue - the default value to return if the string is null or empty

Returns:

the parsed long value as a Long object, or the default value if the string is null or empty

Throws:

IParsedValueException - if the string is not a valid long

getLong

@Deprecated
public static long getLong(java.lang.String s)

Deprecated. Use parseLong(String) instead.

getLong

@Deprecated
public static long getLong(java.lang.String s,
                                       long defaultValue)

Deprecated. Use parseLong(String, long) instead.

getLongObject

@Deprecated
public static java.lang.Long getLongObject(java.lang.String s)

Deprecated. Use parseLongObject(String) instead.

getLongObject

@Deprecated
public static java.lang.Long getLongObject(java.lang.String s,
                                                       java.lang.Long defaultValue)

Deprecated. Use parseLongObject(String, Long) instead.

parseFloat

public static float parseFloat(java.lang.String s)

Parses a float from the given string.

Parameters:

s - the string to parse

Returns:

the parsed float value

Throws:

IParsedValueException - if the string is null, empty, or not a valid float

parseFloat

public static float parseFloat(java.lang.String s,
                               float defaultValue)

Parses a float from the given string. Returns the default value if the string is null or empty.

Parameters:

s - the string to parse

defaultValue - the default value to return if the string is null or empty

Returns:

the parsed float value, or the default value if the string is null or empty

Throws:

IParsedValueException - if the string is not a valid float

parseFloatObject

public static java.lang.Float parseFloatObject(java.lang.String s)

Parses a float from the given string.

Parameters:

s - the string to parse

Returns:

the parsed float value as a Float object

Throws:

IParsedValueException - if the string is null, empty, or not a valid float

parseFloatObject

public static java.lang.Float parseFloatObject(java.lang.String s,
                                               java.lang.Float defaultValue)

Parses a float from the given string. Returns the default value if the string is null or empty.

Parameters:

s - the string to parse

defaultValue - the default value to return if the string is null or empty

Returns:

the parsed float value as a Float object, or the default value if the string is null or empty

Throws:

IParsedValueException - if the string is not a valid float

getFloat

@Deprecated
public static float getFloat(java.lang.String s)

Deprecated. Use parseFloat(String) instead.

getFloat

@Deprecated
public static float getFloat(java.lang.String s,
                                         float defaultValue)

Deprecated. Use parseFloat(String, float) instead.

getFloatObject

@Deprecated
public static java.lang.Float getFloatObject(java.lang.String s)

Deprecated. Use parseFloatObject(String) instead.

getFloatObject

@Deprecated
public static java.lang.Float getFloatObject(java.lang.String s,
                                                         java.lang.Float defaultValue)

Deprecated. Use parseFloatObject(String, Float) instead.

parseBigDecimal

public static java.math.BigDecimal parseBigDecimal(java.lang.String s)

Parses a BigDecimal from the given string.

Parameters:

s - the string to parse

Returns:

the parsed BigDecimal value

Throws:

IParsedValueException - if the string is null, empty, or not a valid BigDecimal

parseBigDecimal

public static java.math.BigDecimal parseBigDecimal(java.lang.String s,
                                                   java.math.BigDecimal defaultValue)

Parses a BigDecimal from the given string. Returns the default value if the string is null or empty.

Parameters:

s - the string to parse

defaultValue - the default value to return if the string is null or empty

Returns:

the parsed BigDecimal value, or the default value if the string is null or empty

Throws:

IParsedValueException - if the string is not a valid BigDecimal

getDecimalObject

@Deprecated
public static java.math.BigDecimal getDecimalObject(java.lang.String s)

Deprecated. Use parseBigDecimal(String) instead.

getDecimalObject

@Deprecated
public static java.math.BigDecimal getDecimalObject(java.lang.String s,
                                                                java.math.BigDecimal defaultValue)

Deprecated. Use parseBigDecimal(String, BigDecimal) instead.

parseDouble

public static double parseDouble(java.lang.String s)

Parses a double from the given string.

Parameters:

s - the string to parse

Returns:

the parsed double value

Throws:

IParsedValueException - if the string is null, empty, or not a valid double

parseDouble

public static double parseDouble(java.lang.String s,
                                 double defaultValue)

Parses a double from the given string. Returns the default value if the string is null or empty.

Parameters:

s - the string to parse

defaultValue - the default value to return if the string is null or empty

Returns:

the parsed double value, or the default value if the string is null or empty

Throws:

IParsedValueException - if the string is not a valid double

parseDoubleObject

public static java.lang.Double parseDoubleObject(java.lang.String s)

Parses a double from the given string.

Parameters:

s - the string to parse

Returns:

the parsed double value as a Double object

Throws:

IParsedValueException - if the string is null, empty, or not a valid double

parseDoubleObject

public static java.lang.Double parseDoubleObject(java.lang.String s,
                                                 java.lang.Double defaultValue)

Parses a double from the given string. Returns the default value if the string is null or empty.

Parameters:

s - the string to parse

defaultValue - the default value to return if the string is null or empty

Returns:

the parsed double value as a Double object, or the default value if the string is null or empty

Throws:

IParsedValueException - if the string is not a valid double

getDouble

@Deprecated
public static double getDouble(java.lang.String s)

Deprecated. Use parseDouble(String) instead.

getDouble

@Deprecated
public static double getDouble(java.lang.String s,
                                           double defaultValue)

Deprecated. Use parseDouble(String, double) instead.

getDoubleObject

@Deprecated
public static java.lang.Double getDoubleObject(java.lang.String s)

Deprecated. Use parseDoubleObject(String) instead.

getDoubleObject

@Deprecated
public static java.lang.Double getDoubleObject(java.lang.String s,
                                                           java.lang.Double defaultValue)

Deprecated. Use parseDoubleObject(String, Double) instead.

parseBoolean

public static boolean parseBoolean(java.lang.String s)

Parses a boolean value from a string representation (case-insensitive).

This method converts a string into its corresponding boolean value. The following strings are considered true: "true", "yes", "1". The following strings are considered false: "false", "no", "0". This method uses BooleanToken to define the valid boolean string representations.

Parameters:

s - The string to parse.

Returns:

The parsed boolean value.

Throws:

IParsedValueException - If the input string is not a valid boolean representation.

See Also:

BooleanToken

parseBoolean

public static boolean parseBoolean(java.lang.String s,
                                   java.lang.Boolean defaultValue)

Parses a boolean value from a string representation (case-insensitive), with a default value for null input.

This method converts a string into its corresponding boolean value. The supported string representations are defined in BooleanToken.

Examples of valid input strings (case-insensitive):

• "true"
• "yes"
• "1"
• "false"
• "no"
• "0"

Parameters:

s - The string to parse.

defaultValue - The default value to return if the input string is null.

Returns:

The parsed boolean value, or the default value if the input string is null.

Throws:

IParsedValueException - If the input string is not a valid boolean representation.

parseBooleanObject

public static java.lang.Boolean parseBooleanObject(java.lang.String s)

Parses a boolean value from a string representation (case-insensitive), returning a Boolean object.

This method is similar to parseBoolean(String), but it returns a Boolean object instead of a primitive boolean value. This allows for explicitly representing a null value when the input string is null. The following strings are considered true: "true", "yes", "1". The following strings are considered false: "false", "no", "0". This method uses BooleanToken to define the valid boolean string representations.

Parameters:

s - The string to parse.

Returns:

The parsed boolean value as a Boolean object, or null if the input string is null.

Throws:

IParsedValueException - If the input string is not a valid boolean representation.

See Also:

parseBoolean(String)

parseBooleanObject

public static java.lang.Boolean parseBooleanObject(java.lang.String s,
                                                   java.lang.Boolean defaultValue)

Parses a boolean value from a string representation (case-insensitive), with a default value for null input, returning a Boolean object.

This method converts a string into its corresponding boolean value. The following strings are considered true: "true", "yes", "1". The following strings are considered false: "false", "no", "0". This method uses BooleanToken to define the valid boolean string representations. If the input string is null, the specified default value is returned.

Parameters:

s - The string to parse.s

defaultValue - The default value to return if the input string is null.

Returns:

The parsed boolean value as a Boolean object, or the default value if the input string is null.

Throws:

IParsedValueException - If the input string is not a valid boolean representation.

getBool

@Deprecated
public static boolean getBool(java.lang.String s)

Deprecated. Use parseBoolean(String) instead.

getBool

@Deprecated
public static boolean getBool(java.lang.String s,
                                          boolean defaultValue)

Deprecated. Use parseBoolean(String, Boolean) instead.

getBool

@Deprecated
public static boolean getBool(java.lang.String s,
                                          java.lang.Boolean defaultValue)

Deprecated. Use parseBoolean(String, Boolean) instead.

getBoolObject

@Deprecated
public static java.lang.Boolean getBoolObject(java.lang.String s)

Deprecated. Use parseBooleanObject(String) instead.

getBoolObject

@Deprecated
public static java.lang.Boolean getBoolObject(java.lang.String s,
                                                          java.lang.Boolean defaultValue)

Deprecated. Use parseBooleanObject(String, Boolean) instead.

getBoolObject

@Deprecated
public static java.lang.Boolean getBoolObject(java.lang.String s,
                                                          java.lang.Boolean defaultValue,
                                                          boolean useDefaultValue)

Deprecated. Use parseBooleanObject(String) or parseBooleanObject(String, Boolean) instead.

parsePeriod

public static java.time.Period parsePeriod(java.lang.String s)

Parses a Period from a string representation.

This method converts a string in the format "10y", "5M", "2w", etc. into its corresponding Period object. The supported units are defined in PeriodUnit.

Examples of valid input strings:

• "10y" (10 years)
• "5M" (5 months)
• "2w" (2 weeks)
• "1d" (1 day)

Parameters:

s - the string to parse

Returns:

the parsed Period object

Throws:

IParsedValueException - if the input string is null, empty, or does not represent a valid period

parseRoundingMode

public static int parseRoundingMode(java.lang.String s)

Parses a rounding mode from a string representation.

This method converts a string into its corresponding SimpleRoundingMode enum value and extracts the associated rounding mode as an integer. The input string is case-insensitive. The supported rounding modes are defined in SimpleRoundingMode.

Parameters:

s - The string representation of the rounding mode.

Returns:

The parsed rounding mode as an integer value.

Throws:

java.lang.IllegalArgumentException - if the input string is null, empty, or does not represent a valid rounding mode.

getRoundingMode

@Deprecated
public static int getRoundingMode(java.lang.String s)

Deprecated. Use parseRoundingMode(String) instead.

convertNumberTo

public static java.lang.Number convertNumberTo(java.lang.Number number,
                                               java.lang.Class<?> targetType)

Converts the given number to the specified target type. Supported target types are: Byte, Short, Integer, Long, Float, Double, and BigDecimal.

Parameters:

number - the number to convert

targetType - the target type

Returns:

the converted number

Throws:

java.lang.IllegalArgumentException - if the conversion is not supported