org.deegree.framework.util
Class StringTools

java.lang.Object
  org.deegree.framework.util.StringTools

public class StringTools
extends Object

this is a collection of some methods that extends the functionallity of the sun-java string class.

Version:

$Revision: 9339 $, $Date: 2007-12-27 13:31:52 +0100 (Do, 27 Dez 2007) $

Author:

Andreas Poth, last edited by: $Author: apoth $

Constructor Summary

StringTools()

Method Summary

static String	arrayToString(double[] s, char delimiter) transforms a double array to one string. the array fields are seperated by the submitted delimiter:
static String	arrayToString(int[] s, char delimiter) transforms a int array to one string. the array fields are seperated by the submitted delimiter:
static String	arrayToString(String[] s, char delimiter) transforms a string array to one string. the array fields are seperated by the submitted delimiter:
static String	concat(int size, Object... objects) concatenates an array of strings using a
static boolean	contains(String[] target, String value) checks if the submitted array contains the string value
static int	countString(String target, String token) countString count the occurrences of token into target
static String[]	deleteDoubles(String[] s) deletes all double entries from the submitted array
static String	extractString(String target, String startDel, String endDel, boolean delStart, boolean delEnd) extract a string contained between startDel and endDel, you can remove the delimiters if set true the parameters delStart and delEnd
static String[]	extractStrings(String target, String startString, String endString) Extract all the strings that begin with "start" and end with "end" and store it into an array of String
static String	listToString(List s, char delimiter) transforms a list to one string. the array fields are seperated by the submitted delimiter:
static String	normalizeString(String source, String locale) The passed string gets normalized along the rules for the given locale as they are set in the file ".
static String[]	removeFromArray(String[] target, String s) removes all fields from the array that equals s
static String	replace(String target, String from, String to, boolean all) replaces occurences of a string fragment within a string by a new string.
static String	stackTraceToString(StackTraceElement[] se) transforms an array of StackTraceElements into a String
static String	stackTraceToString(Throwable e) gets the stacktrace array from the passed Excption and transforms it into a String
static String[]	toArray(String s, String delimiter, boolean deleteDoubles) parse a string and return its tokens as array
static double[]	toArrayDouble(String s, String delimiter) convert the array of string like [(x1,y1),(x2,y2)...] into an array of double [x1,y1,x2,y2...]
static float[]	toArrayFloat(String s, String delimiter) convert the array of string like [(x1,y1),(x2,y2)...] into an array of float values [x1,y1,x2,y2...]
static List<String>	toList(String s, String delimiter, boolean deleteDoubles) parse a string and return its tokens as typed List
static String	validateString(String s, String mark) clears the begin and end of a string from the strings sumitted

Methods inherited from class java.lang.Object

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

Constructor Detail

StringTools

public StringTools()

Method Detail

concat

public static String concat(int size,
                            Object... objects)

concatenates an array of strings using a

Parameters:

size - estimated size of the target string

objects - toString() will be called for each object to append it to the result string

Returns:

See Also:

StringBuffer

replace

public static String replace(String target,
                             String from,
                             String to,
                             boolean all)

replaces occurences of a string fragment within a string by a new string.

Parameters:

target - is the original string

from - is the string to be replaced

to - is the string which will used to replace

all - if it's true all occurences of the string to be replaced will be replaced. else only the first occurence will be replaced.

Returns:

the changed target string

toArray

public static String[] toArray(String s,
                               String delimiter,
                               boolean deleteDoubles)

parse a string and return its tokens as array

Parameters:

s - string to parse

delimiter - delimiter that marks the end of a token

deleteDoubles - if it's true all string that are already within the resulting array will be deleted, so that there will only be one copy of them.

Returns:

toList

public static List<String> toList(String s,
                                  String delimiter,
                                  boolean deleteDoubles)

parse a string and return its tokens as typed List

Parameters:

s - string to parse

delimiter - delimiter that marks the end of a token

deleteDoubles - if it's true all string that are already within the resulting array will be deleted, so that there will only be one copy of them.

Returns:

arrayToString

public static String arrayToString(String[] s,
                                   char delimiter)

transforms a string array to one string. the array fields are seperated by the submitted delimiter:

Parameters:

s - stringarray to transform

delimiter -

listToString

public static String listToString(List s,
                                  char delimiter)

transforms a list to one string. the array fields are seperated by the submitted delimiter:

Parameters:

s - stringarray to transform

delimiter -

arrayToString

public static String arrayToString(double[] s,
                                   char delimiter)

transforms a double array to one string. the array fields are seperated by the submitted delimiter:

Parameters:

s - stringarray to transform

delimiter -

arrayToString

public static String arrayToString(int[] s,
                                   char delimiter)

transforms a int array to one string. the array fields are seperated by the submitted delimiter:

Parameters:

s - stringarray to transform

delimiter -

validateString

public static String validateString(String s,
                                    String mark)

clears the begin and end of a string from the strings sumitted

Parameters:

s - string to validate

mark - string to remove from begin and end of s

deleteDoubles

public static String[] deleteDoubles(String[] s)

deletes all double entries from the submitted array

removeFromArray

public static String[] removeFromArray(String[] target,
                                       String s)

removes all fields from the array that equals s

Parameters:

target - array where to remove the submitted string

s - string to remove

contains

public static boolean contains(String[] target,
                               String value)

checks if the submitted array contains the string value

Parameters:

target - array to check if it contains value

value - string to check if it within the array

toArrayDouble

public static double[] toArrayDouble(String s,
                                     String delimiter)

convert the array of string like [(x1,y1),(x2,y2)...] into an array of double [x1,y1,x2,y2...]

Parameters:

s -

delimiter -

Returns:

toArrayFloat

public static float[] toArrayFloat(String s,
                                   String delimiter)

convert the array of string like [(x1,y1),(x2,y2)...] into an array of float values [x1,y1,x2,y2...]

Parameters:

s -

delimiter -

Returns:

stackTraceToString

public static String stackTraceToString(StackTraceElement[] se)

transforms an array of StackTraceElements into a String

stackTraceToString

public static String stackTraceToString(Throwable e)

gets the stacktrace array from the passed Excption and transforms it into a String

countString

public static int countString(String target,
                              String token)

countString count the occurrences of token into target

Parameters:

target -

token -

Returns:

extractStrings

public static String[] extractStrings(String target,
                                      String startString,
                                      String endString)

Extract all the strings that begin with "start" and end with "end" and store it into an array of String

Parameters:

target -

startString -

endString -

Returns:

null if no strings were found!!

extractString

public static String extractString(String target,
                                   String startDel,
                                   String endDel,
                                   boolean delStart,
                                   boolean delEnd)

extract a string contained between startDel and endDel, you can remove the delimiters if set true the parameters delStart and delEnd

Parameters:

target -

startDel -

endDel -

delStart -

delEnd -

Returns:

normalizeString

public static String normalizeString(String source,
                                     String locale)
                              throws IOException,
                                     SAXException,
                                     XMLParsingException

The passed string gets normalized along the rules for the given locale as they are set in the file "./normalization.xml". If such rules are specified, the following order is obeyed:

1. if the attribute "case" is set with "toLower" or "toUpper", the letters are switched to lower case or to upper case respectively.
2. all rules given in the "Rule" elements are performed.
3. if the attribute "removeDoubles" is set and not empty, all multi occurences of the letters given in this attribute are reduced to a single occurence.

Parameters:

source - the String to normalize

locale - the locale language defining the rules to choose, e.g. "de"

Returns:

the normalized String

Throws:

IOException

SAXException

XMLParsingException