StringUtils (Common Utilities 6.0.0-RC1 API)

java.lang.Object
- com.sun.enterprise.util.StringUtils

```
public class StringUtils
extends Object
```

Field Summary

Fields
Modifier and Type Field and Description

static String EOL

static String NEWLINE

Fields
Modifier and Type	Field and Description
`static String`	`EOL`
`static String`	`NEWLINE`

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static String`	`cat(String separator, String... list)` Concatenate a list of strings, putting a separator in between each one.
`static String`	`escapeForHtml(String str)` Escape characters to use result in html.
`static String`	`formatSQLException(SQLException ex)`
`static String`	`getPenultimateDirName(String s)`
`static String`	`getProperty(String propName)` Get a system propety given a property name, possibly trying all combination of upercase, name mangling to get a value.
`static String`	`getStackTrace(Throwable t)`
`static boolean`	`isHex(char c)`
`static boolean`	`isHex(String s)`
`static boolean`	`isToken(String s)`
`static void`	`main(String[] args)`
`static String`	`makeFilePath(String[] strings, boolean addTrailing)` A utility to get the Operating System specific path from given array of Strings.
`static int`	`maxWidth(Vector v)`
`static String`	`nvl(String str)` If given `String` is `null` then returns empty `String` otherwise returns given `String`
`static boolean`	`ok(String s)`
`static String`	`padLeft(String s, int len)`
`static String`	`padRight(String s, int len)`
`static List<String>`	`parseStringList(String line)` Parses a string containing substrings separated from each other by the standard separator characters and returns a list of strings.
`static List<String>`	`parseStringList(String line, String sep)` Parses a string containing substrings separated from each other by the specified set of separator characters and returns a list of strings.
`static void`	`prepend(String[] ss, String what)`
`static String`	`quotePathIfNecessary(String path)` Nightmares can result from using a path with a space in it! This method will enclose in double-quotes if needed.
`static String`	`quotePathIfNecessary(String path, char quoteChar)` Nightmares can result from using a path with a space in it! This method will enclose in the specified quote characters if needed.
`static String`	`removeChar(String strOrig, char c)` Remove a character from a String
`static String`	`removeEnclosingQuotes(String s)` Removes the quoting around a String.
`static String`	`replace(String s, String token, String replace)`
`static int`	`safeLength(String s)` return the length of the String - or 0 if it's null
`static String`	`stripToken(String s)`
`static void`	`testUpperCase()`
`static String[]`	`toLines(String s)`
`static String`	`toShortClassName(String className)`
`static String`	`toString(Properties props)`
`static String`	`upperCaseFirstLetter(String s)`

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

- Field Detail
  - NEWLINE
```
public static final String NEWLINE
```
  - EOL
```
public static final String EOL
```
- Method Detail
  - safeLength
```
public static int safeLength(String s)
```
    return the length of the String - or 0 if it's null
  - ok
```
public static boolean ok(String s)
```
  - formatSQLException
```
public static String formatSQLException(SQLException ex)
```
  - maxWidth
```
public static int maxWidth(Vector v)
```
  - isHex
```
public static boolean isHex(String s)
```
  - isHex
```
public static boolean isHex(char c)
```
  - getPenultimateDirName
```
public static String getPenultimateDirName(String s)
```
  - toShortClassName
```
public static String toShortClassName(String className)
```
  - padRight
```
public static String padRight(String s,
                              int len)
```
  - padLeft
```
public static String padLeft(String s,
                             int len)
```
  - toLines
```
public static String[] toLines(String s)
```
  - prepend
```
public static void prepend(String[] ss,
                           String what)
```
  - upperCaseFirstLetter
```
public static String upperCaseFirstLetter(String s)
```
  - replace
```
public static String replace(String s,
                             String token,
                             String replace)
```
  - toString
```
public static String toString(Properties props)
```
  - main
```
public static void main(String[] args)
```
  - testUpperCase
```
public static void testUpperCase()
```
  - makeFilePath
```
public static String makeFilePath(String[] strings,
                                  boolean addTrailing)
```
    A utility to get the Operating System specific path from given array of Strings.
    
    Parameters:
    
    strings - an array of Strings participating in the path.
    
    addTrailing - a boolean that determines whether the returned String should have a trailing File Separator character. None of the strings may be null or empty String. An exception is thrown.
    
    Returns:
    
    a String that concatenates these Strings and gets a path. Returns a null if the array is null or contains no elements.
    
    Throws:
    
    IllegalArgumentException - if any of the arguments is null or is an empty string.
  - parseStringList
```
public static List<String> parseStringList(String line)
```
    Parses a string containing substrings separated from each other by the standard separator characters and returns a list of strings. Splits the string line into individual string elements separated by the field separators, and returns these individual strings as a list of strings. The individual string elements are trimmed of leading and trailing whitespace. Only non-empty strings are returned in the list.
    
    Parameters:
    
    line - The string to split
    
    Returns:
    
    Returns the list containing the individual strings that the input string was split into.
  - parseStringList
```
public static List<String> parseStringList(String line,
                                           String sep)
```
    Parses a string containing substrings separated from each other by the specified set of separator characters and returns a list of strings. Splits the string line into individual string elements separated by the field separators specified in sep, and returns these individual strings as a list of strings. The individual string elements are trimmed of leading and trailing whitespace. Only non-empty strings are returned in the list.
    
    Parameters:
    
    line - The string to split
    
    sep - The list of separators to use for determining where the string should be split. If null, then the standard separators (see StringTokenizer javadocs) are used.
    
    Returns:
    
    Returns the list containing the individual strings that the input string was split into.
  - getProperty
```
public static String getProperty(String propName)
```
    Get a system propety given a property name, possibly trying all combination of upercase, name mangling to get a value.
    
    Parameters:
    
    propName - the approximate system property name
    
    Returns:
    
    the property value if found, null otherwise
  - removeChar
```
public static String removeChar(String strOrig,
                                char c)
```
    Remove a character from a String
    
    Parameters:
    
    strOrig - original string
    
    c - character to remove from the string
    
    Returns:
    
    String with specified characters removed
  - getStackTrace
```
public static String getStackTrace(Throwable t)
```
  - isToken
```
public static final boolean isToken(String s)
```
  - stripToken
```
public static final String stripToken(String s)
```
  - cat
```
public static String cat(String separator,
                         String... list)
```
    Concatenate a list of strings, putting a separator in between each one. If the list is one string, then the separator is not used. The separator will never be added to the start or end of the returned string. When empty or null strings are encountered in the list of strings they are ignore.
    
    Parameters:
    
    separator - Separator to use between concatenated strings
    
    list - List of strings to concatenate together
    
    Returns:
    
    String created by concatenating provided strings
  - removeEnclosingQuotes
```
public static String removeEnclosingQuotes(String s)
```
    Removes the quoting around a String.
    
    Parameters:
    
    s - The String that may have enclosing quotes
    
    Returns:
    
    The String resulting from removing the enclosing quotes
  - quotePathIfNecessary
```
public static String quotePathIfNecessary(String path)
```
    Nightmares can result from using a path with a space in it! This method will enclose in double-quotes if needed.
    
    Parameters:
    
    path -
    
    Returns:
  - quotePathIfNecessary
```
public static String quotePathIfNecessary(String path,
                                          char quoteChar)
```
    Nightmares can result from using a path with a space in it! This method will enclose in the specified quote characters if needed.
    
    Parameters:
    
    path -
    
    Returns:
  - escapeForHtml
```
public static String escapeForHtml(String str)
```
    Escape characters to use result in html.
    
    Chars Escape sequence
    
    < <
    
    > >
    
    & &
    
    " "
    
    \t
  - nvl
```
public static String nvl(String str)
```
    If given String is null then returns empty String otherwise returns given String

Chars	Escape sequence
<	<
>	>
&	&
"	"
\t

Class StringUtils

Field Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

NEWLINE

EOL

Method Detail

safeLength

ok

formatSQLException

maxWidth

isHex

isHex

getPenultimateDirName

toShortClassName

padRight

padLeft

toLines

prepend

upperCaseFirstLetter

replace

toString

main

testUpperCase

makeFilePath

parseStringList

parseStringList

getProperty

removeChar

getStackTrace

isToken

stripToken

cat

removeEnclosingQuotes

quotePathIfNecessary

quotePathIfNecessary

escapeForHtml

nvl