com.aspc.remote.util.misc

Class StringUtilities

java.lang.Object

com.aspc.remote.util.misc.StringUtilities

@Immutable
public final class StringUtilities
extends java.lang.Object

StringUtilities
THREAD MODE: MULTI-THREADED utilities

Since:

2 July 1997

Author:

Nigel Leck

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	BASE91CIPHER
static java.lang.String	COMPRESSION_DEFLATE Encoding DEFLATE
static java.lang.String	COMPRESSION_GZIP Encoding GZIP - default
static java.lang.String	COMPRESSION_NONE Encoding NONE
static java.lang.String	ENCODED_URL_AND
static java.lang.String	ENCODED_URL_EQUALS
static java.lang.String	ENCODED_URL_QUESTION
static java.lang.String	ENCODED_URL_QUOTE
static java.lang.String	ENCODED_URL_SPACE
static java.util.regex.Pattern	FILE_MIME_TYPE_PATTERN validate mime type
static java.lang.String[]	HEX_CODES
static java.util.regex.Pattern	HOST_PATTERN
static java.util.regex.Pattern	IP_PATTERN Valid IP address
static java.util.regex.Pattern	LOCAL_IP_PATTERN Local IP address http://en.wikipedia.org/wiki/Private_network
static int	PASSWORD_SEQUENTIAL_LENGTH
static java.util.regex.Pattern	PHONE_REGEX valid phone regular expression
static java.util.regex.Pattern	URI_PATTERN URI pattern matching KNOWN ISSUE: @ should be encoded if it's not used between user and host
static java.util.regex.Pattern	UUENCODED_PATH_PATTERN UUENCODED pattern

Method Summary

Modifier and Type	Method and Description
static java.lang.String	appendURLParam(java.lang.String uri, java.lang.String param, java.lang.String value) Appends parameter and value to the given URL.
static boolean	assertIllegalCharactersHTML(java.lang.String text) http://en.wikipedia.org/wiki/Character_encodings_in_HTML
static java.lang.String	byteArrayToHexString(byte[] b) byte array to hex string
static java.lang.String	capitalize(java.lang.String str) Capitalizes the first letter of the specified string.
static java.lang.String	capitalizeWordsInString(java.lang.String words) Capitalizes the first character IN EACH WORD of the specified string.
static boolean	check8Bit(java.lang.String text)
static void	checkIllegalCharactersHTML(java.lang.String text) http://en.wikipedia.org/wiki/Character_encodings_in_HTML
static java.lang.String	checkSumAdler32(byte[] data) calculates the Adler32 checksum value of this byte array
static java.lang.String	checkSumAdler32(java.lang.String str) get the Adler32 checksum value of this string
static boolean	checkXML(int c) http://en.wikipedia.org/wiki/Valid_characters_in_XML
static boolean	checkXML(java.lang.String text) Check all characters are valid XML characters.
static java.lang.String	cleanNumberString(java.lang.String valueToClean) This method cleans chars that cause parsing problems when we want to parse String to Number (Integer,Double,Float,Long....)
static java.lang.String	compress(java.lang.String text)
static java.lang.String	compressB91(java.lang.String text) compress a java string with gzip and encode to ASCII with basE91
static byte[]	compressToBytes(java.lang.String text) Compress the text to a gzip byte array
static boolean	contains(java.lang.String src, java.lang.String qry) Checks if the query can be found in the source string.
static boolean	containsRudeWord(java.lang.String word) Does this word contain a rude word.
static java.lang.String	convertHtmlToText(java.lang.String htmlText) Convert HTML to Text
static java.lang.String	decode(java.lang.String str) Decodes a String from a MIME format called "x-www-form-urlencoded" format.
static byte[]	decodeBase64(byte[] input) Decodes a byte array that is base64 encoded.
static java.lang.String	decodeBase64(java.lang.String encodedStr) The Web Servers strip off the trailing ='s so just append them if needed
static byte[]	decodeBase91(java.lang.String src) decode a basE91 to original string
static java.lang.String	decodeHex(java.lang.String szSrc) The Web Servers strip off the trailing ='s so just append them if needed
static java.lang.String	decodeHTML(java.lang.String encodedHTML) http://en.wikipedia.org/wiki/List_of_XML_and_HTML_character_entity_references
static java.lang.String	decodeSQL(java.lang.String sqlString)
static byte[]	decodeToBytes(java.lang.String str) Decode into bytes
static java.lang.String	decodeUTF8(java.lang.String utf8)
static java.lang.String	decodeUTF8base64(java.lang.String base64utf8) decode a normal string from UTF8 & base 64 String.
static java.lang.String	decompress(byte[] array) decompress a string to a normal native java string
static java.lang.String	decompress(byte[] array, java.lang.String type) decompress a string to a normal native java string
static java.lang.String	decompress(java.lang.String compressedData, java.lang.String type) decompress a string to a normal native java string
static java.lang.String	decompressB91(java.lang.String compressedData) decompress a string with GZIP to a normal native java string
static java.lang.String	deduplicate(java.lang.String words, char delimator) De-Duplicate words in a string.
static java.lang.String	encode(byte[] array)
static java.lang.String	encode(byte[] array, int off, int len, boolean strict)
static java.lang.String	encode(java.lang.String str) Encodes a String into a MIME format called "x-www-form-urlencoded" format.
static java.lang.String	encode32(byte[] orgArray) Encode bytes using 32 safe characters.
static byte[]	encodeBase64(byte[] input) Encodes a byte array to base64
static java.lang.String	encodeBase64(java.lang.String szSrc)
static java.lang.String	encodeBase91(byte[] data) encode a String to basE91 ASCII, basE91 is similar to BASE64 but more efficient in both encoding speed and string size
static java.lang.String	encodeHex(java.lang.String szSrc)
static java.lang.String	encodeHTML(java.lang.String value) http://en.wikipedia.org/wiki/Character_encodings_in_HTML http://www.w3.org/TR/html401/types.html#type-name
static java.lang.String	encodeISqlValue(java.lang.String value) encode a value used for isql to prevent sql injection
static java.lang.String	encodeJavaDoc(java.lang.String doubleByteStr) Some characters are valid in Java Docs comments that aren't in HTML.
static java.lang.String	encodeSQL(java.lang.String doubleByteStr)
static java.lang.String	encodeStrict(java.lang.String str)
static java.lang.String	encodeUTF8(java.lang.String doubleByteStr)
static java.lang.String	encodeUTF8base64(java.lang.String normalString) Encode a normal string UTF8 and then base 64
static java.lang.String	escape(java.lang.String value) Escapes special characters using a backslash
static int	htmlWordCount(java.lang.String html) count word count in a piece of html
static boolean	inList(java.lang.String[] lst, java.lang.String qry) Checks if the query string is in the given list
static boolean	isAsciiWhiteSpace(char c)
static boolean	isBlank(java.lang.Object obj) Is the string blank same as trim().equals( "") just faster.
static boolean	isCharacterValidURL(java.lang.Character c) Invalid character found in the request target.
static boolean	isContainAnyOf(java.lang.String pattern, java.lang.String value) Is a value Contain any of pattern
static boolean	isLike(java.lang.String[] patterns, java.lang.String value) Is a value LIKE and a pattern
static boolean	isLike(java.lang.String pattern, java.lang.String value) Is a value LIKE and a pattern
static boolean	isNotEncoded(java.lang.String str) check if the str is NOT strictly encoded into "x-www-form-urlencoded" format.
static boolean	isNumber(java.lang.String value) Determines whether the value contains only numbers, Please do not use this method for checking numeric value, because it not allows dots,minus,hex...
static boolean	isPatternMatch(java.lang.String pattern, java.lang.String path) Is a value LIKE and a comma separated list of patterns with excludes
static boolean	isValidPhoneNumber(java.lang.String phone) Is valid phone number
static java.lang.String	join(java.lang.String fieldDelim, java.util.List list)
static java.lang.String	leftPad(java.lang.String strToPad, int len, java.lang.String padStr)
static java.lang.String[]	listHashTags(java.lang.String text)
static java.lang.String	makeSafeHTML(java.lang.String text, char replacementChar)
static java.lang.String	maskCreditCards(java.lang.String text)
static boolean	matches(java.lang.String pattern, java.lang.String value) Check if a value matches a pattern.
static boolean	notBlank(java.lang.Object obj) Is the string blank same as trim().equals( "") just faster.
static java.lang.String	obscure(java.lang.Object obj)
static double	parseDouble(java.lang.String text)
static boolean	passwordHaveSequentialCharacters(java.lang.String password) check if password have sequential characters.
static boolean	passwordHaveSequentialCharacters(java.lang.String password, boolean repeat, boolean descend, int limit) check if password have sequential characters.
static java.lang.String	replace(java.lang.String text, java.lang.String name, java.lang.String value) Deprecated. As of JDK 1.5, replaced by String#replace(String, String)
static java.lang.String	rightPad(java.lang.String strToPad, int len, java.lang.String padStr) Pad the string with the padding string and then truncate to the expected size.
static java.lang.String	rightTrim(java.lang.String text)
static java.lang.String	romanNumeral(int arabic) An object of type RomanNumeral is an integer between 1 and 3999.
static int	romanNumeral(java.lang.String roman)
static java.lang.String	safeMessage(java.lang.String message)
static java.lang.String	shrinkTo(java.lang.String text, java.lang.String[][] preHint, java.lang.String[][] postHint, int requestedTargetLength, int requestedMaxLength) What letters can be compressed? Here's the list: cc, ms, ns, ps, in, ls, fi, fl, ffl, ffi, iv, ix, vi, oy, ii, xi, nj, ".
static java.lang.String	shrinkTo140(java.lang.String text, java.lang.String[][] preHint, java.lang.String[][] postHint)
static java.lang.String[]	split(java.lang.String values, char fieldDelim, char quote) Performs a split on a string that contains multiple values separated by a field delimiter and with strings grouped by a string delimiter
static java.lang.String[][]	splitAttributes(java.lang.String attributes) split attributes.
static java.lang.String[]	splitCommands(java.lang.String currentSql)
static java.lang.String	sqlValueCheck(java.lang.String value) Check that this is a value SQL value which includes WHERE clauses and columns
static java.lang.String	stripPasswordFromURL(java.lang.String url) Stript out passwords from urls in the form http://user:password@hostname
static java.lang.String	stripPasswordFromURLs(java.lang.String urls) Stript out passwords from URLs in the form http://user:password@hostname
static java.lang.String	stripTagsFromHTML(java.lang.String HTML, java.lang.String tags) Strip the tags from the HTML
static java.lang.String	toHexString(byte[] bytes) Converts and array of bytes to a hexadecimal string, two characters per byte
static int	twitterLength(java.lang.String text)
static boolean	validCharactersHTML(java.lang.String text)
static java.lang.String	webSafePath(java.lang.String title) Convert any title to a web safe & human readable path
static java.lang.String	wrap(java.lang.String text, int pWidth, int pRow) Performs simple word wrapping.
static java.lang.String	wrap(java.lang.String text, int pWidth, int pRow, boolean addMoreSymbol) Performs simple word wrapping.

Methods inherited from class java.lang.Object

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

Field Detail

IP_PATTERN

public static final java.util.regex.Pattern IP_PATTERN

Valid IP address

LOCAL_IP_PATTERN

public static final java.util.regex.Pattern LOCAL_IP_PATTERN

Local IP address http://en.wikipedia.org/wiki/Private_network

HOST_PATTERN

public static final java.util.regex.Pattern HOST_PATTERN

UUENCODED_PATH_PATTERN

public static final java.util.regex.Pattern UUENCODED_PATH_PATTERN

UUENCODED pattern

URI_PATTERN

public static final java.util.regex.Pattern URI_PATTERN

URI pattern matching KNOWN ISSUE: @ should be encoded if it's not used between user and host

PHONE_REGEX

public static final java.util.regex.Pattern PHONE_REGEX

valid phone regular expression

FILE_MIME_TYPE_PATTERN

public static final java.util.regex.Pattern FILE_MIME_TYPE_PATTERN

validate mime type

COMPRESSION_GZIP

public static final java.lang.String COMPRESSION_GZIP

Encoding GZIP - default

See Also:

Constant Field Values

COMPRESSION_NONE

public static final java.lang.String COMPRESSION_NONE

Encoding NONE

See Also:

Constant Field Values

COMPRESSION_DEFLATE

public static final java.lang.String COMPRESSION_DEFLATE

Encoding DEFLATE

See Also:

Constant Field Values

ENCODED_URL_QUOTE

public static final java.lang.String ENCODED_URL_QUOTE

See Also:

Constant Field Values

ENCODED_URL_AND

public static final java.lang.String ENCODED_URL_AND

See Also:

Constant Field Values

ENCODED_URL_QUESTION

public static final java.lang.String ENCODED_URL_QUESTION

See Also:

Constant Field Values

ENCODED_URL_EQUALS

public static final java.lang.String ENCODED_URL_EQUALS

See Also:

Constant Field Values

ENCODED_URL_SPACE

public static final java.lang.String ENCODED_URL_SPACE

See Also:

Constant Field Values

PASSWORD_SEQUENTIAL_LENGTH

public static final int PASSWORD_SEQUENTIAL_LENGTH

See Also:

Constant Field Values

HEX_CODES

public static final java.lang.String[] HEX_CODES

BASE91CIPHER

public static final java.lang.String BASE91CIPHER

See Also:

Constant Field Values

Method Detail

isAsciiWhiteSpace

@CheckReturnValue
public static boolean isAsciiWhiteSpace(char c)

Parameters:

c -

Returns:

maskCreditCards

public static java.lang.String maskCreditCards(java.lang.String text)

safeMessage

@CheckReturnValue
 @Nonnull
public static java.lang.String safeMessage(@Nullable
                                                                       java.lang.String message)

romanNumeral

@CheckReturnValue
public static java.lang.String romanNumeral(int arabic)

An object of type RomanNumeral is an integer between 1 and 3999. It can be constructed either from an integer or from a string that represents a Roman numeral in this range. The function toString() will return a standardized Roman numeral representation of the number. The function toInt() will return the number as a value of type int.

Parameters:

arabic -

Returns:

the value

encode32

@CheckReturnValue
 @Nonnull
public static java.lang.String encode32(@Nonnull
                                                                    byte[] orgArray)

Encode bytes using 32 safe characters.

Parameters:

orgArray -

Returns:

romanNumeral

@CheckReturnValue
public static int romanNumeral(java.lang.String roman)

deduplicate

@CheckReturnValue
 @Nonnull
public static java.lang.String deduplicate(@Nonnull
                                                                       java.lang.String words,
                                                                       char delimator)

De-Duplicate words in a string. "abc,XYZ,Abc,hello,world,xyz" -> "abc,XYZ,hello,world"

Parameters:

words -

delimator -

Returns:

The unique words list

webSafePath

@CheckReturnValue
public static java.lang.String webSafePath(@Nullable
                                                             java.lang.String title)

Convert any title to a web safe & human readable path

Parameters:

title - to convert

Returns:

the web safe path

isCharacterValidURL

@CheckReturnValue
public static boolean isCharacterValidURL(java.lang.Character c)

Invalid character found in the request target. The valid characters are defined in RFC 7230 and RFC 3986

Parameters:

c - the character

Returns:

true if valid in URL

listHashTags

public static java.lang.String[] listHashTags(java.lang.String text)

shrinkTo140

@CheckReturnValue
public static java.lang.String shrinkTo140(java.lang.String text,
                                                             java.lang.String[][] preHint,
                                                             java.lang.String[][] postHint)

twitterLength

@CheckReturnValue
public static int twitterLength(@Nonnull
                                                  java.lang.String text)

shrinkTo

@CheckReturnValue
public static java.lang.String shrinkTo(java.lang.String text,
                                                          java.lang.String[][] preHint,
                                                          java.lang.String[][] postHint,
                                                          int requestedTargetLength,
                                                          int requestedMaxLength)

What letters can be compressed? Here's the list: cc, ms, ns, ps, in, ls, fi, fl, ffl, ffi, iv, ix, vi, oy, ii, xi, nj, ". " (period space), and ", " (comma space).

Parameters:

text -

preHint -

postHint -

requestedMaxLength - the max length

requestedTargetLength - the length the user waits the tweet

Returns:

the value

parseDouble

@CheckReturnValue
public static double parseDouble(java.lang.String text)

compressToBytes

@Nonnull
 @CheckReturnValue
public static byte[] compressToBytes(@Nonnull
                                                                 java.lang.String text)
                                                          throws java.lang.Exception

Compress the text to a gzip byte array

Parameters:

text - the text to compress

Returns:

the gzip bytes

Throws:

java.lang.Exception - a serious problem

compress

@CheckReturnValue
public static java.lang.String compress(java.lang.String text)
                                                   throws java.lang.Exception

Parameters:

text -

Returns:

the value

Throws:

java.lang.Exception - a serious problem

decompress

@CheckReturnValue
public static java.lang.String decompress(java.lang.String compressedData,
                                                            java.lang.String type)
                                                     throws java.lang.Exception

decompress a string to a normal native java string

Parameters:

compressedData -

type - the type

Returns:

the value

Throws:

java.lang.Exception - a serious problem

decompress

@Nonnull
 @CheckReturnValue
public static java.lang.String decompress(@Nonnull
                                                                      byte[] array)
                                                               throws java.lang.Exception

decompress a string to a normal native java string

Parameters:

array -

Returns:

the value

Throws:

java.lang.Exception - a serious problem

decompress

@Nonnull
 @CheckReturnValue
public static java.lang.String decompress(@Nonnull
                                                                      byte[] array,
                                                                      @Nonnull
                                                                      java.lang.String type)
                                                               throws java.lang.IllegalArgumentException,
                                                                      java.io.IOException

decompress a string to a normal native java string

Parameters:

array -

type - the type

Returns:

the value

Throws:

java.lang.IllegalArgumentException - a serious problem

java.io.IOException

splitAttributes

@CheckReturnValue
public static java.lang.String[][] splitAttributes(java.lang.String attributes)

split attributes. UPDATE ABC SET name='abc', email='nigel@abc.com.au'

Parameters:

attributes -

Returns:

list of attributes.

splitCommands

@CheckReturnValue
public static java.lang.String[] splitCommands(java.lang.String currentSql)

Parameters:

currentSql -

Returns:

the value

rightTrim

@CheckReturnValue
 @Nonnull
public static java.lang.String rightTrim(@Nonnull
                                                                     java.lang.String text)

Parameters:

text -

Returns:

the value

isPatternMatch

@CheckReturnValue
public static boolean isPatternMatch(@Nonnull
                                                       java.lang.String pattern,
                                                       @Nonnull
                                                       java.lang.String path)

Is a value LIKE and a comma separated list of patterns with excludes

Parameters:

path - the "file" path to check

pattern - The pattern to match to.

Returns:

true if match

isContainAnyOf

@CheckReturnValue
public static boolean isContainAnyOf(java.lang.String pattern,
                                                       java.lang.String value)

Is a value Contain any of pattern

Parameters:

pattern - The pattern to match to.

value - The value to match

Returns:

true if match

matches

@CheckReturnValue
public static boolean matches(@Nonnull
                                                java.lang.String pattern,
                                                @Nonnull
                                                java.lang.String value)

Check if a value matches a pattern. The pattern is whitespace separated with support for wild cards and negation.

Parameters:

pattern - the pattern to check

value - the value

Returns:

matches.

isLike

@CheckReturnValue
public static boolean isLike(java.lang.String[] patterns,
                                               java.lang.String value)

Is a value LIKE and a pattern

Parameters:

patterns - The patterns to match to.

value - The value to match

Returns:

true if match

isLike

@CheckReturnValue
public static boolean isLike(@Nonnull
                                               java.lang.String pattern,
                                               @Nonnull
                                               java.lang.String value)

Is a value LIKE and a pattern

Parameters:

pattern - The pattern to match to.

value - The value to match

Returns:

true if match

replace

@CheckReturnValue
 @Nullable
 @Deprecated
public static java.lang.String replace(@Nullable
                                                                                 java.lang.String text,
                                                                                 @Nonnull
                                                                                 java.lang.String name,
                                                                                 @Nonnull
                                                                                 java.lang.String value)

Deprecated. As of JDK 1.5, replaced by String#replace(String, String)

The function replace() replaces every occurrence of the second parameter "name" with the third parameter "value" in the first parameter text. If no changes were made, the first parameter is returned without changes (no new string object is generated.)

Parameters:

text - The string that will be iterated through to replace parts

name - The string that will be replaced

value - The string that will replace the original text.

Returns:

the value

notBlank

@CheckReturnValue
public static boolean notBlank(@Nullable
                                                 java.lang.Object obj)

Is the string blank same as trim().equals( "") just faster.

Parameters:

obj -

Returns:

the value

isBlank

@CheckReturnValue
public static boolean isBlank(@Nullable
                                                java.lang.Object obj)

Is the string blank same as trim().equals( "") just faster.

Parameters:

obj -

Returns:

the value

decodeSQL

@CheckReturnValue
public static java.lang.String decodeSQL(@Nullable
                                                           java.lang.String sqlString)

Parameters:

sqlString -

Returns:

the value

assertIllegalCharactersHTML

@CheckReturnValue
public static boolean assertIllegalCharactersHTML(@Nonnull
                                                                    java.lang.String text)

http://en.wikipedia.org/wiki/Character_encodings_in_HTML

Parameters:

text -

Returns:

true

Throws:

java.lang.AssertionError

checkIllegalCharactersHTML

public static void checkIllegalCharactersHTML(@Nonnull
                                              java.lang.String text)
                                       throws java.lang.IllegalArgumentException

http://en.wikipedia.org/wiki/Character_encodings_in_HTML

Parameters:

text -

Throws:

java.lang.IllegalArgumentException

validCharactersHTML

@CheckReturnValue
public static boolean validCharactersHTML(@Nonnull
                                                            java.lang.String text)

makeSafeHTML

public static java.lang.String makeSafeHTML(@Nonnull
                                            java.lang.String text,
                                            char replacementChar)

decodeHTML

@CheckReturnValue
public static java.lang.String decodeHTML(@Nonnull
                                                            java.lang.String encodedHTML)

http://en.wikipedia.org/wiki/List_of_XML_and_HTML_character_entity_references

Parameters:

encodedHTML -

Returns:

the value

encodeHTML

@CheckReturnValue
 @Nonnull
public static java.lang.String encodeHTML(@Nullable
                                                                      java.lang.String value)

http://en.wikipedia.org/wiki/Character_encodings_in_HTML http://www.w3.org/TR/html401/types.html#type-name

Parameters:

value - the value

Returns:

the value

checkSumAdler32

@CheckReturnValue
 @Nonnull
public static java.lang.String checkSumAdler32(@Nullable
                                                                           java.lang.String str)

get the Adler32 checksum value of this string

Parameters:

str - String

Returns:

checksum value as hex ( 8 characters).

checkSumAdler32

@CheckReturnValue
 @Nonnull
public static java.lang.String checkSumAdler32(@Nonnull
                                                                           byte[] data)

calculates the Adler32 checksum value of this byte array

Parameters:

data - byte array

Returns:

checksum 32-bit integer in hex

encodeJavaDoc

@CheckReturnValue
public static java.lang.String encodeJavaDoc(java.lang.String doubleByteStr)

Some characters are valid in Java Docs comments that aren't in HTML.

Parameters:

doubleByteStr -

Returns:

the value

sqlValueCheck

@CheckReturnValue
public static java.lang.String sqlValueCheck(@Nullable
                                                               java.lang.String value)
                                                        throws java.lang.IllegalArgumentException

Check that this is a value SQL value which includes WHERE clauses and columns

Parameters:

value - the value

Returns:

the value

Throws:

java.lang.IllegalArgumentException

encodeSQL

@CheckReturnValue
public static java.lang.String encodeSQL(@Nullable
                                                           java.lang.String doubleByteStr)

Parameters:

doubleByteStr -

Returns:

the value

decodeUTF8

@CheckReturnValue
 @Nullable
public static java.lang.String decodeUTF8(@Nullable
                                                                       java.lang.String utf8)

Parameters:

utf8 -

Returns:

the value

stripTagsFromHTML

@CheckReturnValue
public static java.lang.String stripTagsFromHTML(@Nonnull
                                                                   java.lang.String HTML,
                                                                   @Nonnull
                                                                   java.lang.String tags)

Strip the tags from the HTML

Parameters:

HTML - the HTML to strip the tags from.

tags - the tags to strip

Returns:

the clean HTML.

stripPasswordFromURL

@CheckReturnValue
 @Nonnull
public static java.lang.String stripPasswordFromURL(@Nullable
                                                                                java.lang.String url)

Stript out passwords from urls in the form http://user:password@hostname

Parameters:

url -

Returns:

the value

stripPasswordFromURLs

@CheckReturnValue
 @Nonnull
public static java.lang.String stripPasswordFromURLs(@Nullable
                                                                                 java.lang.String urls)

Stript out passwords from URLs in the form http://user:password@hostname

Parameters:

urls - the URLs

Returns:

the value

encodeISqlValue

@CheckReturnValue
 @Nonnull
public static java.lang.String encodeISqlValue(@Nonnull
                                                                           java.lang.String value)

encode a value used for isql to prevent sql injection

Parameters:

value - the value

Returns:

the value

htmlWordCount

@CheckReturnValue
public static int htmlWordCount(@Nullable
                                                  java.lang.String html)

count word count in a piece of html

Parameters:

html - html code

Returns:

word count

convertHtmlToText

@CheckReturnValue
 @Nonnull
public static java.lang.String convertHtmlToText(@Nonnull
                                                                             java.lang.String htmlText)
                                                                      throws java.lang.Exception

Convert HTML to Text

Parameters:

htmlText - The HTML to convert

Returns:

the plain text

Throws:

java.lang.Exception - a serious problem

encodeUTF8

@CheckReturnValue
 @Nonnull
public static java.lang.String encodeUTF8(@Nonnull
                                                                      java.lang.String doubleByteStr)

Parameters:

doubleByteStr -

Returns:

the value

wrap

@CheckReturnValue
public static java.lang.String wrap(java.lang.String text,
                                                      int pWidth,
                                                      int pRow)
                                               throws NotFoundException

Performs simple word wrapping.

Parameters:

pWidth -

pRow -

text - text to be wrap

Returns:

the value

Throws:

NotFoundException

wrap

@CheckReturnValue
public static java.lang.String wrap(java.lang.String text,
                                                      int pWidth,
                                                      int pRow,
                                                      boolean addMoreSymbol)
                                               throws NotFoundException

Performs simple word wrapping. TODO handle case where next char after max columns is a new line

Parameters:

pWidth -

pRow -

text - text to be wrap

addMoreSymbol - adds "..." to value if last line is truncated

Returns:

the value

Throws:

NotFoundException

encode

@CheckReturnValue
 @Nonnull
public static java.lang.String encode(@Nonnull
                                                                  java.lang.String str)

Encodes a String into a MIME format called "x-www-form-urlencoded" format. for performance reasons check that we need to encode before creating new objects.

Parameters:

str -

Returns:

the value

encodeStrict

@CheckReturnValue
 @Nonnull
public static java.lang.String encodeStrict(@Nonnull
                                                                        java.lang.String str)

Parameters:

str -

Returns:

the value

encode

@CheckReturnValue
 @Nonnull
public static java.lang.String encode(@Nonnull
                                                                  byte[] array)

Parameters:

array -

Returns:

the value

encode

@CheckReturnValue
public static java.lang.String encode(byte[] array,
                                                        int off,
                                                        int len,
                                                        boolean strict)

Parameters:

array -

off -

len -

strict -

Returns:

the value

isNotEncoded

@CheckReturnValue
public static boolean isNotEncoded(@Nullable
                                                     java.lang.String str)

check if the str is NOT strictly encoded into "x-www-form-urlencoded" format.

Parameters:

str - string to test

Returns:

true if the str is NOT strictly encoded, false when the str is null or it could be encoded, eg: "%20" could be or could be NOT encoded

decode

@CheckReturnValue
 @Nonnull
public static java.lang.String decode(@Nonnull
                                                                  java.lang.String str)

Decodes a String from a MIME format called "x-www-form-urlencoded" format.

• The ASCII characters 'a' through 'z', 'A' through 'Z', and '0' through '9' remain the same.
• The space character ' ' is converted into a plus sign '+'.
• Special characters '-' '_' '.' '*' remain unchanged
• All other characters are converted into the 3-character string "%xy", where xy is the two-digit hexadecimal representation of the lower 8-bits of the character.

Parameters:

str -

Returns:

the value

Throws:

java.lang.RuntimeException

decodeToBytes

@CheckReturnValue
 @Nonnull
public static byte[] decodeToBytes(@Nonnull
                                                               java.lang.String str)

Decode into bytes

Parameters:

str -

Returns:

the value

Throws:

java.lang.RuntimeException

leftPad

@CheckReturnValue
 @Nonnull
public static java.lang.String leftPad(@Nonnull
                                                                   java.lang.String strToPad,
                                                                   @Nonnegative
                                                                   int len,
                                                                   @Nonnull
                                                                   java.lang.String padStr)

Parameters:

strToPad -

len -

padStr -

Returns:

the value

obscure

@CheckReturnValue
 @Nonnull
public static java.lang.String obscure(@Nullable
                                                                   java.lang.Object obj)

Parameters:

obj -

Returns:

the value

rightPad

@CheckReturnValue
 @Nonnull
public static java.lang.String rightPad(@Nonnull
                                                                    java.lang.String strToPad,
                                                                    @Nonnegative
                                                                    int len,
                                                                    @Nonnull
                                                                    java.lang.String padStr)

Pad the string with the padding string and then truncate to the expected size.

Parameters:

strToPad - The string that will be appended to.

len - The final length of the string.

padStr - the string to pad with.

Returns:

the value the resulting value which will always be expected length long.

compressB91

@Nonnull
 @CheckReturnValue
public static java.lang.String compressB91(@Nonnull
                                                                       java.lang.String text)
                                                                throws java.lang.Exception

compress a java string with gzip and encode to ASCII with basE91

Parameters:

text - the string to be compressed

Returns:

ASCII string

Throws:

java.lang.Exception - a serious exception

decompressB91

@Nonnull
 @CheckReturnValue
public static java.lang.String decompressB91(@Nonnull
                                                                         java.lang.String compressedData)
                                                                  throws java.lang.Exception

decompress a string with GZIP to a normal native java string

Parameters:

compressedData - ASCII string to be decompressed

Returns:

original string

Throws:

java.lang.Exception - a serious exception

encodeBase91

@CheckReturnValue
 @Nonnull
public static java.lang.String encodeBase91(@Nonnull
                                                                        byte[] data)

encode a String to basE91 ASCII, basE91 is similar to BASE64 but more efficient in both encoding speed and string size

Parameters:

data - the data

Returns:

ASCII string

decodeBase91

@Nonnull
 @CheckReturnValue
public static byte[] decodeBase91(@Nonnull
                                                              java.lang.String src)
                                                       throws java.lang.Exception

decode a basE91 to original string

Parameters:

src - string to be decoded

Returns:

the original string

Throws:

java.lang.Exception - a serious exception

encodeUTF8base64

@CheckReturnValue
 @Nonnull
public static java.lang.String encodeUTF8base64(@Nonnull
                                                                            java.lang.String normalString)

Encode a normal string UTF8 and then base 64

Parameters:

normalString - normal Java String

Returns:

UTF8 and base64 encoded string.

decodeUTF8base64

@CheckReturnValue
 @Nonnull
public static java.lang.String decodeUTF8base64(@Nonnull
                                                                            java.lang.String base64utf8)

decode a normal string from UTF8 & base 64 String.

Parameters:

base64utf8 - a String that is first UTF8 and then base64

Returns:

UTF8 and base64 encoded string.

checkXML

@CheckReturnValue
public static boolean checkXML(@Nullable
                                                 java.lang.String text)

Check all characters are valid XML characters.

Parameters:

text - the text to check

Returns:

true if all valid or text is NULL.

checkXML

@CheckReturnValue
public static boolean checkXML(int c)

http://en.wikipedia.org/wiki/Valid_characters_in_XML

Parameters:

c - the character to check

Returns:

true if valid

check8Bit

@CheckReturnValue
public static boolean check8Bit(@Nonnull
                                                  java.lang.String text)

encodeBase64

@CheckReturnValue
 @Nonnull
public static java.lang.String encodeBase64(@Nonnull
                                                                        java.lang.String szSrc)

Parameters:

szSrc -

Returns:

the value

decodeBase64

@CheckReturnValue
 @Nonnull
public static java.lang.String decodeBase64(@Nonnull
                                                                        java.lang.String encodedStr)

The Web Servers strip off the trailing ='s so just append them if needed

Parameters:

encodedStr - encoded string

Returns:

the decoded string

encodeBase64

@CheckReturnValue
 @Nonnull
public static byte[] encodeBase64(@Nonnull
                                                              byte[] input)

Encodes a byte array to base64

Parameters:

input - the byte array to encode

Returns:

byte[] the encoded bytes

decodeBase64

@CheckReturnValue
 @Nonnull
public static byte[] decodeBase64(@Nonnull
                                                              byte[] input)

Decodes a byte array that is base64 encoded. The decoder will only handle base64 characters and the padding byte '=', if your input contains other characters, such as newlines used by certain protocol max line lengths, an exception will be thrown. You can split/remove the illegal characters before calling this method. It is expecting well formed input, i.e. input should be 4 byte multiples with padding as appropriate. It will however *sometimes* handle input where the padding has been stripped ( by a web server for example )

Parameters:

input - the base64 byte array to decode

Returns:

byte[] the decoded byte array

byteArrayToHexString

@CheckReturnValue
 @Nonnull
public static java.lang.String byteArrayToHexString(@Nonnull
                                                                                byte[] b)

byte array to hex string

Parameters:

b - byte array

Returns:

hex string

encodeHex

@CheckReturnValue
 @Nonnull
public static java.lang.String encodeHex(@Nonnull
                                                                     java.lang.String szSrc)

Parameters:

szSrc -

Returns:

the value

decodeHex

@CheckReturnValue
 @Nullable
public static java.lang.String decodeHex(@Nullable
                                                                      java.lang.String szSrc)

The Web Servers strip off the trailing ='s so just append them if needed

Parameters:

szSrc -

Returns:

the value

contains

@CheckReturnValue
public static boolean contains(@Nullable
                                                 java.lang.String src,
                                                 @Nullable
                                                 java.lang.String qry)

Checks if the query can be found in the source string.

Parameters:

src -

qry -

Returns:

true if the query string was found, false otherwise

inList

@CheckReturnValue
public static boolean inList(@Nullable
                                               java.lang.String[] lst,
                                               @Nullable
                                               java.lang.String qry)

Checks if the query string is in the given list

Parameters:

lst - the list to search

qry - the query string

Returns:

Boolean true if the query string is in the list of strings, false otherwise

toHexString

@CheckReturnValue
 @Nonnull
public static java.lang.String toHexString(@Nonnull
                                                                       byte[] bytes)

Converts and array of bytes to a hexadecimal string, two characters per byte

Parameters:

bytes - the bytes to convert

Returns:

String the hexadecimal representation

join

@CheckReturnValue
 @Nonnull
public static java.lang.String join(@Nonnull
                                                                java.lang.String fieldDelim,
                                                                @Nonnull
                                                                java.util.List list)

split

@CheckReturnValue
 @Nonnull
public static java.lang.String[] split(@Nonnull
                                                                   java.lang.String values,
                                                                   char fieldDelim,
                                                                   char quote)

Performs a split on a string that contains multiple values separated by a field delimiter and with strings grouped by a string delimiter

Parameters:

values - - value to be parsed

fieldDelim - the field delimiter

quote - the quote character

Returns:

String[] - list of String values

capitalizeWordsInString

@CheckReturnValue
 @Nonnull
public static java.lang.String capitalizeWordsInString(@Nonnull
                                                                                   java.lang.String words)

Capitalizes the first character IN EACH WORD of the specified string.

Parameters:

words - the name to capitalize

Returns:

The specified string with the first letter capitalized.

capitalize

@CheckReturnValue
 @Nonnull
public static java.lang.String capitalize(@Nonnull
                                                                      java.lang.String str)

Capitalizes the first letter of the specified string.

Parameters:

str - the name to capitalize

Returns:

The specified string with the first letter capitalized.

passwordHaveSequentialCharacters

@CheckReturnValue
public static boolean passwordHaveSequentialCharacters(@Nonnull
                                                                         java.lang.String password)

check if password have sequential characters.

Parameters:

password - the password to check

Returns:

Boolean value

passwordHaveSequentialCharacters

@CheckReturnValue
public static boolean passwordHaveSequentialCharacters(@Nullable
                                                                         java.lang.String password,
                                                                         boolean repeat,
                                                                         boolean descend,
                                                                         int limit)

check if password have sequential characters.

Parameters:

password - the password to check

repeat -

descend -

limit -

Returns:

Boolean value

containsRudeWord

@CheckReturnValue
public static boolean containsRudeWord(@Nonnull
                                                         java.lang.String word)

Does this word contain a rude word. When generating a password just skip over rude words.

Parameters:

word - the word to check

Returns:

true if there is a possible rude word.

cleanNumberString

@CheckReturnValue
 @Nonnull
public static java.lang.String cleanNumberString(@Nonnull
                                                                             java.lang.String valueToClean)

This method cleans chars that cause parsing problems when we want to parse String to Number (Integer,Double,Float,Long....)

Parameters:

valueToClean - - the String that we want to clean

Returns:

new clean value

isNumber

@CheckReturnValue
public static boolean isNumber(@Nonnull
                                                 java.lang.String value)

Determines whether the value contains only numbers, Please do not use this method for checking numeric value, because it not allows dots,minus,hex...

Parameters:

value - value

Returns:

true if the value contains only numbers

isValidPhoneNumber

@CheckReturnValue
public static boolean isValidPhoneNumber(@Nonnull
                                                           java.lang.String phone)

Is valid phone number

Parameters:

phone - phone

Returns:

the value

escape

@CheckReturnValue
 @Nullable
public static java.lang.String escape(@Nullable
                                                                   java.lang.String value)

Escapes special characters using a backslash

Parameters:

value - the string

Returns:

escaped string

appendURLParam

@CheckReturnValue
 @Nonnull
public static java.lang.String appendURLParam(@Nonnull
                                                                          java.lang.String uri,
                                                                          @Nonnull
                                                                          java.lang.String param,
                                                                          @Nonnull
                                                                          java.lang.String value)

Appends parameter and value to the given URL.

Parameters:

uri -

param -

value - the value

Returns:

the value