io.inversion.utils

Class Utils

java.lang.Object

io.inversion.utils.Utils

public class Utils
extends java.lang.Object

Collection of utility methods designed to make java programming less verbose

Field Summary

Fields

Modifier and Type	Field and Description
static long	DAY
protected static java.lang.String[]	EMPTY_STRING_ARRAY
static long	GB
static long	HOUR
static int	K64
static int	KB
static int	MB
static long	MONTH
protected static java.lang.String	NEW_LINE
static long	WEEK
static long	YEAR

Constructor Summary

Constructors

Constructor and Description
Utils()

Method Summary

Modifier and Type	Method and Description
static org.apache.commons.collections4.multimap.ArrayListValuedHashMap	addToMap(org.apache.commons.collections4.multimap.ArrayListValuedHashMap map, java.lang.String... keyValuePairs)
static <M extends java.util.Map> M	addToMap(M map, java.lang.String... keyValuePairs)
static java.util.ArrayList	asList(java.lang.Object... objects)
static java.util.HashMap	asMap(java.lang.Object... objects)
static java.util.HashSet	asSet(java.lang.Object... objects)
static boolean	atob(java.lang.Object str) Faster and null safe way to call Integer.parseInt(str.trim()) that swallows exceptions.
static double	atod(java.lang.Object str) Faster and null safe way to call Double.parseDouble(str.trim()) that swallows exceptions.
static float	atof(java.lang.Object str) Faster and null safe way to call Float.parseFloat(str.trim()) that swallows exceptions.
static int	atoi(java.lang.Object str) Faster and null safe way to call Integer.parseInt(str.trim()) that swallows exceptions.
static long	atol(java.lang.Object str) Faster and null safe way to call Long.parseLong(str.trim()) that swallows exceptions.
static java.lang.Object	cast(java.lang.String type, java.lang.Object value)
static void	close(java.lang.Object... toClose) Utility to call a close() method on supplied objects if it exists and completely ignore any exceptions
static boolean	containsToken(java.lang.String findThisToken, java.lang.String inThisString) Checks for a whole word case insensitive match of findThisToken in inThisString
static java.io.File	createTempFile(java.lang.String fileName)
static java.util.Date	date(java.lang.String date) Attempts an ISO8601 data as yyyy-MM-dd|yyyyMMdd][T(hh:mm[:ss[.sss]]|hhmm[ss[.sss]])]?[Z|[+-]hh[:]mm], then yyyy-MM-dd, then MM/dd/yy, then MM/dd/yyyy, then yyyyMMdd
static java.util.Date	date(java.lang.String date, java.lang.String format) Faster way to apply a SimpleDateForamt without having to catch ParseException
static java.lang.String	dequote(java.lang.String str) Removes all matching pairs of '"` characters from the start and end of a string.
static java.lang.String	dequote(java.lang.String str, char[] quoteChars)
static boolean	empty(java.lang.Object... arr)
static boolean	equal(java.lang.Object obj1, java.lang.Object obj2) A null safe loose equality checker.
static void	error(java.lang.String message) Shortcut for throw new RuntimeException(message);
static java.util.List<java.lang.String>	explode(java.lang.String delim, java.lang.String... pieces)
static java.io.InputStream	findInputStream(java.lang.String fileOrUrl) Attempts to locate the stream as a file, url, or classpath resource
static java.lang.String	findProperty(java.lang.String... names)
static java.lang.Object	first(java.util.List list)
static java.lang.String	formatDate(java.util.Date date, java.lang.String format) Simple one liner to avoid verbosity of using SimpleDateFormat
static java.lang.String	formatIso8601(java.util.Date date)
static java.lang.Throwable	getCause(java.lang.Throwable t) Tries to \"unwrap\" nested exceptions looking for the root cause
static java.lang.reflect.Field	getField(java.lang.String fieldName, java.lang.Class clazz) Searches the inheritance hierarchy for a field with the the given name and makes sure it is settable via Field.setAccesible
static java.util.List<java.lang.reflect.Field>	getFields(java.lang.Class clazz) Gets all the fields from from all classes in the inheritance hierarchy EXCEPT for any class who's packages starts with \"java\"
static java.lang.reflect.Method	getMethod(java.lang.Class clazz, java.lang.String name) Searches the inheritance hierarchy for the first method of the given name (ignores case).
static java.lang.String	getProperty(java.lang.String name)
static java.lang.Object	getProperty(java.lang.String name, java.lang.Object object) Tries to find a bean property getter then defaults to returning the Field value
static java.lang.String	getShortCause(java.lang.Throwable t)
static java.lang.String	getShortCause(java.lang.Throwable t, int lines)
static java.util.List<java.lang.String>	getStackTraceLines(java.lang.Throwable stackTrace)
static java.lang.String	getStackTraceString(java.lang.Throwable stackTrace)
static java.lang.String	hash(byte[] byteArr, java.lang.String algorithm)
static java.lang.String	implode(java.lang.String glue, java.lang.Object... pieces)
static boolean	in(java.lang.Object toFind, java.lang.Object... values)
static boolean	isWildcard(java.lang.String str) Returns true if the string contains a * or a ?
static java.lang.Object	last(java.util.List list)
static java.lang.String	limitLines(java.lang.String text, int limit)
static java.lang.String	md5(byte[] bytes)
static java.util.Date	parseIso8601(java.lang.String date)
static java.util.LinkedHashMap<java.lang.String,java.lang.String>	parseQueryString(java.lang.String query)
static void	pipe(java.io.InputStream src, java.io.OutputStream dest) Copy all data from src to dst and close the streams
static java.lang.String	read(java.io.File file) Read teh contents of a file to a string
static java.lang.String	read(java.io.InputStream in) Read all of the stream to a string and close the stream.
static java.lang.String	read(java.lang.String resource) Finds an input stream for resource and reads it into a string
static boolean	regexMatch(java.lang.String regex, java.lang.String string) Performs string.matches() but also checks for null
static void	rethrow(java.lang.String message, java.lang.Throwable e) Throws the root cause of e as a RuntimeException
static void	rethrow(java.lang.Throwable e) Throws the root cause of e as a RuntimeException
static int	roundUp(int num, int divisor)
static java.lang.String	sha1(byte[] bytes)
static void	sleep(long millis) Easy way to call Thread.sleep(long) without worrying about try/catch for InterruptedException
static java.lang.String	slugify(java.lang.String str) returns a lowercased url safe string
static java.util.List<java.lang.String>	split(java.lang.String string, char splitOn, char... quoteChars) Breaks the string on splitOn but when inside a quoteChars quoted string.
static java.lang.String[]	splitLines(java.lang.String text)
static java.lang.String	substringAfter(java.lang.String string, java.lang.String breakAfterLast)
static java.lang.String	substringBefore(java.lang.String string, java.lang.String breakBefore)
static boolean	testCompare(java.lang.String expected, java.lang.String actual)
static long	time() Less typing to call System.currentTimeMillis()
static java.math.BigDecimal	toDollarAmount(double amount) Turns a double value into a rounded double with 2 digits of precision 12.3334 -> 12.33 23.0 -> 23.00 45.677 -> 45.68
static boolean	wildcardMatch(java.lang.String wildcard, java.lang.String string) Pattern matches the string using ? to indicate any one single value and * to indicate any 0-n multiple values
static java.lang.String	wildcardToRegex(java.lang.String wildcard) Converts a * and ? wildcard style patterns into regex style pattern
static void	write(java.io.File file, java.lang.String text) Write the string value to a file
static void	write(java.lang.String file, java.lang.String text) Write the string value to a file

Methods inherited from class java.lang.Object

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

Field Detail

KB

public static final int KB

See Also:

Constant Field Values

MB

public static final int MB

See Also:

Constant Field Values

GB

public static final long GB

See Also:

Constant Field Values

K64

public static final int K64

See Also:

Constant Field Values

HOUR

public static final long HOUR

See Also:

Constant Field Values

DAY

public static final long DAY

See Also:

Constant Field Values

MONTH

public static final long MONTH

See Also:

Constant Field Values

WEEK

public static final long WEEK

See Also:

Constant Field Values

YEAR

public static final long YEAR

See Also:

Constant Field Values

NEW_LINE

protected static final java.lang.String NEW_LINE

EMPTY_STRING_ARRAY

protected static final java.lang.String[] EMPTY_STRING_ARRAY

Constructor Detail

Utils

public Utils()

Method Detail

equal

public static boolean equal(java.lang.Object obj1,
                            java.lang.Object obj2)

A null safe loose equality checker.

Parameters:

obj1 -

obj2 -

Returns:

Test for strict == equality, then .equals() equality, then .toString().equals() equality. Either param can be null.

in

public static boolean in(java.lang.Object toFind,
                         java.lang.Object... values)

empty

public static boolean empty(java.lang.Object... arr)

Returns:

true if any args are not null with a toString().length() > 0

first

public static java.lang.Object first(java.util.List list)

last

public static java.lang.Object last(java.util.List list)

implode

public static java.lang.String implode(java.lang.String glue,
                                       java.lang.Object... pieces)

Parameters:

glue -

pieces -

Returns:

Concatenates pieces[0] + glue + pieces[n]... Intelligently recurses through Collections

explode

public static java.util.List<java.lang.String> explode(java.lang.String delim,
                                                       java.lang.String... pieces)

Parameters:

delim -

pieces -

Returns:

Same as String.split() but performs a trim() on each piece and returns an list instead of an array

split

public static java.util.List<java.lang.String> split(java.lang.String string,
                                                     char splitOn,
                                                     char... quoteChars)

Breaks the string on splitOn but when inside a quoteChars quoted string.

Parameters:

string -

splitOn -

quoteChars -

Returns:

substringBefore

public static java.lang.String substringBefore(java.lang.String string,
                                               java.lang.String breakBefore)

substringAfter

public static java.lang.String substringAfter(java.lang.String string,
                                              java.lang.String breakAfterLast)

addToMap

public static org.apache.commons.collections4.multimap.ArrayListValuedHashMap addToMap(org.apache.commons.collections4.multimap.ArrayListValuedHashMap map,
                                                                                       java.lang.String... keyValuePairs)

addToMap

public static <M extends java.util.Map> M addToMap(M map,
                                                   java.lang.String... keyValuePairs)

asList

public static java.util.ArrayList asList(java.lang.Object... objects)

asSet

public static java.util.HashSet asSet(java.lang.Object... objects)

asMap

public static java.util.HashMap asMap(java.lang.Object... objects)

containsToken

public static boolean containsToken(java.lang.String findThisToken,
                                    java.lang.String inThisString)

Checks for a whole word case insensitive match of findThisToken in inThisString

https://www.baeldung.com/java-regexp-escape-char https://stackoverflow.com/questions/7459263/regex-whole-word

Parameters:

findThisToken -

inThisString -

dequote

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

Removes all matching pairs of '"` characters from the start and end of a string.

Parameters:

str -

Returns:

dequote

public static java.lang.String dequote(java.lang.String str,
                                       char[] quoteChars)

toDollarAmount

public static java.math.BigDecimal toDollarAmount(double amount)

Turns a double value into a rounded double with 2 digits of precision 12.3334 -> 12.33 23.0 -> 23.00 45.677 -> 45.68

Parameters:

amount -

Returns:

roundUp

public static int roundUp(int num,
                          int divisor)

atob

public static boolean atob(java.lang.Object str)

Faster and null safe way to call Integer.parseInt(str.trim()) that swallows exceptions.

atoi

public static int atoi(java.lang.Object str)

Faster and null safe way to call Integer.parseInt(str.trim()) that swallows exceptions.

atol

public static long atol(java.lang.Object str)

Faster and null safe way to call Long.parseLong(str.trim()) that swallows exceptions.

atof

public static float atof(java.lang.Object str)

Faster and null safe way to call Float.parseFloat(str.trim()) that swallows exceptions.

atod

public static double atod(java.lang.Object str)

Faster and null safe way to call Double.parseDouble(str.trim()) that swallows exceptions.

slugify

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

returns a lowercased url safe string

Parameters:

str -

Returns:

sha1

public static java.lang.String sha1(byte[] bytes)

Parameters:

bytes -

Returns:

Hash the bytes with SHA-1

md5

public static java.lang.String md5(byte[] bytes)

Parameters:

bytes -

Returns:

Hash the bytes with MD5

hash

public static java.lang.String hash(byte[] byteArr,
                                    java.lang.String algorithm)

Parameters:

byteArr -

algorithm -

Returns:

Hash the bytes with the given algorithm

time

public static long time()

Less typing to call System.currentTimeMillis()

parseIso8601

public static java.util.Date parseIso8601(java.lang.String date)
                                   throws java.text.ParseException

Throws:

java.text.ParseException

formatIso8601

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

formatDate

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

Simple one liner to avoid verbosity of using SimpleDateFormat

date

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

Faster way to apply a SimpleDateForamt without having to catch ParseException

Parameters:

date -

format -

date

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

Attempts an ISO8601 data as yyyy-MM-dd|yyyyMMdd][T(hh:mm[:ss[.sss]]|hhmm[ss[.sss]])]?[Z|[+-]hh[:]mm], then yyyy-MM-dd, then MM/dd/yy, then MM/dd/yyyy, then yyyyMMdd

Parameters:

date -

Returns:

testCompare

public static boolean testCompare(java.lang.String expected,
                                  java.lang.String actual)

getCause

public static java.lang.Throwable getCause(java.lang.Throwable t)

Tries to \"unwrap\" nested exceptions looking for the root cause

Parameters:

t -

error

public static void error(java.lang.String message)

Shortcut for throw new RuntimeException(message);

rethrow

public static void rethrow(java.lang.Throwable e)

Throws the root cause of e as a RuntimeException

Parameters:

e -

rethrow

public static void rethrow(java.lang.String message,
                           java.lang.Throwable e)

Throws the root cause of e as a RuntimeException

Parameters:

e -

sleep

public static void sleep(long millis)

Easy way to call Thread.sleep(long) without worrying about try/catch for InterruptedException

Parameters:

millis -

getShortCause

public static java.lang.String getShortCause(java.lang.Throwable t)

getShortCause

public static java.lang.String getShortCause(java.lang.Throwable t,
                                             int lines)

getStackTraceLines

public static java.util.List<java.lang.String> getStackTraceLines(java.lang.Throwable stackTrace)

getStackTraceString

public static java.lang.String getStackTraceString(java.lang.Throwable stackTrace)

splitLines

public static java.lang.String[] splitLines(java.lang.String text)

limitLines

public static final java.lang.String limitLines(java.lang.String text,
                                                int limit)

getField

public static java.lang.reflect.Field getField(java.lang.String fieldName,
                                               java.lang.Class clazz)

Searches the inheritance hierarchy for a field with the the given name and makes sure it is settable via Field.setAccesible

Parameters:

fieldName -

clazz -

Returns:

getFields

public static java.util.List<java.lang.reflect.Field> getFields(java.lang.Class clazz)

Gets all the fields from from all classes in the inheritance hierarchy EXCEPT for any class who's packages starts with \"java\"

Parameters:

clazz -

Returns:

getMethod

public static java.lang.reflect.Method getMethod(java.lang.Class clazz,
                                                 java.lang.String name)

Searches the inheritance hierarchy for the first method of the given name (ignores case). No distinction is made for overloaded method names.

Parameters:

clazz -

name -

Returns:

getProperty

public static java.lang.Object getProperty(java.lang.String name,
                                           java.lang.Object object)

Tries to find a bean property getter then defaults to returning the Field value

Parameters:

name -

object -

Returns:

read

public static java.lang.String read(java.lang.String resource)

Finds an input stream for resource and reads it into a string

Parameters:

resource -

Returns:

the content of code as a String

read

public static java.lang.String read(java.io.InputStream in)

Read all of the stream to a string and close the stream. Throws RuntimeException instead of IOException

Parameters:

in -

Returns:

read

public static java.lang.String read(java.io.File file)
                             throws java.lang.Exception

Read teh contents of a file to a string

Parameters:

file -

Returns:

Throws:

ApiException

java.lang.Exception

write

public static void write(java.io.File file,
                         java.lang.String text)
                  throws java.lang.Exception

Write the string value to a file

Parameters:

file -

text -

Throws:

ApiException

java.lang.Exception

write

public static void write(java.lang.String file,
                         java.lang.String text)
                  throws java.lang.Exception

Write the string value to a file

Parameters:

file -

text -

Throws:

ApiException

java.lang.Exception

pipe

public static void pipe(java.io.InputStream src,
                        java.io.OutputStream dest)
                 throws java.lang.Exception

Copy all data from src to dst and close the streams

Parameters:

src -

dest -

Throws:

ApiException

java.lang.Exception

createTempFile

public static java.io.File createTempFile(java.lang.String fileName)
                                   throws java.io.IOException

Throws:

java.io.IOException

findInputStream

public static java.io.InputStream findInputStream(java.lang.String fileOrUrl)

Attempts to locate the stream as a file, url, or classpath resource

Parameters:

fileOrUrl -

Returns:

isWildcard

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

Returns true if the string contains a * or a ?

wildcardMatch

public static boolean wildcardMatch(java.lang.String wildcard,
                                    java.lang.String string)

Pattern matches the string using ? to indicate any one single value and * to indicate any 0-n multiple values

regexMatch

public static boolean regexMatch(java.lang.String regex,
                                 java.lang.String string)

Performs string.matches() but also checks for null

Parameters:

regex -

string -

Returns:

wildcardToRegex

public static java.lang.String wildcardToRegex(java.lang.String wildcard)

Converts a * and ? wildcard style patterns into regex style pattern

Parameters:

wildcard -

Returns:

See Also:

http://www.rgagnon.com/javadetails/java-0515.html

parseQueryString

public static java.util.LinkedHashMap<java.lang.String,java.lang.String> parseQueryString(java.lang.String query)

findProperty

public static java.lang.String findProperty(java.lang.String... names)

getProperty

public static java.lang.String getProperty(java.lang.String name)

cast

public static java.lang.Object cast(java.lang.String type,
                                    java.lang.Object value)

close

public static void close(java.lang.Object... toClose)

Utility to call a close() method on supplied objects if it exists and completely ignore any exceptions

Parameters:

toClose -