/**
 * 首字母变小写
 *
 * @param str 字符串
 * @return {String}
 */
StringUtil.firstCharToLower(String str);

/**
 * 首字母变大写
 *
 * @param str 字符串
 * @return {String}
 */
StringUtil.firstCharToUpper(String str);

/**
 * Check whether the given {@code CharSequence} contains actual <em>text</em>.
 * <p>More specifically, this method returns {@code true} if the
 * {@code CharSequence} is not {@code null}, its length is greater than
 * 0, and it contains at least one non-whitespace character.
 * <pre class="code">
 * StringUtil.isBlank(null) = true
 * StringUtil.isBlank("") = true
 * StringUtil.isBlank(" ") = true
 * StringUtil.isBlank("12345") = false
 * StringUtil.isBlank(" 12345 ") = false
 * </pre>
 *
 * @param cs the {@code CharSequence} to check (may be {@code null})
 * @return {@code true} if the {@code CharSequence} is not {@code null},
 * its length is greater than 0, and it does not contain whitespace only
 * @see Character#isWhitespace
 */
StringUtil.isBlank(CharSequence cs);

/**
 * <p>Checks if a CharSequence is not empty (""), not null and not whitespace only.</p>
 * <pre>
 * StringUtil.isNotBlank(null)	  = false
 * StringUtil.isNotBlank("")		= false
 * StringUtil.isNotBlank(" ")	   = false
 * StringUtil.isNotBlank("bob")	 = true
 * StringUtil.isNotBlank("  bob  ") = true
 * </pre>
 *
 * @param cs the CharSequence to check, may be null
 * @return {@code true} if the CharSequence is
 * not empty and not null and not whitespace
 * @see Character#isWhitespace
 */
StringUtil.isNotBlank(CharSequence cs);

/**
 * 有 任意 一个 Blank
 *
 * @param css CharSequence
 * @return boolean
 */
StringUtil.isAnyBlank(CharSequence css);

/**
 * 有 任意 一个 Blank
 *
 * @param css CharSequence
 * @return boolean
 */
StringUtil.isAnyBlank(Collection<CharSequence> css);

/**
 * 是否全非 Blank
 *
 * @param css CharSequence
 * @return boolean
 */
StringUtil.isNoneBlank(CharSequence css);

/**
 * 是否全非 Blank
 *
 * @param css CharSequence
 * @return boolean
 */
StringUtil.isNoneBlank(Collection<CharSequence> css);

/**
 * 有 任意 一个 Blank
 *
 * @param css CharSequence
 * @return boolean
 */
StringUtil.isAnyNotBlank(CharSequence css);

/**
 * 有 任意 一个 Blank
 *
 * @param css CharSequence
 * @return boolean
 */
StringUtil.isAnyNotBlank(Collection<CharSequence> css);

/**
 * 判断一个字符串是否是数字
 *
 * @param cs the CharSequence to check, may be null
 * @return {boolean}
 */
StringUtil.isNumeric(CharSequence cs);

/**
 * 将字符串中特定模式的字符转换成map中对应的值
 * <p>
 * use: format("my name is ${name}, and i like ${like}!", {"name":"L.cm", "like": "Java"})
 *
 * @param message 需要转换的字符串
 * @param params  转换所需的键值对集合
 * @return 转换后的字符串
 */
StringUtil.format(String message, Map<String,Object> params);

/**
 * 同 log 格式的 format 规则
 * <p>
 * use: format("my name is {}, and i like {}!", "L.cm", "Java")
 *
 * @param message   需要转换的字符串
 * @param arguments 需要替换的变量
 * @return 转换后的字符串
 */
StringUtil.format(String message, Object arguments);

/**
 * Convert a {@code Collection} into a delimited {@code String} (e.g., CSV).
 * <p>Useful for {@code toString()} implementations.
 *
 * @param coll the {@code Collection} to convert
 * @return the delimited {@code String}
 */
StringUtil.join(Collection<?> coll);

/**
 * Convert a {@code Collection} into a delimited {@code String} (e.g. CSV).
 * <p>Useful for {@code toString()} implementations.
 *
 * @param coll  the {@code Collection} to convert
 * @param delim the delimiter to use (typically a ",")
 * @return the delimited {@code String}
 */
StringUtil.join(Collection<?> coll, String delim);

/**
 * Convert a {@code String} array into a comma delimited {@code String}
 * (i.e., CSV).
 * <p>Useful for {@code toString()} implementations.
 *
 * @param arr the array to display
 * @return the delimited {@code String}
 */
StringUtil.join(Object[] arr);

/**
 * Convert a {@code String} array into a delimited {@code String} (e.g. CSV).
 * <p>Useful for {@code toString()} implementations.
 *
 * @param arr   the array to display
 * @param delim the delimiter to use (typically a ",")
 * @return the delimited {@code String}
 */
StringUtil.join(Object[] arr, String delim);

/**
 * 分割 字符串
 *
 * @param str       字符串
 * @param delimiter 分割符
 * @return 字符串数组
 */
StringUtil.split(String str, String delimiter);

/**
 * 分割 字符串 删除常见 空白符
 *
 * @param str       字符串
 * @param delimiter 分割符
 * @return 字符串数组
 */
StringUtil.splitTrim(String str, String delimiter);

/**
 * 字符串是否符合指定的 表达式
 *
 * <p>
 * pattern styles: "xxx*", "*xxx", "*xxx*" and "xxx*yyy"
 * </p>
 *
 * @param pattern 表达式
 * @param str     字符串
 * @return 是否匹配
 */
StringUtil.simpleMatch(String pattern, String str);

/**
 * 字符串是否符合指定的 表达式
 *
 * <p>
 * pattern styles: "xxx*", "*xxx", "*xxx*" and "xxx*yyy"
 * </p>
 *
 * @param patterns 表达式 数组
 * @param str      字符串
 * @return 是否匹配
 */
StringUtil.simpleMatch(String[] patterns, String str);

/**
 * 生成uuid，采用 jdk 9 的形式，优化性能
 *
 * @return UUID
 */
StringUtil.getUUID();

/**
 * 转义HTML用于安全过滤
 *
 * @param html html
 * @return {String}
 */
StringUtil.escapeHtml(String html);

/**
 * 清理字符串，清理出某些不可见字符和一些sql特殊字符
 *
 * @param txt 文本
 * @return {String}
 */
StringUtil.cleanText(String txt);

/**
 * 获取标识符，用于参数清理
 *
 * @param param 参数
 * @return 清理后的标识符
 */
StringUtil.cleanIdentifier(String param);

/**
 * 随机数生成
 *
 * @param count 字符长度
 * @return 随机数
 */
StringUtil.random(int count);

/**
 * 随机数生成
 *
 * @param count      字符长度
 * @param randomType 随机数类别
 * @return 随机数
 */
StringUtil.random(int count, RandomType randomType);