com.simplifiedlogic.nitro.jlink

Class DataUtils

java.lang.Object

com.simplifiedlogic.nitro.jlink.DataUtils

public class DataUtils
extends java.lang.Object

Utility methods for data value conversions

Constructor Summary

Constructors

Constructor and Description
DataUtils()

Method Summary

Methods

Modifier and Type	Method and Description
static java.lang.Object	decodeBase64(java.lang.Object input) Base64-decode a string and return it as a decoded String.
static byte[]	encodeBase64(java.lang.Object input) Base64-encode an object and return it as a byte array
static boolean	getBooleanValue(java.lang.Object in) Convert a generic object into a boolean value.
static boolean	getBooleanValue(java.lang.Object in, boolean encoded) Convert a generic object into a boolean value.
static java.util.List<java.lang.Object>	getCsvList(java.lang.String csv) Converts a String containing a set of comma-separated values and returns it as a java.util.List object.
static double	getDoubleValue(java.lang.Object in) Convert a generic object into a double value
static double	getDoubleValue(java.lang.Object in, boolean encoded) Convert a generic object into a double value
static int	getIntValue(java.lang.Object in) Convert a generic object into an int value.
static int	getIntValue(java.lang.Object in, boolean encoded) Convert a generic object into an int value.
static java.lang.String	getStringValue(java.lang.Object in) Convert a generic object into a String value.
static java.lang.String	getStringValue(java.lang.Object in, boolean encoded) Convert a generic object into a String value.
static boolean	validBoolean(java.lang.String val) Validate whether a string contains a valid boolean value

Methods inherited from class java.lang.Object

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

Constructor Detail

DataUtils

public DataUtils()

Method Detail

getIntValue

public static int getIntValue(java.lang.Object in)
                       throws java.lang.NumberFormatException,
                              java.io.IOException

Convert a generic object into an int value.

Parameters:

in - The object to convert

Returns:

The int value of the object

Throws:

java.lang.NumberFormatException - if the value is not a valid integer

java.io.IOException

getIntValue

public static int getIntValue(java.lang.Object in,
              boolean encoded)
                       throws java.lang.NumberFormatException,
                              java.io.IOException

Convert a generic object into an int value.

Parameters:

in - The object to convert

encoded - Whether the object is Base64-encoded

Returns:

The int value of the object

Throws:

java.lang.NumberFormatException - if the value is not a valid integer

java.io.IOException

getDoubleValue

public static double getDoubleValue(java.lang.Object in)
                             throws java.lang.NumberFormatException,
                                    java.io.IOException

Convert a generic object into a double value

Parameters:

in - The object to convert

Returns:

The double value of the object

Throws:

java.lang.NumberFormatException - if the value is not a valid double

java.io.IOException

getDoubleValue

public static double getDoubleValue(java.lang.Object in,
                    boolean encoded)
                             throws java.lang.NumberFormatException,
                                    java.io.IOException

Convert a generic object into a double value

Parameters:

in - The object to convert

encoded - Whether the object is Base64-encoded

Returns:

The double value of the object

Throws:

java.lang.NumberFormatException - if the value is not a valid double

java.io.IOException

getBooleanValue

public static boolean getBooleanValue(java.lang.Object in)

Convert a generic object into a boolean value.

This function will also interpret the string values "1", "y", "yes", "true", and "on" as a boolean true value.

Parameters:

in - The object to convert

Returns:

The boolean value of the object

getBooleanValue

public static boolean getBooleanValue(java.lang.Object in,
                      boolean encoded)

Convert a generic object into a boolean value.

This function will also interpret the string values "1", "y", "yes", "true", and "on" as a boolean true value.

Parameters:

in - The object to convert

encoded - Whether the object is Base64-encoded

Returns:

The boolean value of the object

validBoolean

public static boolean validBoolean(java.lang.String val)

Validate whether a string contains a valid boolean value

This function will interpret the string values "1", "y", "yes", "true", and "on" as a boolean true value.

This function will interpret the string values "2", "n", "no", "false", and "off" as a boolean false value.

Parameters:

val - The string to validate

Returns:

True if the value is a valid boolean

getStringValue

public static java.lang.String getStringValue(java.lang.Object in)

Convert a generic object into a String value. The reason not to just use toString() on the object is that this function also handles input in the form of a byte array, which toString() does not do well.

Parameters:

in - The object to convert

Returns:

The String value of the object

getStringValue

public static java.lang.String getStringValue(java.lang.Object in,
                              boolean encoded)

Convert a generic object into a String value. The reason not to just use toString() on the object is that this function also handles input in the form of a byte array, which toString() does not do well.

Parameters:

in - The object to convert

encoded - Whether the object is Base64-encoded

Returns:

The String value of the object

getCsvList

public static java.util.List<java.lang.Object> getCsvList(java.lang.String csv)

Converts a String containing a set of comma-separated values and returns it as a java.util.List object. The list can contain both String and Integer objects; if an item is detected to be numeric then it is converted to an Integer; otherwise it is converted to a String.

Needs to be modified to handle decimal (Double) values as well.

Parameters:

csv - The comma-separated list of values

Returns:

The values as a list of objects

encodeBase64

public static byte[] encodeBase64(java.lang.Object input)

Base64-encode an object and return it as a byte array

Parameters:

input - The object to encode

Returns:

The Base64-encoded value

decodeBase64

public static java.lang.Object decodeBase64(java.lang.Object input)

Base64-decode a string and return it as a decoded String.

If anything other than a String is passed in, then assume the object is already decoded and just return it.

Parameters:

input - The Base64-encoded string to decode

Returns:

The decoded string, or the input object if it was not a string.