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"
