de.greenrobot.common

Class StringUtils

java.lang.Object

de.greenrobot.common.StringUtils

public class StringUtils
extends Object

Utilities for working with strings, like splitting, url-encoding, and MD5 digests.

Author:

markus

Constructor Summary

Constructors

Constructor and Description
StringUtils()

Method Summary

Methods

Modifier and Type	Method and Description
static String	concatLines(List<String> lines) Returns a concatenated string consisting of the given lines seperated by a new line character \n.
static String	decodeUrl(String stringToDecode) URL-Decodes a given string using UTF-8.
static String	decodeUrlIso(String stringToDecode) URL-Decodes a given string using ISO-8859-1.
static String	ellipsize(String text, int maxLength) Cuts the string at the end if it's longer than maxLength and appends "..." to it.
static String	encodeUrl(String stringToEncode) URL-Encodes a given string using UTF-8 (some web pages have problems with UTF-8 and umlauts, consider encodeUrlIso(String) also).
static String	encodeUrlIso(String stringToEncode) URL-encodes a given string using ISO-8859-1, which may work better with web pages and umlauts compared to UTF-8.
static String[]	fastSplit(String string, char delimiter) Splits a String based on a single character, which is usually faster than regex-based String.split().
static List<String>	findLinesContaining(String text, String searchText)
static String	generateDigestString(String stringToEncode, String digestAlgo, String encoding, int lengthToPad)
static String	generateMD5String(String stringToEncode) Generates the MD5 digest for a given String based on UTF-8.
static String	generateSHA1String(String stringToEncode) Generates the SHA-1 digest for a given String based on UTF-8.
static String	joinArrayOnComma(int[] array)
static String	joinArrayOnComma(String[] array)
static String	joinIterableOnComma(Iterable<?> iterable)
static String	resolveEntity(String entity) Simple HTML/XML entity resolving: Only supports unicode enitities and a very limited number text represented entities (apos, quot, gt, lt, and amp).
static String[]	splitLines(String text, boolean skipEmptyLines)
static String	toHexString(byte[] bytes, int lengthToPad)

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

fastSplit

public static String[] fastSplit(String string,
                 char delimiter)

Splits a String based on a single character, which is usually faster than regex-based String.split().

encodeUrl

public static String encodeUrl(String stringToEncode)

URL-Encodes a given string using UTF-8 (some web pages have problems with UTF-8 and umlauts, consider encodeUrlIso(String) also). No UnsupportedEncodingException to handle as it is dealt with in this method.

encodeUrlIso

public static String encodeUrlIso(String stringToEncode)

URL-encodes a given string using ISO-8859-1, which may work better with web pages and umlauts compared to UTF-8. No UnsupportedEncodingException to handle as it is dealt with in this method.

decodeUrl

public static String decodeUrl(String stringToDecode)

URL-Decodes a given string using UTF-8. No UnsupportedEncodingException to handle as it is dealt with in this method.

decodeUrlIso

public static String decodeUrlIso(String stringToDecode)

URL-Decodes a given string using ISO-8859-1. No UnsupportedEncodingException to handle as it is dealt with in this method.

generateMD5String

public static String generateMD5String(String stringToEncode)

Generates the MD5 digest for a given String based on UTF-8. The digest is padded with zeroes in the front if necessary.

Returns:

MD5 digest (32 characters).

generateSHA1String

public static String generateSHA1String(String stringToEncode)

Generates the SHA-1 digest for a given String based on UTF-8. The digest is padded with zeroes in the front if necessary. The SHA-1 algorithm is considers to produce less collisions than MD5.

Returns:

SHA-1 digest (40 characters).

generateDigestString

public static String generateDigestString(String stringToEncode,
                          String digestAlgo,
                          String encoding,
                          int lengthToPad)

toHexString

public static String toHexString(byte[] bytes,
                 int lengthToPad)

resolveEntity

public static String resolveEntity(String entity)

Simple HTML/XML entity resolving: Only supports unicode enitities and a very limited number text represented entities (apos, quot, gt, lt, and amp). There are many more: http://www.w3.org/TR/REC-html40/sgml/dtd.html

Parameters:

entity - The entity name without & and ; (null throws NPE)

Returns:

Resolved entity or the entity itself if it could not be resolved.

ellipsize

public static String ellipsize(String text,
               int maxLength)

Cuts the string at the end if it's longer than maxLength and appends "..." to it. The length of the resulting string including "..." is always less or equal to the given maxLength. It's valid to pass a null text; in this case null is returned.

splitLines

public static String[] splitLines(String text,
                  boolean skipEmptyLines)

findLinesContaining

public static List<String> findLinesContaining(String text,
                               String searchText)

concatLines

public static String concatLines(List<String> lines)

Returns a concatenated string consisting of the given lines seperated by a new line character \n. The last line does not have a \n at the end.

joinIterableOnComma

public static String joinIterableOnComma(Iterable<?> iterable)

joinArrayOnComma

public static String joinArrayOnComma(int[] array)

joinArrayOnComma

public static String joinArrayOnComma(String[] array)