public class Helper extends Object implements Serializable
Purpose: Define any usefull methods that are missing from the base Java.
Modifier and Type | Field and Description |
---|---|
protected static Vector |
calendarCache
PERF: Used to cache a set of calendars for conversion/printing purposes.
|
protected static String |
CR
Store CR string, for some reason \n is not platform independent.
|
protected static String |
CURRENT_WORKING_DIRECTORY
Prime the platform-dependent current working directory
|
protected static TimeZone |
defaultTimeZone
PERF: Cache default timezone for calendar conversion.
|
protected static String |
FILE_SEPARATOR
Prime the platform-dependent file separator
|
protected static Object |
nullWrapper
Used to store null values in hashtables, is helper because need to be serializable.
|
protected static String |
PATH_SEPARATOR
Prime the platform-dependent path separator
|
protected static boolean |
shouldOptimizeDates
Used to configure JDBC level date optimization.
|
protected static String |
TEMP_DIRECTORY
Prime the platform-dependent temporary directory
|
Constructor and Description |
---|
Helper() |
Modifier and Type | Method and Description |
---|---|
static void |
addAllToVector(Vector theVector,
List elementsToAdd) |
static void |
addAllToVector(Vector theVector,
Vector elementsToAdd) |
static Vector |
addAllUniqueToVector(Vector theVector,
Vector elementsToAdd) |
static Calendar |
allocateCalendar()
PERF: This is used to optimize Calendar conversion/printing.
|
static boolean |
areTypesAssignable(Vector types1,
Vector types2)
PUBLIC:
Compare two vectors of types.
|
static Object[] |
arrayFromVector(Vector vector)
Convert the specified vector into an array.
|
static byte[] |
buildBytesFromHexString(String hex)
Convert the HEX string to a byte array.
|
static Hashtable |
buildHashtableFromVector(Vector theVector)
Convert the passed Vector to a Hashtable
Return the Hashtable
|
static String |
buildHexStringFromBytes(byte[] bytes)
Convert the byte array to a HEX string.
|
static Vector |
buildVectorFromHashtableElements(Hashtable hashtable)
Create a new Vector containing all of the hashtable elements
|
static Vector |
buildVectorFromHashtableElements(IdentityHashtable hashtable)
Create a new Vector containing all of the hashtable elements
|
static Vector |
buildVectorFromMapElements(Map map)
Create a new Vector containing all of the map elements.
|
static String |
buildZeroPrefix(int number,
int totalDigits)
Build a numerical string with leading 0s.
|
static String |
buildZeroPrefixAndTruncTrailZeros(int number,
int totalDigits)
Build a numerical string with leading 0s and truncate trailing zeros.
|
static Calendar |
calendarFromUtilDate(Date date)
Answer a Calendar from a date.
|
static boolean |
classImplementsInterface(Class aClass,
Class anInterface)
INTERNAL:
Return whether a Class implements a specific interface, either directly or indirectly
(through interface or implementation inheritance).
|
static boolean |
classIsSubclass(Class subClass,
Class superClass)
INTERNAL:
Return whether a Class is a subclass of, or the same as, another Class.
|
static boolean |
compareArrays(Object[] array1,
Object[] array2) |
static boolean |
compareBigDecimals(BigDecimal one,
BigDecimal two)
Compare two BigDecimals.
|
static boolean |
compareByteArrays(byte[] array1,
byte[] array2) |
static boolean |
compareCharArrays(char[] array1,
char[] array2) |
static boolean |
compareHashtables(Hashtable hashtable1,
Hashtable hashtable2)
PUBLIC:
Compare the elements in 2 hashtables to see if they are equal
Added Nov 9, 2000 JED Patch 2.5.1.8
|
static boolean |
compareOrderedVectors(Vector vector1,
Vector vector2)
Compare the elements in two
Vector s to see if they are equal. |
static boolean |
compareUnorderedVectors(Vector v1,
Vector v2)
Compare the elements in two
Vector s to see if they are equal. |
static Hashtable |
concatenateHashtables(Hashtable first,
Hashtable second) |
static Map |
concatenateMaps(Map first,
Map second)
Merge the two Maps into a new HashMap.
|
static Vector |
concatenateUniqueVectors(Vector first,
Vector second)
Return a new vector with no duplicated values
|
static Vector |
concatenateVectors(Vector first,
Vector second) |
static boolean |
containsNull(Vector v,
int index)
Returns whether the given
Vector contains a null element
Return true if the Vector contains a null element
Return false otherwise. |
static Vector |
copyVector(Vector originalVector,
int startIndex,
int stopIndex)
Return a copy of the vector containing a subset starting at startIndex
and ending at stopIndex.
|
static String |
cr()
Return a string containing the platform-appropriate
characters for carriage return.
|
static String |
currentWorkingDirectory()
Return the name of the "current working directory".
|
static Date |
dateFromCalendar(Calendar calendar)
Answer a sql.Date from a Calendar.
|
static Date |
dateFromLong(Long longObject)
Answer a Date from a long
This implementation is based on the java.sql.Date class, not java.util.Date.
|
static Date |
dateFromString(String dateString)
Answer a Date from a string representation.
|
static Date |
dateFromTimestamp(Timestamp timestamp)
Answer a Date from a timestamp
This implementation is based on the java.sql.Date class, not java.util.Date.
|
static Date |
dateFromYearMonthDate(int year,
int month,
int day)
Answer a Date with the year, month, date.
|
static boolean |
doesFileExist(String fileName)
Returns true if the file of this name does indeed exist
|
static String |
doubleSlashes(String path)
Double up \ to allow printing of directories for source code generation.
|
static String |
extractJarNameFromURL(URL url)
Extracts the actual path to the jar file.
|
static String |
fileSeparator()
Return a string containing the platform-appropriate
characters for separating directory and file names.
|
static Method |
getDeclaredMethod(Class javaClass,
String methodName,
Class[] methodParameterTypes)
INTERNAL:
Returns a Method for the specified Class, method name,
and formal parameter types.
|
static TimeZone |
getDefaultTimeZone()
PERF: Return the cached default platform.
|
static Field |
getField(Class javaClass,
String fieldName)
INTERNAL:
Returns a Field for the specified Class and field name.
|
static Object |
getInstanceFromClass(Class classFullName)
Return the class instance from the class
|
static Object |
getNullWrapper()
Used to store null values in hashtables, is helper because need to be serializable.
|
static Class |
getObjectClass(Class javaClass)
Returns the object class.
|
static String |
getPackageName(Class javaClass)
return a package name for the specified class.
|
static String |
getShortClassName(Class javaClass)
Answers the unqualified class name for the provided class.
|
static String |
getShortClassName(Object object)
Answers the unqualified class name for the specified object.
|
static String |
getShortClassName(String javaClassName)
Answers the unqualified class name from the specified String.
|
static String |
getTabs(int noOfTabs)
Return a string containing the specified number of tabs.
|
static int |
indexOfNullElement(Vector v,
int index)
Returns the index of the the first
null element found in the specified
Vector starting the search at the starting index specified. |
static boolean |
isCollection(Object testObject)
Return true if the object implements the Collection interface
Creation date: (9/7/00 1:59:51 PM)
|
static boolean |
isPrimitiveWrapper(Class classInQuestion)
ADVANCED
returns true if the class in question is a primitive wrapper
|
static boolean |
isUpperCaseString(String s)
Returns true if the string given is an all upper case string
|
static boolean |
isVowel(char c)
Returns true if the character given is a vowel.
|
static File[] |
listFilesIn(File directory)
Return an array of the files in the specified directory.
|
static Vector |
makeVectorFromObject(Object theObject)
Make a Vector from the passed object.
|
static String |
pathSeparator()
Return a string containing the platform-appropriate
characters for separating entries in a path (e.g.
|
static String |
printCalendar(Calendar calendar)
Print the Calendar.
|
static String |
printCalendar(Calendar calendar,
boolean useLocalTime)
Print the Calendar.
|
static String |
printCalendarWithoutNanos(Calendar calendar)
Print the Calendar without the nanos portion.
|
static String |
printDate(Calendar calendar)
Print the date part of the calendar.
|
static String |
printDate(Calendar calendar,
boolean useLocalTime)
Print the date part of the calendar.
|
static String |
printDate(Date date)
Print the sql.Date.
|
static String |
printStackTraceToString(Throwable aThrowable)
Return a String containing the printed stacktrace of an exception.
|
static String |
printTime(Calendar calendar)
Print the time part of the calendar.
|
static String |
printTime(Calendar calendar,
boolean useLocalTime)
Print the time part of the calendar.
|
static String |
printTime(Time time)
Print the sql.Time.
|
static String |
printTimeFromMilliseconds(long milliseconds) |
static String |
printTimestamp(Timestamp timestamp)
Print the sql.Timestamp.
|
static String |
printTimestampWithoutNanos(Timestamp timestamp)
Print the sql.Timestamp without the nanos portion.
|
static String |
printVector(Vector vector)
Given a Vector, print it, even if there is a null in it
|
static Hashtable |
rehashHashtable(Hashtable table) |
static Map |
rehashMap(Map table) |
static void |
releaseCalendar(Calendar calendar)
PERF: This is used to optimize Calendar conversion/printing.
|
static String |
removeAllButAlphaNumericToFit(String s1,
int maximumStringLength)
Returns a String which has had enough non-alphanumeric characters removed to be equal to
the maximumStringLength.
|
static String |
removeCharacterToFit(String s1,
char aChar,
int maximumStringLength)
Returns a String which has had enough of the specified character removed to be equal to
the maximumStringLength.
|
static boolean |
removeNullElement(Vector v)
Remove the first
null element found in the specified Vector . |
static String |
removeVowels(String s1)
Returns a String which has had enough of the specified character removed to be equal to
the maximumStringLength.
|
static String |
replaceFirstSubString(String source,
String subString,
String replacement)
Replaces the first subString of the source with the replacement.
|
static Vector |
reverseVector(Vector theVector) |
static String |
rightTrimString(String originalString)
Returns a new string with all space characters removed from the right
|
static void |
setShouldOptimizeDates(boolean value)
Return if JDBC date access should be optimized.
|
static String |
shortenStringsByRemovingVowelsToFit(String s1,
String s2,
int maximumStringLength)
Returns a String which is a concatenation of two string which have had enough
vowels removed from them so that the sum of the sized of the two strings is less than
or equal to the specified size.
|
static boolean |
shouldOptimizeDates()
Return if JDBC date access should be optimized.
|
static Date |
sqlDateFromUtilDate(Date utilDate)
Answer a sql.Date from a timestamp.
|
static void |
systemBug(String description)
Can be used to mark code if a workaround is added for a JDBC driver or other bug.
|
static String |
tempDirectory()
Return the name of the "temporary directory".
|
static Time |
timeFromCalendar(Calendar calendar)
Answer a sql.Time from a Calendar.
|
static Time |
timeFromDate(Date date)
Answer a Time from a Date
This implementation is based on the java.sql.Date class, not java.util.Date.
|
static Time |
timeFromHourMinuteSecond(int hour,
int minute,
int second)
Answer a Time with the hour, minute, second.
|
static Time |
timeFromLong(Long longObject)
Answer a Time from a long
|
static Time |
timeFromString(String timeString)
Answer a Time from a string representation.
|
static Time |
timeFromTimestamp(Timestamp timestamp)
Answer a Time from a Timestamp
Usus the Hours, Minutes, Seconds instead of getTime() ms value.
|
static Timestamp |
timestampFromCalendar(Calendar calendar)
Answer a Timestamp from a Calendar.
|
static Timestamp |
timestampFromDate(Date date)
Answer a Timestamp from a java.util.Date.
|
static Timestamp |
timestampFromLong(long millis)
Answer a Time from a long
|
static Timestamp |
timestampFromLong(Long millis)
Answer a Time from a long
|
static Timestamp |
timestampFromString(String timestampString)
Answer a Timestamp from a string representation.
|
static Timestamp |
timestampFromYearMonthDateHourMinuteSecondNanos(int year,
int month,
int date,
int hour,
int minute,
int second,
int nanos)
Answer a Timestamp with the year, month, day, hour, minute, second.
|
static void |
toDo(String description)
Can be used to mark code as need if something strange is seen.
|
static String |
truncate(String originalString,
int size)
If the size of the original string is larger than the passed in size,
this method will remove the vowels from the original string.
|
static Date |
utilDateFromLong(Long longObject)
Answer a Date from a long
This implementation is based on the java.sql.Date class, not java.util.Date.
|
static Date |
utilDateFromSQLDate(Date sqlDate)
Answer a java.util.Date from a sql.date
|
static Date |
utilDateFromTime(Time time)
Answer a java.util.Date from a sql.Time
|
static Date |
utilDateFromTimestamp(Timestamp timestampObject)
Answer a java.util.Date from a timestamp
|
static Vector |
vectorFromArray(Object[] array)
Convert the specified array into a vector.
|
static void |
writeHexString(byte[] bytes,
Writer writer)
Convert the byte array to a HEX string.
|
protected static boolean shouldOptimizeDates
protected static Object nullWrapper
protected static Vector calendarCache
protected static TimeZone defaultTimeZone
protected static String CR
protected static String PATH_SEPARATOR
protected static String FILE_SEPARATOR
protected static String CURRENT_WORKING_DIRECTORY
protected static String TEMP_DIRECTORY
public static boolean shouldOptimizeDates()
public static void setShouldOptimizeDates(boolean value)
public static Calendar allocateCalendar()
public static TimeZone getDefaultTimeZone()
public static void releaseCalendar(Calendar calendar)
public static Vector addAllUniqueToVector(Vector theVector, Vector elementsToAdd)
public static Object[] arrayFromVector(Vector vector)
public static byte[] buildBytesFromHexString(String hex)
public static Hashtable buildHashtableFromVector(Vector theVector)
public static String buildHexStringFromBytes(byte[] bytes)
public static Vector buildVectorFromHashtableElements(Hashtable hashtable)
public static Vector buildVectorFromMapElements(Map map)
public static Vector buildVectorFromHashtableElements(IdentityHashtable hashtable)
public static Calendar calendarFromUtilDate(Date date)
public static boolean classImplementsInterface(Class aClass, Class anInterface)
public static boolean classIsSubclass(Class subClass, Class superClass)
public static boolean compareBigDecimals(BigDecimal one, BigDecimal two)
BigDecimal.equals(Object)
public static boolean compareByteArrays(byte[] array1, byte[] array2)
public static boolean compareCharArrays(char[] array1, char[] array2)
public static boolean areTypesAssignable(Vector types1, Vector types2)
public static boolean compareHashtables(Hashtable hashtable1, Hashtable hashtable2)
public static boolean compareOrderedVectors(Vector vector1, Vector vector2)
Vector
s to see if they are equal.
The order of the elements is significant.public static boolean compareUnorderedVectors(Vector v1, Vector v2)
Vector
s to see if they are equal.
The order of the elements is ignored.v1
- a vectorv2
- a vectorpublic static Hashtable concatenateHashtables(Hashtable first, Hashtable second)
public static Map concatenateMaps(Map first, Map second)
public static Vector concatenateUniqueVectors(Vector first, Vector second)
public static boolean containsNull(Vector v, int index)
Vector
contains a null
element
Return true
if the Vector contains a null element
Return false
otherwise.
This is needed in jdk1.1, where Vector.contains(Object)
for a null
element will result in a NullPointerException
....public static Vector copyVector(Vector originalVector, int startIndex, int stopIndex) throws ValidationException
vector
- - original vectorstartIndex
- - starting position in vectorstopIndex
- - ending position in vectorTopLinkException
ValidationException
public static String cr()
public static String currentWorkingDirectory()
public static String tempDirectory()
public static Date dateFromLong(Long longObject)
longObject
- - milliseconds from the epoch (00:00:00 GMT
Jan 1, 1970). Negative values represent dates prior to the epoch.public static Date dateFromYearMonthDate(int year, int month, int day)
public static Date dateFromString(String dateString) throws ConversionException
dateString
- - string representation of dateConversionException
public static Date dateFromTimestamp(Timestamp timestamp)
timestampObject
- - timestamp representation of datepublic static boolean doesFileExist(String fileName)
public static String doubleSlashes(String path)
public static String extractJarNameFromURL(URL url)
public static String fileSeparator()
public static Field getField(Class javaClass, String fieldName) throws NoSuchFieldException
NoSuchFieldException
public static Method getDeclaredMethod(Class javaClass, String methodName, Class[] methodParameterTypes) throws NoSuchMethodException
NoSuchMethodException
public static Object getInstanceFromClass(Class classFullName)
public static Object getNullWrapper()
public static Class getObjectClass(Class javaClass)
public static String getShortClassName(Class javaClass)
public static String getShortClassName(String javaClassName)
public static String getShortClassName(Object object)
public static String getPackageName(Class javaClass)
public static String getTabs(int noOfTabs)
public static int indexOfNullElement(Vector v, int index)
null
element found in the specified
Vector
starting the search at the starting index specified.
Return an int >= 0 and less than size if a null
element was found.
Return -1 if a null
element was not found.
This is needed in jdk1.1, where Vector.contains(Object)
for a null
element will result in a NullPointerException
....public static boolean isCollection(Object testObject)
testObject
- java.lang.Objectpublic static boolean isPrimitiveWrapper(Class classInQuestion)
public static boolean isUpperCaseString(String s)
public static boolean isVowel(char c)
public static File[] listFilesIn(File directory)
public static Vector makeVectorFromObject(Object theObject)
public static String pathSeparator()
public static String printStackTraceToString(Throwable aThrowable)
public static String printTimeFromMilliseconds(long milliseconds)
public static String printVector(Vector vector)
public static String removeAllButAlphaNumericToFit(String s1, int maximumStringLength)
public static String removeCharacterToFit(String s1, char aChar, int maximumStringLength)
public static boolean removeNullElement(Vector v)
null
element found in the specified Vector
.
Return true
if a null
element was found and removed.
Return false
if a null
element was not found.
This is needed in jdk1.1, where Vector.removeElement(Object)
for a null
element will result in a NullPointerException
....public static String removeVowels(String s1)
public static String replaceFirstSubString(String source, String subString, String replacement)
public static String rightTrimString(String originalString)
originalString
- - timestamp representation of datepublic static String shortenStringsByRemovingVowelsToFit(String s1, String s2, int maximumStringLength)
public static Date sqlDateFromUtilDate(Date utilDate)
public static String printDate(Calendar calendar, boolean useLocalTime)
public static String printTime(Calendar calendar, boolean useLocalTime)
public static String printCalendar(Calendar calendar, boolean useLocalTime)
public static String buildZeroPrefix(int number, int totalDigits)
public static String buildZeroPrefixAndTruncTrailZeros(int number, int totalDigits)
public static String printTimestampWithoutNanos(Timestamp timestamp)
public static String printCalendarWithoutNanos(Calendar calendar)
public static Date dateFromCalendar(Calendar calendar)
public static void systemBug(String description)
public static Time timeFromDate(Date date)
timestampObject
- - time representation of datepublic static Time timeFromLong(Long longObject)
longObject
- - milliseconds from the epoch (00:00:00 GMT
Jan 1, 1970). Negative values represent dates prior to the epoch.public static Time timeFromHourMinuteSecond(int hour, int minute, int second)
public static Time timeFromString(String timeString) throws ConversionException
timeString
- - string representation of timeConversionException
public static Time timeFromTimestamp(Timestamp timestamp)
public static Time timeFromCalendar(Calendar calendar)
public static Timestamp timestampFromCalendar(Calendar calendar)
public static Timestamp timestampFromDate(Date date)
public static Timestamp timestampFromLong(Long millis)
longObject
- - milliseconds from the epoch (00:00:00 GMT
Jan 1, 1970). Negative values represent dates prior to the epoch.public static Timestamp timestampFromLong(long millis)
longObject
- - milliseconds from the epoch (00:00:00 GMT
Jan 1, 1970). Negative values represent dates prior to the epoch.public static Timestamp timestampFromString(String timestampString) throws ConversionException
timestampString
- - string representation of timestampConversionException
public static Timestamp timestampFromYearMonthDateHourMinuteSecondNanos(int year, int month, int date, int hour, int minute, int second, int nanos)
public static void toDo(String description)
public static String truncate(String originalString, int size)
public static Date utilDateFromLong(Long longObject)
longObject
- - milliseconds from the epoch (00:00:00 GMT
Jan 1, 1970). Negative values represent dates prior to the epoch.public static Date utilDateFromSQLDate(Date sqlDate)
sqlDate
- - sql.date representation of datepublic static Date utilDateFromTime(Time time)
time
- - time representation of util datepublic static Date utilDateFromTimestamp(Timestamp timestampObject)
timestampObject
- - timestamp representation of datepublic static Vector vectorFromArray(Object[] array)
public static void writeHexString(byte[] bytes, Writer writer) throws IOException
IOException
Copyright © 2022. All rights reserved.