net.anotheria.util

Class StringUtils

java.lang.Object

net.anotheria.util.StringUtils

public final class StringUtils
extends Object

StringUtils - some small but usefull utils for String handling.

Version:

1.3

Author:

Leon Rosenberg

Method Summary

Methods

Modifier and Type	Method and Description
static String	_replace2(String source, char replaceChar, char replaceWith) Returns a new String which equals source String
static List<String>	_tokenize(String source, char escapeStart, char escapeEnd, boolean skipEmptyTokens, char... delimiters)
static List<String>	_tokenize(String source, char escapeStart, char escapeEnd, char... delimiters)
static Map<String,String>	buildHashTable(String source) Builds a hash table from the String like *(TYPE : MESSAGE + CR) useful for http requests etc.
static Map<String,String>	buildParameterMap(String source)
static Map<String,String>	buildParameterMap(String source, char lineDelimiter, char parameterDelimiter)
static String	capitalize(String s)
static int	charCount(String source, char toCount) Returns the number of occurencies of the specified cha rin the given string.
static String	combineStrings(String[] strings, char delimiter)
static String	concat(String a, String b)
static String	concat(String a, String b, String delimiter)
static <T> String	concatenateTokens(Collection<T> tokens, char delimiter, char tokenStartingTag, char tokenEndingTag)
static <T> String	concatenateTokens(Collection<T> tokens, String delimiterSequence)
static <T> String	concatenateTokens(String delimiterSequence, float[] tokens)
static <T> String	concatenateTokens(String delimiterSequence, int[] tokens)
static <T> String	concatenateTokens(String delimiterSequence, long[] tokens)
static <T> String	concatenateTokens(String delimiterSequence, T... tokens) Concatenates tokens to String where tokens are separated from each other by delimiterSequence.
static String	escape(String src, char... escapedChars) Escapes all occurrences of escapedChars in a source string with where escaping char is '\'.
static List<String>	extractSuperTags(String source, char tagStart, char tagEnd, char escapeChar)
static List<String>	extractTags(String source, char tagStart, char tagEnd)
static List<String>	extractTagsWithEscapeChar(String source, char tagStart, char tagEnd, char escapeChar)
static String	getFirstLine(String source) Returns first line of multilined String.
static String	getStringAfter(String src, String toSearch)
static String	getStringAfter(String src, String toSearch, int start)
static String	getStringAfterIncl(String src, String toSearch)
static String	getStringAfterIncl(String src, String toSearch, int start)
static String	getStringBefore(String src, String toSearch)
static String	getStringBefore(String src, String toSearch, int start)
static String	getStringBeforeIncl(String src, String toSearch)
static String	getStringBeforeIncl(String src, String toSearch, int start)
static String	getStringWith(String src, String toSearch)
static String	getStringWith(String src, String toSearch, int start)
static List<String>	indexSuperTags(String source, char tagStart, char tagEnd)
static String	insert(String source, String insertion, int position) Inserts the string at the specified position in the source string.
static boolean	isEmpty(String src)
static boolean	isSurroundedWith(String src, char starting, char ending)
static String	makeDelimitedString(String src, String delimiter, int interval)
static String	normalize(String s)
static String	postfill(String s, int desiredLength, String fillString) Postfills (appends) the given string with the string as long as the size of the resulting string is less then desiredLength; Example: prefill("1", 4, "0") -> 0001.
static String	prefill(String s, int desiredLength, String fillString) Prefills the given string with the string as long as the size of the resulting string is less then desiredLength; Example: prefill("1", 4, "0") -> 0001.
static String	remove(String source, int beginIndex, int length) Removes from the source string the characters sequence pointed by beginIndex and length.
static String	removeAnchorEndTag(String s)
static String	removeAnchorTag(String s)
static String	removeBashComments(String src)
static String	removeCComments(String src)
static String	removeChar(String src, char c) Returns a source String with all occurences of 'c' removed.
static String	removeCharAt(String src, int position)
static String	removeChars(String src, char[] c)
static String	removeCPPComments(String src)
static String	removeImgTag(String s)
static String	removeLines(String src)
static String	removeString(String s, String toRemove)
static String	removeSurround(String src)
static String	removeTag(String s, String tag)
static String	replace(String source, char replaceChar, char replaceWith)
static String	replace(String source, char replaceChar, String replaceWith)
static String	replace(String source, Map<String,String> map) - kle 14.06.2001 Replace a set of chars with a set of strings
static String	replace(String src, String toReplace, char with)
static String	replace(String src, String toReplace, String with) Replaces all occurences of the toReplace string in the source string with the 'with' string.
static String	replaceOnce(String src, String toReplace, String with)
static String	replaceUmlauts(String src)
static <T> Vector<T>	reverse(Vector<T> v) Reverses the order in the Vector.
static String	reverseString(String src)
static net.anotheria.util.StringUtils.StringPair	splitString(String source, char delimiter)
static String	strip(String src, int fromBeginn, int fromEnd)
static String	substringFromEnd(String src, int indexFromEnd)
static String	surroundWith(String src, char starting, char ending)
static String[]	tokenize(String source, boolean ignoreEmptyTokens, char delimiter)
static String[]	tokenize(String source, char delimiter) Returns an array of stringtokens from the source string.
static String[]	tokenize(String source, char delimiter, char escapeChar)
static List<String>	tokenize(String source, char escapeStart, char escapeEnd, char... delimiters)
static List<String>	tokenize2list(String source, char delimiter)
static List<String>	tokenize2list(String source, char delimiter, char escapeChar)
static Map<String,String>	tokenize2map(String source, char entriesDelimiter, char keyValueDelimiter) Return a Map with entries from the source string tokenized on entries using the entriesDelimiter and on key-value pair with keyValueDelimiter.
static Vector<String>	tokenize2vector(String source, char delimiter) Return a Vector with tokens from the source string tokenized using the delimiter char.
static List<String>	toStringList(List<?> list) Converts an Objects list to the list of Strings by calling toString method of each Object from incoming list.
static String	trimString(String value, String delimiter, int maxSize) Trims string to last index of delimiter which is situated before max size index and concatenates it with "...".

Methods inherited from class java.lang.Object

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

Method Detail

tokenize2vector

public static final Vector<String> tokenize2vector(String source,
                             char delimiter)

Return a Vector with tokens from the source string tokenized using the delimiter char.

tokenize2list

public static final List<String> tokenize2list(String source,
                         char delimiter,
                         char escapeChar)

tokenize2list

public static final List<String> tokenize2list(String source,
                         char delimiter)

tokenize2map

public static final Map<String,String> tokenize2map(String source,
                              char entriesDelimiter,
                              char keyValueDelimiter)

Return a Map with entries from the source string tokenized on entries using the entriesDelimiter and on key-value pair with keyValueDelimiter.

tokenize

public static final String[] tokenize(String source,
                char delimiter)

Returns an array of stringtokens from the source string. The String "Leon Power Tools" with delimiter ' ' will return {"Leon","Power","Tools"} Last change: LR 15 Aug 98 4:23 pm

tokenize

public static final String[] tokenize(String source,
                boolean ignoreEmptyTokens,
                char delimiter)

tokenize

public static final String[] tokenize(String source,
                char delimiter,
                char escapeChar)

removeCharAt

public static final String removeCharAt(String src,
                  int position)

removeChar

public static final String removeChar(String src,
                char c)

Returns a source String with all occurences of 'c' removed. removeChar("Leon's Power Tools", ' ') will return "Leon'sPowerTools".

removeChars

public static final String removeChars(String src,
                 char[] c)

removeLines

public static final String removeLines(String src)

getFirstLine

public static String getFirstLine(String source)

Returns first line of multilined String.

buildHashTable

public static Map<String,String> buildHashTable(String source)

Builds a hash table from the String like *(TYPE : MESSAGE + CR) useful for http requests etc.

buildParameterMap

public static Map<String,String> buildParameterMap(String source)

buildParameterMap

public static Map<String,String> buildParameterMap(String source,
                                   char lineDelimiter,
                                   char parameterDelimiter)

charCount

public static int charCount(String source,
            char toCount)

Returns the number of occurencies of the specified cha rin the given string.

insert

public static String insert(String source,
            String insertion,
            int position)

Inserts the string at the specified position in the source string.

Parameters:

source - source string

insertion - string to be inserted at the specified position

position - position in the source string to insert

Returns:

the resulting string

Throws:

IndexOutOfBoundsException - if the position is negative, or position is larger than the length of source string

_replace2

public static String _replace2(String source,
               char replaceChar,
               char replaceWith)

Returns a new String which equals source String

replace

public static String replace(String source,
             char replaceChar,
             char replaceWith)

replace

public static String replace(String source,
             char replaceChar,
             String replaceWith)

replace

public static String replace(String source,
             Map<String,String> map)

- kle 14.06.2001 Replace a set of chars with a set of strings

Parameters:

sorce - the source string

map - replace map

Returns:

a source string where all chars that are members of map keys are replaced with the interlocking values

splitString

public static net.anotheria.util.StringUtils.StringPair splitString(String source,
                                                    char delimiter)

reverse

public static <T> Vector<T> reverse(Vector<T> v)

Reverses the order in the Vector.

concat

public static final String concat(String a,
            String b)

concat

public static final String concat(String a,
            String b,
            String delimiter)

combineStrings

public static String combineStrings(String[] strings,
                    char delimiter)

capitalize

public static final String capitalize(String s)

getStringAfter

public static String getStringAfter(String src,
                    String toSearch,
                    int start)

getStringAfter

public static String getStringAfter(String src,
                    String toSearch)

getStringAfterIncl

public static String getStringAfterIncl(String src,
                        String toSearch,
                        int start)

getStringAfterIncl

public static String getStringAfterIncl(String src,
                        String toSearch)

getStringWith

public static String getStringWith(String src,
                   String toSearch,
                   int start)

getStringWith

public static String getStringWith(String src,
                   String toSearch)

getStringBefore

public static String getStringBefore(String src,
                     String toSearch,
                     int start)

getStringBefore

public static String getStringBefore(String src,
                     String toSearch)

getStringBeforeIncl

public static String getStringBeforeIncl(String src,
                         String toSearch,
                         int start)

getStringBeforeIncl

public static String getStringBeforeIncl(String src,
                         String toSearch)

removeImgTag

public static String removeImgTag(String s)

removeAnchorTag

public static String removeAnchorTag(String s)

removeAnchorEndTag

public static String removeAnchorEndTag(String s)

removeTag

public static String removeTag(String s,
               String tag)

removeString

public static String removeString(String s,
                  String toRemove)

remove

public static String remove(String source,
            int beginIndex,
            int length)

Removes from the source string the characters sequence pointed by beginIndex and length.

Parameters:

source - source string

beginIndex - the beginning index, inclusive

length - the length of characters sequence to remove

Returns:

the resulting string

Throws:

IndexOutOfBoundsException - if the beginIndex or length are negative, or beginIndex or beginIndex + length are larger than the length of source string

replaceOnce

public static final String replaceOnce(String src,
                 String toReplace,
                 String with)

replace

public static final String replace(String src,
             String toReplace,
             String with)

Replaces all occurences of the toReplace string in the source string with the 'with' string.

Parameters:

src - source text.

toReplace - string to replace.

with - string to replace with.

Returns:

replace

public static final String replace(String src,
             String toReplace,
             char with)

removeCComments

public static final String removeCComments(String src)

removeCPPComments

public static final String removeCPPComments(String src)

removeBashComments

public static final String removeBashComments(String src)

reverseString

public static String reverseString(String src)

makeDelimitedString

public static String makeDelimitedString(String src,
                         String delimiter,
                         int interval)

prefill

public static String prefill(String s,
             int desiredLength,
             String fillString)

Prefills the given string with the string as long as the size of the resulting string is less then desiredLength; Example: prefill("1", 4, "0") -> 0001.

postfill

public static String postfill(String s,
              int desiredLength,
              String fillString)

Postfills (appends) the given string with the string as long as the size of the resulting string is less then desiredLength; Example: prefill("1", 4, "0") -> 0001.

extractTags

public static List<String> extractTags(String source,
                       char tagStart,
                       char tagEnd)

extractTagsWithEscapeChar

public static List<String> extractTagsWithEscapeChar(String source,
                                     char tagStart,
                                     char tagEnd,
                                     char escapeChar)

strip

public static String strip(String src,
           int fromBeginn,
           int fromEnd)

isSurroundedWith

public static boolean isSurroundedWith(String src,
                       char starting,
                       char ending)

removeSurround

public static String removeSurround(String src)

surroundWith

public static String surroundWith(String src,
                  char starting,
                  char ending)

extractSuperTags

public static List<String> extractSuperTags(String source,
                            char tagStart,
                            char tagEnd,
                            char escapeChar)

indexSuperTags

public static List<String> indexSuperTags(String source,
                          char tagStart,
                          char tagEnd)

tokenize

public static final List<String> tokenize(String source,
                    char escapeStart,
                    char escapeEnd,
                    char... delimiters)

_tokenize

public static final List<String> _tokenize(String source,
                     char escapeStart,
                     char escapeEnd,
                     char... delimiters)

_tokenize

public static final List<String> _tokenize(String source,
                     char escapeStart,
                     char escapeEnd,
                     boolean skipEmptyTokens,
                     char... delimiters)

substringFromEnd

public static String substringFromEnd(String src,
                      int indexFromEnd)

concatenateTokens

public static <T> String concatenateTokens(Collection<T> tokens,
                           char delimiter,
                           char tokenStartingTag,
                           char tokenEndingTag)

concatenateTokens

public static <T> String concatenateTokens(Collection<T> tokens,
                           String delimiterSequence)

concatenateTokens

public static <T> String concatenateTokens(String delimiterSequence,
                           T... tokens)

Concatenates tokens to String where tokens are separated from each other by delimiterSequence. NOTE: vararg of parameterized types (here @param array) for primitive arrays doesn't work properly. This utility have to be accomplished with concatenateTokens methods for each primitive arrays!!!

Type Parameters:

T -

Parameters:

delimiterSequence -

tokens -

Returns:

concatenateTokens

public static <T> String concatenateTokens(String delimiterSequence,
                           int[] tokens)

concatenateTokens

public static <T> String concatenateTokens(String delimiterSequence,
                           long[] tokens)

concatenateTokens

public static <T> String concatenateTokens(String delimiterSequence,
                           float[] tokens)

replaceUmlauts

public static String replaceUmlauts(String src)

escape

public static String escape(String src,
            char... escapedChars)

Escapes all occurrences of escapedChars in a source string with where escaping char is '\'. Note: Source string is not checked whether character from escapedChars is already escaped or not.

Parameters:

src - source string to escape

escapedChars - sequence of characters to escape

Returns:

escaped string

normalize

public static String normalize(String s)

isEmpty

public static boolean isEmpty(String src)

toStringList

public static List<String> toStringList(List<?> list)

Converts an Objects list to the list of Strings by calling toString method of each Object from incoming list.

Parameters:

list - incoming list of Objects

Returns:

list where each incoming object converted to string.

trimString

public static String trimString(String value,
                String delimiter,
                int maxSize)

Trims string to last index of delimiter which is situated before max size index and concatenates it with "...". If maxSize > value.length than value will be returned.

Parameters:

value - string to trim

delimiter - delimiter for trimming

maxSize - max size of trimmed string

Returns:

trimmed and concatenated with "..." string