com.dpslink.base.util

Class Util

java.lang.Object

com.dpslink.base.util.Util

All Implemented Interfaces:

java.io.Serializable

public class Util
extends java.lang.Object
implements java.io.Serializable

A utility class that contains miscellaneous helper methods.

The methods in this class are accessible from within a template via the $util variable.

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
private static java.text.DecimalFormat[]	cvCurrencyFormat An array of formatters used to format and parse currency numbers.
private static java.text.DecimalFormat[]	cvDecimalFormat An array of formatters used to format and parse decimal numbers.
private static java.text.NumberFormat[]	cvNumberFormat An array of formatters used to format and parse whole numbers.
private static char[]	hexDigit Hexidecimal digits used to convert characters to hex output.
static int	LEFT Constant used for left padding.
static int	RIGHT Constant used for right padding.
private static long	serialVersionUID The class' serialization version id.

Constructor Summary

Constructors

Constructor and Description
Util()

Method Summary

Modifier and Type	Method and Description
static java.lang.String	addSiteRootPath(java.lang.String s) Adds the site's root path to the beginning of the given string.
static java.lang.String	addSiteRootPathURL(java.lang.String s) Adds the site's root path to the beginning of the given string and returns the result as a URL.
static java.lang.Object[]	arrayListToObjectArray(java.util.ArrayList<?> al) Converts a given array list to an object array.
static java.lang.String[]	arrayListToStringArray(java.util.ArrayList<?> al) Converts a given array list to a string array.
static java.util.ArrayList<java.math.BigDecimal>	arrayMath(java.util.ArrayList<java.math.BigDecimal> a1, java.lang.String operator, java.util.ArrayList<java.math.BigDecimal> a2) Performs a math operation on 2 operand arrays.
static java.lang.String	booleanToYesNo(boolean value) Returns a string of "Yes" or "No" corresponding to the true (yes) or false (no) value of the given boolean parameter.
static java.lang.String	escapeRegEx(java.lang.String s) Returns an escaped string that is suitable for use as a regular expression pattern.
static int	findInArray(java.lang.String[] array, java.lang.String value) Finds the given value in the given array and returns the index of the value within the array.
static java.lang.String	formatCurrency(java.math.BigDecimal number) Returns a formatted currency string based on the current system locale.
static java.lang.String	formatCurrency(java.math.BigDecimal number, boolean fmtzero) Returns a formatted currency string based on the current system locale.
static java.lang.String	formatCurrency(java.math.BigDecimal number, boolean fmtzero, boolean fmtgrps) Returns a formatted currency string based on the current system locale.
static java.lang.String	formatCurrency(double number) Returns a formatted currency string based on the current system locale.
static java.lang.String	formatCurrency(double number, boolean fmtzero) Returns a formatted currency string based on the current system locale.
static java.lang.String	formatCurrency(double number, boolean fmtzero, boolean fmtgrps) Returns a formatted currency string based on the current system locale.
static java.lang.String	formatDate(java.util.Date date, int style) Returns a formatted date string for the given date using the given format style, default locale and default timezone.
static java.lang.String	formatDate(java.util.Date date, int style, java.util.Locale locale) Returns a formatted date string for the given date using the given format style, locale and default timezone.
static java.lang.String	formatDate(java.util.Date date, int style, java.util.Locale locale, java.util.TimeZone tz) Returns a formatted date string for the given date using the given format style, locale and timezone.
static java.lang.String	formatDate(java.util.Date date, int style, java.util.TimeZone tz) Returns a formatted date string for the given date using the given format style, timezone and default locale.
static java.lang.String	formatDateInput(java.util.Date date) Returns a formatted date string for the given date using the properties "Site.Format.DateInput" definition.
static java.lang.String	formatDateTime(java.util.Date date, int style) Returns a formatted date and time string for the given date using the given format style, default locale and default timezone.
static java.lang.String	formatDateTime(java.util.Date date, int style, java.util.Locale locale) Returns a formatted date and time string for the given date using the given format style, locale and default timezone.
static java.lang.String	formatDateTime(java.util.Date date, int style, java.util.Locale locale, java.util.TimeZone tz) Returns a formatted date and time string for the given date using the given format style, locale and timezone.
static java.lang.String	formatDateTime(java.util.Date date, int style, java.util.TimeZone tz) Returns a formatted date and time string for the given date using the given format style, timezone and default locale.
static java.lang.String	formatNumber(java.math.BigDecimal number) Returns a formatted number string based on the current system locale.
static java.lang.String	formatNumber(java.math.BigDecimal number, boolean fmtzero) Returns a formatted number string based on the current system locale.
static java.lang.String	formatNumber(java.math.BigDecimal number, boolean fmtzero, boolean fmtgrps) Returns a formatted number string based on the current system locale.
static java.lang.String	formatNumber(double number) Returns a formatted number string based on the current system locale.
static java.lang.String	formatNumber(double number, boolean fmtzero) Returns a formatted number string based on the current system locale.
static java.lang.String	formatNumber(double number, boolean fmtzero, boolean fmtgrps) Returns a formatted number string based on the current system locale.
static java.lang.String	formatNumber(long number) Returns a formatted number string based on the current system locale.
static java.lang.String	formatNumber(long number, boolean fmtzero) Returns a formatted number string based on the current system locale.
static java.lang.String	formatNumber(long number, boolean fmtzero, boolean fmtgrps) Returns a formatted number string based on the current system locale.
static java.lang.String	formatString(java.lang.String text, java.lang.String... values) Returns a formatted string with the given set of substitution values inserted into the given text.
static java.lang.String	formatTime(java.util.Date date, int style) Returns a formatted time string for the given date using the given format style and default locale and default timezone.
static java.lang.String	formatTime(java.util.Date date, int style, java.util.Locale locale) Returns a formatted time string for the given date using the given format style, locale and default timezone.
static java.lang.String	formatTime(java.util.Date date, int style, java.util.Locale locale, java.util.TimeZone tz) Returns a formatted time string for the given date using the given format style, locale and timezone.
static java.lang.String	formatTime(java.util.Date date, int style, java.util.TimeZone tz) Returns a formatted time string for the given date using the given format style, timezone and default locale.
static java.lang.String	formatTimeInput(java.util.Date date) Returns a formatted time string for the given date using the properties "Site.Format.TimeInput" definition.
static java.lang.String	getClassRootName(java.lang.Class<?> clazz) Returns a class' root name (what follows the package name).
private static java.text.DecimalFormat	getCurrencyFormatter(int fmtidx) Returns the decimal formatter used to format and parse currency numbers.
static java.lang.String	getCurrencyFormatterPattern(int fmtidx) Returns the pattern for the decimal formatter used to format and parse currency numbers.
static java.text.DateFormat	getDateFormatter(int style) Returns a date formatter using the given format style, default locale and default timezone.
static java.text.DateFormat	getDateFormatter(int style, java.util.Locale locale) Returns a date formatter using the given format style, locale and default timezone.
static java.text.DateFormat	getDateFormatter(int style, java.util.Locale locale, java.util.TimeZone tz) Returns a date formatter using the given format style, locale and timezone.
static java.text.DateFormat	getDateFormatter(int style, java.util.TimeZone tz) Returns a date formatter using the given format style, timezone and default locale.
static java.text.DateFormat	getDateTimeFormatter(int style) Returns a date and time formatter using the given format style, default locale and default timezone.
static java.text.DateFormat	getDateTimeFormatter(int style, java.util.Locale locale) Returns a date and time formatter using the given format style, locale and default timezone.
static java.text.DateFormat	getDateTimeFormatter(int style, java.util.Locale locale, java.util.TimeZone tz) Returns a date and time formatter using the given format style, locale and timezone.
static java.text.DateFormat	getDateTimeFormatter(int style, java.util.TimeZone tz) Returns a date and time formatter using the given format style, timezone and default locale.
private static java.text.DecimalFormat	getDecimalFormatter(int fmtidx) Returns the decimal formatter used to format and parse decimal numbers.
static java.lang.String	getDecimalFormatterPattern(int fmtidx) Returns the pattern for the decimal formatter used to format and parse decimal numbers.
private static java.text.NumberFormat	getIntegerFormatter(int fmtidx) Returns the number formatter used to format and parse whole numbers.
static java.lang.String	getIntegerFormatterPattern(int fmtidx) Returns the pattern for the number formatter used to format and parse whole numbers.
static java.lang.String	getInvokerIdentity(java.lang.Object invokee) Returns the reference point within the code from where the given invokee is being called.
static java.lang.String	getInvokerIdentity(java.lang.String invokee) Returns the reference point within the code from where the given invokee is being called.
static java.lang.String	getResourceContent(java.lang.String resname) Returns a String for the given resource file name's content.
static java.lang.String	getResourceContent(java.lang.String resname, boolean trim) Returns a String for the given resource file name's content.
static java.lang.String	getResourcePath(java.lang.String resname) Returns the file path to the given resource file name.
static java.io.BufferedReader	getResourceReader(java.lang.String resname) Returns a BufferedReader for the given resource file name.
static java.io.InputStream	getResourceStream(java.lang.String resname) Returns an input stream for the given resource file name.
static java.net.URL	getResourceURL(java.lang.String resname) Returns a URL for the given resource file name.
static java.util.ArrayList<java.lang.String>	getSortedPropertiesList(java.util.Properties props) Returns a sorted list of the property keys and values in the given set of properties.
static java.text.DateFormat	getTimeFormatter(int style) Returns a time formatter using the given format style, default locale and default timezone.
static java.text.DateFormat	getTimeFormatter(int style, java.util.Locale locale) Returns a time formatter using the given format style, locale and default timezone.
static java.text.DateFormat	getTimeFormatter(int style, java.util.Locale locale, java.util.TimeZone tz) Returns a time formatter using the given format style, locale and timezone.
static java.text.DateFormat	getTimeFormatter(int style, java.util.TimeZone tz) Returns a time formatter using the given format style, timezone and default locale.
static java.util.Properties	loadProperties(java.io.File file) Returns a Properties object that contains the contents of the given properties file.
static java.util.Properties	loadProperties(java.lang.String propfile) Returns a Properties object that contains the contents of the given properties file.
static java.lang.String	pad(java.lang.String base, int direction, int length, char padChar) Returns a string of the given length filled with the given character.
static java.lang.String	padL(java.lang.String base, int length) Convenience method to pad a string on the left with spaces.
static java.lang.String	padR(java.lang.String base, int length) Convenience method to pad a string on the right with spaces.
static java.lang.String	padWithChar(int length, char character) Returns a string of the given length filled with the given character.
static java.util.ArrayList<java.lang.String>	parseCSV(java.lang.String line) Parses a string encoded in CSV format.
static java.util.Date	parseDate(java.lang.String date) Parses the given date string into a Date object.
static java.util.Date	parseDate(java.lang.String date, java.util.Locale locale) Parses the given date string into a Date object.
static java.util.Date	parseDate(java.lang.String date, java.util.Locale locale, java.util.TimeZone tz) Parses the given date string into a Date object.
static java.util.Date	parseDate(java.lang.String date, java.util.TimeZone tz) Parses the given date string into a Date object.
static java.util.Date	parseDateInput(java.lang.String date) Parses the given date string into a Date object using the properties "Site.Format.DateInput" definition.
static double	parseDouble(java.lang.String number) Parses the given number string into a double value.
static <T extends java.lang.Enum<T>> T	parseEnum(java.lang.Class<T> clazz, java.lang.String name) Parses the given enum and returns the constant having the given name.
static float	parseFloat(java.lang.String number) Parses the given number string into a float value.
static int	parseInteger(java.lang.String number) Parses the given number string into an int value.
static long	parseLong(java.lang.String number) Parses the given number string into a long value.
static short	parseShort(java.lang.String number) Parses the given number string into a short value.
static java.lang.String[]	parseString(java.lang.String s, java.lang.String delimiter) Parses a given string into an array of strings based on a given delimiter.
static java.util.Date	parseTimeInput(java.lang.String time) Parses the given time string into a Date object using the properties "Site.Format.TimeInput" definition.
static java.lang.String	replaceString(java.lang.String s, java.lang.String oldstr, java.lang.String newstr) Returns the given string with all occurrences of a substring replaced with another substring.
static java.math.BigDecimal	roundCurrency(java.math.BigDecimal value) Returns the given value rounded to the appropriate number of currency decimal positions.
static java.math.BigDecimal	roundCurrency(double value) Returns the given value rounded to the appropriate number of currency decimal positions.
static java.util.ArrayList<java.lang.String>	stringToArrayList(java.lang.String s, int maxlen) Converts a string into a collection of string elements with each element's length being not more than a maximum length.
static char	toHexChar(int nibble) Convert a nibble (4 bits) to a hex character.
static java.lang.String	toMixedCase(java.lang.String s) Returns a mixed case string for the given string.
static java.lang.String	trimR(java.lang.String s) Removes trailing spaces from a string.
static java.lang.String	truncate(java.lang.String input, int maxLen) Returns the string, truncated to maximum length.
static java.lang.Object[]	vectorToObjectArray(java.util.Vector<?> v) Converts a given vector to an object array.
static java.lang.String[]	vectorToStringArray(java.util.Vector<?> v) Converts a given vector to a string array.

Methods inherited from class java.lang.Object

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

Field Detail

serialVersionUID

private static final long serialVersionUID

The class' serialization version id.

See Also:

Constant Field Values

LEFT

public static final int LEFT

Constant used for left padding.

See Also:

Constant Field Values

RIGHT

public static final int RIGHT

Constant used for right padding.

See Also:

Constant Field Values

cvCurrencyFormat

private static java.text.DecimalFormat[] cvCurrencyFormat

An array of formatters used to format and parse currency numbers. The 1st formatter is used when grouping separators are included. The 2nd is used when grouping separators are not included.

cvDecimalFormat

private static java.text.DecimalFormat[] cvDecimalFormat

An array of formatters used to format and parse decimal numbers. The 1st formatter is used when grouping separators are included. The 2nd is used when grouping separators are not included.

cvNumberFormat

private static java.text.NumberFormat[] cvNumberFormat

An array of formatters used to format and parse whole numbers. The 1st formatter is used when grouping separators are included. The 2nd is used when grouping separators are not included.

hexDigit

private static char[] hexDigit

Hexidecimal digits used to convert characters to hex output.

Constructor Detail

Util

public Util()

Method Detail

addSiteRootPath

public static java.lang.String addSiteRootPath(java.lang.String s)

Adds the site's root path to the beginning of the given string.

Parameters:

s - (String) The string to process.

Returns:

String - The given string with the root path prepended to it.

addSiteRootPathURL

public static java.lang.String addSiteRootPathURL(java.lang.String s)

Adds the site's root path to the beginning of the given string and returns the result as a URL.

Parameters:

s - (String) The string to process.

Returns:

String - The given string with the root path prepended to it.

arrayListToObjectArray

public static java.lang.Object[] arrayListToObjectArray(java.util.ArrayList<?> al)

Converts a given array list to an object array.

Parameters:

al - (ArrayList) The array list that is to be converted.

Returns:

Object[] - The resulting object array.

arrayListToStringArray

public static java.lang.String[] arrayListToStringArray(java.util.ArrayList<?> al)

Converts a given array list to a string array.

Parameters:

al - (ArrayList) The array list that is to be converted.

Returns:

String[] - The resulting string array.

booleanToYesNo

public static java.lang.String booleanToYesNo(boolean value)

Returns a string of "Yes" or "No" corresponding to the true (yes) or false (no) value of the given boolean parameter.

Parameters:

value - (boolean) The boolean value.

Returns:

String - "Yes" if parameter is true, "No" if false.

escapeRegEx

public static java.lang.String escapeRegEx(java.lang.String s)

Returns an escaped string that is suitable for use as a regular expression pattern. The given string should simply contain the character(s) that are to be matched vs. a preformatted regex pattern string. This method assumes that any regex metacharacters contained in the given string are characters to be matched, meaning that any metacharacters in the string are escaped.

Parameters:

s - (String) The string to process.

Returns:

String - The escaped string.

findInArray

public static int findInArray(java.lang.String[] array,
                              java.lang.String value)

Finds the given value in the given array and returns the index of the value within the array. Searching is case insensitive.

Parameters:

array - (String[]) The array to search.

value - (String) The value to find.

Returns:

int - The index of the value within the array or -1 if the value was not found.

formatCurrency

public static java.lang.String formatCurrency(java.math.BigDecimal number)

Returns a formatted currency string based on the current system locale. Zero value numbers are always formatted and always includes grouping separators.

Parameters:

number - (BigDecimal) The number to format.

Returns:

String - A formatted currency string for the given number.

formatCurrency

public static java.lang.String formatCurrency(java.math.BigDecimal number,
                                              boolean fmtzero)

Returns a formatted currency string based on the current system locale. Always includes grouping separators.

Parameters:

number - (BigDecimal) The number to format.

fmtzero - (boolean) true if zero value numbers are to be formatted, otherwise false.

Returns:

String - A formatted currency string for the given number.

formatCurrency

public static java.lang.String formatCurrency(java.math.BigDecimal number,
                                              boolean fmtzero,
                                              boolean fmtgrps)

Returns a formatted currency string based on the current system locale. Optionally includes grouping separators.

Parameters:

number - (BigDecimal) The number to format.

fmtzero - (boolean) true if zero value numbers are to be formatted, otherwise false.

fmtgrps - (boolean) true if grouping separators are to be included, otherwise false.

Returns:

String - A formatted currency string for the given number.

formatCurrency

public static java.lang.String formatCurrency(double number)

Returns a formatted currency string based on the current system locale. Zero value numbers are always formatted and always includes grouping separators.

Parameters:

number - (double) The number to format.

Returns:

String - A formatted currency string for the given number.

formatCurrency

public static java.lang.String formatCurrency(double number,
                                              boolean fmtzero)

Returns a formatted currency string based on the current system locale. Always includes grouping separators.

Parameters:

number - (double) The number to format.

fmtzero - (boolean) true if zero value numbers are to be formatted, otherwise false.

Returns:

String - A formatted currency string for the given number.

formatCurrency

public static java.lang.String formatCurrency(double number,
                                              boolean fmtzero,
                                              boolean fmtgrps)

Returns a formatted currency string based on the current system locale. Optionally includes grouping separators.

Parameters:

number - (double) The number to format.

fmtzero - (boolean) true if zero value numbers are to be formatted, otherwise false.

fmtgrps - (boolean) true if grouping separators are to be included, otherwise false.

Returns:

String - A formatted currency string for the given number.

formatDate

public static java.lang.String formatDate(java.util.Date date,
                                          int style)

Returns a formatted date string for the given date using the given format style, default locale and default timezone. Valid format styles are:

• DateFormat.FULL
• DateFormat.LONG
• DateFormat.MEDIUM
• DateFormat.SHORT

Parameters:

date - (Date) The date to format.

style - (int) The desired style of the formatted date.

Returns:

String - A formatted date string for the given date and style and default locale and default timezone.

formatDate

public static java.lang.String formatDate(java.util.Date date,
                                          int style,
                                          java.util.Locale locale)

Returns a formatted date string for the given date using the given format style, locale and default timezone. Valid format styles are:

• DateFormat.FULL
• DateFormat.LONG
• DateFormat.MEDIUM
• DateFormat.SHORT

Parameters:

date - (Date) The date to format.

style - (int) The desired style of the formatted date.

locale - (Locale) The desired locale of the formatted date.

Returns:

String - A formatted date string for the given date, style and locale and default timezone.

formatDate

public static java.lang.String formatDate(java.util.Date date,
                                          int style,
                                          java.util.TimeZone tz)

Returns a formatted date string for the given date using the given format style, timezone and default locale. Valid format styles are:

• DateFormat.FULL
• DateFormat.LONG
• DateFormat.MEDIUM
• DateFormat.SHORT

Parameters:

date - (Date) The date to format.

style - (int) The desired style of the formatted date.

tz - (TimeZone) The desired timezone for the formatted date.

Returns:

String - A formatted date string for the given date, style and timezone and default locale.

formatDate

public static java.lang.String formatDate(java.util.Date date,
                                          int style,
                                          java.util.Locale locale,
                                          java.util.TimeZone tz)

Returns a formatted date string for the given date using the given format style, locale and timezone. Valid format styles are:

• DateFormat.FULL
• DateFormat.LONG
• DateFormat.MEDIUM
• DateFormat.SHORT

Parameters:

date - (Date) The date to format.

style - (int) The desired style of the formatted date.

locale - (Locale) The desired locale of the formatted date.

tz - (TimeZone) The desired timezone for the formatted date.

Returns:

String - A formatted date string for the given date, style, locale and timezone.

formatDateInput

public static java.lang.String formatDateInput(java.util.Date date)

Returns a formatted date string for the given date using the properties "Site.Format.DateInput" definition.

Parameters:

date - (Date) The date to format.

Returns:

String - A formatted date string for the given date. Returns an empty string if the given date is null.

formatDateTime

public static java.lang.String formatDateTime(java.util.Date date,
                                              int style)

Returns a formatted date and time string for the given date using the given format style, default locale and default timezone. Valid format styles are:

• DateFormat.FULL
• DateFormat.LONG
• DateFormat.MEDIUM
• DateFormat.SHORT

Parameters:

date - (Date) The date to format.

style - (int) The desired style of the formatted date.

Returns:

String - A formatted date and time string for the given date and style and default locale and default timezone.

formatDateTime

public static java.lang.String formatDateTime(java.util.Date date,
                                              int style,
                                              java.util.Locale locale)

Returns a formatted date and time string for the given date using the given format style, locale and default timezone. Valid format styles are:

• DateFormat.FULL
• DateFormat.LONG
• DateFormat.MEDIUM
• DateFormat.SHORT

Parameters:

date - (Date) The date to format.

style - (int) The desired style of the formatted date.

locale - (Locale) The desired locale of the formatted date.

Returns:

String - A formatted date and time string for the given date, style, locale and default timezone.

formatDateTime

public static java.lang.String formatDateTime(java.util.Date date,
                                              int style,
                                              java.util.TimeZone tz)

Returns a formatted date and time string for the given date using the given format style, timezone and default locale. Valid format styles are:

• DateFormat.FULL
• DateFormat.LONG
• DateFormat.MEDIUM
• DateFormat.SHORT

Parameters:

date - (Date) The date to format.

style - (int) The desired style of the formatted date.

tz - (TimeZone) The desired timezone for the formatted date.

Returns:

String - A formatted date and time string for the given date, style, timezone and default locale.

formatDateTime

public static java.lang.String formatDateTime(java.util.Date date,
                                              int style,
                                              java.util.Locale locale,
                                              java.util.TimeZone tz)

Returns a formatted date and time string for the given date using the given format style, locale and timezone. Valid format styles are:

• DateFormat.FULL
• DateFormat.LONG
• DateFormat.MEDIUM
• DateFormat.SHORT

Parameters:

date - (Date) The date to format.

style - (int) The desired style of the formatted date.

locale - (Locale) The desired locale of the formatted date.

tz - (TimeZone) The desired timezone for the formatted date.

Returns:

String - A formatted date and time string for the given date, style, locale and timezone.

formatNumber

public static java.lang.String formatNumber(java.math.BigDecimal number)

Returns a formatted number string based on the current system locale. Zero value numbers are always formatted and always includes grouping separators.

Parameters:

number - (BigDecimal) The number to format.

Returns:

String - A formatted number string for the given number.

formatNumber

public static java.lang.String formatNumber(java.math.BigDecimal number,
                                            boolean fmtzero)

Returns a formatted number string based on the current system locale. Always includes grouping separators.

Parameters:

number - (BigDecimal) The number to format.

fmtzero - (boolean) true if zero value numbers are to be formatted, otherwise false.

Returns:

String - A formatted number string for the given number.

formatNumber

public static java.lang.String formatNumber(java.math.BigDecimal number,
                                            boolean fmtzero,
                                            boolean fmtgrps)

Returns a formatted number string based on the current system locale. Optionally includes grouping separators.

Parameters:

number - (BigDecimal) The number to format.

fmtzero - (boolean) true if zero value numbers are to be formatted, otherwise false.

fmtgrps - (boolean) true if grouping separators are to be included, otherwise false.

Returns:

String - A formatted number string for the given number.

formatNumber

public static java.lang.String formatNumber(double number)

Returns a formatted number string based on the current system locale. Zero value numbers are always formatted and always includes grouping separators.

Parameters:

number - (double) The number to format.

Returns:

String - A formatted number string for the given number.

formatNumber

public static java.lang.String formatNumber(double number,
                                            boolean fmtzero)

Returns a formatted number string based on the current system locale. Always includes grouping separators.

Parameters:

number - (double) The number to format.

fmtzero - (boolean) true if zero value numbers are to be formatted, otherwise false.

Returns:

String - A formatted number string for the given number.

formatNumber

public static java.lang.String formatNumber(double number,
                                            boolean fmtzero,
                                            boolean fmtgrps)

Returns a formatted number string based on the current system locale. Optionally includes grouping separators.

Parameters:

number - (double) The number to format.

fmtzero - (boolean) true if zero value numbers are to be formatted, otherwise false.

fmtgrps - (boolean) true if grouping separators are to be included, otherwise false.

Returns:

String - A formatted number string for the given number.

formatNumber

public static java.lang.String formatNumber(long number)

Returns a formatted number string based on the current system locale. Zero value numbers are always formatted and always includes grouping separators.

Parameters:

number - (long) The number to format.

Returns:

String - A formatted number string for the given number.

formatNumber

public static java.lang.String formatNumber(long number,
                                            boolean fmtzero)

Returns a formatted number string based on the current system locale. Always includes grouping separators.

Parameters:

number - (long) The number to format.

fmtzero - (boolean) true if zero value numbers are to be formatted, otherwise false.

Returns:

String - A formatted number string for the given number.

formatNumber

public static java.lang.String formatNumber(long number,
                                            boolean fmtzero,
                                            boolean fmtgrps)

Returns a formatted number string based on the current system locale. Optionally includes grouping separators.

Parameters:

number - (long) The number to format.

fmtzero - (boolean) true if zero value numbers are to be formatted, otherwise false.

fmtgrps - (boolean) true if grouping separators are to be included, otherwise false.

Returns:

String - A formatted number string for the given number.

formatString

public static java.lang.String formatString(java.lang.String text,
                                            java.lang.String... values)

Returns a formatted string with the given set of substitution values inserted into the given text. Substitution positions within the given text are denoted by {n} where n is a zero-based ordinal for each value to be substituted (i.e. {0} {1} {2} {3}).

Parameters:

text - (String) The text that is to have values substituted into it.

values - (String) The value(s) that are to be substituted into the given text. This parm uses the varargs feature and can therefore be passed as multiple parms (text, value1, value2, value3, valueN) or as an array (text, values[]).

Returns:

String - The formatted string.

formatTime

public static java.lang.String formatTime(java.util.Date date,
                                          int style)

Returns a formatted time string for the given date using the given format style and default locale and default timezone. Valid format styles are:

• DateFormat.FULL
• DateFormat.LONG
• DateFormat.MEDIUM
• DateFormat.SHORT

Parameters:

date - (Date) The date to format.

style - (int) The desired style of the formatted time.

Returns:

String - A formatted time string for the given date and style and default locale and default timezone.

formatTime

public static java.lang.String formatTime(java.util.Date date,
                                          int style,
                                          java.util.Locale locale)

Returns a formatted time string for the given date using the given format style, locale and default timezone. Valid format styles are:

• DateFormat.FULL
• DateFormat.LONG
• DateFormat.MEDIUM
• DateFormat.SHORT

Parameters:

date - (Date) The date to format.

style - (int) The desired style of the formatted time.

locale - (Locale) The desired locale of the formatted time.

Returns:

String - A formatted time string for the given date, style, locale and default timezone.

formatTime

public static java.lang.String formatTime(java.util.Date date,
                                          int style,
                                          java.util.TimeZone tz)

Returns a formatted time string for the given date using the given format style, timezone and default locale. Valid format styles are:

• DateFormat.FULL
• DateFormat.LONG
• DateFormat.MEDIUM
• DateFormat.SHORT

Parameters:

date - (Date) The date to format.

style - (int) The desired style of the formatted time.

tz - (TimeZone) The desired timezone for the formatted time.

Returns:

String - A formatted time string for the given date, style, timezone and default locale.

formatTime

public static java.lang.String formatTime(java.util.Date date,
                                          int style,
                                          java.util.Locale locale,
                                          java.util.TimeZone tz)

Returns a formatted time string for the given date using the given format style, locale and timezone. Valid format styles are:

• DateFormat.FULL
• DateFormat.LONG
• DateFormat.MEDIUM
• DateFormat.SHORT

Parameters:

date - (Date) The date to format.

style - (int) The desired style of the formatted time.

locale - (Locale) The desired locale of the formatted time.

tz - (TimeZone) The desired timezone for the formatted time.

Returns:

String - A formatted time string for the given date, style, locale and timezone.

formatTimeInput

public static java.lang.String formatTimeInput(java.util.Date date)

Returns a formatted time string for the given date using the properties "Site.Format.TimeInput" definition.

Parameters:

date - (Date) The date to format.

Returns:

String - A formatted time string for the given date. Returns an empty string if the given date is null.

getClassRootName

public static java.lang.String getClassRootName(java.lang.Class<?> clazz)

Returns a class' root name (what follows the package name).

Parameters:

clazz - (Class) A class object.

Returns:

String - The class' name sans package.

getCurrencyFormatter

private static java.text.DecimalFormat getCurrencyFormatter(int fmtidx)

Returns the decimal formatter used to format and parse currency numbers.

Parameters:

fmtidx - (int) The index of the formatter to return. The 1st formatter (index 0) is used when grouping separators are to be included in the formatted results. The 2nd formatter (index 1) is used when grouping separators are not included.

Returns:

DecimalFormat - The currency formatter. The formatter returned is based on the current system locale. The formatter does not make any assumptions regarding decimal positions.

getCurrencyFormatterPattern

public static java.lang.String getCurrencyFormatterPattern(int fmtidx)

Returns the pattern for the decimal formatter used to format and parse currency numbers.

Parameters:

fmtidx - (int) The index of the pattern to return. The 1st pattern (index 0) is used when grouping separators are to be included in the formatted results. The 2nd pattern (index 1) is used when grouping separators are not included.

Returns:

String - The currency formatter pattern. The pattern returned is based on the current system locale. The pattern does not make any assumptions regarding decimal positions.

getDateFormatter

public static java.text.DateFormat getDateFormatter(int style)

Returns a date formatter using the given format style, default locale and default timezone. Valid format styles are:

• DateFormat.FULL
• DateFormat.LONG
• DateFormat.MEDIUM
• DateFormat.SHORT

Parameters:

style - (int) The desired style of the formatter.

Returns:

DateFormat - A date formatter for the given style and default locale and default timezone.

getDateFormatter

public static java.text.DateFormat getDateFormatter(int style,
                                                    java.util.Locale locale)

Returns a date formatter using the given format style, locale and default timezone. Valid format styles are:

• DateFormat.FULL
• DateFormat.LONG
• DateFormat.MEDIUM
• DateFormat.SHORT

Parameters:

style - (int) The desired style of the formatter.

locale - (Locale) The desired locale of the formatter.

Returns:

DateFormat - A date formatter for the given style, locale and default timezone.

getDateFormatter

public static java.text.DateFormat getDateFormatter(int style,
                                                    java.util.TimeZone tz)

Returns a date formatter using the given format style, timezone and default locale. Valid format styles are:

• DateFormat.FULL
• DateFormat.LONG
• DateFormat.MEDIUM
• DateFormat.SHORT

Parameters:

style - (int) The desired style of the formatter.

tz - (TimeZone) The desired timezone for the formatter.

Returns:

DateFormat - A date formatter for the given style, timezone and default locale.

getDateFormatter

public static java.text.DateFormat getDateFormatter(int style,
                                                    java.util.Locale locale,
                                                    java.util.TimeZone tz)

Returns a date formatter using the given format style, locale and timezone. Valid format styles are:

• DateFormat.FULL
• DateFormat.LONG
• DateFormat.MEDIUM
• DateFormat.SHORT

Parameters:

style - (int) The desired style of the formatter.

locale - (Locale) The desired locale of the formatter.

tz - (TimeZone) The desired timezone for the formatter.

Returns:

DateFormat - A date formatter for the given style, locale and timezone.

getDateTimeFormatter

public static java.text.DateFormat getDateTimeFormatter(int style)

Returns a date and time formatter using the given format style, default locale and default timezone. Valid format styles are:

• DateFormat.FULL
• DateFormat.LONG
• DateFormat.MEDIUM
• DateFormat.SHORT

Parameters:

style - (int) The desired style of the formatter.

Returns:

DateFormat - A date and time formatter for the given style and default locale and default timezone.

getDateTimeFormatter

public static java.text.DateFormat getDateTimeFormatter(int style,
                                                        java.util.Locale locale)

Returns a date and time formatter using the given format style, locale and default timezone. Valid format styles are:

• DateFormat.FULL
• DateFormat.LONG
• DateFormat.MEDIUM
• DateFormat.SHORT

Parameters:

style - (int) The desired style of the formatter.

locale - (Locale) The desired locale of the formatter.

Returns:

DateFormat - A date and time formatter for the given style, locale and default timezone.

getDateTimeFormatter

public static java.text.DateFormat getDateTimeFormatter(int style,
                                                        java.util.TimeZone tz)

Returns a date and time formatter using the given format style, timezone and default locale. Valid format styles are:

• DateFormat.FULL
• DateFormat.LONG
• DateFormat.MEDIUM
• DateFormat.SHORT

Parameters:

style - (int) The desired style of the formatter.

tz - (TimeZone) The desired timezone for the formatter.

Returns:

DateFormat - A date and time formatter for the given style, timezone and default locale.

getDateTimeFormatter

public static java.text.DateFormat getDateTimeFormatter(int style,
                                                        java.util.Locale locale,
                                                        java.util.TimeZone tz)

Returns a date and time formatter using the given format style, locale and timezone. Valid format styles are:

• DateFormat.FULL
• DateFormat.LONG
• DateFormat.MEDIUM
• DateFormat.SHORT

Parameters:

style - (int) The desired style of the formatter.

locale - (Locale) The desired locale of the formatter.

tz - (TimeZone) The desired timezone for the formatter.

Returns:

DateFormat - A date and time formatter for the given style, locale and timezone.

getDecimalFormatter

private static java.text.DecimalFormat getDecimalFormatter(int fmtidx)

Returns the decimal formatter used to format and parse decimal numbers.

Parameters:

fmtidx - (int) The index of the formatter to return. The 1st formatter (index 0) is used when grouping separators are to be included in the formatted results. The 2nd formatter (index 1) is used when grouping separators are not included.

Returns:

DecimalFormat - The decimal formatter. The formatter returned is based on the current system locale. The formatter does not make any assumptions regarding decimal positions.

getDecimalFormatterPattern

public static java.lang.String getDecimalFormatterPattern(int fmtidx)

Returns the pattern for the decimal formatter used to format and parse decimal numbers.

Parameters:

fmtidx - (int) The index of the pattern to return. The 1st pattern (index 0) is used when grouping separators are to be included in the formatted results. The 2nd pattern (index 1) is used when grouping separators are not included.

Returns:

String - The decimal formatter pattern. The pattern returned is based on the current system locale. The pattern does not make any assumptions regarding decimal positions.

getIntegerFormatter

private static java.text.NumberFormat getIntegerFormatter(int fmtidx)

Returns the number formatter used to format and parse whole numbers.

Parameters:

fmtidx - (int) The index of the formatter to return. The 1st formatter (index 0) is used when grouping separators are to be included in the formatted results. The 2nd formatter (index 1) is used when grouping separators are not included.

Returns:

NumberFormat - The number formatter. The formatter returned is based on the current system locale. The formatter assumes zero decimal positions.

getIntegerFormatterPattern

public static java.lang.String getIntegerFormatterPattern(int fmtidx)

Returns the pattern for the number formatter used to format and parse whole numbers.

Parameters:

fmtidx - (int) The index of the pattern to return. The 1st pattern (index 0) is used when grouping separators are to be included in the formatted results. The 2nd pattern (index 1) is used when grouping separators are not included.

Returns:

String - The number formatter pattern. The pattern returned is based on the current system locale. The pattern assumes zero decimal positions.

getInvokerIdentity

public static java.lang.String getInvokerIdentity(java.lang.Object invokee)

Returns the reference point within the code from where the given invokee is being called. The format of the reference point is a single line of text that contains the same information as what is generated on a single line of a printStackTrace().

To use, call this method from within the method where you wish to know the invoker's identity. Pass the class object that contains the method being invoked (i.e. "this").

This method determines the invoker's identity by obtaining a stack trace and then searching the stack for the given invokee's entry. The method then returns the next entry in the stack that follows the invokee's entry.

Parameters:

invokee - (Object) The class object containing the method being invoked (i.e. "this").

Returns:

String - The invoker's identity, generally formatted as "at package.class.method(class.java:statement)". The format may be slightly different depending on the JVM being used.

getInvokerIdentity

public static java.lang.String getInvokerIdentity(java.lang.String invokee)

Returns the reference point within the code from where the given invokee is being called. The format of the reference point is a single line of text that contains the same information as what is generated on a single line of a printStackTrace().

To use, call this method from within the method where you wish to know the invoker's identity. Pass the name of the class that contains the method being invoked (i.e. "com.dpslink.ecomm.servlet.ReviewCart").

This method determines the invoker's identity by obtaining a stack trace and then searching the stack for the given invokee's entry. The method then returns the next entry in the stack that follows the invokee's entry.

Parameters:

invokee - (String) The name of the class containing the method being invoked (i.e. "com.dpslink.ecomm.servlet.ReviewCart").

Returns:

String - The invoker's identity, generally formatted as "at package.class.method(class.java:statement)". The format may be slightly different depending on the JVM being used.

getResourceContent

public static java.lang.String getResourceContent(java.lang.String resname)

Returns a String for the given resource file name's content. Resource files are assumed to reside in a folder that is accessible via the classpath. File names are assumed to be lower case. Always trims comments and blank lines from the result.

Parameters:

resname - (String) The name of the resource file to retrieve.

Returns:

String - The contents of the specified resource file.

getResourceContent

public static java.lang.String getResourceContent(java.lang.String resname,
                                                  boolean trim)

Returns a String for the given resource file name's content. Resource files are assumed to reside in a folder that is accessible via the classpath. File names are assumed to be lower case. Always trims comments from the result. Trimming blank lines is optional.

Parameters:

resname - (String) The name of the resource file to retrieve.

trim - (boolean) true to trim blank lines from the result, otherwise false.

Returns:

String - The contents of the specified resource file.

getResourcePath

public static java.lang.String getResourcePath(java.lang.String resname)

Returns the file path to the given resource file name. Resource files are assumed to reside in a folder that is accessible via the classpath. File names are assumed to be lower case.

Parameters:

resname - (String) The name of the resource file to retrieve.

Returns:

String - The path to the specified file name, or null if no file exists for the specified name. Includes trailing file separator character.

getResourceReader

public static java.io.BufferedReader getResourceReader(java.lang.String resname)

Returns a BufferedReader for the given resource file name. Resource files are assumed to reside in a folder that is accessible via the classpath. File names are assumed to be lower case.

Parameters:

resname - (String) The name of the resource file to retrieve.

Returns:

BufferedReader - A buffered reader for the specified file name, or null if no file exists for the specified name.

getResourceStream

public static java.io.InputStream getResourceStream(java.lang.String resname)

Returns an input stream for the given resource file name. Resource files are assumed to reside in a folder that is accessible via the classpath. This method makes no assumptions regarding the case of the resource name.

Parameters:

resname - (String) The name of the resource file to retrieve.

Returns:

InputStream - An input stream for the specified file name, or null if no file exists for the specified name.

getResourceURL

public static java.net.URL getResourceURL(java.lang.String resname)

Returns a URL for the given resource file name. Resource files are assumed to reside in a folder that is accessible via the classpath. File names are assumed to be lower case.

Parameters:

resname - (String) The name of the resource file to retrieve.

Returns:

URL - A URL for the specified file name, or null if no file exists for the specified name.

getSortedPropertiesList

public static java.util.ArrayList<java.lang.String> getSortedPropertiesList(java.util.Properties props)

Returns a sorted list of the property keys and values in the given set of properties.

Parameters:

props - (Properties) The properties to process.

Returns:

ArrayList - The sorted list.

getTimeFormatter

public static java.text.DateFormat getTimeFormatter(int style)

Returns a time formatter using the given format style, default locale and default timezone. Valid format styles are:

• DateFormat.FULL
• DateFormat.LONG
• DateFormat.MEDIUM
• DateFormat.SHORT

Parameters:

style - (int) The desired style of the formatter.

Returns:

DateFormat - A time formatter for the given style and default locale and default timezone.

getTimeFormatter

public static java.text.DateFormat getTimeFormatter(int style,
                                                    java.util.Locale locale)

Returns a time formatter using the given format style, locale and default timezone. Valid format styles are:

• DateFormat.FULL
• DateFormat.LONG
• DateFormat.MEDIUM
• DateFormat.SHORT

Parameters:

style - (int) The desired style of the formatter.

locale - (Locale) The desired locale of the formatter.

Returns:

DateFormat - A time formatter for the given style, locale and default timezone.

getTimeFormatter

public static java.text.DateFormat getTimeFormatter(int style,
                                                    java.util.TimeZone tz)

Returns a time formatter using the given format style, timezone and default locale. Valid format styles are:

• DateFormat.FULL
• DateFormat.LONG
• DateFormat.MEDIUM
• DateFormat.SHORT

Parameters:

style - (int) The desired style of the formatter.

tz - (TimeZone) The desired timezone for the formatter.

Returns:

DateFormat - A time formatter for the given style, timezone and default locale.

getTimeFormatter

public static java.text.DateFormat getTimeFormatter(int style,
                                                    java.util.Locale locale,
                                                    java.util.TimeZone tz)

Returns a time formatter using the given format style, locale and timezone. Valid format styles are:

• DateFormat.FULL
• DateFormat.LONG
• DateFormat.MEDIUM
• DateFormat.SHORT

Parameters:

style - (int) The desired style of the formatter.

locale - (Locale) The desired locale of the formatter.

tz - (TimeZone) The desired timezone for the formatter.

Returns:

DateFormat - A time formatter for the given style, locale and timezone.

loadProperties

public static java.util.Properties loadProperties(java.io.File file)

Returns a Properties object that contains the contents of the given properties file. If the properties file to load cannot be found or cannot be loaded, this method silently fails and returns an empty properties object.

Parameters:

file - (File) The file for the properties to load.

Returns:

Properties - The loaded properties.

loadProperties

public static java.util.Properties loadProperties(java.lang.String propfile)

Returns a Properties object that contains the contents of the given properties file. The properties file to load must be accessible via the classpath. If the properties file to load cannot be found or cannot be loaded, this method silently fails and returns an empty properties object.

Parameters:

propfile - (String) The name of the properties file to load.

Returns:

Properties - The loaded properties.

pad

public static java.lang.String pad(java.lang.String base,
                                   int direction,
                                   int length,
                                   char padChar)

Returns a string of the given length filled with the given character.

Parameters:

base - (String) String to be padded.

direction - (int) Pad direction (left or right).

length - (int) The length of the string to return.

padChar - (char) The character that is to be used as a fill character for the new string.

Returns:

String - containing the given number of characters.

padL

public static java.lang.String padL(java.lang.String base,
                                    int length)

Convenience method to pad a string on the left with spaces.

Parameters:

base - (String) String to be padded.

length - (int) The length of the string to return.

Returns:

String - containing the given number of characters.

padR

public static java.lang.String padR(java.lang.String base,
                                    int length)

Convenience method to pad a string on the right with spaces.

Parameters:

base - (String) String to be padded.

length - (int) The length of the string to return.

Returns:

String - containing the given number of characters.

padWithChar

public static java.lang.String padWithChar(int length,
                                           char character)

Returns a string of the given length filled with the given character.

Parameters:

length - (int) The length of the string to return.

character - (char) The character that is to be used as a fill character for the new string.

Returns:

String - containing the given number of characters.

parseCSV

public static java.util.ArrayList<java.lang.String> parseCSV(java.lang.String line)

Parses a string encoded in CSV format. Returns a collection containing the parsed fields or null if an error occurred.

Parameters:

line - (String) The text line to be parsed.

Returns:

ArrayList - The parsed result collection of String or null if a parsing error occurred.

parseDate

public static java.util.Date parseDate(java.lang.String date)

Parses the given date string into a Date object. In order for the given string to parse correctly, it must conform to the default locale DateFormat.SHORT format.

Parameters:

date - (String) The string to be parsed.

Returns:

Date - The Date object for the parsed string, or null if the given string could not be parsed.

parseDate

public static java.util.Date parseDate(java.lang.String date,
                                       java.util.Locale locale)

Parses the given date string into a Date object. In order for the given string to parse correctly, it must conform to the given locale's DateFormat.SHORT format.

Parameters:

date - (String) The string to be parsed.

locale - (Locale) The locale to use for the parsing.

Returns:

Date - The Date object for the parsed string, or null if the given string could not be parsed.

parseDate

public static java.util.Date parseDate(java.lang.String date,
                                       java.util.TimeZone tz)

Parses the given date string into a Date object. In order for the given string to parse correctly, it must conform to the default locale's DateFormat.SHORT format.

Parameters:

date - (String) The string to be parsed.

tz - (TimeZone) The timezone for the parsing.

Returns:

Date - The Date object for the parsed string, or null if the given string could not be parsed.

parseDate

public static java.util.Date parseDate(java.lang.String date,
                                       java.util.Locale locale,
                                       java.util.TimeZone tz)

Parses the given date string into a Date object. In order for the given string to parse correctly, it must conform to the given locale's DateFormat.SHORT format.

Parameters:

date - (String) The string to be parsed.

locale - (Locale) The locale to use for the parsing.

tz - (TimeZone) The timezone for the parsing.

Returns:

Date - The Date object for the parsed string, or null if the given string could not be parsed.

parseDateInput

public static java.util.Date parseDateInput(java.lang.String date)

Parses the given date string into a Date object using the properties "Site.Format.DateInput" definition.

Parameters:

date - (String) The string to be parsed.

Returns:

Date - The Date object for the parsed string, or null if the given string could not be parsed.

parseDouble

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

Parses the given number string into a double value.

Parameters:

number - (String) The string to be parsed.

Returns:

double - The parsed results, or zero if the given string could not be parsed.

parseEnum

public static <T extends java.lang.Enum<T>> T parseEnum(java.lang.Class<T> clazz,
                                                        java.lang.String name)

Parses the given enum and returns the constant having the given name.

Parameters:

clazz - (Class) The class for the enum to parse.

name - (String) The name of the constant to retrieve.

Returns:

Enum - The constant with the specified name or null if no constant could be determined.

parseFloat

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

Parses the given number string into a float value.

Parameters:

number - (String) The string to be parsed.

Returns:

float - The parsed results, or zero if the given string could not be parsed.

parseInteger

public static int parseInteger(java.lang.String number)

Parses the given number string into an int value.

Parameters:

number - (String) The string to be parsed.

Returns:

int - The parsed results, or zero if the given string could not be parsed.

parseLong

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

Parses the given number string into a long value.

Parameters:

number - (String) The string to be parsed.

Returns:

long - The parsed results, or zero if the given string could not be parsed.

parseShort

public static short parseShort(java.lang.String number)

Parses the given number string into a short value.

Parameters:

number - (String) The string to be parsed.

Returns:

short - The parsed results, or zero if the given string could not be parsed.

parseString

public static java.lang.String[] parseString(java.lang.String s,
                                             java.lang.String delimiter)

Parses a given string into an array of strings based on a given delimiter.

Parameters:

s - (String) The string to be parsed.

delimiter - (String) The delimiter to be used for the parsing.

Returns:

String[] - A string array containing the parsed results.

parseTimeInput

public static java.util.Date parseTimeInput(java.lang.String time)

Parses the given time string into a Date object using the properties "Site.Format.TimeInput" definition.

Parameters:

time - (String) The string to be parsed.

Returns:

Date - The Date object for the parsed string, or null if the given string could not be parsed.

replaceString

public static java.lang.String replaceString(java.lang.String s,
                                             java.lang.String oldstr,
                                             java.lang.String newstr)

Returns the given string with all occurrences of a substring replaced with another substring.

Parameters:

s - (String) The string to process.

oldstr - (String) The substring to find and replace.

newstr - (String) The replacement substring.

Returns:

String - The processed string.

roundCurrency

public static java.math.BigDecimal roundCurrency(double value)

Returns the given value rounded to the appropriate number of currency decimal positions.

Parameters:

value - (double) The value to round.

Returns:

BigDecimal - The rounded result.

roundCurrency

public static java.math.BigDecimal roundCurrency(java.math.BigDecimal value)

Returns the given value rounded to the appropriate number of currency decimal positions.

Parameters:

value - (BigDecimal) The value to round.

Returns:

BigDecimal - The rounded result.

stringToArrayList

public static java.util.ArrayList<java.lang.String> stringToArrayList(java.lang.String s,
                                                                      int maxlen)

Converts a string into a collection of string elements with each element's length being not more than a maximum length.

Parameters:

s - (String) The string to process.

maxlen - (int) The maximum length of a collection element's content.

Returns:

ArrayList - The processed results.

toHexChar

public static char toHexChar(int nibble)

Convert a nibble (4 bits) to a hex character.

Parameters:

nibble - (int) the nibble to convert.

Returns:

char - representing nibble.

toMixedCase

public static java.lang.String toMixedCase(java.lang.String s)

Returns a mixed case string for the given string.

Parameters:

s - (String) The string to process.

Returns:

String - The processed results.

trimR

public static java.lang.String trimR(java.lang.String s)

Removes trailing spaces from a string. Does not remove leading spaces.

Parameters:

s - (String) The string to trim.

Returns:

String - The trimmed results.

truncate

public static java.lang.String truncate(java.lang.String input,
                                        int maxLen)

Returns the string, truncated to maximum length.

Parameters:

input - (String) The string to truncate.

maxLen - (int) The maximum length of the string to return

Returns:

String - the truncated string.

vectorToObjectArray

public static java.lang.Object[] vectorToObjectArray(java.util.Vector<?> v)

Converts a given vector to an object array.

Parameters:

v - (Vector) The vector that is to be converted.

Returns:

Object[] - The resulting object array.

vectorToStringArray

public static java.lang.String[] vectorToStringArray(java.util.Vector<?> v)

Converts a given vector to a string array.

Parameters:

v - (Vector) The vector that is to be converted.

Returns:

String[] - The resulting string array.

arrayMath

public static java.util.ArrayList<java.math.BigDecimal> arrayMath(java.util.ArrayList<java.math.BigDecimal> a1,
                                                                  java.lang.String operator,
                                                                  java.util.ArrayList<java.math.BigDecimal> a2)

Performs a math operation on 2 operand arrays. A result array is returned which contains the element by element result of the operation. For example arrayMath(array1, "+", array2) will return a result array array3 where: array3[0] = array1[0] + array2[0] array3[1] = array1[1] + array2[1] array3[2] = array1[2] + array2[2] array3[n] = array1[n] + array2[n] Note: The result array will contain same number of elements as the largest operand array. If a corresponding element of one of the arrays is not present, then BigDecimal.ZERO is used.

Parameters:

a1 - (ArrayList) Operand array 1.

operator - (String) Operation to perform ("+", "-", "*", "/").

a2 - (ArrayList) Operand array 2.

Returns:

ArrayList[] - The resulting array.