Difference between revisions of "TextUtils"
Line 58: | Line 58: | ||
/** | /** | ||
* Replaces JavaScript invalid chars within input String with the | * Replaces JavaScript invalid chars within input String with the | ||
− | * corresponding | + | * corresponding escapes. |
* | * | ||
* @param input the input String. | * @param input the input String. | ||
* @return the input string, with JS invalid chars replaced by the | * @return the input string, with JS invalid chars replaced by the | ||
− | * corresponding | + | * corresponding escapes. |
*/ | */ | ||
public static String replaceJSInvalidChars(String input) | public static String replaceJSInvalidChars(String input) | ||
/** | /** | ||
− | * Generate random chars string of given | + | * Replaces SQL invalid chars within input String with the |
+ | * corresponding escapes. | ||
+ | * | ||
+ | * @param input | ||
+ | * the input String. | ||
+ | * @return the input string, with SQL invalid chars replaced by the | ||
+ | * corresponding escapes. | ||
+ | */ | ||
+ | public static String replaceSQLInvalidChars(String input) | ||
+ | |||
+ | /** | ||
+ | * Dumps the content of a byte array as chars | ||
+ | * | ||
+ | * @param arr | ||
+ | * a byte array | ||
+ | * @return A representation of the given byte array as a sequence of chars | ||
+ | */ | ||
+ | public static String dumpByteArrayAsChars(byte[] arr) | ||
+ | |||
+ | /** | ||
+ | * Generate random chars string of given length. | ||
* | * | ||
* @param length | * @param length | ||
Line 73: | Line 93: | ||
*/ | */ | ||
public static String generateRandomString(int length) | public static String generateRandomString(int length) | ||
+ | |||
+ | /** | ||
+ | * Return a String representation of the given throwable stack-trace. | ||
+ | * | ||
+ | * @param throwable | ||
+ | * @return riturn the stack-trace | ||
+ | */ | ||
+ | public static String getStackTrace(Throwable throwable) | ||
+ | |||
+ | /** | ||
+ | * Convert the following definitions to the corresponding EOL char/s: | ||
+ | * - \n or LF : line feed | ||
+ | * - \r or CR : carriage return | ||
+ | * - \r\n or CR-LF : carriage return and line feed | ||
+ | * - native : OS native EOL | ||
+ | * | ||
+ | * @param def | ||
+ | * the definition to convert | ||
+ | * @return the EOL char/s or null | ||
+ | */ | ||
+ | public static String getEOL(String def) | ||
</syntaxhighlight> | </syntaxhighlight> | ||
Revision as of 13:48, 22 May 2012
Class FQN: it.greenvulcano.util.txt.TextUtils
Following the TextUtils public static methods
/**
* Compile pattern as a regular expression then check if exists a match in text.
*
* @param pattern
* @param text
* @return true if the pattern match the text
*/
public static boolean matches(String pattern, String text)
/**
* Replaces within input string all the occurrences of the
* substring toBeReplaced with occurrences of the substring replacement.
*
* @param input
* the input String.
* @param toBeReplaced
* the substring to be replaced within input string.
* @param replacement
* the string used to replace substring toBeReplaced within input string.
* @return the input string, with all occurrences of the substring
* toBeReplaced replaced by occurrences of the substring replacement.
*/
public static String replaceSubstring(String input, String toBeReplaced, String replacement);
/**
* Replaces placeholders value in the input string.
*
* @param input
* the input text
* @param phPrefix
* the placeholder prefix
* @param phSuffix
* the placeholder suffix
* @param phValues
* the placeholder values
* @return the string with placeholders replaced
*
*/
public static String replacePlaceholder(String input, String phPrefix, String phSuffix, Hashtable<String, String> phValues)
/**
* This method tokenizes a given string using another given string as
* separator and returns a List containing found tokens. The
* returned List is NEVER null (it may have zero elements, anyway).
*
* @param theString
* the string to be tokenized.
* @param separatorString
* the string separator between tokens.
* @return a List containing found tokens.
*/
public static List<String> splitByStringSeparator(String theString, String separatorString)
/**
* Replaces JavaScript invalid chars within input String with the
* corresponding escapes.
*
* @param input the input String.
* @return the input string, with JS invalid chars replaced by the
* corresponding escapes.
*/
public static String replaceJSInvalidChars(String input)
/**
* Replaces SQL invalid chars within input String with the
* corresponding escapes.
*
* @param input
* the input String.
* @return the input string, with SQL invalid chars replaced by the
* corresponding escapes.
*/
public static String replaceSQLInvalidChars(String input)
/**
* Dumps the content of a byte array as chars
*
* @param arr
* a byte array
* @return A representation of the given byte array as a sequence of chars
*/
public static String dumpByteArrayAsChars(byte[] arr)
/**
* Generate random chars string of given length.
*
* @param length
* @return a random string of given length.
*/
public static String generateRandomString(int length)
/**
* Return a String representation of the given throwable stack-trace.
*
* @param throwable
* @return riturn the stack-trace
*/
public static String getStackTrace(Throwable throwable)
/**
* Convert the following definitions to the corresponding EOL char/s:
* - \n or LF : line feed
* - \r or CR : carriage return
* - \r\n or CR-LF : carriage return and line feed
* - native : OS native EOL
*
* @param def
* the definition to convert
* @return the EOL char/s or null
*/
public static String getEOL(String def)
Follows some usage examples:
/* We assume that #map contains the following mappings:
* prop1 -> value1
* prop2 -> value2
*/
#input = "text text prop{{prop1}} text text prop{{prop2}}",
#value = @it.greenvulcano.util.txt.TextUtils@replacePlaceholder(#input, "prop{{", "}}", #map)
// #value contains: "text text value1 text text value2"