com.dkfqs.tools.lib

Class Utils

java.lang.Object

com.dkfqs.tools.lib.Utils

public class Utils
extends java.lang.Object

Various utilities. All methods are static.

Field Summary

Fields

Modifier and Type	Field and Description
static java.text.SimpleDateFormat	RESULT_FILENAME_FRAGMENT_DATE_FORMAT A simple date format with the pattern "yyyy-MM-dd@HH-mm-ss".
static java.text.SimpleDateFormat	SIMPLE_DATE_FORMAT A simple date format with the pattern "yyyy-MM-dd HH:mm:ss".
static java.text.SimpleDateFormat	SIMPLE_DATE_FORMAT_WITH_MILLIS A simple date format with the pattern "yyyy-MM-dd HH:mm:ss.SSS".
static java.text.SimpleDateFormat	SOURCE_FILE_DATE_FORMAT A simple date format with the pattern "dd MMM yyyy HH:mm:ss".

Method Summary

Modifier and Type	Method and Description
static int	binaryIndex(byte[] src, byte[] pattern) Get the index of a binary pattern within binary data.
static int	binaryIndex(byte[] data, byte[] searchFragment, int offset) Search inside binary data for a fragment of data, starting at a specific offset.
static java.lang.String	bytesToHex(byte[] bytes) Convert a byte array to a hex string.
static int	caseInsensitiveIndexOf(java.lang.String text, java.lang.String search) Perform a case insensitive 'index of'.
static java.lang.String	formatTimestamp(long timestamp) Format an absolute date and time to a string.
static java.lang.String	formatTimestamp(java.util.TimeZone timeZone, long timestamp) Format an absolute date and time to a string by using a specific time zone.
static java.lang.String	formatTimestampInSourceFileFormat(long timestamp) Format an absolute date and time to a string in 'source file date format'.
static java.lang.String	formatTimestampInSourceFileFormat(java.util.TimeZone timeZone, long timestamp) Format an absolute date and time to a string in 'source file date format' by using a specific time zone.
static java.lang.String	formatTimestampResultFileNameFragmentFormat(long timestamp) Format an absolute date and time to a string in 'result file name fragment format'.
static java.lang.String	formatTimestampResultFileNameFragmentFormat(java.util.TimeZone timeZone, long timestamp) Format an absolute date and time to a string in 'result file name fragment format' by using a specific time zone.
static java.lang.String	formatTimestampWithMillis(long timestamp) Format an absolute date and time to a string which includes also milliseconds.
static java.lang.String	formatTimestampWithMillis(java.util.TimeZone timeZone, long timestamp) Format an absolute date and time to a string which includes also milliseconds by using a specific time zone.
static java.util.TimeZone	getDefaultTimeZone() Get the default time zone.
static java.lang.String	getStrippedFileName(java.io.File file) Get from a file the file name without extension
static byte[]	gUnZip(byte[] b) Decompress a byte array which was compressed by the GZIP algorithm.
static byte[]	inflate(byte[] b) Inflate a byte array which was compressed by the ZLIB algorithm.
static boolean	is90HumanReadableASCII(byte[] bytes) Get if an array of bytes contains at least 90% human readable ASCII chars.
static boolean	isFormalValidVariableName(java.lang.String variableName) Verify if the name of a variable is formal valid.
static boolean	matchToWildcardString(java.lang.String checkString, java.lang.String wildcardString) Check if a text string mach to another text string which contains one ore more wildcard chars.
static java.lang.String	stripFileExtension(java.lang.String fileName) Get from a file name with extension the file name without extension

Methods inherited from class java.lang.Object

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

Field Detail

SIMPLE_DATE_FORMAT

public static final java.text.SimpleDateFormat SIMPLE_DATE_FORMAT

A simple date format with the pattern "yyyy-MM-dd HH:mm:ss".

SIMPLE_DATE_FORMAT_WITH_MILLIS

public static final java.text.SimpleDateFormat SIMPLE_DATE_FORMAT_WITH_MILLIS

A simple date format with the pattern "yyyy-MM-dd HH:mm:ss.SSS".

SOURCE_FILE_DATE_FORMAT

public static final java.text.SimpleDateFormat SOURCE_FILE_DATE_FORMAT

A simple date format with the pattern "dd MMM yyyy HH:mm:ss".

RESULT_FILENAME_FRAGMENT_DATE_FORMAT

public static final java.text.SimpleDateFormat RESULT_FILENAME_FRAGMENT_DATE_FORMAT

A simple date format with the pattern "yyyy-MM-dd@HH-mm-ss".

Method Detail

formatTimestamp

public static java.lang.String formatTimestamp(long timestamp)

Format an absolute date and time to a string.

Parameters:

timestamp - the absolute date and time (Unix time)

Returns:

the formatted string

See Also:

SIMPLE_DATE_FORMAT

formatTimestamp

public static java.lang.String formatTimestamp(java.util.TimeZone timeZone,
                                               long timestamp)

Format an absolute date and time to a string by using a specific time zone.

Parameters:

timeZone - the time zone

timestamp - the absolute date and time (Unix time)

Returns:

the formatted string

See Also:

SIMPLE_DATE_FORMAT

formatTimestampWithMillis

public static java.lang.String formatTimestampWithMillis(long timestamp)

Format an absolute date and time to a string which includes also milliseconds.

Parameters:

timestamp - the absolute date and time (Unix time)

Returns:

the formatted string

See Also:

SIMPLE_DATE_FORMAT_WITH_MILLIS

formatTimestampWithMillis

public static java.lang.String formatTimestampWithMillis(java.util.TimeZone timeZone,
                                                         long timestamp)

Format an absolute date and time to a string which includes also milliseconds by using a specific time zone.

Parameters:

timeZone - the time zone

timestamp - the absolute date and time (Unix time)

Returns:

the formatted string

See Also:

SIMPLE_DATE_FORMAT_WITH_MILLIS

formatTimestampInSourceFileFormat

public static java.lang.String formatTimestampInSourceFileFormat(long timestamp)

Format an absolute date and time to a string in 'source file date format'.

Parameters:

timestamp - the absolute date and time (Unix time)

Returns:

the formatted string

See Also:

SOURCE_FILE_DATE_FORMAT

formatTimestampInSourceFileFormat

public static java.lang.String formatTimestampInSourceFileFormat(java.util.TimeZone timeZone,
                                                                 long timestamp)

Format an absolute date and time to a string in 'source file date format' by using a specific time zone.

Parameters:

timeZone - the time zone

timestamp - the absolute date and time (Unix time)

Returns:

the formatted string

See Also:

SOURCE_FILE_DATE_FORMAT

formatTimestampResultFileNameFragmentFormat

public static java.lang.String formatTimestampResultFileNameFragmentFormat(long timestamp)

Format an absolute date and time to a string in 'result file name fragment format'.

Parameters:

timestamp - the absolute date and time (Unix time)

Returns:

the formatted string

See Also:

RESULT_FILENAME_FRAGMENT_DATE_FORMAT

formatTimestampResultFileNameFragmentFormat

public static java.lang.String formatTimestampResultFileNameFragmentFormat(java.util.TimeZone timeZone,
                                                                           long timestamp)

Format an absolute date and time to a string in 'result file name fragment format' by using a specific time zone.

Parameters:

timeZone - the time zone

timestamp - the absolute date and time (Unix time)

Returns:

the formatted string

See Also:

RESULT_FILENAME_FRAGMENT_DATE_FORMAT

getDefaultTimeZone

public static java.util.TimeZone getDefaultTimeZone()

Get the default time zone.

Returns:

the default time zone

matchToWildcardString

public static boolean matchToWildcardString(java.lang.String checkString,
                                            java.lang.String wildcardString)

Check if a text string mach to another text string which contains one ore more wildcard chars. The following wildcard chars are supported:

• '?' = wildcard for one char
• '*' = wildcard for multiple chars

Parameters:

checkString - the string to check

wildcardString - the matching string which can contain wildcards '?' and/or '*'

Returns:

true if the string to check matches to the string which contains the wildcards

gUnZip

public static byte[] gUnZip(byte[] b)
                     throws java.io.IOException

Decompress a byte array which was compressed by the GZIP algorithm.

Parameters:

b - the byte array to decompress

Returns:

the decompressed data

Throws:

java.io.IOException - if the decompression fails

inflate

public static byte[] inflate(byte[] b)
                      throws java.io.IOException

Inflate a byte array which was compressed by the ZLIB algorithm.

Parameters:

b - the byte array to inflate

Returns:

the inflated data

Throws:

java.io.IOException - if the inflation fails

caseInsensitiveIndexOf

public static int caseInsensitiveIndexOf(java.lang.String text,
                                         java.lang.String search)

Perform a case insensitive 'index of'.

Parameters:

text - the text

search - the search fragment

Returns:

the offset of the search fragment, or -1 if the search fragment was not found.

binaryIndex

public static int binaryIndex(byte[] src,
                              byte[] pattern)

Get the index of a binary pattern within binary data.

Parameters:

src - the binary data

pattern - the binary pattern

Returns:

the index or -1 if the pattern was not found

binaryIndex

public static int binaryIndex(byte[] data,
                              byte[] searchFragment,
                              int offset)

Search inside binary data for a fragment of data, starting at a specific offset.

Parameters:

data - the binary data

searchFragment - the fragment to search

offset - the offset where the search starts inside the binary data (0..n-1)

Returns:

the index where the search fragment was found, or -1 if the search fragment was not found, and also -1 if the length of the search fragment is zero.

is90HumanReadableASCII

public static boolean is90HumanReadableASCII(byte[] bytes)

Get if an array of bytes contains at least 90% human readable ASCII chars.

Parameters:

bytes - the array of bytes

Returns:

true if the array of bytes contains at least 90% human readable ASCII chars

isFormalValidVariableName

public static boolean isFormalValidVariableName(java.lang.String variableName)

Verify if the name of a variable is formal valid. The name of a variable can contain only letters (a-z , A-Z), numeric digits (0-9) or the underscore character (_). The first character of a variable name must be a letter (a-z, A-Z) or underscore (_).

Parameters:

variableName - the name of the variable

Returns:

true if the name of the variable is formal valid

stripFileExtension

public static java.lang.String stripFileExtension(java.lang.String fileName)

Get from a file name with extension the file name without extension

Parameters:

fileName - the file name with extension

Returns:

the file name without extension

getStrippedFileName

public static java.lang.String getStrippedFileName(java.io.File file)

Get from a file the file name without extension

Parameters:

file - the file

Returns:

the file name without extension

bytesToHex

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

Convert a byte array to a hex string.

Parameters:

bytes - the byte array to convert

Returns:

the hex string of the byte array in uppercase chars