com.github.hypfvieh.util

Class StringUtil

java.lang.Object

com.github.hypfvieh.util.StringUtil

public final class StringUtil
extends Object

Utility class for String manipulation.

Since:

v1.0 - 2016-06-29

Author:

hypfvieh

Method Summary

Modifier and Type	Method and Description
static String	defaultIfBlank(String _str, String _default) Checks if given String is blank (see isBlank(String).
static boolean	equalsAny(boolean _ignoreCase, String _str, String... _compare) Checks if any of the given strings in _compare is equal to _str (either case-insensitive or case-sensitive).
static boolean	equalsAny(String _str, String... _compare) Checks if any of the given strings in _compare is equal to _str (case-sensitive).
static boolean	equalsIgnoreCaseAny(String _str, String... _compare) Checks if any of the given strings in _compare is equal to _str (case-insensitive).
static boolean	isBlank(String _str) Checks if the given String is either null or blank.
static String	join(String _delimiter, List<String> _strings) Combines the Strings in _string using _delimiter.
static String	join(String _delimiter, String[] _strings) Combines the Strings in _string using _delimiter.
static String	lowerCaseFirstChar(String _str) Lower case the first letter of the given string.
static String	randomString(int _length) Generate a simple (cryptographic insecure) random string.
static String	replaceByMap(String _searchStr, Map<String,String> _replacements) Replace all placeholders in given string by value of the corresponding key in given Map.
static String	rot13(String _input) Simple rot13 implementation.
static List<String>	smartWordSplit(String _text, int _len) Tries to split a string in a smart way.
static List<String>	splitEqually(String _text, int _len) Splits a Text to equal parts.
static String	upperCaseFirstChar(String _str) Upper case the first letter of the given string.

Methods inherited from class java.lang.Object

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

Method Detail

smartWordSplit

public static List<String> smartWordSplit(String _text,
                                          int _len)

Tries to split a string in a smart way.

String will be splitted by space and then recombined until each line has the given length or less than the given length, if the next token would cause the line to be longer than requested It is ensured that each line has a maximum length of _len, it could be short but never longer.

Parameters:

_text -

_len -

Returns:

list or null if _text was null

splitEqually

public static List<String> splitEqually(String _text,
                                        int _len)

Splits a Text to equal parts. There is no detection of words, everything will be cut to the same length.

Parameters:

_text -

_len -

Returns:

list of string splitted to _len or null if _text was null

replaceByMap

public static String replaceByMap(String _searchStr,
                                  Map<String,String> _replacements)

Replace all placeholders in given string by value of the corresponding key in given Map.

Parameters:

_searchStr -

_replacements -

Returns:

String or null if _searchStr was null

lowerCaseFirstChar

public static String lowerCaseFirstChar(String _str)

Lower case the first letter of the given string.

Parameters:

_str -

Returns:

upperCaseFirstChar

public static String upperCaseFirstChar(String _str)

Upper case the first letter of the given string.

Parameters:

_str -

Returns:

rot13

public static String rot13(String _input)

Simple rot13 implementation.

Parameters:

_input -

Returns:

equalsIgnoreCaseAny

public static boolean equalsIgnoreCaseAny(String _str,
                                          String... _compare)

Checks if any of the given strings in _compare is equal to _str (case-insensitive).
Will return true if both parameters are null or _str is null and _compare is empty.

Parameters:

_str -

_compare -

Returns:

true if equal false otherwise

equalsAny

public static boolean equalsAny(String _str,
                                String... _compare)

Checks if any of the given strings in _compare is equal to _str (case-sensitive).
Will return true if both parameters are null or _str is null and _compare is empty.

Parameters:

_str -

_compare -

Returns:

true if equal false otherwise

equalsAny

public static boolean equalsAny(boolean _ignoreCase,
                                String _str,
                                String... _compare)

Checks if any of the given strings in _compare is equal to _str (either case-insensitive or case-sensitive).
Will return true if both parameters are null or _str is null and _compare is empty.

Parameters:

_ignoreCase -

_str -

_compare -

Returns:

true if equal false otherwise

isBlank

public static boolean isBlank(String _str)

Checks if the given String is either null or blank. Blank means:

 " " - true
 "" - true
 null - true
 " xx" - false
 

Parameters:

_str -

Returns:

defaultIfBlank

public static String defaultIfBlank(String _str,
                                    String _default)

Checks if given String is blank (see isBlank(String).
If String is blank, the given default is returned, otherwise the String is returned.

Parameters:

_str - string to check

_default - default in case of blank string

Returns:

_str or _default

randomString

public static String randomString(int _length)

Generate a simple (cryptographic insecure) random string.

Parameters:

_length - length of random string

Returns:

random string or empty string if _length <= 0

join

public static String join(String _delimiter,
                          List<String> _strings)

Combines the Strings in _string using _delimiter.

Parameters:

_delimiter -

_strings -

Returns:

null if _strings is null, concatenated string otherwise

join

public static String join(String _delimiter,
                          String[] _strings)

Combines the Strings in _string using _delimiter.

Parameters:

_delimiter -

_strings -

Returns:

null if _strings is null, concatenated string otherwise