org.springframework.security.util
Class StringSplitUtils

java.lang.Object
  org.springframework.security.util.StringSplitUtils

public final class StringSplitUtils
extends Object

Provides several String manipulation methods.

Version:

$Id$

Author:

Ben Alex

Method Summary

static String[]	split(String toSplit, String delimiter) Splits a String at the first instance of the delimiter.
static Map	splitEachArrayElementAndCreateMap(String[] array, String delimiter, String removeCharacters) Takes an array of Strings, and for each element removes any instances of removeCharacter, and splits the element based on the delimiter.
static String[]	splitIgnoringQuotes(String str, char separatorChar) Splits a given string on the given separator character, skips the contents of quoted substrings when looking for separators.
static String	substringAfterLast(String str, String separator)
static String	substringBeforeLast(String str, String separator)

Methods inherited from class java.lang.Object

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

Method Detail

split

public static String[] split(String toSplit,
                             String delimiter)

Splits a String at the first instance of the delimiter.

Does not include the delimiter in the response.

Parameters:

toSplit - the string to split

delimiter - to split the string up with

Returns:

a two element array with index 0 being before the delimiter, and index 1 being after the delimiter (neither element includes the delimiter)

Throws:

IllegalArgumentException - if an argument was invalid

splitEachArrayElementAndCreateMap

public static Map splitEachArrayElementAndCreateMap(String[] array,
                                                    String delimiter,
                                                    String removeCharacters)

Takes an array of Strings, and for each element removes any instances of removeCharacter, and splits the element based on the delimiter. A Map is then generated, with the left of the delimiter providing the key, and the right of the delimiter providing the value.

Will trim both the key and value before adding to the Map.

Parameters:

array - the array to process

delimiter - to split each element using (typically the equals symbol)

removeCharacters - one or more characters to remove from each element prior to attempting the split operation (typically the quotation mark symbol) or null if no removal should occur

Returns:

a Map representing the array contents, or null if the array to process was null or empty

substringBeforeLast

public static String substringBeforeLast(String str,
                                         String separator)

substringAfterLast

public static String substringAfterLast(String str,
                                        String separator)

splitIgnoringQuotes

public static String[] splitIgnoringQuotes(String str,
                                           char separatorChar)

Splits a given string on the given separator character, skips the contents of quoted substrings when looking for separators. Introduced for use in DigestProcessingFilter (see SEC-506).

This was copied and modified from commons-lang StringUtils