connector.common

Class Util

java.lang.Object

connector.common.Util

public class Util
extends java.lang.Object

Constructor Summary

Constructors

Constructor and Description
Util()

Method Summary

Modifier and Type	Method and Description
static <T> java.util.List<T>	arrayToList(T[] array) Given an array, returns a list.
static java.util.List	asList(java.lang.Object o) Return a List with the given object.
static boolean	atob(java.lang.String a) Convert a string to a boolean.
static int	atoi(java.lang.String a) Convert a String value into a primitive integer value.
static int	atoi(java.lang.String a, int def) Convert a String value into a primitive integer value.
static long	atol(java.lang.String a) Convert a string to a long.
static java.lang.String	capitalize(java.lang.String str) Capitalize the first character of a string.
static java.lang.String	computeDifference(java.util.Date start, java.util.Date end)
static long	computeDifferenceMilli(java.util.Date start, java.util.Date end)
static java.util.List<java.lang.String>	convertStringToList(java.lang.String value, java.lang.String delimiter)
static java.util.Set<java.lang.String>	convertStringToSet(java.lang.String value, java.lang.String delimiter)
static java.util.List<java.lang.String>	csvToList(java.lang.String src)
static java.util.List<java.lang.String>	csvToList(java.lang.String src, java.lang.String delimiter)
static java.lang.String	dateToString(java.util.Date src)
static java.lang.String	dateToString(java.util.Date src, java.lang.String format)
static java.lang.String	dateToString(java.util.Date src, java.lang.String format, java.util.TimeZone tz)
static java.lang.String	dtoa(double d) Convert a double to a string.
static java.lang.String	escapeMetaCharacters(java.lang.String inputString) Escapes the following metaCharacters String[] metaCharacters = new String[]{"\\", "^", "$", "{", "}", "[", "]", "(", ")", ".", "*", "+", "?", "|", "<", ">", "-", "&", "%"};
static java.lang.String	escapeXmlSpecialChar(java.lang.String inputString)
static java.lang.String	expandVariables(java.lang.String src, java.util.Map<java.lang.String,java.lang.Object> variables)
static <T> java.util.List<T>	filterNulls(java.util.List<T> src) Remove nulls from a list.
static java.lang.String	ftoa(float f) Convert a float to a string.
static java.lang.Object	get(java.util.Map map, java.lang.String name)
static boolean	getBoolean(java.util.Map map, java.lang.String name)
static java.util.Date	getDate(java.lang.Object o)
static java.lang.String	getHostName()
static int	getInt(java.util.Map map, java.lang.String name)
static java.util.Map<java.lang.String,java.lang.String>	getJarDetails(java.lang.String jarClass, java.util.List<java.lang.String> attributes)
static java.lang.String	getString(java.util.Map map, java.lang.String name)
static java.lang.String	getString(java.lang.String s)
static long	getTimeDiff(java.time.Instant start)
static java.lang.Object	getValueFromMap(java.util.Map map, java.lang.String name)
static boolean	isAnyNullOrEmpty(java.lang.String... vals)
static boolean	isBooleanOrNumberOrList(java.lang.Object attributeValue)
static boolean	isEmpty(java.util.Collection collection)
static boolean	isEmpty(int[] args)
static boolean	isEmpty(java.util.Iterator i) Return true if the specified Iterator is empty.
static boolean	isEmpty(java.util.Map map)
static boolean	isEmpty(java.lang.Object[] args)
static boolean	isEmpty(java.lang.String src)
static boolean	isIdentityNow()
static boolean	isInt(java.lang.String str)
static boolean	isNothing(java.lang.String str)
static boolean	isNotNullOrEmpty(java.lang.String str)
static boolean	isNullOrEmpty(java.lang.String str)
static <T> java.lang.Iterable<T>	iterate(java.lang.Iterable<T> iterable)
static java.lang.String	itoa(int i) Convert an integer to a string.
static java.lang.String	listToCsv(java.util.List list)
static java.lang.String	listToCsv(java.util.List list, boolean filterEmpty)
static java.util.Map	listToMap(java.util.List<java.lang.String> listOfValues)
static java.lang.String	listToQuotedCsv(java.util.List list, java.lang.Character quoteChar, boolean filterEmpty)
static java.lang.String	listToQuotedCsv(java.util.List list, java.lang.Character quoteChar, boolean filterEmpty, boolean conditionallyQuote)
static java.lang.String	listToQuotedCsv(java.util.List list, java.lang.Character quoteChar, boolean filterEmpty, boolean conditionallyQuote, boolean conditionallyAddSpace)
static java.lang.String	ltoa(long l) Convert a long to a string.
static boolean	nullSafeCaseInsensitiveEq(java.lang.String o1, java.lang.String o2) This method performs a null-safe equality comparison between the two strings.
static <T extends java.lang.Comparable> int	nullSafeCompareTo(T o1, T o2) Return the compareTo() value for two objects that may be null.
static boolean	nullSafeContains(java.util.List list, java.lang.Object o) Check a list for the given object, checking for null on the list.
static boolean	nullSafeEq(java.lang.Object o1, java.lang.Object o2) This method performs a null-safe equality comparison between the two given objects.
static boolean	nullSafeEq(java.lang.Object o1, java.lang.Object o2, boolean nullsEq) This method performs a null-safe equality comparison between the two given objects.
static boolean	nullSafeEq(java.lang.Object o1, java.lang.Object o2, boolean nullsEq, boolean emptyStringToNull) This method performs a null-safe equality comparison between the two given objects.
static boolean	nullSafeEq(java.lang.String s1, java.lang.String s2)
static boolean	nullSafeEq(java.lang.String s1, java.lang.String s2, boolean nullsEq)
static boolean	otob(java.lang.Object o) Convert an object to a boolean.
static int	otoi(java.lang.Object o) Convert an object to a Integer.
static java.util.List<java.lang.String>	otol(java.lang.Object o) Convert an object to a List of Strings.
static java.util.List<java.lang.String>	otolForNonCSVList(java.lang.Object o)
static java.util.Map<java.lang.String,java.lang.Object>	otom(java.lang.Object o) Convert an object to a Map.
static java.lang.String	otos(java.lang.Object o) Convert an object to its string representation.
static <T> java.util.List<java.util.List<T>>	partition(java.util.Collection<T> members, int maxSize)
static java.lang.String	quoteNameSQLObject(java.lang.String sqlParam)
static java.lang.String	quoteSQLPassword(java.lang.String passwordToQuote)
static java.util.List<java.lang.String[]>	readFile(java.lang.String fileNameWithPath, java.lang.String delimiter, boolean skipHeaderOnFirstLine)
static <T> void	removeDuplicates(java.util.List<T> list)
static java.lang.String	replaceCharacter(java.lang.String toReplace, java.lang.String replaceWith, java.lang.String str)
static <T> java.lang.Iterable<T>	safeIterable(java.lang.Iterable<T> iterable)
static java.lang.String	setToCsv(java.util.Set<?> set)
static int	size(java.util.Collection c) Return the size of the given collection.
static java.lang.String	stackToString(java.lang.Throwable th)
static java.util.Date	stringToDate(java.lang.String src)
static java.util.List	stringToList(java.lang.String value)
static java.lang.String	trimWhitespace(java.lang.String src)
static java.lang.String	uuid()

Methods inherited from class java.lang.Object

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

Constructor Detail

Util

public Util()

Method Detail

uuid

public static java.lang.String uuid()

partition

public static <T> java.util.List<java.util.List<T>> partition(java.util.Collection<T> members,
                                                              int maxSize)

capitalize

public static java.lang.String capitalize(java.lang.String str)

Capitalize the first character of a string.

atoi

public static int atoi(java.lang.String a)

Convert a String value into a primitive integer value.

atoi

public static int atoi(java.lang.String a,
                       int def)

Convert a String value into a primitive integer value. If the string is invalid, the value of the "def" argument is returned.

otoi

public static int otoi(java.lang.Object o)

Convert an object to a Integer.

atol

public static long atol(java.lang.String a)

Convert a string to a long.

itoa

public static java.lang.String itoa(int i)

Convert an integer to a string.

ltoa

public static java.lang.String ltoa(long l)

Convert a long to a string.

ftoa

public static java.lang.String ftoa(float f)

Convert a float to a string.

dtoa

public static java.lang.String dtoa(double d)

Convert a double to a string.

otob

public static boolean otob(java.lang.Object o)

Convert an object to a boolean.

otos

public static java.lang.String otos(java.lang.Object o)

Convert an object to its string representation. This will convert Lists and Collections to comma-separated lists. Any other object is simply returned as its toString() representation.

Parameters:

o - The object to convert to a string.

Returns:

The string representation of the given object, or null if the given object is null.

otol

public static java.util.List<java.lang.String> otol(java.lang.Object o)

Convert an object to a List of Strings. This is useful when contending with arguments that may be coming in as CSVs or as Lists.

Parameters:

o - Either a List or a CSV list

Returns:

A new List containing all the elements in the specified object. Note that if the specified object is a List this method returns a new List containing all the elements of the one that was passed in.

otom

public static java.util.Map<java.lang.String,java.lang.Object> otom(java.lang.Object o)

Convert an object to a Map.

otolForNonCSVList

public static java.util.List<java.lang.String> otolForNonCSVList(java.lang.Object o)

getValueFromMap

public static java.lang.Object getValueFromMap(java.util.Map map,
                                               java.lang.String name)

csvToList

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

csvToList

public static java.util.List<java.lang.String> csvToList(java.lang.String src,
                                                         java.lang.String delimiter)

escapeMetaCharacters

public static java.lang.String escapeMetaCharacters(java.lang.String inputString)

Escapes the following metaCharacters String[] metaCharacters = new String[]{"\\", "^", "$", "{", "}", "[", "]", "(", ")", ".", "*", "+", "?", "|", "<", ">", "-", "&", "%"};

listToCsv

public static java.lang.String listToCsv(java.util.List list)

listToCsv

public static java.lang.String listToCsv(java.util.List list,
                                         boolean filterEmpty)

setToCsv

public static java.lang.String setToCsv(java.util.Set<?> set)

listToQuotedCsv

public static java.lang.String listToQuotedCsv(java.util.List list,
                                               java.lang.Character quoteChar,
                                               boolean filterEmpty)

listToQuotedCsv

public static java.lang.String listToQuotedCsv(java.util.List list,
                                               java.lang.Character quoteChar,
                                               boolean filterEmpty,
                                               boolean conditionallyQuote)

listToQuotedCsv

public static java.lang.String listToQuotedCsv(java.util.List list,
                                               java.lang.Character quoteChar,
                                               boolean filterEmpty,
                                               boolean conditionallyQuote,
                                               boolean conditionallyAddSpace)

size

public static int size(java.util.Collection c)

Return the size of the given collection.

Parameters:

c - The possibly-null collection to get the size of.

isNullOrEmpty

public static boolean isNullOrEmpty(java.lang.String str)

isNotNullOrEmpty

public static boolean isNotNullOrEmpty(java.lang.String str)

isEmpty

public static boolean isEmpty(java.util.Collection collection)

isEmpty

public static boolean isEmpty(java.util.Iterator i)

Return true if the specified Iterator is empty.

Parameters:

i - Iterator being checked

Returns:

true of the given Iterator is empty

isEmpty

public static boolean isEmpty(java.lang.Object[] args)

isEmpty

public static boolean isEmpty(java.util.Map map)

isEmpty

public static boolean isEmpty(java.lang.String src)

isNothing

public static boolean isNothing(java.lang.String str)

isInt

public static boolean isInt(java.lang.String str)

asList

public static java.util.List asList(java.lang.Object o)

Return a List with the given object. If the object is a List, it is returned. If the object is a collection, a List with all of the elements of the collection is returned. If the object is a non-collection, a new List containing the given object is returned. If the object is null, null is returned.

Parameters:

o - The object to return as a list.

getString

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

getString

public static java.lang.String getString(java.util.Map map,
                                         java.lang.String name)

convertStringToList

public static java.util.List<java.lang.String> convertStringToList(java.lang.String value,
                                                                   java.lang.String delimiter)

stringToList

public static java.util.List stringToList(java.lang.String value)

convertStringToSet

public static java.util.Set<java.lang.String> convertStringToSet(java.lang.String value,
                                                                 java.lang.String delimiter)

replaceCharacter

public static java.lang.String replaceCharacter(java.lang.String toReplace,
                                                java.lang.String replaceWith,
                                                java.lang.String str)

readFile

public static java.util.List<java.lang.String[]> readFile(java.lang.String fileNameWithPath,
                                                          java.lang.String delimiter,
                                                          boolean skipHeaderOnFirstLine)
                                                   throws java.lang.Exception

Throws:

java.lang.Exception

isBooleanOrNumberOrList

public static boolean isBooleanOrNumberOrList(java.lang.Object attributeValue)

quoteSQLPassword

public static java.lang.String quoteSQLPassword(java.lang.String passwordToQuote)

quoteNameSQLObject

public static java.lang.String quoteNameSQLObject(java.lang.String sqlParam)

iterate

public static <T> java.lang.Iterable<T> iterate(java.lang.Iterable<T> iterable)

safeIterable

public static <T> java.lang.Iterable<T> safeIterable(java.lang.Iterable<T> iterable)

stackToString

public static java.lang.String stackToString(java.lang.Throwable th)

atob

public static boolean atob(java.lang.String a)

Convert a string to a boolean.

listToMap

public static java.util.Map listToMap(java.util.List<java.lang.String> listOfValues)

isAnyNullOrEmpty

public static boolean isAnyNullOrEmpty(java.lang.String... vals)

get

public static java.lang.Object get(java.util.Map map,
                                   java.lang.String name)

getInt

public static int getInt(java.util.Map map,
                         java.lang.String name)

getBoolean

public static boolean getBoolean(java.util.Map map,
                                 java.lang.String name)

trimWhitespace

public static java.lang.String trimWhitespace(java.lang.String src)

nullSafeCaseInsensitiveEq

public static boolean nullSafeCaseInsensitiveEq(java.lang.String o1,
                                                java.lang.String o2)

This method performs a null-safe equality comparison between the two strings. This will return true if both objects are null and nullsEq is true. Empty or "null" strings will be converted to null before checking if emptyStringToNull is true.

nullSafeCompareTo

public static <T extends java.lang.Comparable> int nullSafeCompareTo(T o1,
                                                                     T o2)

Return the compareTo() value for two objects that may be null. Nulls are considered equal, and null is greater than non-null.

getHostName

public static java.lang.String getHostName()

nullSafeEq

public static boolean nullSafeEq(java.lang.String s1,
                                 java.lang.String s2,
                                 boolean nullsEq)

nullSafeEq

public static boolean nullSafeEq(java.lang.String s1,
                                 java.lang.String s2)

nullSafeContains

public static boolean nullSafeContains(java.util.List list,
                                       java.lang.Object o)

Check a list for the given object, checking for null on the list.

Parameters:

list -

o -

Returns:

true if value is found in the list

nullSafeEq

public static boolean nullSafeEq(java.lang.Object o1,
                                 java.lang.Object o2)

This method performs a null-safe equality comparison between the two given objects. If both objects are null, this returns false.

Parameters:

o1 - The first object to compare.

o2 - The second object to compare.

Returns:

True if both objects are non-null and equal.

nullSafeEq

public static boolean nullSafeEq(java.lang.Object o1,
                                 java.lang.Object o2,
                                 boolean nullsEq)

This method performs a null-safe equality comparison between the two given objects. This will return true if both objects are null and nullsEq is true.

Parameters:

o1 - The first object to compare.

o2 - The second object to compare.

nullsEq - Whether two null objects should be considered equal.

Returns:

True if both objects equal, or both objects are null and nullsEq is true.

nullSafeEq

public static boolean nullSafeEq(java.lang.Object o1,
                                 java.lang.Object o2,
                                 boolean nullsEq,
                                 boolean emptyStringToNull)

This method performs a null-safe equality comparison between the two given objects. This will return true if both objects are null and nullsEq is true. Empty or "null" strings will be converted to null before checking if emptyStringToNull is true.

getDate

public static java.util.Date getDate(java.lang.Object o)

dateToString

public static java.lang.String dateToString(java.util.Date src)

dateToString

public static java.lang.String dateToString(java.util.Date src,
                                            java.lang.String format)

dateToString

public static java.lang.String dateToString(java.util.Date src,
                                            java.lang.String format,
                                            java.util.TimeZone tz)

stringToDate

public static java.util.Date stringToDate(java.lang.String src)
                                   throws java.text.ParseException

Throws:

java.text.ParseException

computeDifferenceMilli

public static long computeDifferenceMilli(java.util.Date start,
                                          java.util.Date end)
                                   throws java.lang.Exception

Throws:

java.lang.Exception

computeDifference

public static java.lang.String computeDifference(java.util.Date start,
                                                 java.util.Date end)
                                          throws java.lang.Exception

Throws:

java.lang.Exception

isIdentityNow

public static boolean isIdentityNow()

expandVariables

public static java.lang.String expandVariables(java.lang.String src,
                                               java.util.Map<java.lang.String,java.lang.Object> variables)

removeDuplicates

public static <T> void removeDuplicates(java.util.List<T> list)

filterNulls

public static <T> java.util.List<T> filterNulls(java.util.List<T> src)

Remove nulls from a list. Added as a temporary kludge for some obscure Hibernate crap that adds phantom null's to Lists under some conditions. Do not collapse empty lists to null, some object constructors set the list before they begin populating it. This obviously still has the potental for nulls, but at least Hibernate doesn't appear to follow that pattern.

getJarDetails

public static java.util.Map<java.lang.String,java.lang.String> getJarDetails(java.lang.String jarClass,
                                                                             java.util.List<java.lang.String> attributes)
                                                                      throws java.lang.Exception

Throws:

java.lang.Exception

arrayToList

public static <T> java.util.List<T> arrayToList(T[] array)

Given an array, returns a list.

Parameters:

array - Array to copy to a list

Returns:

New List, empty list if array is null.

isEmpty

public static boolean isEmpty(int[] args)

escapeXmlSpecialChar

public static java.lang.String escapeXmlSpecialChar(java.lang.String inputString)

getTimeDiff

public static long getTimeDiff(java.time.Instant start)