org.opensaml.xml.util

Class DatatypeHelper

java.lang.Object

org.opensaml.xml.util.DatatypeHelper

public final class DatatypeHelper
extends Object

Helper class for working with various datatypes.

Constructor Summary

Constructors

Modifier	Constructor and Description
private	DatatypeHelper() Constructor.

Method Summary

Methods

Modifier and Type	Method and Description
static byte[]	fileToByteArray(File file) Reads the contents of a file in to a byte array.
static String	inputstreamToString(InputStream input, 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(String s) A "safe" null/empty check for strings.
static String	listToStringValue(List<String> values, 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 String	safeTrim(String s) A safe string trim that handles nulls.
static String	safeTrimOrNullString(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 List<String>	stringToList(String string, 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

Constructor Detail

DatatypeHelper

private DatatypeHelper()

Constructor.

Method Detail

isEmpty

public static boolean isEmpty(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 String safeTrim(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 String safeTrimOrNullString(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(File file)
                              throws 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:

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

inputstreamToString

public static String inputstreamToString(InputStream input,
                         CharsetDecoder decoder)
                                  throws 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:

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

stringToList

public static List<String> stringToList(String string,
                        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 String listToStringValue(List<String> values,
                       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