StringTool (domui :: alg 1.1 API)

java.lang.Object
- to.etc.util.StringTool

```
public class StringTool
extends Object
```
This static utility class contains a load of string functions. And some other stuff I could not quickly find a place for ;-)

Version:

1.0

Author:

Frits Jalvingh

Field Summary

Fields
Modifier and Type Field and Description

static int MAX_EMAIL_LENGTH
According to RFC 3696

static int MAX_SIZE_IN_BYTES_FOR_ORACLE_VARCHAR2
Deprecated.

Fields
Modifier and Type	Field and Description
`static int`	`MAX_EMAIL_LENGTH` According to RFC 3696
`static int`	`MAX_SIZE_IN_BYTES_FOR_ORACLE_VARCHAR2` Deprecated.

Constructor Summary

Constructors
Constructor and Description

StringTool()

Constructors
Constructor and Description
`StringTool()`

Method Summary

All Methods Static Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`static void`	`addPathToVector(List<String> v, String p)` Adds a path to the vector specified, if the path is an existing file or directory, and it doesn't already exist in the vector.
`static void`	`addSearchEnvToVector(List<String> v, String envvar)` Adds the value of a "search path environment variable" to the vector.
`static void`	`addSearchPathToVector(List<String> v, String searchpath)` Takes a search path, i.e.
`static void`	`arrayToAsciiStr(Appendable sb, byte[] ar, int bi, int nc)` Returns a string containing only printable chars for the given bytes.
`static void`	`arrayToDumpLine(Appendable sb, byte[] ar, int bi, int nc)` Returns a dumpstring containing the offset, the hex bytes, and the ascii representation of a given dump buffer.
`static void`	`arrayToHexStr(Appendable sb, byte[] ar, int bi, int nc, boolean fillout)` Returns a string of hex bytes for a given thing.
`static void`	`createInsertStatement(StringBuilder sb, String table, String pkname, String pkexpr, String[] fields)`
`static void`	`createUpdateStatement(StringBuilder sb, String table, String pkname, String[] fields)`
`static boolean`	`dbGetBool(String fv)` Returns a boolean value from some database field.
`static String`	`dbSetBool(boolean v)` Returns a char(1) value to store in a database for booleans.
`static byte[]`	`decodeBase64(byte[] data)` This method decodes the given byte[] using the base64-encoding specified in RFC-2045 (Section 6.8).
`static byte[]`	`decodeBase64(String str)` This method decodes the given string using the base64-encoding specified in RFC-2045 (Section 6.8).
`static String`	`decodeBase64ToString(String str)` This method decodes the given string using the base64-encoding specified in RFC-2045 (Section 6.8).
`static String`	`decodeURLEncoded(String encoded)` Decode the URLEncoded string passed to a real string.
`static void`	`dumpData(Appendable sb, byte[] ar, int off, int len)` Dump the data as a formatted multiline buffer: like
`static void`	`dumpDebugLocation(org.slf4j.Logger log, String msg)`
`static void`	`dumpErrorLocation(org.slf4j.Logger log, String msg)`
`static void`	`dumpInfoLocation(org.slf4j.Logger log, String msg)`
`static void`	`dumpLocation(String msg)` Kept in api since it was useful for some debugs while coding, use just for debug purposes only, do not use in produciton code.
`static void`	`dumpTraceLocation(org.slf4j.Logger log, String msg)`
`static void`	`dumpWarnLocation(org.slf4j.Logger log, String msg)`
`static byte[]`	`encodeBase64(byte[] data)` This method encodes the given byte[] using the base64-encoding specified in RFC-2045 (Section 6.8).
`static String`	`encodeBase64(String str)` This method encodes the given string using the base64-encoding specified in RFC-2045 (Section 6.8).
`static String`	`encodeBase64ToString(byte[] data)`
`static void`	`encodeURLEncoded(Appendable sb, String str)` Encode the string passed to URLEncoded format.
`static String`	`encodeURLEncoded(String str)`
`static void`	`entitiesToUnicode(Appendable sb, String str, boolean ignoremarkers)` Scans the input string for entities and replaces all entities that are actually found with their Unicode character code.
`static int`	`entityToUnicode(String ename)` Translates an entity name to unicode.
`static boolean`	`equalStringList(List<String> inl, List<String> al, boolean caseindependent)`
`static String`	`extractSingleLine(String in)` Tries to extract a single line of max.
`static String`	`fill(int count, char character)`
`static File`	`findFileOnEnv(String pname, String env)` Finds a filename along the classpath..
`static File`	`findFileOnPath(String fname, String path)` Returns the complete filename of the first file that is found along the path specified.
`static String`	`fixFileURL(String fileurl)`
`static byte[]`	`fromHex(String s)` Decodes a hex string into a byte array.
`static String`	`generateGUID()` Generate an unique identifier with reasonable expectations that it will be globally unique.
`static byte[]`	`getBase64Map()`
`static List<String>`	`getEnvironment()` Returns the list of environment variables of the supported OS's.
`static String`	`getExceptionMessage(Throwable t)` If the throwable passed as a message then return it verbatim, else return the exception's classname.
`static String`	`getFileExtension(String fn)` Deprecated.
`static String`	`getFinalFrom(Class<?> cl, long sval)`
`static String`	`getFinalFrom(Class<?> cl, long sval, String part)` Traverses a given class and tries to find a public
`static String`	`getFinalFrom(Class<?> cl, long sval, String part, String ign)` Traverses a given class and tries to find a public
`static int`	`getJreVersion()`
`static int`	`getLevenshteinDistance(String s, String t, boolean ignorecase)` This returns the Levenshtein distance between two strings, which is the number of changes (adds, removes) that are needed to convert source into target.
`static String`	`getLocation()`
`static void`	`getLocation(StringBuffer sb)`
`static String`	`getNextPathComponent(int ix, String s, boolean includeslash)` Find the 1st part of the path passed, i.e.
`static String`	`getNextPathComponent(String s, boolean includeslash)`
`static String`	`getRandomStringWithPrefix(int length, String prefix)` This methods creates a random String with the specified prefix and length given.
`static String`	`getString(InputStream is)` Deprecated.
`static void`	`htmlStringize(Appendable o, String is)` Enter with a string; it returns the same string but replaces HTML recognised characters with their &..; equivalent.
`static String`	`htmlStringize(String is)` Enter with a string; it returns the same string but replaces HTML recognised characters with their &..; equivalent.
`static void`	`htmlStringize(StringBuilder sb, String is)` Enter with a string; it returns the same string but replaces HTML recognised characters with their &..; equivalent.
`static void`	`htmlStringizewithLF(StringBuilder sb, String is)` Enter with a string; it returns the same string but replaces HTML recognised characters with their &..; equivalent.
`static String`	`intToStr(int val, int radix, int npos)` Returns a number in the specified base, and with the specified #of positions.
`static boolean`	`isAllSpaces(String s)`
`static boolean`	`isBlank(String s)` Checks if string is blank.
`static boolean`	`isDomainChar(char c)`
`static boolean`	`isEqual(Object a, Object b)`
`static boolean`	`isEqualIgnoreCase(String a, String b)`
`static boolean`	`isInteger(String string)` Checks if forwarded string can be parsed into an Integer.
`static boolean`	`isInvalidOracleLength(String text)` Checks whether a given text is too big for the maximum varchar2 database field
`static boolean`	`isNumber(String s)` Returns TRUE if the string is a number, possibly containing a '.'.
`static boolean`	`isValidDbFieldName(String s)` Field name must start with ascii letter, then letters, digits or _.
`static boolean`	`isValidDomainName(String s)` Checks if the name is a valid domain name.
`static boolean`	`isValidDottedName(String s)`
`static boolean`	`isValidEmail(String em)`
`static boolean`	`isValidJavaIdentifier(String s)`
`static boolean`	`isWhiteSpaceOrNbsp(char c)`
`static void`	`main(String[] args)`
`static String`	`makeSearchPath(List<String> v)` Returns a string buffer containing a search path variable from the vector passed.
`static String`	`makeSearchPath(String[] v)` Returns a string buffer containing a search path variable from the vector passed.
`static void`	`makeSearchPath(StringBuffer sb, String[] v)` Returns a string buffer containing a search path variable from the vector passed.
`static void`	`makeSearchPath(StringBuilder sb, List<String> v)` Returns a string buffer containing a search path variable from the vector passed.
`static String`	`makeURL(File f)` Workaround for Java bug delivering file:// instead of file:/// for file.toURL().toString().
`static String`	`normalizeConcat(String current, String tpl)` Called when generate() is called with a string.
`static String`	`normalizeUndot(String ins)` Takes an input URL and handles all '.' and '..' replacements.
`static String`	`normalizeURL(String current, String tpl)` Called when generate() is called with a string.
`static String`	`oldStrOracleTruncate(String in, int nchars)` Handles Oracle truncation rules: If the string is > nchars truncate to nchars Convert the string to bytes in UTF-8 encoding If the string length, in bytes, is > 4000 bytes (the max stupid size of Oracle's stupid varchar2 column, stupid) remove characters until the string fits the stupidly limited Oracle column
`static String`	`oldStrOracleTruncate(String in, int nchars, String suffixForTooLong)` Returns string that can fix into Oracle column, and in case that it has to be truncated it adds specified suffix to it, that is still not exceding Oracle limit in total.
`static void`	`parseString(StringBuilder sb, String s)` Takes a java string, without quotes, and replaces all escape sequences in there with their actual character representation.
`static void`	`printHex(PrintStream pw, byte[] arr)`
`static void`	`printHex(PrintStream pw, byte[] arr, int start, int end)`
`static void`	`printHex(PrintWriter pw, byte[] arr)`
`static void`	`printHex(PrintWriter pw, byte[] arr, int start, int end)`
`static String`	`removeAccents(String str)` Replaces all accented letters with their non-accented equivalents - FOR WESTERN LANGUAGES ONLY!
`static String`	`removeRepeatingCharacters(String in)` Replaces long character sequences without space like ---- and ===== with a way shorter version (single character).
`static String`	`renderAsRawHtml(String input, boolean removeEndingNewLines)` Does some transformation of custom string to html output -> taking into account several customizations.
`static String`	`replaceNewLineChars(String content, String replacement)` Replaces all end of line characters with space so that content is represented in one line.
`static void`	`strAddIntFixed(Appendable sb, int val, int radix, int len)` Converts the integer to a string with a fixed length, adding leading zeroes if needed.
`static String`	`strBackslashToSlash(String s)` Takes an input string and replaces all occurences of the backslash with a forward slash.
`static String`	`strCapitalized(String name)`
`static String`	`strCommad(long val)` Returns a properly formatted commad string for a number [english only].
`static String`	`strDuration(long dlt)`
`static String`	`strDurationMillis(long dlt)`
`static boolean`	`strEndsWithIgnoreCase(String st, String with)` Returns T if the string ends with the specified string, while ignoring case.
`static int`	`strIndexOfIgnoreCase(String txt, String match)` Tries to locate a substring in a string while ignoring case.
`static StringBuffer`	`stringize(String s)` Converts a string into a java-compilable version of a string, i.e.
`static void`	`stringize(StringBuffer sb, String s)`
`static StringBuffer`	`stringizeNQ(String s)`
`static String`	`strNanoTime(long ns)` Return a nanotime timestamp with 2 thousands of precision max.
`static String`	`strOracleTruncate(String in, int nchars)`
`static String`	`strOracleTruncate(String in, int nchars, String suffix)`
`static String`	`strReplace(String src, String old, String nw)` Case-sensitive replace of all occurrences of [old] with [new].
`static String`	`strSize(long sz)` Returns a string representing some size, in bytes.
`static void`	`strStacktrace(Appendable sb, Throwable t)`
`static String`	`strStacktrace(Throwable t)`
`static void`	`strStacktraceFiltered(Appendable sb, Throwable t, String[] skipbefore, String[] skipafter, int linelimit)` Report a filtered location stack trace, where the start of the stack trace and the end can be removed.
`static boolean`	`strStartsWithIgnoreCase(String st, String with)` Returns T if the string starts with the specified string, while ignoring case.
`static String`	`strToFixedLength(String s, char c, int l)` Returns a string with the specified length.
`static String`	`strToFixedLength(String s, int l)` Returns a string with the specified length.
`static int`	`strToInt(String v, int defval)`
`static void`	`strToJavascriptString(Appendable w, String cs, boolean dblquote)`
`static String`	`strToJavascriptString(String cs, boolean dblquote)`
`static long`	`strToLong(String v, int six, int eix, int defval)`
`static long`	`strToLong(String v, long defval)`
`static String`	`strTrunc(String s, int len)`
`static String`	`strTruncateUtf8Bytes(String in, int nchars, int nbytes)`
`static String`	`strTruncateUtf8Bytes(String in, int nchars, int nbytes, String suffix)`
`static String`	`strUnquote(String s)`
`static String`	`strUnspace(String s)` Removes all whitespace from a string.
`static String`	`toHex(byte[] arr)` Converts the byte array to a hex string.
`static String`	`toHex(byte[] arr, int start, int end)` Converts the byte array passed to a hex string.
`static String`	`toHexSp(byte[] arr)` Converts the byte array to a hex string.
`static String`	`toHexSp(byte[] arr, int start, int end)` Converts the byte array passed to a hex string.
`static String`	`toXY(int x, int y)` Returns a coordinate pair as a string.
`static String`	`truncLeadingOracleColumn(String text, int columnSize)` This method removes the leading characters from the string, if it exceeds the column size or needs more then 4000 bytes to store in the database.
`static String`	`truncLength(String s, int maxlen)` If the input string is too long, returns a substring containing at most maxlen characters.
`static void`	`unicodeToEntities(StringBuffer sb, String str)` Replaces all non-ascii stuff with their entities.
`static String`	`urlLastPart(String url)` Returns the last element (document name?) from the url passed.
`static int`	`utf8Length(String in)`
`static int`	`utf8Truncated(String in, int length, int maxbytes)`
`static boolean`	`validateUrl(String urlValue)` Loose checks if provided URL is valid. It allows URLs with and without http, https, ftp...
`static String`	`xmlStringize(String is)` Enter with a string; it returns the same string but replaces HTML recognised characters with their &..; equivalent.
`static void`	`xmlStringize(StringBuffer sb, String is)` Enter with a string; it returns the same string but replaces HTML recognised characters with their &..; equivalent.
`static String`	`xmlStringizeForDomApi(String is)` Converts input string to xml representation that complies to DOM API 5.2 Character Escaping http://www.w3.org/TR/2000/WD-xml-c14n-20000119.html#charescaping
`static void`	`xmlStringizeForDomApi(StringBuffer sb, String is)` Converts input string to xml representation that complies to DOM API 5.2 Character Escaping http://www.w3.org/TR/2000/WD-xml-c14n-20000119.html#charescaping

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail
- MAX_SIZE_IN_BYTES_FOR_ORACLE_VARCHAR2
```
@Deprecated
public static final int MAX_SIZE_IN_BYTES_FOR_ORACLE_VARCHAR2
```
  Deprecated.
  
  PLEASE DO NOT USE ANYMORE - this limit will change in Oracle 12. To get the correct limit please call DomApplication.getPlatformVarcharByteLimit() which will return either 0 or the correct byte limit for the oracle version used.
  
  See Also:
  
  Constant Field Values
- MAX_EMAIL_LENGTH
```
public static final int MAX_EMAIL_LENGTH
```
  According to RFC 3696
  
  See Also:
  
  Constant Field Values

Constructor Detail
- StringTool
```
public StringTool()
```

Method Detail

isValidJavaIdentifier

public static boolean isValidJavaIdentifier(@Nonnull
                                            String s)

getRandomStringWithPrefix

@Nonnull
public static String getRandomStringWithPrefix(int length,
                                                        @Nonnull
                                                        String prefix)

This methods creates a random String with the specified prefix and length given. The generated string does not contain vowels (a, e, i, o, u)

Parameters:: length -; prefix -
Returns:

isValidDomainName
```
public static boolean isValidDomainName(@Nonnull
                                        String s)
```
Checks if the name is a valid domain name. These can contain only letters (a..z), digits (0..9), the dash and dots. Dots cannot start or end a name, nor can two dots occurs immediately next to another.

Parameters:

s -

Returns:

isNumber

public static boolean isNumber(@Nonnull
                               String s)

Returns TRUE if the string is a number, possibly containing a '.'.

Parameters:: s -
Returns:

isDomainChar

public static boolean isDomainChar(char c)

isWhiteSpaceOrNbsp

public static boolean isWhiteSpaceOrNbsp(char c)

isAllSpaces

public static boolean isAllSpaces(@Nonnull
                                  String s)

isValidEmail

public static boolean isValidEmail(@Nonnull
                                   String em)

isValidDbFieldName

public static boolean isValidDbFieldName(@Nonnull
                                         String s)

Field name must start with ascii letter, then letters, digits or _.

Parameters:: s -
Returns:

isValidDottedName

public static boolean isValidDottedName(String s)

isEqual

public static boolean isEqual(@Nullable
                              Object a,
                              @Nullable
                              Object b)

isEqualIgnoreCase

public static final boolean isEqualIgnoreCase(@Nullable
                                              String a,
                                              @Nullable
                                              String b)

stringize

public static void stringize(@Nonnull
                             StringBuffer sb,
                             @Nonnull
                             String s)

stringize
```
public static StringBuffer stringize(@Nonnull
                                     String s)
```
Converts a string into a java-compilable version of a string, i.e. surrounded by quotes, and with escape sequences escaped..

stringizeNQ

public static StringBuffer stringizeNQ(@Nonnull
                                       String s)

strBackslashToSlash

public static String strBackslashToSlash(@Nonnull
                                         String s)

Takes an input string and replaces all occurences of the backslash with a forward slash.

strSize
```
public static String strSize(long sz)
```
Returns a string representing some size, in bytes. Depending on the size it will be represented as KB, MB, GB or TB.

parseString

public static void parseString(@Nonnull
                               StringBuilder sb,
                               @Nonnull
                               String s)

Takes a java string, without quotes, and replaces all escape sequences in there with their actual character representation.

truncLength

public static String truncLength(@Nullable
                                 String s,
                                 int maxlen)

If the input string is too long, returns a substring containing at most maxlen characters.

strToFixedLength
```
public static String strToFixedLength(String s,
                                      int l)
```
Returns a string with the specified length. If the string is too long it is truncated; if it is too short it is filled with spaces.

strToFixedLength

public static String strToFixedLength(@Nonnull
                                      String s,
                                      char c,
                                      int l)

Returns a string with the specified length. If the string is too long it is truncated; if it is too short it is filled with c.

toXY

@Nonnull
public static String toXY(int x,
                                   int y)

Returns a coordinate pair as a string.

getLevenshteinDistance

public static int getLevenshteinDistance(@Nonnull
                                         String s,
                                         @Nonnull
                                         String t,
                                         boolean ignorecase)

This returns the Levenshtein distance between two strings, which is the number of changes (adds, removes) that are needed to convert source into target. The number of changes is an indication of the difference between those strings.

strStartsWithIgnoreCase

public static boolean strStartsWithIgnoreCase(@Nonnull
                                              String st,
                                              @Nonnull
                                              String with)

Returns T if the string starts with the specified string, while ignoring case.

Parameters:: st - the string whose start is to be checked; with - the start string
Returns:

strEndsWithIgnoreCase

public static boolean strEndsWithIgnoreCase(@Nonnull
                                            String st,
                                            @Nonnull
                                            String with)

Returns T if the string ends with the specified string, while ignoring case.

Parameters:: st - the string whose end is to be checked; with - the end string
Returns:

strIndexOfIgnoreCase

public static int strIndexOfIgnoreCase(@Nonnull
                                       String txt,
                                       @Nonnull
                                       String match)

Tries to locate a substring in a string while ignoring case.

Parameters:: txt -; match -
Returns:

intToStr
```
@Nonnull
public static String intToStr(int val,
                                       int radix,
                                       int npos)
```
Returns a number in the specified base, and with the specified #of positions. If the number is too large for the #positions then the high values are cut off.

strAddIntFixed

public static void strAddIntFixed(@Nonnull
                                  Appendable sb,
                                  int val,
                                  int radix,
                                  int len)

Converts the integer to a string with a fixed length, adding leading zeroes if needed.

Parameters:: sb -; val -; radix -; len -

strCommad
```
@Nonnull
public static String strCommad(long val)
```
Returns a properly formatted commad string for a number [english only].

Parameters:

val -

Returns:

strDuration

@Nonnull
public static String strDuration(long dlt)

strDurationMillis

@Nonnull
public static String strDurationMillis(long dlt)

strTrunc

public static String strTrunc(@Nullable
                              String s,
                              int len)

arrayToHexStr

public static void arrayToHexStr(@Nonnull
                                 Appendable sb,
                                 @Nonnull
                                 byte[] ar,
                                 int bi,
                                 int nc,
                                 boolean fillout)
                          throws IOException

Returns a string of hex bytes for a given thing.

Throws:: IOException

arrayToAsciiStr

public static void arrayToAsciiStr(@Nonnull
                                   Appendable sb,
                                   @Nonnull
                                   byte[] ar,
                                   int bi,
                                   int nc)
                            throws IOException

Returns a string containing only printable chars for the given bytes.

Throws:: IOException

arrayToDumpLine

public static void arrayToDumpLine(@Nonnull
                                   Appendable sb,
                                   @Nonnull
                                   byte[] ar,
                                   int bi,
                                   int nc)
                            throws IOException

Returns a dumpstring containing the offset, the hex bytes, and the ascii representation of a given dump buffer.

Throws:: IOException

dumpData

public static void dumpData(@Nonnull
                            Appendable sb,
                            @Nonnull
                            byte[] ar,
                            int off,
                            int len)
                     throws IOException

Dump the data as a formatted multiline buffer: like

        0000 ff ef aa bb cc dd 99 88  ff ef aa bb cc dd 99 88 sgdfkajse

Parameters:: sb -; ar -; off -; len -
Throws:: IOException

printHex

public static void printHex(@Nonnull
                            PrintWriter pw,
                            @Nonnull
                            byte[] arr)

printHex

public static void printHex(@Nonnull
                            PrintWriter pw,
                            @Nonnull
                            byte[] arr,
                            int start,
                            int end)

printHex

public static void printHex(@Nonnull
                            PrintStream pw,
                            @Nonnull
                            byte[] arr)

printHex

public static void printHex(@Nonnull
                            PrintStream pw,
                            @Nonnull
                            byte[] arr,
                            int start,
                            int end)

toHex
```
public static String toHex(byte[] arr,
                           int start,
                           int end)
```
Converts the byte array passed to a hex string. This converts the region [start..end>.

Parameters:

arr - the array containing the data to convert

start - the first byte in the array to convert

end - the exclusive end of the region to convert

Returns:

toHex
```
public static String toHex(byte[] arr)
```
Converts the byte array to a hex string.

Parameters:

arr -

Returns:

toHexSp
```
public static String toHexSp(byte[] arr,
                             int start,
                             int end)
```
Converts the byte array passed to a hex string. This converts the region [start..end>.

Parameters:

arr - the array containing the data to convert

start - the first byte in the array to convert

end - the exclusive end of the region to convert

Returns:

toHexSp
```
public static String toHexSp(byte[] arr)
```
Converts the byte array to a hex string.

Parameters:

arr -

Returns:

fromHex
```
public static byte[] fromHex(String s)
                      throws Exception
```
Decodes a hex string into a byte array.

Parameters:

s - the string

Returns:

the decoded array

Throws:

Exception - if the array is malformed.

findFileOnPath

public static File findFileOnPath(String fname,
                                  String path)

Returns the complete filename of the first file that is found along the path specified.

findFileOnEnv

public static File findFileOnEnv(String pname,
                                 String env)

Finds a filename along the classpath..

getFileExtension
```
@Deprecated
public static String getFileExtension(String fn)
```
Deprecated.

Returns the extension of a file. The extension includes the . If no extension is present then the empty string is returned ("").

See Also:

FileTool.getFileExtension(String)

addPathToVector
```
public static void addPathToVector(List<String> v,
                                   String p)
```
Adds a path to the vector specified, if the path is an existing file or directory, and it doesn't already exist in the vector.

addSearchPathToVector
```
public static void addSearchPathToVector(List<String> v,
                                         String searchpath)
```
Takes a search path, i.e. a list of directory/file names separated by the system path separator and adds all files/directories specified to the vector v, only if the pathname exists and if it is not already

addSearchEnvToVector

public static void addSearchEnvToVector(List<String> v,
                                        String envvar)

Adds the value of a "search path environment variable" to the vector.

See Also:: addSearchPathToVector()

makeSearchPath

public static void makeSearchPath(StringBuilder sb,
                                  List<String> v)

Returns a string buffer containing a search path variable from the vector passed.

makeSearchPath
```
public static String makeSearchPath(List<String> v)
```
Returns a string buffer containing a search path variable from the vector passed.

makeSearchPath

public static void makeSearchPath(StringBuffer sb,
                                  String[] v)

Returns a string buffer containing a search path variable from the vector passed.

makeSearchPath
```
public static String makeSearchPath(String[] v)
```
Returns a string buffer containing a search path variable from the vector passed.

getFinalFrom

public static String getFinalFrom(Class<?> cl,
                                  long sval)

getFinalFrom

public static String getFinalFrom(Class<?> cl,
                                  long sval,
                                  String part)

Traverses a given class and tries to find a public

getFinalFrom

public static String getFinalFrom(Class<?> cl,
                                  long sval,
                                  String part,
                                  String ign)

Traverses a given class and tries to find a public

urlLastPart
```
public static String urlLastPart(String url)
```
Returns the last element (document name?) from the url passed.

htmlStringize
```
public static String htmlStringize(String is)
```
Enter with a string; it returns the same string but replaces HTML recognised characters with their &..; equivalent. This allows parts of HTML to be rendered neatly.

htmlStringize
```
public static void htmlStringize(StringBuilder sb,
                                 String is)
```
Enter with a string; it returns the same string but replaces HTML recognised characters with their &..; equivalent. This allows parts of HTML to be rendered neatly.

htmlStringizewithLF
```
public static void htmlStringizewithLF(StringBuilder sb,
                                       String is)
```
Enter with a string; it returns the same string but replaces HTML recognised characters with their &..; equivalent. This allows parts of HTML to be rendered neatly. Linefeeds are not removed.

htmlStringize
```
public static void htmlStringize(Appendable o,
                                 String is)
                          throws Exception
```
Enter with a string; it returns the same string but replaces HTML recognised characters with their &..; equivalent. This allows parts of HTML to be rendered neatly.

Throws:

Exception

xmlStringize
```
public static String xmlStringize(String is)
```
Enter with a string; it returns the same string but replaces HTML recognised characters with their &..; equivalent. This allows parts of HTML to be rendered neatly.

xmlStringizeForDomApi
```
public static String xmlStringizeForDomApi(String is)
```
Converts input string to xml representation that complies to DOM API 5.2 Character Escaping http://www.w3.org/TR/2000/WD-xml-c14n-20000119.html#charescaping

xmlStringize
```
public static void xmlStringize(StringBuffer sb,
                                String is)
```
Enter with a string; it returns the same string but replaces HTML recognised characters with their &..; equivalent. This allows parts of HTML to be rendered neatly.

xmlStringizeForDomApi
```
public static void xmlStringizeForDomApi(StringBuffer sb,
                                         String is)
```
Converts input string to xml representation that complies to DOM API 5.2 Character Escaping http://www.w3.org/TR/2000/WD-xml-c14n-20000119.html#charescaping

entitiesToUnicode
```
public static void entitiesToUnicode(Appendable sb,
                                     String str,
                                     boolean ignoremarkers)
                              throws IOException
```
Scans the input string for entities and replaces all entities that are actually found with their Unicode character code. The resulting string is appended to the string buffer. WARNING: this does not take HTML tah parameters into consideration!

Parameters:

sb - the buffer to append the string to

str - the string to copy while replacing entities.

Throws:

IOException

unicodeToEntities

public static void unicodeToEntities(StringBuffer sb,
                                     String str)

Replaces all non-ascii stuff with their entities. Also replaces <, > and &.

Parameters:: sb -; str -

entityToUnicode
```
public static int entityToUnicode(String ename)
```
Translates an entity name to unicode. The entity can also be a numeral.

Parameters:

ename -

Returns:

strToJavascriptString

public static String strToJavascriptString(String cs,
                                           boolean dblquote)

strToJavascriptString

public static void strToJavascriptString(Appendable w,
                                         String cs,
                                         boolean dblquote)

dbGetBool
```
public static boolean dbGetBool(String fv)
```
Returns a boolean value from some database field. This returns T if the string contains T, Y, 1.

dbSetBool
```
public static String dbSetBool(boolean v)
```
Returns a char(1) value to store in a database for booleans.

main

public static void main(String[] args)

getEnvironment
```
public static List<String> getEnvironment()
```
Returns the list of environment variables of the supported OS's. Because in their infinite wizdom the Java builders deprecated the use of this we need to do something complex..

getBase64Map

public static final byte[] getBase64Map()

encodeBase64
```
public static final String encodeBase64(String str)
```
This method encodes the given string using the base64-encoding specified in RFC-2045 (Section 6.8). It's used for example in the "Basic" authorization scheme.

Parameters:

str - the string

Returns:

the base64-encoded str

encodeBase64
```
public static final byte[] encodeBase64(byte[] data)
```
This method encodes the given byte[] using the base64-encoding specified in RFC-2045 (Section 6.8).

Parameters:

data - the data

Returns:

the base64-encoded data

decodeBase64ToString
```
public static final String decodeBase64ToString(String str)
```
This method decodes the given string using the base64-encoding specified in RFC-2045 (Section 6.8).

Parameters:

str - the base64-encoded string.

Returns:

the decoded str.

decodeBase64
```
public static final byte[] decodeBase64(String str)
```
This method decodes the given string using the base64-encoding specified in RFC-2045 (Section 6.8).

Parameters:

str - the base64-encoded string.

Returns:

the decoded str.

decodeBase64
```
public static final byte[] decodeBase64(byte[] data)
```
This method decodes the given byte[] using the base64-encoding specified in RFC-2045 (Section 6.8).

Parameters:

data - the base64-encoded data.

Returns:

the decoded data.

encodeBase64ToString

public static final String encodeBase64ToString(byte[] data)

strStacktrace

public static String strStacktrace(Throwable t)

strStacktrace

public static void strStacktrace(Appendable sb,
                                 Throwable t)

strStacktraceFiltered

public static void strStacktraceFiltered(Appendable sb,
                                         Throwable t,
                                         String[] skipbefore,
                                         String[] skipafter,
                                         int linelimit)

Report a filtered location stack trace, where the start of the stack trace and the end can be removed.

Parameters:: sb -; t -; skipbefore -; skipafter -

normalizeURL
```
public static final String normalizeURL(String current,
                                        String tpl)
                                 throws Exception
```
Called when generate() is called with a string. This must decode the string into a key object that can be used by the decodeInputURL key to determine a resource provider and a provider-relative key.

This default implementation assumes that the key is to be a normal URL string, and uses path semantics to create the actual key from the string passed: if it contains a host name it is stripped; if it is relative then the complete path is appended.

Throws:

Exception

normalizeConcat
```
public static final String normalizeConcat(String current,
                                           String tpl)
                                    throws Exception
```
Called when generate() is called with a string. This must decode the string into a key object that can be used by the decodeInputURL key to determine a resource provider and a provider-relative key.

This default implementation assumes that the key is to be a normal URL string, and uses path semantics to create the actual key from the string passed: if it contains a host name it is stripped; if it is relative then the complete path is appended.

Throws:

Exception

normalizeUndot
```
public static final String normalizeUndot(String ins)
```
Takes an input URL and handles all '.' and '..' replacements. Any '.' sublevel is replaced by nothing (removed completely); any '..' is replaced by removing the 'upper' level and replacing that with the rest of the string.

Parameters:

ins - the input URL

Returns:

the output URL.

strToInt

public static int strToInt(String v,
                           int defval)

strToLong

public static long strToLong(String v,
                             long defval)

strToLong

public static long strToLong(String v,
                             int six,
                             int eix,
                             int defval)

getNextPathComponent

public static String getNextPathComponent(int ix,
                                          String s,
                                          boolean includeslash)

Find the 1st part of the path passed, i.e. the part before the first /. If the path contains no / it returns the full path.

Parameters:: s -
Returns:

getNextPathComponent

public static String getNextPathComponent(String s,
                                          boolean includeslash)

equalStringList

public static boolean equalStringList(List<String> inl,
                                      List<String> al,
                                      boolean caseindependent)

makeURL
```
public static String makeURL(File f)
```
Workaround for Java bug delivering file:// instead of file:/// for file.toURL().toString().

Parameters:

f -

Returns:

fixFileURL

public static String fixFileURL(String fileurl)

encodeURLEncoded

public static void encodeURLEncoded(Appendable sb,
                                    String str)

Encode the string passed to URLEncoded format. See strDecodeURLEncoded for description of the format.

Parameters:: sb -; data -

encodeURLEncoded

public static String encodeURLEncoded(String str)

decodeURLEncoded
```
public static String decodeURLEncoded(String encoded)
```
Decode the URLEncoded string passed to a real string. An URL encoded string is obtained as follows:
- Convert the Unicode string to UTF-8 (bytes)
- Each byte that is not a letter or digit is replaced by %HH, where HH is the hex code for the byte.
This code undoes the encoding and delivers the original string. If the input is badly formed the result is undefined.
Parameters:

encoded -

Returns:

getLocation

public static final String getLocation()

getLocation

public static final void getLocation(StringBuffer sb)

dumpLocation
```
public static final void dumpLocation(String msg)
```
Kept in api since it was useful for some debugs while coding, use just for debug purposes only, do not use in produciton code. In case that dumping stack is required for production code for remote sessions on client side, please use sumbLEVELLocation methods that are using regular logger.

Parameters:

msg -

dumpDebugLocation

public static final void dumpDebugLocation(@Nonnull
                                           org.slf4j.Logger log,
                                           @Nonnull
                                           String msg)

dumpTraceLocation

public static final void dumpTraceLocation(@Nonnull
                                           org.slf4j.Logger log,
                                           @Nonnull
                                           String msg)

dumpInfoLocation

public static final void dumpInfoLocation(@Nonnull
                                          org.slf4j.Logger log,
                                          @Nonnull
                                          String msg)

dumpWarnLocation

public static final void dumpWarnLocation(@Nonnull
                                          org.slf4j.Logger log,
                                          @Nonnull
                                          String msg)

dumpErrorLocation

public static final void dumpErrorLocation(@Nonnull
                                           org.slf4j.Logger log,
                                           @Nonnull
                                           String msg)

strUnquote

public static String strUnquote(String s)

strUnspace
```
public static String strUnspace(String s)
```
Removes all whitespace from a string.

Parameters:

s -

Returns:

oldStrOracleTruncate
```
public static String oldStrOracleTruncate(String in,
                                          int nchars)
```
Handles Oracle truncation rules:
- If the string is > nchars truncate to nchars
- Convert the string to bytes in UTF-8 encoding
- If the string length, in bytes, is > 4000 bytes (the max stupid size of Oracle's stupid varchar2 column, stupid) remove characters until the string fits the stupidly limited Oracle column
Parameters:

in -

nchars -

Returns:

strOracleTruncate

@Nullable
public static String strOracleTruncate(@Nullable
                                                 String in,
                                                 int nchars)

strTruncateUtf8Bytes

@Nullable
public static String strTruncateUtf8Bytes(@Nullable
                                                    String in,
                                                    int nchars,
                                                    int nbytes)

utf8Truncated

public static int utf8Truncated(String in,
                                int length,
                                int maxbytes)

utf8Length

public static int utf8Length(String in)

strOracleTruncate

public static String strOracleTruncate(String in,
                                       int nchars,
                                       String suffix)

strTruncateUtf8Bytes

public static String strTruncateUtf8Bytes(String in,
                                          int nchars,
                                          int nbytes,
                                          String suffix)

oldStrOracleTruncate
```
public static String oldStrOracleTruncate(String in,
                                          int nchars,
                                          String suffixForTooLong)
```
Returns string that can fix into Oracle column, and in case that it has to be truncated it adds specified suffix to it, that is still not exceding Oracle limit in total.

Parameters:

in -

nchars -

suffixForTooLong -

Returns:

strNanoTime
```
public static String strNanoTime(long ns)
```
Return a nanotime timestamp with 2 thousands of precision max.

Parameters:

ns -

Returns:

strReplace

public static String strReplace(String src,
                                String old,
                                String nw)

Case-sensitive replace of all occurrences of [old] with [new].

Parameters:: src -; old -; nw -
Returns:

getExceptionMessage
```
public static String getExceptionMessage(Throwable t)
```
If the throwable passed as a message then return it verbatim, else return the exception's classname.

Parameters:

t -

Returns:

getJreVersion
```
public static int getJreVersion()
```

removeRepeatingCharacters
```
public static String removeRepeatingCharacters(String in)
```
Replaces long character sequences without space like ---- and ===== with a way shorter version (single character). If the chars in sequence are digits, they won't be shortened.

Parameters:

in -

maxlen -

Returns:

extractSingleLine
```
public static String extractSingleLine(String in)
```
Tries to extract a single line of max. 80 chars from a memo field by scanning for a closing '.'

Parameters:

in -

Returns:

generateGUID
```
@Nonnull
public static String generateGUID()
```
Generate an unique identifier with reasonable expectations that it will be globally unique. This does not use the known GUID format but shortens the string by encoding into base64-like encoding.

Returns:

isBlank
```
public static boolean isBlank(String s)
```
Checks if string is blank.

Parameters:

s - String to be validated.

Returns:

true if the string is null, empty or only spaces; false otherwise.

createInsertStatement

public static void createInsertStatement(StringBuilder sb,
                                         String table,
                                         String pkname,
                                         String pkexpr,
                                         String[] fields)

createUpdateStatement

public static void createUpdateStatement(StringBuilder sb,
                                         String table,
                                         String pkname,
                                         String[] fields)

fill

public static String fill(int count,
                          char character)

removeAccents

@Nonnull
public static String removeAccents(@Nonnull
                                            String str)

Replaces all accented letters with their non-accented equivalents - FOR WESTERN LANGUAGES ONLY!

Parameters:: str -
Returns:

getString

@Deprecated
 @Nonnull
public static String getString(@Nonnull
                                                     InputStream is)
                                              throws Exception

Deprecated.

SCHEDULED FOR REMOVAL - please use FileTool.readStreamAsString(InputStream, String) instead. It can be parametrized by "UTF-8" we use here.

Parameters:: is -
Returns:
Throws:: Exception

truncLeadingOracleColumn

@Nullable
public static String truncLeadingOracleColumn(@Nullable
                                                        String text,
                                                        int columnSize)

 This method removes the leading characters from the string, if it exceeds the column size
 or needs more then 4000 bytes to store in the database.

 There's a limit on the size in bytes for an Oracle varchar2. This limit is
 4000 bytes (MAX_SIZE_IN_BYTES_FOR_ORACLE_VARCHAR2). So if you declare a varchar2(4000 char),
 it's possible that for example 3970 characters won't fit, because there are charaters in the string
 that needs more then one byte in UTF8.

Parameters:: text -
Returns:

strCapitalized

@Nonnull
public static String strCapitalized(@Nonnull
                                             String name)

isInvalidOracleLength

public static boolean isInvalidOracleLength(@Nonnull
                                            String text)

Checks whether a given text is too big for the maximum varchar2 database field

Parameters:: text -
Returns:

isInteger

public static boolean isInteger(@Nullable
                                String string)

Checks if forwarded string can be parsed into an Integer.

Parameters:: string -
Returns:

replaceNewLineChars

@Nonnull
public static String replaceNewLineChars(@Nonnull
                                                  String content,
                                                  @Nonnull
                                                  String replacement)

Replaces all end of line characters with space so that content is represented in one line.

Parameters:: content - that should be without new line characters; replacement - for new line characters
Returns:: given string without new line characters

validateUrl
```
public static boolean validateUrl(@Nullable
                                  String urlValue)
```
Loose checks if provided URL is valid.
It allows URLs with and without http, https, ftp... online PDFs, Images, locally mapped IP addresses and IP addresses itself.

Parameters:

urlValue -

Returns:

renderAsRawHtml
```
public static String renderAsRawHtml(@Nonnull
                                     String input,
                                     boolean removeEndingNewLines)
```
Does some transformation of custom string to html output -> taking into account several customizations. If input uses HTML for new line (
or
) then it ignores rest or \n characters, otherwise converts \n to
. If removeEndingNewLines then it removes all the ending new lines too.

Parameters:

input -

Returns:

Class StringTool

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

MAX_SIZE_IN_BYTES_FOR_ORACLE_VARCHAR2

MAX_EMAIL_LENGTH

Constructor Detail

StringTool

Method Detail

isValidJavaIdentifier

getRandomStringWithPrefix

isValidDomainName

isNumber

isDomainChar

isWhiteSpaceOrNbsp

isAllSpaces

isValidEmail

isValidDbFieldName

isValidDottedName

isEqual

isEqualIgnoreCase

stringize

stringize

stringizeNQ

strBackslashToSlash

strSize

parseString

truncLength

strToFixedLength

strToFixedLength

toXY

getLevenshteinDistance

strStartsWithIgnoreCase

strEndsWithIgnoreCase

strIndexOfIgnoreCase

intToStr

strAddIntFixed

strCommad

strDuration

strDurationMillis

strTrunc

arrayToHexStr

arrayToAsciiStr

arrayToDumpLine

dumpData

printHex

printHex

printHex

printHex

toHex

toHex

toHexSp

toHexSp

fromHex

findFileOnPath

findFileOnEnv

getFileExtension

addPathToVector

addSearchPathToVector

addSearchEnvToVector

makeSearchPath

makeSearchPath

makeSearchPath

makeSearchPath

getFinalFrom

getFinalFrom

getFinalFrom

urlLastPart

htmlStringize

htmlStringize

htmlStringizewithLF

htmlStringize

xmlStringize

xmlStringizeForDomApi

xmlStringize

xmlStringizeForDomApi

entitiesToUnicode

unicodeToEntities