formatSize(long bytes)

String

Formats a byte count as a human-readable size string (e.g. 1.5 MB). Units: B, KB, MB, GB, TB, PB, EB.

bytes: The size in bytes.

parseSize(String text)

long

Parses a human-readable size string (e.g. "10MB", "2GB") into bytes. Supports KB, MB, GB suffixes.

text: The size string to parse.

formatDate(Calendar cal)

String

Formats a Calendar value as dd-MM-yyyy HH:mm:ss in the calendar's own time zone. Returns null if cal is null.

formatDate(Date date)

String

Formats a Date value as dd-MM-yyyy HH:mm:ss.

formatDate(long unixEpoch)

String

Formats a Unix epoch value (milliseconds since 1970-01-01) as dd-MM-yyyy HH:mm:ss.

formatSeconds(long time)

String

Formats a duration in milliseconds as HH:MM:SS.

formatSecondsSince(long time)

String

Formats the elapsed time since the given start timestamp (in milliseconds) as HH:MM:SS. Pass the result of System.currentTimeMillis() at the start of the operation.

formatMilliSeconds(long time)

String

Formats a duration in milliseconds as HH:MM:SS.mmm.

formatMilliSecondsSince(long time)

String

Formats the elapsed time since the given start timestamp (in milliseconds) as HH:MM:SS.mmm. Pass the result of System.currentTimeMillis() at the start of the operation.

formatArray(String[] values)

String

Converts a string array to a readable string. Returns the single element directly for one-element arrays, and the Apache Commons ArrayUtils.toString representation for multi-element arrays. Returns null for null input.

formatObject(Object value)

String

Converts an object to a string. For Object[] uses ArrayUtils.toString; otherwise calls toString(). Returns null for null input.

escapeHtml(String str)

String

Escapes < and > as HTML entities, and converts newlines to <br/>. Returns null for null input.

sanitizeInput(String string)

String

Sanitizes an HTML string to remove potentially dangerous content (XSS). Uses either the AntiSamy library or a legacy regex approach depending on the Config.SECURITY_INPUT_SANITIZER setting. Returns null for null input.

cleanXSS(String value)

String

Cleans a string by escaping HTML angle brackets and parentheses, removing eval() expressions and inline JavaScript, and stripping script keywords.

sanitizeEmailString(String value)

String

Removes any characters that are not letters, digits, punctuation, or spaces from the given string. Useful for sanitizing email address strings.

isValidUUID(String str)

boolean

Returns true if the given string is a valid UUID.

validUTF8(byte[] input)

boolean

Returns true if the given byte array is a valid UTF-8 sequence.

fixUTF8(byte[] input)

byte[]

Replaces null bytes (0x00) with spaces (0x20) in a byte array.

fixUTF8(String input)

String

Replaces null Unicode characters (\u0000) with spaces and trims the result. Returns null for null input.

trimUnicodeSurrogates(String text)

String

Removes Unicode surrogate characters from the given string and trims it. Returns null for null input. Useful for preparing text before indexing or XML serialization.

stripNonValidXMLCharacters(String in)

String

Removes all characters that are not valid in XML 1.0. Returns an empty string for null or empty input. Use this before inserting arbitrary text into an XML document.