commons-lang3之StringUtils
字符串是一种在开发中经常使用到的数据类型，对字符串的处理也变得非常重要，字符串本身有一些方法，但都没有对null做处理，而且有时可能还需要做一些额外处理才能满足我们的需求，比如，要判断某个字符串中是否包含字符串a或者字符串ax，使用自带的字符串方法，我们可能要这么写
boolean isContains = false; String s = "abc"; if(s != null) { if(s.contains("a") || s.contains("ax")) { isContains = true; } }
使用commons-lang3工具包，就只需要一行代码就可以，其他内容已经被封装好，并且已经对null做了处理，StringUtils类中大部分的方法都对null做了处理，所以不会出现空指针异常
boolean flag = StringUtils.containsAny("abc", new String[] {"a","ax"});
但即便如此，对于第三方jar包，也建议不要直接使用，最好自己封装一下，使用时调用自己封装的接口，这样，以后如果方法有变动，或者使用其他的jar包，也不需要每个调用都做修改，只需要修改自己封装的接口即可。不要使用已过期的方法
maven依赖如：https://www.cnblogs.com/qq931399960/p/10689571.html中所示，可以简单先看下这个类中的方法，有个印象，在对字符串做处理时，再去源码中查看具体的使用方式，每个方法在注释中都有详细的例子，使用起来很方便，比如上述containsAny方法
/** * <p>Checks if the CharSequence contains any of the CharSequences in the given array.</p> * * <p> * A {@code null} {@code cs} CharSequence will return {@code false}. A {@code null} or zero * length search array will return {@code false}. * </p> * * <pre> * StringUtils.containsAny(null, *) = false * StringUtils.containsAny("", *) = false * StringUtils.containsAny(*, null) = false * StringUtils.containsAny(*, []) = false * StringUtils.containsAny("abcd", "ab", null) = true * StringUtils.containsAny("abcd", "ab", "cd") = true * StringUtils.containsAny("abc", "d", "abc") = true * </pre> * * * @param cs The CharSequence to check, may be null * @param searchCharSequences The array of CharSequences to search for, may be null. * Individual CharSequences may be null as well. * @return {@code true} if any of the search CharSequences are found, {@code false} otherwise * @since 3.4 */ public static boolean containsAny(final CharSequence cs, final CharSequence... searchCharSequences) { if (isEmpty(cs) || ArrayUtils.isEmpty(searchCharSequences)) { return false; } for (final CharSequence searchCharSequence : searchCharSequences) { if (contains(cs, searchCharSequence)) { return true; } } return false; }
下面是对StringUtils的一些简单测试
// true,为null或者size==0，返回true boolean empty = StringUtils.isEmpty(""); // false,与isEmpty相反 boolean notEmpty = StringUtils.isNotEmpty(""); // true,数组中有一个为null或size==0的字符串，则返回true boolean anyEmpty = StringUtils.isAnyEmpty(new String[] { "aa", "" }); // false,全部都不为空，返回true boolean noneEmpty = StringUtils.isNoneEmpty(new String[] { "", "aa" }); // true,全部为空，返回true boolean allEmpty = StringUtils.isAllEmpty(new String[] { "", "" }); // true,为null或者size==0或者只存在空白字符(如" ")，则返回true boolean blank = StringUtils.isBlank(" "); // false,与isBlank相反 boolean notBlank = StringUtils.isNotBlank(" "); // true,数组中任何一个为null或者空字符串或者空白字符，则返回true boolean anyBlank = StringUtils.isAnyBlank(new String[] { "dd", " " }); // false,与isAnyBlank 相反 boolean noneBlank = StringUtils.isNoneBlank(new String[] { "dd", "" }); // true,数组中的数据全部为null，或者空字符串或者空白字符，则返回true boolean allBlank = StringUtils.isAllBlank(new String[] { "", " " }); // dd,去掉前后字符，为null,返回null String trim = StringUtils.trim(" dd "); // "",为null或者size==0，则返回空字符串 String trimToEmpty = StringUtils.trimToEmpty(" "); // null,为null或者size==0，则返回null String trimToNull = StringUtils.trimToNull(" "); // abc,截取字符串 String truncate = StringUtils.truncate("abcde", 3); // cdefg,从第二个起，截取5个长度 String truncate = StringUtils.truncate("abcdefghl", 2, 5); // ddds与trim类似 String strip = StringUtils.strip(" dd d s "); // yes, it is,去掉指定的开头字符和结尾字符,第二个字符为dd或者da也会有同样输出 String strip = StringUtils.strip("ddyes, it is ddd", "d"); // yes, it is ddd String stripStart = StringUtils.stripStart("ddyes, it is ddd", "d"); // ddyes, it is String stripEnd = StringUtils.stripEnd("ddyes, it is ddd", "d"); // [it is, dd],去掉参数中所有元素的前后空格 String[] stripAll = StringUtils.stripAll(" it is ", " dd "); // [it is , it],去掉数组中每个元素前后的指定字符 String[] stripAll = StringUtils.stripAll(new String[] { "ddit is d", "ditd" }, "d"); // false boolean equals = StringUtils.equals(null, ""); // true boolean equalsIgnoreCase = StringUtils.equalsIgnoreCase("abc", "ABC"); // [,ab,cde, dsd,] 2个元素,默认分隔符为空白字符 String[] split = StringUtils.split(",ab,cde dsd,"); // [ab, cde , dsd] 3个元素，去掉了为空的元素，空白字符组成的字符串会保留 String[] split = StringUtils.split(",ab,cde ,,dsd,", ","); // [ab, cde, dsd] 3个元素，以,和空白字符分隔，第二个参数中每个字符都当成一个分隔符，与上一个方法比，放方法第二个元素后没有空白字符 String[] split = StringUtils.split(",ab,cde ,,dsd,", ", "); // [ab, cde ,,dsd,] 2个元素，由于最大只允许2个 String[] split = StringUtils.split(",ab,cde ,,dsd,", ", ", 2); // [,ab,cde , ,dsd,] 2个元素，第二个参数所有字符当成一个整体的分隔符 String[] splitByWholeSeparator = StringUtils.splitByWholeSeparator(",ab,cde , ,dsd,", ", "); // [, dd, ]，3个元素，两个空的 String[] splitPreserveAllTokens = StringUtils.splitPreserveAllTokens(" dd "); // [, aa, , ],4个元素，3个空的 String[] splitPreserveAllTokens = StringUtils.splitPreserveAllTokens(",aa,,", ","); // [, aa, , bb, ] 5个元素，以,或者空白字符分隔 String[] splitPreserveAllTokens = StringUtils.splitPreserveAllTokens(",aa, bb,", ", "); // [,aa, bb,] 2个，以, 作为一个整体分隔 String[] splitByWholeSeparatorPreserveAllTokens = StringUtils.splitByWholeSeparatorPreserveAllTokens(",aa, bb,", ", "); // [ABC, 123, abc, ;,., I, t] 6个元素 String[] splitByCharacterType = StringUtils.splitByCharacterType("ABC123abc;,.It"); String join = StringUtils.join("12", "a", "df", "3"); // 12adf3 List<String> ls = new ArrayList<>(); ls.add("aa"); ls.add("bb"); ls.add("cc"); // insert into table values ('aa','bb','cc');,在组织'aa','bb','cc' String join = "'" + StringUtils.join(ls, "','") + "'"; // abc String deleteWhitespace = StringUtils.deleteWhitespace(" a b c "); // abc is it String remove = StringUtils.remove("abcdd is dddit", "d"); // dit isdd，只删除第一个参数起始处中对应的第二个参数。 String removeStart = StringUtils.removeStart("ddit isdd", "d"); // ddit isd, 只删除第一个参数结束处中对应的第二个参数。 String removeEnd = StringUtils.removeEnd("ddit isdd", "d"); // it is String removeIgnoreCase = StringUtils.removeIgnoreCase("ddit isdd", "D"); // rdit // isdd,虽然replace的功能已经包含有replaceOne，但如果确定只有一个需要替换，最好还是使用replaceOne，因为这个找到一个替换后就会停止查找 String replaceOnce = StringUtils.replaceOnce("ddit isdd", "d", "r"); // rdit isdd String replaceOnceIgnoreCase = StringUtils.replaceOnceIgnoreCase("ddit isdd", "D", "r"); // rrit isrr String replace = StringUtils.replace("ddit isdd", "d", "r"); // rrit isrr String replaceIgnoreCase = StringUtils.replaceIgnoreCase("ddit isdd", "D", "r"); // rris isrr,批量替换 String replaceEach = StringUtils.replaceEach("ddit isdd", new String[] { "d", "t" }, new String[] { "r", "s" }); // tcte String replaceEachRepeatedly = StringUtils.replaceEachRepeatedly("abcde", new String[] { "ab", "d" }, new String[] { "d", "t" }); // aaaaaa 将第一个参数重复第二个参数次，形成一个新的字符串 String repeat = StringUtils.repeat("aa", 3); // aa,aa,aa 将第一个参数重复第三个参数次，并且以第二个参数分隔，形成一个新的字符串 String repeat = StringUtils.repeat("aa", ",", 3); // ab，在左侧填充两个空白字符，形成一个4个字符的字符串， String leftPad = StringUtils.leftPad("ab", 4); // ab ，在两边填充空白字符，形成一个以第一个参数为中心的4个字符串长度字符串 String center = StringUtils.center("ab", 4); // true,正整数返回true boolean numeric = StringUtils.isNumeric("123"); // true 正整数，且包含有空白字符或者空字符串，空白字符，返回true boolean numericSpace = StringUtils.isNumericSpace("12 3"); // 5417543010，获取字符串中的数字，并拼接在一起 String digits = StringUtils.getDigits("(541) 754-3010"); // true,字符串size==0或者空白字符，返回true，null及其他字符返回false boolean whitespace = StringUtils.isWhitespace(" "); // abcdefg...，显示指定长度的字符串，多余的使用... String abbreviate = StringUtils.abbreviate("abcdefghijklmnopq", 10); // abcdefg*** String abbreviate = StringUtils.abbreviate("abcdefghijklmnopq", "***", 10); // abcd***opq String abbreviateMiddle = StringUtils.abbreviateMiddle("abcdefghijklmnopq", "***", 10); // a，获取数组共所有元素相同的前缀 String commonPrefix = StringUtils.getCommonPrefix("abcdf", "ads", "arf"); // true, endsWith同理 boolean startsWith = StringUtils.startsWith("abcdef", "ab"); // true，endsWithIgnoreCase同理 boolean startsWithIgnoreCase = StringUtils.startsWithIgnoreCase("abcdefg", "aB"); // true,第一个参数的前缀匹配第二个数组参数中的任何一个元素时，返回true，endsWithAny同理 boolean startsWithAny = StringUtils.startsWithAny("abcdef", new String[] { "x", "ab", " " }); // abcxyzddd,如果出第一个参数的后缀包含在后面参数中，则直接返回第一个参数，否则将返回第一个参数+第二个参数 String appendIfMissing = StringUtils.appendIfMissing("abcxyz", "ddd", new String[] { "qwe", "123" }); // dddabcxyz,原理同上 String prependIfMissing = StringUtils.prependIfMissing("abcxyz", "ddd", new String[] { "qwe", "123" }); // cbd String encodedString = StringUtils.toEncodedString(new byte[] { 'c', 'b', 'd' }, Charset.defaultCharset()); // "xxx" String wrap = StringUtils.wrap("xxx", "\""); // *xx* String wrapIfMissing = StringUtils.wrapIfMissing("xx", "*"); // 前后必须有相同字符才可以unwrap String unwrap = StringUtils.unwrap("'aa'", "'"); // {97,98,99} int[] codePoints = StringUtils.toCodePoints("abc"); // abc，删除最后一个字符，如果是\r\n则一起删除 String chop = StringUtils.chop("abc\r\n"); // abc,如果最后存在换行符，则删除最后的换行符 String chomp = StringUtils.chomp("abc\r\n"); // true boolean contains = StringUtils.contains("abcd", "ab"); // true boolean containsAny = StringUtils.containsAny("abcdefg", "2", "a"); // false boolean containsOnly = StringUtils.containsOnly("abcdefg", "aa"); // true boolean containsIgnoreCase = StringUtils.containsIgnoreCase("abcdef", "aB"); // false boolean containsNone = StringUtils.containsNone("abcdef", 'a', 'x'); // true boolean containsWhitespace = StringUtils.containsWhitespace("aa bbc"); // 此外还有substring，indexof等方法
