com.unboundid.scim.sdk

Class StaticUtils

java.lang.Object

com.unboundid.scim.sdk.StaticUtils

public final class StaticUtils
extends Object

This class provides a number of static utility functions.

Method Summary

Methods

Modifier and Type	Method and Description
static String	collectionToString(Collection<?> collection, String separator) Creates a string representation of the elements in the collection separated by separator.
static Throwable	getRootCause(Throwable t) Inspects the Throwable to obtain the root cause.
static String	getStackTrace(StackTraceElement[] elements) Returns a single-line string representation of the stack trace.
static void	getStackTrace(StackTraceElement[] elements, StringBuilder buffer) Appends a single-line string representation of the stack trace to the given buffer.
static String	getStackTrace(Throwable t) Retrieves a single-line string representation of the stack trace for the provided Throwable.
static void	getStackTrace(Throwable t, StringBuilder buffer) Appends a single-line string representation of the stack trace for the provided Throwable to the given buffer.
static byte[]	getUTF8Bytes(String s) Retrieves a UTF-8 byte representation of the provided string.
static String	listToString(List<?> list, String separator) Creates a string representation of the elements in the list separated by separator.
static String	toLowerCase(String s) Retrieves an all-lowercase version of the provided string.

Methods inherited from class java.lang.Object

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

Method Detail

toLowerCase

public static String toLowerCase(String s)

Retrieves an all-lowercase version of the provided string.

Parameters:

s - The string for which to retrieve the lowercase version.

Returns:

An all-lowercase version of the provided string.

listToString

public static String listToString(List<?> list,
                  String separator)

Creates a string representation of the elements in the list separated by separator.

Parameters:

list - the list to print

separator - to use between elements

Returns:

String representing the list

collectionToString

public static String collectionToString(Collection<?> collection,
                        String separator)

Creates a string representation of the elements in the collection separated by separator.

Parameters:

collection - to print

separator - to use between elements

Returns:

String representing the collection

getUTF8Bytes

public static byte[] getUTF8Bytes(String s)

Retrieves a UTF-8 byte representation of the provided string.

Parameters:

s - The string for which to retrieve the UTF-8 byte representation.

Returns:

The UTF-8 byte representation for the provided string.

getStackTrace

public static String getStackTrace(Throwable t)

Retrieves a single-line string representation of the stack trace for the provided 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).

Parameters:

t - The Throwable for which to retrieve the stack trace.

Returns:

A single-line string representation of the stack trace for the provided Throwable.

getStackTrace

public static void getStackTrace(Throwable t,
                 StringBuilder buffer)

Appends a single-line string representation of the stack trace for the provided 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).

Parameters:

t - The Throwable for which to retrieve the stack trace.

buffer - The buffer to which the information should be appended.

getStackTrace

public static String getStackTrace(StackTraceElement[] elements)

Returns a single-line string representation of the stack trace. It will include a list of source files and line numbers (if available) for the stack trace.

Parameters:

elements - The stack trace.

Returns:

A single-line string representation of the stack trace.

getStackTrace

public static void getStackTrace(StackTraceElement[] elements,
                 StringBuilder buffer)

Appends a single-line string representation of the stack trace to the given buffer. It will include a list of source files and line numbers (if available) for the stack trace.

Parameters:

elements - The stack trace.

buffer - The buffer to which the information should be appended.

getRootCause

public static Throwable getRootCause(Throwable t)

Inspects the Throwable to obtain the root cause. This method walks through the exception chain to the last element (the "root" of the tree) and returns that exception.

This method handles recursive cause structures that might otherwise cause infinite loops. If the Throwable parameter has a cause of itself, then a reference to itself will be returned. If the cause chain loops, the last element in the chain before it loops is returned.

Parameters:

t - the Throwable to get the root cause for. This may be null.

Returns:

the root cause of the Throwable, or null if none is found or the input is null.