org.opensaml.xml.util
Class DatatypeHelper

java.lang.Object
  org.opensaml.xml.util.DatatypeHelper

public final class DatatypeHelper
extends java.lang.Object

Helper class for working with various datatypes.

Method Summary

static byte[]	fileToByteArray(java.io.File file) Reads the contents of a file in to a byte array.
static java.lang.String	inputstreamToString(java.io.InputStream input, java.nio.charset.CharsetDecoder decoder) Reads an input stream into a string.
static byte[]	intToByteArray(int integer) Converts an integer into an unsigned 4-byte array.
static boolean	isEmpty(java.lang.String s) A "safe" null/empty check for strings.
static java.lang.String	listToStringValue(java.util.List<java.lang.String> values, java.lang.String delimiter) Converts a List of strings into a single string, with values separated by a specified delimiter.
static <T> boolean	safeEquals(T s1, T s2) Compares two strings for equality, allowing for nulls.
static java.lang.String	safeTrim(java.lang.String s) A safe string trim that handles nulls.
static java.lang.String	safeTrimOrNullString(java.lang.String s) Removes preceeding or proceeding whitespace from a string or return null if the string is null or of zero length after trimming (i.e.
static java.util.List<java.lang.String>	stringToList(java.lang.String string, java.lang.String delimiter) Converts a delimited string into a list.

Methods inherited from class java.lang.Object

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

Method Detail

isEmpty

public static boolean isEmpty(java.lang.String s)

A "safe" null/empty check for strings.

Parameters:

s - The string to check

Returns:

true if the string is null or the trimmed string is length zero

safeEquals

public static <T> boolean safeEquals(T s1,
                                     T s2)

Compares two strings for equality, allowing for nulls.

Type Parameters:

T - type of object to compare

Parameters:

s1 - The first operand

s2 - The second operand

Returns:

true if both are null or both are non-null and the same strng value

safeTrim

public static java.lang.String safeTrim(java.lang.String s)

A safe string trim that handles nulls.

Parameters:

s - the string to trim

Returns:

the trimmed string or null if the given string was null

safeTrimOrNullString

public static java.lang.String safeTrimOrNullString(java.lang.String s)

Removes preceeding or proceeding whitespace from a string or return null if the string is null or of zero length after trimming (i.e. if the string only contained whitespace).

Parameters:

s - the string to trim

Returns:

the trimmed string or null

intToByteArray

public static byte[] intToByteArray(int integer)

Converts an integer into an unsigned 4-byte array.

Parameters:

integer - integer to convert

Returns:

4-byte array representing integer

fileToByteArray

public static byte[] fileToByteArray(java.io.File file)
                              throws java.io.IOException

Reads the contents of a file in to a byte array.

Parameters:

file - file to read

Returns:

the byte contents of the file

Throws:

java.io.IOException - throw if there is a problem reading the file in to the byte array

inputstreamToString

public static java.lang.String inputstreamToString(java.io.InputStream input,
                                                   java.nio.charset.CharsetDecoder decoder)
                                            throws java.io.IOException

Reads an input stream into a string. The provide stream is not closed.

Parameters:

input - the input stream to read

decoder - character decoder to use, if null, system default character set is used

Returns:

the string read from the stream

Throws:

java.io.IOException - thrown if there is a problem reading from the stream and decoding it

stringToList

public static java.util.List<java.lang.String> stringToList(java.lang.String string,
                                                            java.lang.String delimiter)

Converts a delimited string into a list.

Parameters:

string - the string to be split into a list

delimiter - the delimiter between values. This string may contain multiple delimiter characters, as allowed by StringTokenizer

Returns:

the list of values or an empty list if the given string is null or empty

listToStringValue

public static java.lang.String listToStringValue(java.util.List<java.lang.String> values,
                                                 java.lang.String delimiter)

Converts a List of strings into a single string, with values separated by a specified delimiter.

Parameters:

values - list of strings

delimiter - the delimiter used between values

Returns:

delimited string of values