字符串操作 — Google Guava

前言

Java 里字符串表示字符的不可变序列,创建后就不能更改。在我们日常的工作中,字符串的使用非常频繁,熟练的对其操作可以极大的提升我们的工作效率,今天要介绍的主角是 Google 开源的一个核心 JavaGuava,它提供了集合类型、不可变的集合、并发、I / O、缓存、字符串等许多实用功能。在本文中,我们将学习使用 Guava 中的 StringsSplitter 字符串操作工具类。

如何使用

Google Guava 会同步到 Maven Central 中,所以,如果你是 Maven 项目的话只需要在 pom.xml 文件中引入如下依赖即可:

<dependency>
    <groupId>com.google.guava</groupId>
    <artifactId>guava</artifactId>
    <version>28.2-jre</version>
</dependency>

对于 Gradle 项目在 build.gradle 中引入如下依赖即可:

compile group: 'com.google.guava', name: 'guava', version: '28.2-jre'

PS:28.2-jre 是编写本文时的最新版本,你可以从 Maven Central 中查看当前的最新版本。

为什么需要引入类库

Google Guava 提供了很多实用的静态方法,这些可以解决开发人员在开发中所要完成的一些重复任务。当然,这个工作我们也可以自己做,但是引入类库它会降低错误发生的可能性,毕竟这些类库都是已经经过多年的生产验证。比如类库中 Strings 提供的一个方法 commonPrefix,它接受两个字符串并返回两个字符串之间的公共前缀(eg: abcdabef 返回 ab)。你可以在脑子里想象一下在应用程序代码中面临这样的要求时,自己要如何编写代码来完成该操作,要自己实现这个功能,还是需要花费一些时间的,同时还需要考虑到各种边界异常情况。这就是类库提供给我们的最大价值之一,所以当我们需要的某种功能可以作为一种工具方法使用时,首先应该去寻找一些已存在的类库并去熟练使用的它们,而不是自己去实现。总结起来使用类库有如下几个原因:

  1. Google Guava 类库有人已经对其进行了彻底的测试,bug 出现的概率会比我们自己实现的小很多
  2. 作为 Google Guava 的一部分,已经存在各种测试用例,用于测试实用程序的实现。如果我们自己编写代码实现的话,可能还要去编写和维护它们的测试。

Strings

Google Guava 有许多实用的工具类和方法,不可能在一篇文章中都有介绍完,在本文中,只会介绍和字符串操作相关的两个工具类。首先第一个是 Strings 类,该类提供了操作 StringCharSequence 的实用方法。

nullToEmpty、emptyToNull 和 isNullOrEmpty

nullToEmpty 方法功能为:如果传入的字符串为 null,则返回一个空字符串 "",否则,返回一个空字符串,否则按原样返回传递的字符串。

@Test
public void testStringsOfNullToEmpty() {
    System.out.println(Strings.nullToEmpty("mghio"));         // mghio
    System.out.println(Strings.nullToEmpty(""));              // ""
    System.out.println(Strings.nullToEmpty(null));            // ""
    System.out.println(Strings.nullToEmpty(null).isEmpty());  // true
}

emptyToNull 方法功能为:它与 nullToEmpty 相反,如果传入了空字符串,则返回 null,否则返回原始字符串。

@Test
public void testStringsOfEmptyToNull() {
    System.out.println(Strings.emptyToNull("mghio"));  // mghio
    System.out.println(Strings.emptyToNull(null));     // null
    System.out.println(Strings.emptyToNull(""));       // null
}

isNullOrEmpty 方法功能为:如果传入的字符串为 null 或为空,则返回 true,否则返回 false

@Test
public void testStringsOfIsNullOrEmpty() {
    System.out.println(Strings.isNullOrEmpty("mghio"));  // false
    System.out.println(Strings.isNullOrEmpty(""));       // true
    System.out.println(Strings.isNullOrEmpty(null));     // true
}
padStart 和 padEnd

这两个方法有三个参数,分别为:输入字符串、最小长度和要填充的字符,它将字符根据需要多次插入到输入字符串的开头,以使输入字符串的长度等于传入的最小长度。

@Test
public void testStringsOfPadStart() {
    System.out.println(Strings.padStart("9527", 6, '0'));    // 009527
    System.out.println(Strings.padStart("123456", 6, '0'));  // 123456
}

在第一行代码中,将两次填充 0 以使最终的字符串长度等于我们传入的最小长度(6)。在第二行代码中,输入字符串长度本身具有所需的最小长度,因此未进行填充padEnd 方法和上面这个方法类似,只不过它是在字符的末尾而不是在开始处进行填充。

@Test
public void testStringsOfPadEnd() {
    System.out.println(Strings.padEnd("9527", 6, '0'));    // 952700
    System.out.println(Strings.padEnd("123456", 6, '0'));  // 123456
}
repeat

该方法需要传入一个字符串和一个重复次数 count,它返回一个由原始字符串组成的字符串,该字符串重复了 count 次。

@Test
public void testStringsRepeat() {
    System.out.println(Strings.repeat("mghio", 3));  // mghiomghiomghio
}
commonPrefix 和 commonSuffix

commonPrefix 方法返回传入的两个字符串之间最大的公共前缀,而 commonSuffix 方法返回传入两个字符串之间最大的公共后缀。

@Test
public void testStrings() {
    System.out.println(Strings.commonPrefix("mghio9527", "mghio666"));  // mghio
    System.out.println(Strings.commonSuffix("iammghio", "nicemghio"));  // mghio
}

Splitter

Splitter 类提供的功能正如其名(PS:一个好的命名很重要),它用于根据提供的分割符将字符串拆分为多个子字符串。我们可以通过传入一个分割符来获一个 Splitter 的实例,有了分割器之后,我们可以根据分割器的配置方式对字符串进行分割。

@Test
public void testSplitterOfSplit() {
    Iterable<String> result = Splitter.on(",").split("m,g,h,i,o");
    System.out.println(result);  // [m, g, h, i, o]
}

上面的例子中使用逗号进行分割,因此,它将传入的字符串 m,g,h,i,o 拆分为一个 Iterable <String>,然后当我们对其进行迭代遍历时会输出 [m, g, h, i, o]

获取 Splitter 实例

on 和 onPattern

现在,我们来看看获得一个分割器 Splitter 的各种方法。on 方法有各种不同的重载版本,它们以字符、字符串或正则表达式作为分隔符,我们还可以将 Pattern 实例作为字符串传递给 onPattern 方法中。

@Test
public void testSplitterOfOn() {
    Splitter wordSplitter = Splitter.on(":;");
    // 下面这行输出结果 [the, text, is, separated, by, colon, semicolon]
    System.out.println(wordSplitter.split("the:;text:;is:;separated:;by:;colon:;semicolon"));
    Splitter patternBasedSplitter = Splitter.on(Pattern.compile("\\s+"));
    System.out.println(patternBasedSplitter.split("abc   dmg hio"));         // [abc, dmg, hio]
    System.out.println(Splitter.onPattern("\\s+").split("www   mghio cn"));  // [www, mghio, cn]
}
fixedLength

fixedLength 也是最有用的方法之一,它可以将字符串分成给定长度的相等部分,需要注意的是,最后一个部分可能会小于给定的长度。

@Test
public void testSplitterOfFixedLength() {
    Splitter fixedLengthSplitter = Splitter.fixedLength(3);
    System.out.println(fixedLengthSplitter.split("iammghiojava"));          // [iam, mgh, ioj, ava]
    System.out.println(fixedLengthSplitter.split("https://www.mghio.cn"));  // [htt, ps:, //w, ww., mgh, io., cn]
}

Splitter 修饰符方法

Splitter 还提供了可以在更改或修改 Splitter 行为的常用方法。

trimResults

这个方法可以从生成的分割器的结果字符串中删除前面和末尾的空格。

@Test
public void testSplitterOfTrimResult() {
    Splitter commaSplitter = Splitter.on(",");
    System.out.println(commaSplitter.split("m, g, h, i, o"));         // [m,  g,  h,  i,  o]
    Splitter commaSplitterWithTrim = commaSplitter.trimResults();
    System.out.println(commaSplitterWithTrim.split("m, g, h, i, o")); // [m, g, h, i, o]
}

注意,第一个分割的结果在字符串 ghio 之前有一个空格,使用 trimResults 方法后,将去除这些前导空格。

omitEmptyStrings

这个方法会从结果中忽略所有空字符串。

@Test
public void testSplitterOfOmitEmptyStrings() {
    Splitter commaSplitter = Splitter.on(",");
    System.out.println(commaSplitter.split("m,,g,h,i,o"));                   // [m, , g, h, i, o]
    Splitter commaSplitterWithNoEmptyString = commaSplitter.omitEmptyStrings();
    System.out.println(commaSplitterWithNoEmptyString.split("m,,g,h,i,o"));  // [m, g, h, i, o]
}

上面的 commaSplitterWithNoEmptyString 会从输出中删除空字符串的结果。

limit

这个方法返回与原始分割器等效的分割器,但它会在达到指定的输入限制后将停止拆分,将后续剩余结果字符串作为一项输出,也就是说,我们可以通过的传入的参数指定结果中存在的最大项目数。需要注意的是:该方法在省略空字符串时,省略的字符串不计算在内。

@Test
public void testSplitterOfLimit() {
    Splitter commaSplitter = Splitter.on(",");
    Splitter limitingCommaSplitter = commaSplitter.limit(3);
    System.out.println(limitingCommaSplitter.split("i,m,g,h,i,o"));  // [i, m, g,h,i,o]
}

有一点需要注意,Splitter 是不可变的(这一点和 String 类似),因此,调用它的任何修饰符方法都将返回新的 Splitter,并且不会修改原始的 Splitter

@Test
public void testSplitterImmutable() {
    Splitter splitter = Splitter.on('/');
    System.out.println("Before: " + splitter);  // Before: com.google.common.base.Splitter@33b37288
    splitter.trimResults();                     // do nothing
    System.out.println("First: " + splitter);   // First: com.google.common.base.Splitter@33b37288
    splitter = splitter.trimResults();          // the returned splitter to be assigned
    System.out.println("Second: " + splitter);  // Second: com.google.common.base.Splitter@77a57272
}
splitToList

我们前面已经使用的 split 方法,它返回的是一个 Iterable<String> 对象。而这里的 splitToList 方法返回一个 List<String>。由于分割方法返回的是 Iterable,因此它是惰性的。

@Test
public void testSplitterOfSplitToList() {
    Splitter commaSplitter = Splitter.on(",");
    List<String> result = commaSplitter.splitToList("m,g,h,i,o");
    System.out.println(result);  // [m, g, h, i, o]
}

MapSplitter

MapSplitter 顾名思义就是用来将一个将字符串拆分为 Map 对象的。我们可以使用 withKeyValueSeparator 方法从 Splitter 中获取 MapSplitter 对象,该方法接收一个字符、字符串或者 Splitter 对象作为参数。首先,根据原始的分割器将字符串分割为多个项,然后,使用传给 withKeyValueSeparator 方法的分割符将各个项分为 Map 键-值对。

@Test
public void testSplitterOfWithKeyValueSeparator() {
    Splitter commaSplitter = Splitter.on(',');
    Splitter.MapSplitter keyValueSplitter = commaSplitter.withKeyValueSeparator('=');
    Map<String, String> map = keyValueSplitter.split("name=mghio,blog=mghio.cn");
    System.out.println(map);  // {name=mghio, blog=mghio.cn}
}

从结果可以看到,它分割为两个 entryname=mghioblog=mghio.cn)项,还有一个点需要注意的是:如果我们在原始的分割器上指定了任何修改器,则它们仅适用于该分割器,而不适用于 MapSplitter

@Test
public void testSplitterOfWithKeyValueSeparatorAndModifiers() {
    Splitter originalSplitter = Splitter.on(",").trimResults();
    Splitter.MapSplitter keyValueSplitter = originalSplitter.withKeyValueSeparator('=');
    // 输出结果:{name  =mghio, blog=   mghio.cn}
    System.out.println(keyValueSplitter.split("name  =mghio,   blog=   mghio.cn"));  
}

由以上结果可以看出 trimResults 修饰方法仅适用于原始拆分器。因此,blog 开头的空格已被移除(使用 , 分割原始字符串时),但是,mghio.cn 开头的空格不会被移除(使用 = 分割成键值时)。

最后需要注意的是:MapSplitter 类被标记为 @Beta,这意味着类库中与 MapSplitter 相关的类和方法是实验性的,可以更改(以中断的方式),甚至将来版本可能删除。

总结

在本文中,介绍了 Google Guava 库以及在项目或应用程序中使用它的好处,如何将其导入到我们的应用程序中使用。然后,介绍了 Guava 库中对字符串操作工具类(StringsSplitter )的一些基本用法,当然,这只是冰山一角,Guava 库还提供了其它很多有用的基础功能,需要我们自己去查询相关文档学习了解,感兴趣的朋友可以去看看它的实现源码,这个库的代码写得很优雅。


参考

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 158,425评论 4 361
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 67,058评论 1 291
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 108,186评论 0 243
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 43,848评论 0 204
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,249评论 3 286
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,554评论 1 216
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,830评论 2 312
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,536评论 0 197
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,239评论 1 241
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,505评论 2 244
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,004评论 1 258
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,346评论 2 253
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 32,999评论 3 235
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,060评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,821评论 0 194
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,574评论 2 271
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,480评论 2 267

推荐阅读更多精彩内容