com.edorasware.commons.core.util.string

Class StringUtils

java.lang.Object

com.edorasware.commons.core.util.string.StringUtils

public final class StringUtils
extends Object

Provides utility methods related to string operations.

Method Summary

Modifier and Type	Method and Description
static com.google.common.collect.ImmutableList<String>	convertToHex(byte[] bytes) Returns the given bytes in hex format.
static com.google.common.collect.ImmutableList<String>	convertToHex(InputStream inputStream) Returns the bytes of the given input stream in hex format.
static com.google.common.collect.ImmutableList<String>	convertToHex(String string, String charsetName) Returns the bytes of the given string in hex format.
static byte[]	getBytes(String string, String charsetName) Returns the bytes of the given string.
static com.google.common.collect.ImmutableList<Pair<String,String>>	getTagAttributesAndContent(String string, String openingTag, String closingOfOpeningTag, String closingTag) For each tag, the tag attributes and the tag content are collected.
static String	replace(String string, String replacement, int firstPosToReplace, int lastPosToReplace) Replaces a substring of the given string with some other string.
static String	replaceTags(String string, String openingTag, String closingTag, com.google.common.base.Function<String,String> replacementFunction) For each tag, the tag is replaced with the content defined by the given replacement function.
static Pair<String,com.google.common.collect.ImmutableMap<String,Object>>	replaceTags(String string, String openingTag, String closingOfOpeningTag, String closingTag, Function2<String,String,Pair<String,Map<String,Object>>> replacementFunction) For each tag, the tag is replaced with the content defined by the given replacement function.
static com.google.common.collect.ImmutableList<String>	toChunks(String string, int chunkSize) Splits the given string into chucks of characters of the given size.
static com.google.common.collect.ImmutableList<String>	toLowerCase(List<String> input) Converts the given strings to lower-case.
static String	trimSuffix(String string, String suffix) Removes the given suffix from the given string.

Methods inherited from class java.lang.Object

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

Method Detail

getTagAttributesAndContent

public static com.google.common.collect.ImmutableList<Pair<String,String>> getTagAttributesAndContent(String string,
                                                                                                      String openingTag,
                                                                                                      String closingOfOpeningTag,
                                                                                                      String closingTag)

For each tag, the tag attributes and the tag content are collected. A tag is identified by the opening tag, the closing of the opening tag, and the closing tag.

Parameters:

string - the string to investigate

openingTag - the opening tag to match

closingOfOpeningTag - the closing of the opening tag to match

closingTag - the closing tag to match

Returns:

pairs of tag attributes and tag content

replaceTags

public static Pair<String,com.google.common.collect.ImmutableMap<String,Object>> replaceTags(String string,
                                                                                             String openingTag,
                                                                                             String closingOfOpeningTag,
                                                                                             String closingTag,
                                                                                             Function2<String,String,Pair<String,Map<String,Object>>> replacementFunction)

For each tag, the tag is replaced with the content defined by the given replacement function. A tag is identified by the opening tag, the closing of the opening tag, and the closing tag.

Parameters:

string - the string to investigate

openingTag - the opening tag to match

closingOfOpeningTag - the closing of the opening tag to match

closingTag - the closing tag to match

replacementFunction - the function to convert the tag into some new string

Returns:

pair of the new string and a parameter map built from the current attributes and content

replaceTags

public static String replaceTags(String string,
                                 String openingTag,
                                 String closingTag,
                                 com.google.common.base.Function<String,String> replacementFunction)

For each tag, the tag is replaced with the content defined by the given replacement function. A tag is identified by the opening tag and the closing tag.

Parameters:

string - the string to investigate

openingTag - the opening tag to match

closingTag - the closing tag to match

replacementFunction - the function to convert the tag into some new string

Returns:

the new string

replace

public static String replace(String string,
                             String replacement,
                             int firstPosToReplace,
                             int lastPosToReplace)

Replaces a substring of the given string with some other string. The substring to replace is defined by the given start and end position in the current string.

Parameters:

string - the string to investigate

replacement - the replacement string

firstPosToReplace - the first position to replace in the string

lastPosToReplace - the last position to replace in the string

Returns:

the new string

trimSuffix

public static String trimSuffix(String string,
                                String suffix)

Removes the given suffix from the given string. If the string does not end with the suffix, the original string is returned.

Parameters:

string - the string to investigate

suffix - the suffix to remove

Returns:

the new string

toLowerCase

public static com.google.common.collect.ImmutableList<String> toLowerCase(List<String> input)

Converts the given strings to lower-case.

Parameters:

input - the string to covert to lower-case

Returns:

the converted strings

toChunks

public static com.google.common.collect.ImmutableList<String> toChunks(String string,
                                                                       int chunkSize)

Splits the given string into chucks of characters of the given size.

Parameters:

string - the string to investigate

chunkSize - the chunk size

Returns:

the chunks of the string

convertToHex

public static com.google.common.collect.ImmutableList<String> convertToHex(InputStream inputStream)
                                                                    throws IOException

Returns the bytes of the given input stream in hex format.

Parameters:

inputStream - the input stream whose bytes to convert

Returns:

the bytes of the input stream in hex format

Throws:

IOException - thrown if an error occurs while reading from the stream

convertToHex

public static com.google.common.collect.ImmutableList<String> convertToHex(String string,
                                                                           String charsetName)

Returns the bytes of the given string in hex format.

Parameters:

string - the string to convert

charsetName - the charset to apply when converting the string to bytes

Returns:

the bytes of the string in hex format

convertToHex

public static com.google.common.collect.ImmutableList<String> convertToHex(byte[] bytes)

Returns the given bytes in hex format.

Parameters:

bytes - the bytes to convert

Returns:

the bytes of the string in hex format

getBytes

public static byte[] getBytes(String string,
                              String charsetName)

Returns the bytes of the given string.

Parameters:

string - the string

charsetName - the name of the charset to apply when converting chars to bytes

Returns:

the bytes of the string