org.opennms.core.utils

Class StringUtils

java.lang.Object

org.opennms.core.utils.StringUtils

public abstract class StringUtils
extends Object

Constructor Summary

Constructors

Constructor and Description
StringUtils()

Method Summary

Modifier and Type	Method and Description
static String[]	createCommandArray(String s) Convenience method for creating arrays of strings suitable for use as command-line parameters when executing an external process.
static String[]	createCommandArray(String s, char delim) Deprecated. Use createCommandArray(String s) instead.
static boolean	isLocalWindowsPath(String path)
static String	prettyXml(String xml) Uses the Xalan javax.transform classes to indent an XML string properly so that it is easier to read.
static String	truncate(String name, int length) truncate

Methods inherited from class java.lang.Object

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

Constructor Detail

StringUtils

public StringUtils()

Method Detail

createCommandArray

public static String[] createCommandArray(String s,
                                          char delim)

Deprecated. Use createCommandArray(String s) instead.

Convenience method for creating arrays of strings suitable for use as command-line parameters when executing an external process.

The default Runtime.execmethod will split a single string based on spaces, but it does not respect spaces within quotation marks, and it will leave the quotation marks in the resulting substrings. This method solves those problems by replacing all in-quote spaces with the given delimiter, removes the quotes, and then splits the resulting string by the remaining out-of-quote spaces. It then goes through each substring and replaces the delimiters with spaces.

Caveat: This method does not respect escaped quotes! It will simply remove them and leave the stray escape characters.

Parameters:

s - the string to split

delim - a char that does not already exist in s

Returns:

An array of strings split by spaces outside of quotes.

Throws:

IllegalArgumentException - If s is null or if delim already exists in s.

createCommandArray

public static String[] createCommandArray(String s)

Convenience method for creating arrays of strings suitable for use as command-line parameters when executing an external process.

The default Runtime.exec method will split a single string based on spaces, but it does not respect spaces within quotation marks, and it will leave the quotation marks in the resulting substrings. This method solves those problems by preserving all in-quote spaces.

Caveat: This method does not respect escaped quotes! It will simply remove them and leave the stray escape characters.

Parameters:

s - the string to split

Returns:

An array of strings split by spaces outside of quotes.

Throws:

IllegalArgumentException - If s is null.

truncate

public static String truncate(String name,
                              int length)

truncate

Parameters:

name - a String object.

length - a int.

Returns:

a String object.

isLocalWindowsPath

public static boolean isLocalWindowsPath(String path)

prettyXml

public static String prettyXml(String xml)
                        throws UnsupportedEncodingException,
                               TransformerException

Uses the Xalan javax.transform classes to indent an XML string properly so that it is easier to read.

Throws:

UnsupportedEncodingException

TransformerException