@ThreadSafety(level=COMPLETELY_THREADSAFE) public final class StaticUtils extends java.lang.Object
Modifier and Type | Field and Description |
---|---|
static java.lang.String |
EOL
The end-of-line marker for this platform.
|
static byte[] |
EOL_BYTES
A byte array containing the end-of-line marker for this platform.
|
static byte[] |
NO_BYTES
A pre-allocated byte array containing zero bytes.
|
static char[] |
NO_CHARS
A pre-allocated empty character array.
|
static Control[] |
NO_CONTROLS
A pre-allocated empty control array.
|
static java.lang.String[] |
NO_STRINGS
A pre-allocated empty string array.
|
static int |
TERMINAL_WIDTH_COLUMNS
The width of the terminal window, in columns.
|
Modifier and Type | Method and Description |
---|---|
static <T> boolean |
arraysEqualOrderIndependent(T[] a1,
T[] a2)
Indicates whether the provided arrays have the same elements, ignoring the
order in which they appear.
|
static boolean |
bothNullOrEqual(java.lang.Object o1,
java.lang.Object o2)
Indicates whether both of the provided objects are
null or both
are logically equal (using the equals method). |
static boolean |
bothNullOrEqualIgnoreCase(java.lang.String s1,
java.lang.String s2)
Indicates whether both of the provided strings are
null or both
are logically equal ignoring differences in capitalization (using the
equalsIgnoreCase method). |
static byte[] |
byteArray(int... bytes)
Creates a byte array from the provided integer values.
|
static void |
byteArrayToCode(byte[] array,
java.lang.StringBuilder buffer)
Appends the Java code that may be used to create the provided byte
array to the given buffer.
|
static java.lang.String |
capitalize(java.lang.String s)
Capitalizes the provided string.
|
static java.lang.String |
capitalize(java.lang.String s,
boolean allWords)
Capitalizes the provided string.
|
static java.lang.String |
cleanExampleCommandLineArgument(java.lang.String s)
This method returns a form of the provided argument that is safe to
use on the command line for the local platform.
|
static java.lang.String |
clearSystemProperty(java.lang.String name)
Attempts to clear the value of the specified system property.
|
static int |
computeMapCapacity(int expectedItemCount)
Computes the capacity that should be used for a map or a set with the
expected number of elements, which can help avoid the need to re-hash or
re-balance the map if too many items are added.
|
static java.lang.String |
concatenateStrings(java.util.List<java.lang.String> l)
Retrieves a single string which is a concatenation of all of the provided
strings.
|
static java.lang.String |
concatenateStrings(java.lang.String... a)
Retrieves a single string which is a concatenation of all of the provided
strings.
|
static java.lang.String |
concatenateStrings(java.lang.String beforeList,
java.lang.String beforeElement,
java.lang.String betweenElements,
java.lang.String afterElement,
java.lang.String afterList,
java.util.List<java.lang.String> l)
Retrieves a single string which is a concatenation of all of the provided
strings.
|
static java.lang.String |
concatenateStrings(java.lang.String beforeList,
java.lang.String beforeElement,
java.lang.String betweenElements,
java.lang.String afterElement,
java.lang.String afterList,
java.lang.String... a)
Retrieves a single string which is a concatenation of all of the provided
strings.
|
static java.io.File |
constructPath(java.io.File baseDirectory,
java.lang.String... pathElements)
Constructs a
File object from the provided path. |
static java.io.IOException |
createIOExceptionWithCause(java.lang.String message,
java.lang.Throwable cause)
Creates a new
IOException with a cause. |
static java.util.Date |
decodeGeneralizedTime(java.lang.String t)
Decodes the provided string as a timestamp in generalized time format.
|
static java.util.UUID |
decodeUUID(byte[] b)
Decodes the value of the provided byte array as a Java UUID.
|
static java.lang.String |
encodeGeneralizedTime(java.util.Date d)
Encodes the provided date in generalized time format.
|
static java.lang.String |
encodeGeneralizedTime(long timestamp)
Encodes the provided timestamp in generalized time format.
|
static byte[] |
encodeUUID(java.util.UUID uuid)
Encodes the provided UUID to a byte array containing its 128-bit
representation.
|
static byte[] |
fromHex(java.lang.String hexString)
Retrieves the bytes that correspond to the provided hexadecimal string.
|
static java.util.Set<java.net.InetAddress> |
getAllLocalAddresses(NameResolver nameResolver)
Attempts to determine all addresses associated with the local system.
|
static java.util.Set<java.lang.String> |
getAvailableCanonicalHostNames(NameResolver nameResolver,
java.util.Collection<java.net.InetAddress> addresses)
Retrieves the canonical host names for the provided set of
InetAddress objects. |
static byte[] |
getBytes(java.lang.String s)
Retrieves a UTF-8 byte representation of the provided string.
|
static java.lang.String |
getCanonicalHostNameIfAvailable(NameResolver nameResolver,
java.net.InetAddress address)
Retrieves the canonical host name for the provided address, if it can be
resolved to a name.
|
static java.lang.String |
getEnvironmentVariable(java.lang.String name)
Retrieves the value of the specified environment variable.
|
static java.util.Map<java.lang.String,java.lang.String> |
getEnvironmentVariables()
Retrieves a map of all environment variables defined in the JVM's process.
|
static java.lang.String |
getExceptionMessage(java.lang.Throwable t)
Retrieves a string representation of the provided
Throwable object
suitable for use in a message. |
static java.lang.String |
getExceptionMessage(java.lang.Throwable t,
boolean includeCause,
boolean includeStackTrace)
Retrieves a string representation of the provided
Throwable object
suitable for use in a message. |
static java.util.Set<java.lang.String> |
getSensitiveToCodeAttributeBaseNames()
Retrieves a set containing the base names (in all lowercase characters) of
any attributes that should be considered sensitive for the purposes of the
toCode methods. |
static java.lang.String |
getStackTrace(java.lang.StackTraceElement[] elements)
Returns a single-line string representation of the stack trace.
|
static void |
getStackTrace(java.lang.StackTraceElement[] elements,
java.lang.StringBuilder buffer)
Appends a single-line string representation of the stack trace to the given
buffer.
|
static java.lang.String |
getStackTrace(java.lang.Throwable t)
Retrieves a single-line string representation of the stack trace for the
provided
Throwable . |
static void |
getStackTrace(java.lang.Throwable t,
java.lang.StringBuilder buffer)
Appends a single-line string representation of the stack trace for the
provided
Throwable to the given buffer. |
static java.util.Properties |
getSystemProperties(java.lang.String... propertyNames)
Retrieves the set of currently defined system properties.
|
static java.lang.String |
getSystemProperty(java.lang.String name)
Retrieves the value of the specified system property.
|
static java.lang.String |
getSystemProperty(java.lang.String name,
java.lang.String defaultValue)
Retrieves the value of the specified system property.
|
static java.lang.String |
getUnqualifiedClassName(java.lang.Class<?> c)
Retrieves the unqualified name (i.e., the name without package information)
for the provided class.
|
static java.util.TimeZone |
getUTCTimeZone()
Retrieves a
TimeZone object that represents the UTC (universal
coordinated time) time zone. |
static <T> java.util.HashSet<T> |
hashSetOf(T... items)
Creates a
HashSet containing the provided items. |
static void |
hexEncode(char c,
java.lang.StringBuilder buffer)
Appends a hex-encoded representation of the provided character to the given
buffer.
|
static void |
hexEncode(int codePoint,
java.lang.StringBuilder buffer)
Appends a hex-encoded representation of the provided code point to the
given buffer.
|
static boolean |
isASCIIString(byte[] b)
Indicates whether the contents of the provided byte array represent an
ASCII string, which is also known in LDAP terminology as an IA5 string.
|
static boolean |
isHex(char c)
Indicates whether the provided character is a valid hexadecimal digit.
|
static boolean |
isNumericOID(java.lang.String s)
Indicates whether the provided string is a valid numeric OID.
|
static boolean |
isPrintable(char c)
Indicates whether the provided character is a printable ASCII character, as
per RFC 4517 section 3.2.
|
static boolean |
isPrintableString(byte[] b)
Indicates whether the contents of the provided byte array represent a
printable LDAP string, as per RFC 4517 section 3.2.
|
static boolean |
isSensitiveToCodeAttribute(java.lang.String name)
Indicates whether the provided attribute name should be considered a
sensitive attribute for the purposes of
toCode methods. |
static boolean |
isValidUTF8(byte[] b)
Indicates whether the contents of the provided array are valid UTF-8.
|
static boolean |
isWindows()
Returns
true if and only if the current process is running on
a Windows-based operating system. |
static boolean |
isWithinUnitTest()
Indicates whether the unit tests are currently running in this JVM.
|
static java.lang.String |
linesToString(java.lang.CharSequence... lines)
Creates a string that is a concatenation of all of the provided lines, with
a line break (using the end-of-line sequence appropriate for the underlying
platform) after each line (including the last line).
|
static java.lang.String |
linesToString(java.util.List<? extends java.lang.CharSequence> lines)
Creates a string that is a concatenation of all of the provided lines, with
a line break (using the end-of-line sequence appropriate for the underlying
platform) after each line (including the last line).
|
static <T> java.util.LinkedHashSet<T> |
linkedHashSetOf(T... items)
Creates a
LinkedHashSet containing the provided items. |
static <K,V> java.util.Map<K,V> |
mapOf(K key,
V value)
Creates an unmodifiable map containing the provided items.
|
static <K,V> java.util.Map<K,V> |
mapOf(K key1,
V value1,
K key2,
V value2)
Creates an unmodifiable map containing the provided items.
|
static <K,V> java.util.Map<K,V> |
mapOf(K key1,
V value1,
K key2,
V value2,
K key3,
V value3)
Creates an unmodifiable map containing the provided items.
|
static <K,V> java.util.Map<K,V> |
mapOf(K key1,
V value1,
K key2,
V value2,
K key3,
V value3,
K key4,
V value4)
Creates an unmodifiable map containing the provided items.
|
static <K,V> java.util.Map<K,V> |
mapOf(K key1,
V value1,
K key2,
V value2,
K key3,
V value3,
K key4,
V value4,
K key5,
V value5)
Creates an unmodifiable map containing the provided items.
|
static <K,V> java.util.Map<K,V> |
mapOf(K key1,
V value1,
K key2,
V value2,
K key3,
V value3,
K key4,
V value4,
K key5,
V value5,
K key6,
V value6)
Creates an unmodifiable map containing the provided items.
|
static <K,V> java.util.Map<K,V> |
mapOf(K key1,
V value1,
K key2,
V value2,
K key3,
V value3,
K key4,
V value4,
K key5,
V value5,
K key6,
V value6,
K key7,
V value7)
Creates an unmodifiable map containing the provided items.
|
static <K,V> java.util.Map<K,V> |
mapOf(K key1,
V value1,
K key2,
V value2,
K key3,
V value3,
K key4,
V value4,
K key5,
V value5,
K key6,
V value6,
K key7,
V value7,
K key8,
V value8)
Creates an unmodifiable map containing the provided items.
|
static <K,V> java.util.Map<K,V> |
mapOf(K key1,
V value1,
K key2,
V value2,
K key3,
V value3,
K key4,
V value4,
K key5,
V value5,
K key6,
V value6,
K key7,
V value7,
K key8,
V value8,
K key9,
V value9)
Creates an unmodifiable map containing the provided items.
|
static <K,V> java.util.Map<K,V> |
mapOf(K key1,
V value1,
K key2,
V value2,
K key3,
V value3,
K key4,
V value4,
K key5,
V value5,
K key6,
V value6,
K key7,
V value7,
K key8,
V value8,
K key9,
V value9,
K key10,
V value10)
Creates an unmodifiable map containing the provided items.
|
static <T> java.util.Map<T,T> |
mapOf(T... items)
Creates an unmodifiable map containing the provided items.
|
static <K,V> java.util.Map<K,V> |
mapOfObjectPairs(ObjectPair<K,V>... items)
Creates an unmodifiable map containing the provided items.
|
static java.lang.String |
millisToHumanReadableDuration(long m)
Converts a duration in seconds to a string with a human-readable duration
which may include days, hours, minutes, and seconds, to the extent that
they are needed.
|
static long |
millisToNanos(long millis)
Converts the provided number of milliseconds to nanoseconds.
|
static long |
nanosToMillis(long nanos)
Converts the provided number of nanoseconds to milliseconds.
|
static int |
numBytesInUTF8CharacterWithFirstByte(byte b)
Determines the number of bytes in a UTF-8 character that starts with the
given byte.
|
static void |
rethrowIfError(java.lang.Throwable throwable)
Re-throws the provided
Throwable instance only if it is an
Error ; otherwise, this method will return without taking any
action. |
static void |
rethrowIfErrorOrRuntimeException(java.lang.Throwable throwable)
Re-throws the provided
Throwable instance only if it is an
Error or a RuntimeException instance; otherwise, this
method will return without taking any action. |
static java.lang.String |
secondsToHumanReadableDuration(long s)
Converts a duration in seconds to a string with a human-readable duration
which may include days, hours, minutes, and seconds, to the extent that
they are needed.
|
static void |
setLoggerLevel(java.util.logging.Logger logger,
java.util.logging.Level logLevel)
Attempts to set the desired log level for the specified logger.
|
static void |
setLogHandlerLevel(java.util.logging.Handler logHandler,
java.util.logging.Level logLevel)
Attempts to set the desired log level for the specified log handler.
|
static <T> java.util.Set<T> |
setOf(T... items)
Creates an unmodifiable set containing the provided items.
|
static void |
setSensitiveToCodeAttributes(java.util.Collection<java.lang.String> names)
Specifies the names of any attributes that should be considered sensitive
for the purposes of the
toCode methods. |
static void |
setSensitiveToCodeAttributes(java.lang.String... names)
Specifies the names of any attributes that should be considered sensitive
for the purposes of the
toCode methods. |
static java.lang.String |
setSystemProperty(java.lang.String name,
java.lang.String value)
Attempts to set the value of the specified system property.
|
static boolean |
stringsEqualIgnoreCaseOrderIndependent(java.lang.String[] a1,
java.lang.String[] a2)
Indicates whether the provided string arrays have the same elements,
ignoring the order in which they appear and differences in capitalization.
|
static java.util.List<java.lang.String> |
stringToLines(java.lang.String s)
Converts the provided string (which may include line breaks) into a list
containing the lines without the line breaks.
|
static void |
throwErrorOrRuntimeException(java.lang.Throwable throwable)
Throws an
Error or a RuntimeException based on the provided
Throwable object. |
static java.util.List<java.lang.String> |
toArgumentList(java.lang.String s)
Attempts to parse the contents of the provided string to an argument list
(e.g., converts something like "--arg1 arg1value --arg2 --arg3 arg3value"
to a list of "--arg1", "arg1value", "--arg2", "--arg3", "arg3value").
|
static <T> T[] |
toArray(java.util.Collection<T> collection,
java.lang.Class<T> type)
Retrieves an array containing the elements of the provided collection.
|
static java.lang.String |
toHex(byte b)
Retrieves a hexadecimal representation of the provided byte.
|
static java.lang.String |
toHex(byte[] b)
Retrieves a hexadecimal representation of the contents of the provided byte
array.
|
static void |
toHex(byte[] b,
java.lang.StringBuilder buffer)
Retrieves a hexadecimal representation of the contents of the provided byte
array.
|
static void |
toHex(byte[] b,
java.lang.String delimiter,
java.lang.StringBuilder buffer)
Retrieves a hexadecimal representation of the contents of the provided byte
array.
|
static void |
toHex(byte b,
java.lang.StringBuilder buffer)
Appends a hexadecimal representation of the provided byte to the given
buffer.
|
static java.lang.String |
toHexPlusASCII(byte[] array,
int indent)
Retrieves a hex-encoded representation of the contents of the provided
array, along with an ASCII representation of its contents next to it.
|
static void |
toHexPlusASCII(byte[] array,
int indent,
java.lang.StringBuilder buffer)
Appends a hex-encoded representation of the contents of the provided array
to the given buffer, along with an ASCII representation of its contents
next to it.
|
static java.lang.String |
toInitialLowerCase(java.lang.String s)
Retrieves a version of the provided string with the first character
converted to lowercase but all other characters retaining their original
capitalization.
|
static <T> java.util.List<T> |
toList(T[] array)
Creates a modifiable list with all of the items of the provided array in
the same order.
|
static java.lang.String |
toLowerCase(java.lang.String s)
Retrieves an all-lowercase version of the provided string.
|
static <T> java.util.List<T> |
toNonNullList(T[] array)
Creates a modifiable list with all of the items of the provided array in
the same order.
|
static java.lang.String |
toUpperCase(java.lang.String s)
Retrieves an all-uppercase version of the provided string.
|
static java.lang.String |
toUTF8String(byte[] b)
Retrieves a string generated from the provided byte array using the UTF-8
encoding.
|
static java.lang.String |
toUTF8String(byte[] b,
int offset,
int length)
Retrieves a string generated from the specified portion of the provided
byte array using the UTF-8 encoding.
|
static <T> java.util.TreeSet<T> |
treeSetOf(T... items)
Creates a
TreeSet containing the provided items. |
static java.lang.String |
trimInterfaceNameFromHostAddress(java.lang.String hostAddress)
Retrieves a version of the provided host address with the interface name
stripped off.
|
static java.lang.String |
trimLeading(java.lang.String s)
Trims only leading spaces from the provided string, leaving any trailing
spaces intact.
|
static java.lang.String |
trimTrailing(java.lang.String s)
Trims only trailing spaces from the provided string, leaving any leading
spaces intact.
|
static java.util.List<java.lang.String> |
wrapLine(java.lang.String line,
int maxWidth)
Wraps the contents of the specified line using the given width.
|
static java.util.List<java.lang.String> |
wrapLine(java.lang.String line,
int maxFirstLineWidth,
int maxSubsequentLineWidth)
Wraps the contents of the specified line using the given width.
|
public static final byte[] NO_BYTES
public static final char[] NO_CHARS
public static final Control[] NO_CONTROLS
public static final java.lang.String[] NO_STRINGS
public static final java.lang.String EOL
public static final byte[] EOL_BYTES
public static final int TERMINAL_WIDTH_COLUMNS
public static byte[] getBytes(java.lang.String s)
s
- The string for which to retrieve the UTF-8 byte representation.public static boolean isASCIIString(byte[] b)
b
- The byte array for which to make the determination. It must
not be null
.true
if the contents of the provided array represent an
ASCII string, or false
if not.public static boolean isPrintable(char c)
c
- The character for which to make the determination.true
if the provided character is a printable ASCII
character, or false
if not.public static boolean isPrintableString(byte[] b)
b
- The byte array for which to make the determination. It must
not be null
.true
if the contents of the provided byte array represent
a printable LDAP string, or false
if not.public static boolean isValidUTF8(byte[] b)
b
- The byte array to examine. It must not be null
.true
if the byte array can be parsed as a valid UTF-8
string, or false
if not.public static java.lang.String toUTF8String(byte[] b)
b
- The byte array for which to return the associated string.public static java.lang.String toUTF8String(byte[] b, int offset, int length)
b
- The byte array for which to return the associated string.offset
- The offset in the array at which the value begins.length
- The number of bytes in the value to convert to a string.public static java.lang.String toInitialLowerCase(java.lang.String s)
s
- The string to be processed.public static java.lang.String toLowerCase(java.lang.String s)
s
- The string for which to retrieve the lowercase version.public static java.lang.String toUpperCase(java.lang.String s)
s
- The string for which to retrieve the uppercase version.public static boolean isHex(char c)
c
- The character for which to make the determination.true
if the provided character does represent a valid
hexadecimal digit, or false
if not.public static java.lang.String toHex(byte b)
b
- The byte to encode as hexadecimal.public static void toHex(byte b, java.lang.StringBuilder buffer)
b
- The byte to encode as hexadecimal.buffer
- The buffer to which the hexadecimal representation is to be
appended.public static java.lang.String toHex(byte[] b)
b
- The byte array to be represented as a hexadecimal string. It
must not be null
.public static void toHex(byte[] b, java.lang.StringBuilder buffer)
b
- The byte array to be represented as a hexadecimal string.
It must not be null
.buffer
- A buffer to which the hexadecimal representation of the
contents of the provided byte array should be appended.public static void toHex(byte[] b, java.lang.String delimiter, java.lang.StringBuilder buffer)
b
- The byte array to be represented as a hexadecimal
string. It must not be null
.delimiter
- A delimiter to be inserted between bytes. It may be
null
if no delimiter should be used.buffer
- A buffer to which the hexadecimal representation of the
contents of the provided byte array should be appended.public static java.lang.String toHexPlusASCII(byte[] array, int indent)
array
- The array whose contents should be processed.indent
- The number of spaces to insert on each line prior to the
first hex byte.public static void toHexPlusASCII(byte[] array, int indent, java.lang.StringBuilder buffer)
array
- The array whose contents should be processed.indent
- The number of spaces to insert on each line prior to the
first hex byte.buffer
- The buffer to which the encoded data should be appended.public static byte[] fromHex(java.lang.String hexString) throws java.text.ParseException
hexString
- The hexadecimal string for which to retrieve the bytes.
It must not be null
, and there must not be any
delimiter between bytes.java.text.ParseException
- If the provided string does not represent valid
hexadecimal data, or if the provided string does
not contain an even number of characters.public static void hexEncode(char c, java.lang.StringBuilder buffer)
c
- The character to be encoded.buffer
- The buffer to which the hex-encoded representation should
be appended.public static void hexEncode(int codePoint, java.lang.StringBuilder buffer)
codePoint
- The code point to be encoded.buffer
- The buffer to which the hex-encoded representation
should be appended.public static void byteArrayToCode(byte[] array, java.lang.StringBuilder buffer)
array
- The byte array containing the data to represent. It must
not be null
.buffer
- The buffer to which the code should be appended.public static java.lang.String getStackTrace(java.lang.Throwable t)
Throwable
. It will include the unqualified name of the
Throwable
class, a list of source files and line numbers (if
available) for the stack trace, and will also include the stack trace for
the cause (if present).t
- The Throwable
for which to retrieve the stack trace.Throwable
.public static void getStackTrace(java.lang.Throwable t, java.lang.StringBuilder buffer)
Throwable
to the given buffer. It will include the
unqualified name of the Throwable
class, a list of source files and
line numbers (if available) for the stack trace, and will also include the
stack trace for the cause (if present).t
- The Throwable
for which to retrieve the stack
trace.buffer
- The buffer to which the information should be appended.public static java.lang.String getStackTrace(java.lang.StackTraceElement[] elements)
elements
- The stack trace.public static void getStackTrace(java.lang.StackTraceElement[] elements, java.lang.StringBuilder buffer)
elements
- The stack trace.buffer
- The buffer to which the information should be appended.public static java.lang.String getExceptionMessage(java.lang.Throwable t)
Throwable
object
suitable for use in a message. For runtime exceptions and errors, then a
full stack trace for the exception will be provided. For exception types
defined in the LDAP SDK, then its getExceptionMessage
method will
be used to get the string representation. For all other types of
exceptions, then the standard string representation will be used.
t
- The Throwable
for which to generate the exception
message.Throwable
object
suitable for use in a message.public static java.lang.String getExceptionMessage(java.lang.Throwable t, boolean includeCause, boolean includeStackTrace)
Throwable
object
suitable for use in a message. For runtime exceptions and errors, then a
full stack trace for the exception will be provided. For exception types
defined in the LDAP SDK, then its getExceptionMessage
method will
be used to get the string representation. For all other types of
exceptions, then the standard string representation will be used.
t
- The Throwable
for which to generate the
exception message.includeCause
- Indicates whether to include information about
the cause (if any) in the exception message.includeStackTrace
- Indicates whether to include a condensed
representation of the stack trace in the
exception message.Throwable
object
suitable for use in a message.public static java.lang.String getUnqualifiedClassName(java.lang.Class<?> c)
c
- The class for which to retrieve the unqualified name.public static java.util.TimeZone getUTCTimeZone()
TimeZone
object that represents the UTC (universal
coordinated time) time zone.TimeZone
object that represents the UTC time zone.public static java.lang.String encodeGeneralizedTime(long timestamp)
timestamp
- The timestamp to be encoded in generalized time format.
It should use the same format as the
System.currentTimeMillis()
method (i.e., the
number of milliseconds since 12:00am UTC on January 1,
1970).public static java.lang.String encodeGeneralizedTime(java.util.Date d)
d
- The date to be encoded in generalized time format.public static java.util.Date decodeGeneralizedTime(java.lang.String t) throws java.text.ParseException
t
- The timestamp to be decoded. It must not be null
.Date
object decoded from the provided timestamp.java.text.ParseException
- If the provided string could not be decoded as a
timestamp in generalized time format.public static java.lang.String trimLeading(java.lang.String s)
s
- The string to be processed. It must not be null
.public static java.lang.String trimTrailing(java.lang.String s)
s
- The string to be processed. It must not be null
.public static java.util.List<java.lang.String> wrapLine(java.lang.String line, int maxWidth)
line
- The line to be wrapped. It must not be null
.maxWidth
- The maximum width for lines in the resulting list. A
value less than or equal to zero will cause no wrapping
to be performed.public static java.util.List<java.lang.String> wrapLine(java.lang.String line, int maxFirstLineWidth, int maxSubsequentLineWidth)
line
- The line to be wrapped. It must not be
null
.maxFirstLineWidth
- The maximum length for the first line in
the resulting list. A value less than or
equal to zero will cause no wrapping to be
performed.maxSubsequentLineWidth
- The maximum length for all lines except the
first line. This must be greater than zero
unless maxFirstLineWidth
is less
than or equal to zero.public static java.lang.String cleanExampleCommandLineArgument(java.lang.String s)
ExampleCommandLineArgument
. Calling
this method is equivalent to:
return ExampleCommandLineArgument.getCleanArgument(s).getLocalForm();For getting direct access to command line arguments that are safe to use on other platforms, call
ExampleCommandLineArgument.getCleanArgument(java.lang.String)
.s
- The string to be processed. It must not be null
.public static java.lang.String concatenateStrings(java.lang.String... a)
a
- The array of strings to concatenate. It must not be
null
.public static java.lang.String concatenateStrings(java.util.List<java.lang.String> l)
l
- The list of strings to concatenate. It must not be
null
.public static java.lang.String concatenateStrings(java.lang.String beforeList, java.lang.String beforeElement, java.lang.String betweenElements, java.lang.String afterElement, java.lang.String afterList, java.lang.String... a)
beforeList
- A string that should be placed at the beginning of
the list. It may be null
or empty if
nothing should be placed at the beginning of the
list.beforeElement
- A string that should be placed before each element
in the list. It may be null
or empty if
nothing should be placed before each element.betweenElements
- The separator that should be placed between
elements in the list. It may be null
or
empty if no separator should be placed between
elements.afterElement
- A string that should be placed after each element
in the list. It may be null
or empty if
nothing should be placed after each element.afterList
- A string that should be placed at the end of the
list. It may be null
or empty if nothing
should be placed at the end of the list.a
- The array of strings to concatenate. It must not
be null
.public static java.lang.String concatenateStrings(java.lang.String beforeList, java.lang.String beforeElement, java.lang.String betweenElements, java.lang.String afterElement, java.lang.String afterList, java.util.List<java.lang.String> l)
beforeList
- A string that should be placed at the beginning of
the list. It may be null
or empty if
nothing should be placed at the beginning of the
list.beforeElement
- A string that should be placed before each element
in the list. It may be null
or empty if
nothing should be placed before each element.betweenElements
- The separator that should be placed between
elements in the list. It may be null
or
empty if no separator should be placed between
elements.afterElement
- A string that should be placed after each element
in the list. It may be null
or empty if
nothing should be placed after each element.afterList
- A string that should be placed at the end of the
list. It may be null
or empty if nothing
should be placed at the end of the list.l
- The list of strings to concatenate. It must not
be null
.public static java.lang.String secondsToHumanReadableDuration(long s)
s
- The number of seconds to be represented.public static java.lang.String millisToHumanReadableDuration(long m)
m
- The number of milliseconds to be represented.public static long nanosToMillis(long nanos)
nanos
- The number of nanoseconds to convert to milliseconds.public static long millisToNanos(long millis)
millis
- The number of milliseconds to convert to nanoseconds.public static boolean isNumericOID(java.lang.String s)
s
- The string to examine. It must not be null
.true
if the provided string is a valid numeric OID, or
false
if not.public static java.lang.String capitalize(java.lang.String s)
s
- The string to be capitalized.public static java.lang.String capitalize(java.lang.String s, boolean allWords)
s
- The string to be capitalized.allWords
- Indicates whether to capitalize all words in the string,
or only the first word.public static byte[] encodeUUID(java.util.UUID uuid)
uuid
- The UUID to be encoded. It must not be null
.public static java.util.UUID decodeUUID(byte[] b) throws java.text.ParseException
b
- The byte array to be decoded as a UUID. It must not be
null
.java.text.ParseException
- If the provided byte array cannot be parsed as a
UUID.public static boolean isWindows()
true
if and only if the current process is running on
a Windows-based operating system.true
if the current process is running on a Windows-based
operating system and false
otherwise.public static java.util.List<java.lang.String> toArgumentList(java.lang.String s) throws java.text.ParseException
s
- The string to be converted to an argument list.java.text.ParseException
- If a problem is encountered while attempting to
parse the given string to an argument list.public static <T> T[] toArray(java.util.Collection<T> collection, java.lang.Class<T> type)
T
- The type of element included in the provided
collection.collection
- The collection to convert to an array.type
- The type of element contained in the collection.public static <T> java.util.List<T> toList(T[] array)
Arrays.asList
,
except that if the provided array is null
, then it will return a
null
list rather than throwing an exception.T
- The type of item contained in the provided array.array
- The array of items to include in the list.null
if the provided array
was null
.public static <T> java.util.List<T> toNonNullList(T[] array)
Arrays.asList
,
except that if the provided array is null
, then it will return an
empty list rather than throwing an exception.T
- The type of item contained in the provided array.array
- The array of items to include in the list.null
.public static boolean bothNullOrEqual(java.lang.Object o1, java.lang.Object o2)
null
or both
are logically equal (using the equals
method).o1
- The first object for which to make the determination.o2
- The second object for which to make the determination.true
if both objects are null
or both are
logically equal, or false
if only one of the objects is
null
or they are not logically equal.public static boolean bothNullOrEqualIgnoreCase(java.lang.String s1, java.lang.String s2)
null
or both
are logically equal ignoring differences in capitalization (using the
equalsIgnoreCase
method).s1
- The first string for which to make the determination.s2
- The second string for which to make the determination.true
if both strings are null
or both are
logically equal ignoring differences in capitalization, or
false
if only one of the objects is null
or they
are not logically equal ignoring capitalization.public static boolean stringsEqualIgnoreCaseOrderIndependent(java.lang.String[] a1, java.lang.String[] a2)
null
strings, and that
no string appears more than once in each array.a1
- The first array for which to make the determination.a2
- The second array for which to make the determination.true
if both arrays have the same set of strings, or
false
if not.public static <T> boolean arraysEqualOrderIndependent(T[] a1, T[] a2)
null
elements, and that no element appears more than once in each
array.T
- The type of element contained in the arrays.a1
- The first array for which to make the determination.a2
- The second array for which to make the determination.true
if both arrays have the same set of elements, or
false
if not.public static int numBytesInUTF8CharacterWithFirstByte(byte b)
b
- The byte for which to make the determination.public static boolean isSensitiveToCodeAttribute(java.lang.String name)
toCode
methods. If an
attribute is considered sensitive, then its values will be redacted in the
output of the toCode
methods.name
- The name for which to make the determination. It may or may
not include attribute options. It must not be null
.true
if the specified attribute is one that should be
considered sensitive for thepublic static java.util.Set<java.lang.String> getSensitiveToCodeAttributeBaseNames()
toCode
methods. By default, only the userPassword and
authPassword attributes and their respective OIDs will be included.toCode
methods.public static void setSensitiveToCodeAttributes(java.lang.String... names)
toCode
methods.names
- The names of any attributes that should be considered
sensitive for the purposes of the toCode
methods.
It may be null
or empty if no attributes should be
considered sensitive.public static void setSensitiveToCodeAttributes(java.util.Collection<java.lang.String> names)
toCode
methods.names
- The names of any attributes that should be considered
sensitive for the purposes of the toCode
methods.
It may be null
or empty if no attributes should be
considered sensitive.public static java.io.IOException createIOExceptionWithCause(java.lang.String message, java.lang.Throwable cause)
IOException
with a cause. The constructor needed to
do this wasn't available until Java SE 6, so reflection is used to invoke
this constructor in versions of Java that provide it. In Java SE 5, the
provided message will be augmented with information about the cause.message
- The message to use for the exception. This may be
null
if the message should be generated from the
provided cause.cause
- The underlying cause for the exception. It may be
null
if the exception should have only a message.IOException
object that was created.public static java.util.List<java.lang.String> stringToLines(java.lang.String s)
s
- The string to convert into a list of its representative lines.public static java.lang.String linesToString(java.lang.CharSequence... lines)
lines
- The lines to include in the string.public static java.lang.String linesToString(java.util.List<? extends java.lang.CharSequence> lines)
lines
- The lines to include in the string.public static java.io.File constructPath(java.io.File baseDirectory, java.lang.String... pathElements)
File
object from the provided path.baseDirectory
- The base directory to use as the starting point.
It must not be null
and is expected to
represent a directory.pathElements
- An array of the elements that make up the remainder
of the path to the specified file, in order from
paths closest to the root of the filesystem to
furthest away (that is, the first element should
represent a file or directory immediately below the
base directory, the second is one level below that,
and so on). It may be null
or empty if the
base directory should be used.File
object.public static byte[] byteArray(int... bytes)
bytes
- The values to include in the byte array.public static boolean isWithinUnitTest()
true
if the unit tests are currently running, or
false
if not.public static void throwErrorOrRuntimeException(java.lang.Throwable throwable) throws java.lang.Error, java.lang.RuntimeException
Error
or a RuntimeException
based on the provided
Throwable
object. This method will always throw something,
regardless of the provided Throwable
object.throwable
- The Throwable
object to use to create the
exception to throw.java.lang.Error
- If the provided Throwable
object is an
Error
instance, then that Error
instance
will be re-thrown.java.lang.RuntimeException
- If the provided Throwable
object is a
RuntimeException
instance, then that
RuntimeException
instance will be
re-thrown. Otherwise, it must be a checked
exception and that checked exception will be
re-thrown as a RuntimeException
.public static void rethrowIfErrorOrRuntimeException(java.lang.Throwable throwable) throws java.lang.Error, java.lang.RuntimeException
Throwable
instance only if it is an
Error
or a RuntimeException
instance; otherwise, this
method will return without taking any action.throwable
- The Throwable
object to examine and potentially
re-throw.java.lang.Error
- If the provided Throwable
object is an
Error
instance, then that Error
instance
will be re-thrown.java.lang.RuntimeException
- If the provided Throwable
object is a
RuntimeException
instance, then that
RuntimeException
instance will be
re-thrown.public static void rethrowIfError(java.lang.Throwable throwable) throws java.lang.Error
Throwable
instance only if it is an
Error
; otherwise, this method will return without taking any
action.throwable
- The Throwable
object to examine and potentially
re-throw.java.lang.Error
- If the provided Throwable
object is an
Error
instance, then that Error
instance
will be re-thrown.public static int computeMapCapacity(int expectedItemCount)
expectedItemCount
- The expected maximum number of items that will
be placed in the map or set. It must be greater
than or equal to zero.@SafeVarargs public static <T> java.util.Set<T> setOf(T... items)
T
- The type of item to include in the set.items
- The items to include in the set. It must not be
null
, but may be empty.@SafeVarargs public static <T> java.util.HashSet<T> hashSetOf(T... items)
HashSet
containing the provided items.T
- The type of item to include in the set.items
- The items to include in the set. It must not be
null
, but may be empty.HashSet
containing the provided items.@SafeVarargs public static <T> java.util.LinkedHashSet<T> linkedHashSetOf(T... items)
LinkedHashSet
containing the provided items.T
- The type of item to include in the set.items
- The items to include in the set. It must not be
null
, but may be empty.LinkedHashSet
containing the provided items.@SafeVarargs public static <T> java.util.TreeSet<T> treeSetOf(T... items)
TreeSet
containing the provided items.T
- The type of item to include in the set.items
- The items to include in the set. It must not be
null
, but may be empty.LinkedHashSet
containing the provided items.public static <K,V> java.util.Map<K,V> mapOf(K key, V value)
K
- The type for the map keys.V
- The type for the map values.key
- The only key to include in the map.value
- The only value to include in the map.public static <K,V> java.util.Map<K,V> mapOf(K key1, V value1, K key2, V value2)
K
- The type for the map keys.V
- The type for the map values.key1
- The first key to include in the map.value1
- The first value to include in the map.key2
- The second key to include in the map.value2
- The second value to include in the map.public static <K,V> java.util.Map<K,V> mapOf(K key1, V value1, K key2, V value2, K key3, V value3)
K
- The type for the map keys.V
- The type for the map values.key1
- The first key to include in the map.value1
- The first value to include in the map.key2
- The second key to include in the map.value2
- The second value to include in the map.key3
- The third key to include in the map.value3
- The third value to include in the map.public static <K,V> java.util.Map<K,V> mapOf(K key1, V value1, K key2, V value2, K key3, V value3, K key4, V value4)
K
- The type for the map keys.V
- The type for the map values.key1
- The first key to include in the map.value1
- The first value to include in the map.key2
- The second key to include in the map.value2
- The second value to include in the map.key3
- The third key to include in the map.value3
- The third value to include in the map.key4
- The fourth key to include in the map.value4
- The fourth value to include in the map.public static <K,V> java.util.Map<K,V> mapOf(K key1, V value1, K key2, V value2, K key3, V value3, K key4, V value4, K key5, V value5)
K
- The type for the map keys.V
- The type for the map values.key1
- The first key to include in the map.value1
- The first value to include in the map.key2
- The second key to include in the map.value2
- The second value to include in the map.key3
- The third key to include in the map.value3
- The third value to include in the map.key4
- The fourth key to include in the map.value4
- The fourth value to include in the map.key5
- The fifth key to include in the map.value5
- The fifth value to include in the map.public static <K,V> java.util.Map<K,V> mapOf(K key1, V value1, K key2, V value2, K key3, V value3, K key4, V value4, K key5, V value5, K key6, V value6)
K
- The type for the map keys.V
- The type for the map values.key1
- The first key to include in the map.value1
- The first value to include in the map.key2
- The second key to include in the map.value2
- The second value to include in the map.key3
- The third key to include in the map.value3
- The third value to include in the map.key4
- The fourth key to include in the map.value4
- The fourth value to include in the map.key5
- The fifth key to include in the map.value5
- The fifth value to include in the map.key6
- The sixth key to include in the map.value6
- The sixth value to include in the map.public static <K,V> java.util.Map<K,V> mapOf(K key1, V value1, K key2, V value2, K key3, V value3, K key4, V value4, K key5, V value5, K key6, V value6, K key7, V value7)
K
- The type for the map keys.V
- The type for the map values.key1
- The first key to include in the map.value1
- The first value to include in the map.key2
- The second key to include in the map.value2
- The second value to include in the map.key3
- The third key to include in the map.value3
- The third value to include in the map.key4
- The fourth key to include in the map.value4
- The fourth value to include in the map.key5
- The fifth key to include in the map.value5
- The fifth value to include in the map.key6
- The sixth key to include in the map.value6
- The sixth value to include in the map.key7
- The seventh key to include in the map.value7
- The seventh value to include in the map.public static <K,V> java.util.Map<K,V> mapOf(K key1, V value1, K key2, V value2, K key3, V value3, K key4, V value4, K key5, V value5, K key6, V value6, K key7, V value7, K key8, V value8)
K
- The type for the map keys.V
- The type for the map values.key1
- The first key to include in the map.value1
- The first value to include in the map.key2
- The second key to include in the map.value2
- The second value to include in the map.key3
- The third key to include in the map.value3
- The third value to include in the map.key4
- The fourth key to include in the map.value4
- The fourth value to include in the map.key5
- The fifth key to include in the map.value5
- The fifth value to include in the map.key6
- The sixth key to include in the map.value6
- The sixth value to include in the map.key7
- The seventh key to include in the map.value7
- The seventh value to include in the map.key8
- The eighth key to include in the map.value8
- The eighth value to include in the map.public static <K,V> java.util.Map<K,V> mapOf(K key1, V value1, K key2, V value2, K key3, V value3, K key4, V value4, K key5, V value5, K key6, V value6, K key7, V value7, K key8, V value8, K key9, V value9)
K
- The type for the map keys.V
- The type for the map values.key1
- The first key to include in the map.value1
- The first value to include in the map.key2
- The second key to include in the map.value2
- The second value to include in the map.key3
- The third key to include in the map.value3
- The third value to include in the map.key4
- The fourth key to include in the map.value4
- The fourth value to include in the map.key5
- The fifth key to include in the map.value5
- The fifth value to include in the map.key6
- The sixth key to include in the map.value6
- The sixth value to include in the map.key7
- The seventh key to include in the map.value7
- The seventh value to include in the map.key8
- The eighth key to include in the map.value8
- The eighth value to include in the map.key9
- The ninth key to include in the map.value9
- The ninth value to include in the map.public static <K,V> java.util.Map<K,V> mapOf(K key1, V value1, K key2, V value2, K key3, V value3, K key4, V value4, K key5, V value5, K key6, V value6, K key7, V value7, K key8, V value8, K key9, V value9, K key10, V value10)
K
- The type for the map keys.V
- The type for the map values.key1
- The first key to include in the map.value1
- The first value to include in the map.key2
- The second key to include in the map.value2
- The second value to include in the map.key3
- The third key to include in the map.value3
- The third value to include in the map.key4
- The fourth key to include in the map.value4
- The fourth value to include in the map.key5
- The fifth key to include in the map.value5
- The fifth value to include in the map.key6
- The sixth key to include in the map.value6
- The sixth value to include in the map.key7
- The seventh key to include in the map.value7
- The seventh value to include in the map.key8
- The eighth key to include in the map.value8
- The eighth value to include in the map.key9
- The ninth key to include in the map.value9
- The ninth value to include in the map.key10
- The tenth key to include in the map.value10
- The tenth value to include in the map.@SafeVarargs public static <T> java.util.Map<T,T> mapOf(T... items)
T
- The type for the map keys and values.items
- The items to include in the map. If it is null or empty,
the map will be empty. If it is non-empty, then the number
of elements in the array must be a multiple of two.
Elements in even-numbered indexes will be the keys for the
map entries, while elements in odd-numbered indexes will be
the map values.@SafeVarargs public static <K,V> java.util.Map<K,V> mapOfObjectPairs(ObjectPair<K,V>... items)
K
- The type for the map keys.V
- The type for the map values.items
- The items to include in the map.public static java.util.Properties getSystemProperties(java.lang.String... propertyNames)
System.getProperties
. However, the LDAP SDK is known to be used in
environments where a security manager prevents setting system properties,
and in that case, calls to System.getProperties
will be rejected
with a SecurityException
because the returned structure is mutable
and could be used to alter system property values. In such cases, a new
empty Properties
object will be created, and may optionally be
populated with the values of a specific set of named properties.propertyNames
- An optional set of property names whose values (if
defined) should be included in the
Properties
object that will be returned if a
security manager prevents retrieving the full set of
system properties. This may be null
or
empty if no specific properties should be retrieved.System.getProperties
if
possible, or a newly-created properties map (possibly including
the values of a specified set of system properties) if it is not
possible to get a mutable set of the system properties.public static java.lang.String getSystemProperty(java.lang.String name)
name
- The name of the system property for which to retrieve the
value.null
if
that variable was not set or its value could not be retrieved
(for example, because a security manager prevents it).public static java.lang.String getSystemProperty(java.lang.String name, java.lang.String defaultValue)
name
- The name of the system property for which to retrieve
the value.defaultValue
- The default value to return if the specified
system property is not set or could not be
retrieved.public static java.lang.String setSystemProperty(java.lang.String name, java.lang.String value)
name
- The name of the System property to set. It must not be
null
.value
- The value to use for the system property. If it is
null
, then the property will be cleared.null
if it
did not have a value or if it could not be set (for example,
because a security manager prevents it).public static java.lang.String clearSystemProperty(java.lang.String name)
name
- The name of the System property to clear. It must not be
null
.null
if it
did not have a value or if it could not be set (for example,
because a security manager prevents it).public static java.util.Map<java.lang.String,java.lang.String> getEnvironmentVariables()
public static java.lang.String getEnvironmentVariable(java.lang.String name)
name
- The name of the environment variable for which to retrieve
the value.null
if that variable was not set or its value could not be retrieved
(for example, because a security manager prevents it).public static void setLoggerLevel(java.util.logging.Logger logger, java.util.logging.Level logLevel)
logger
- The logger whose level should be updated.logLevel
- The log level to set for the logger.public static void setLogHandlerLevel(java.util.logging.Handler logHandler, java.util.logging.Level logLevel)
logHandler
- The log handler whose level should be updated.logLevel
- The log level to set for the log handler.public static java.util.Set<java.net.InetAddress> getAllLocalAddresses(NameResolver nameResolver)
nameResolver
- The name resolver to use to determine the local
host and loopback addresses. If this is
null
, then the LDAP SDK's default name
resolver will be used.public static java.lang.String getCanonicalHostNameIfAvailable(NameResolver nameResolver, java.net.InetAddress address)
nameResolver
- The name resolver to use to obtain the canonical
host name. If this is null
, then the LDAP
SDK's default name resolver will be used.address
- The InetAddress
for which to attempt to
obtain the canonical host name.null
if it cannot be obtained (either because the attempt returns
null
, which shouldn't happen, or because it matches the
IP address).public static java.util.Set<java.lang.String> getAvailableCanonicalHostNames(NameResolver nameResolver, java.util.Collection<java.net.InetAddress> addresses)
InetAddress
objects. If any of the provided addresses cannot be
resolved to a canonical host name (in which case the attempt to get the
canonical host name will return its IP address), it will be excluded from
the returned set.nameResolver
- The name resolver to use to obtain the canonical
host names. If this is null
, then the LDAP
SDK's default name resolver will be used.addresses
- The set of addresses for which to obtain the
canonical host names.public static java.lang.String trimInterfaceNameFromHostAddress(java.lang.String hostAddress)
hostAddress
- The host address to be trimmed.