org.opensaml.xml.util
Class DatatypeHelper

java.lang.Object
  extended by 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


Copyright © 2006-2012 Internet2. All Rights Reserved.