Difference between revisions of "TextUtils"

From GreenVulcano Wiki
Jump to: navigation, search
Line 2: Line 2:
  
 
==Following the TextUtils public static methods==
 
==Following the TextUtils public static methods==
* Parsing
 
 
<syntaxhighlight lang="java5">     
 
<syntaxhighlight lang="java5">     
 
     /**
 
     /**
Line 74: Line 73:
 
     */
 
     */
 
     public static String generateRandomString(int length)
 
     public static String generateRandomString(int length)
 +
</syntaxhighlight>
 +
 +
 +
Follows some usage examples:
 +
<syntaxhighlight lang="java5">
 +
/* 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"
 
</syntaxhighlight>
 
</syntaxhighlight>

Revision as of 11:04, 28 February 2012

Class FQN: it.greenvulcano.util.txt

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 entities.
     * 
     * @param input the input String.
     * @return the input string, with JS invalid chars replaced by the
     *         corresponding entities.
     */
    public static String replaceJSInvalidChars(String input)

    /**
     * Generate random chars string of given <code>length</code>.
     * 
     * @param length
     * @return a random string of given length.
     */
    public static String generateRandomString(int length)


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"