com.threerings.gwt.util

Class StringUtil

java.lang.Object

com.threerings.gwt.util.StringUtil

public class StringUtil
extends Object

Useful string utilities, brought over to GWT land from StringUtil.

Constructor Summary

Constructors

Constructor and Description
StringUtil()

Method Summary

Methods

Modifier and Type	Method and Description
static String	capitalize(String s) Returns a version of the supplied string with the first letter capitalized.
static String	escapeAttribute(String value) Escapes user or deployment values that we need to put into an html attribute.
static String	getOr(String value, String defval) Returns the string if it is non-blank (see isBlank(java.lang.String)), the default value otherwise.
static String	hexlate(byte[] bytes) Generates a string from the supplied bytes that is the HEX encoded representation of those bytes.
static String	hexlate(byte[] bytes, int count) Generates a string from the supplied bytes that is the HEX encoded representation of those bytes.
static boolean	isBlank(String text) Returns true if the supplied string is null, zero length, or contains only whitespace.
static String	join(Iterable<?> items) Joins the given sequence of strings with a command and space between each consecutive pair.
static String	join(Iterable<?> items, String sep) Joins the given sequence of strings, which the given separator string between each consecutive pair.
static String	sanitizeAttribute(String value) Nukes special attribute characters.
static String	truncate(String str, int limit) Truncates the string so it has length less than or equal to the given limit.
static String	truncate(String str, int limit, String appendage) Truncates the string so it has length less than or equal to the given limit.
static byte[]	unhexlate(String hex) Turn a hexlated String back into a byte array.

Methods inherited from class java.lang.Object

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

Constructor Detail

StringUtil

public StringUtil()

Method Detail

hexlate

public static String hexlate(byte[] bytes,
             int count)

Generates a string from the supplied bytes that is the HEX encoded representation of those bytes. Returns the empty string for a null or empty byte array.

Parameters:

bytes - the bytes for which we want a string representation.

count - the number of bytes to stop at (which will be coerced into being <= the length of the array).

hexlate

public static String hexlate(byte[] bytes)

Generates a string from the supplied bytes that is the HEX encoded representation of those bytes.

unhexlate

public static byte[] unhexlate(String hex)

Turn a hexlated String back into a byte array.

isBlank

public static boolean isBlank(String text)

Returns true if the supplied string is null, zero length, or contains only whitespace.

getOr

public static String getOr(String value,
           String defval)

Returns the string if it is non-blank (see isBlank(java.lang.String)), the default value otherwise.

escapeAttribute

public static String escapeAttribute(String value)

Escapes user or deployment values that we need to put into an html attribute.

sanitizeAttribute

public static String sanitizeAttribute(String value)

Nukes special attribute characters. Ideally this would not be needed, but some integrations do not accept special characters in attributes.

truncate

public static String truncate(String str,
              int limit)

Truncates the string so it has length less than or equal to the given limit. Returns null if the input is null.

truncate

public static String truncate(String str,
              int limit,
              String appendage)

Truncates the string so it has length less than or equal to the given limit. If truncation occurs, the result will end with the given appendage. Returns null if the input is null.

capitalize

public static String capitalize(String s)

Returns a version of the supplied string with the first letter capitalized.

join

public static String join(Iterable<?> items)

Joins the given sequence of strings with a command and space between each consecutive pair.

join

public static String join(Iterable<?> items,
          String sep)

Joins the given sequence of strings, which the given separator string between each consecutive pair.