Guava – Join 和 Split 集合

1. 概述

在本教程中，我们将学习如何使用 Guava 库中的 Joiner 和 Splitter。我们将使用 Joiner 将集合转换为字符串，并使用 Splitter 将字符串拆分为集合。

2. 使用Joiner将List转换为String

让我们从一个简单的示例开始，使用 Joiner 将 List 连接到 String。在下面的示例中，我们使用逗号“,”作为分隔符将一个 List 名称连接到一个 String 中：

@Test
public void whenConvertListToString_thenConverted() {
    List<String> names = Lists.newArrayList("John", "Jane", "Adam", "Tom");
    String result = Joiner.on(",").join(names);

    assertEquals(result, "John,Jane,Adam,Tom");
}

3. 使用Joiner将Map转换为String

接下来 – 让我们看看如何使用Joiner将Map转换为String。在下面的示例中，我们使用 withKeyValueSeparator() 将键与其值连接起来：

@Test
public void whenConvertMapToString_thenConverted() {
    Map<String, Integer> salary = Maps.newHashMap();
    salary.put("John", 1000);
    salary.put("Jane", 1500);
    String result = Joiner.on(" , ").withKeyValueSeparator(" = ")
                                    .join(salary);

    assertThat(result, containsString("John = 1000"));
    assertThat(result, containsString("Jane = 1500"));
}

4.加入嵌套集合

现在 – 让我们看看如何将嵌套集合连接到字符串中。在下面的示例中，我们将每个 List 转换为 String 的结果连接起来：

@Test
public void whenJoinNestedCollections_thenJoined() {
    List<ArrayList<String>> nested = Lists.newArrayList(
      Lists.newArrayList("apple", "banana", "orange"),
      Lists.newArrayList("cat", "dog", "bird"),
      Lists.newArrayList("John", "Jane", "Adam"));
    String result = Joiner.on(";").join(Iterables.transform(nested,
      new Function<List<String>, String>() {
          @Override
          public String apply(List<String> input) {
              return Joiner.on("-").join(input);
          }
      }));

    assertThat(result, containsString("apple-banana-orange"));
    assertThat(result, containsString("cat-dog-bird"));
    assertThat(result, containsString("John-Jane-Adam"));
}

5. 使用 Joiner 时处理空值

现在 – 让我们看看使用 Joiner 时处理空值的不同方法。

要在加入集合时跳过空值，请使用skipNulls()，如下例所示：

@Test
public void whenConvertListToStringAndSkipNull_thenConverted() {
    List<String> names = Lists.newArrayList("John", null, "Jane", "Adam", "Tom");
    String result = Joiner.on(",").skipNulls().join(names);

    assertEquals(result, "John,Jane,Adam,Tom");
}

如果您不想跳过 null 值并希望替换它们，请使用 useForNull()，如下例所示：

@Test
public void whenUseForNull_thenUsed() {
    List<String> names = Lists.newArrayList("John", null, "Jane", "Adam", "Tom");
    String result = Joiner.on(",").useForNull("nameless").join(names);

    assertEquals(result, "John,nameless,Jane,Adam,Tom");
}

请注意，useForNull() 不会更改原始列表，它只会影响连接的输出。

6. 使用Splitter从字符串创建列表

现在 – 让我们看看如何将字符串拆分为列表。在下面的示例中，我们使用“-”分隔符将输入的String拆分为List：

@Test
public void whenCreateListFromString_thenCreated() {
    String input = "apple - banana - orange";
    List<String> result = Splitter.on("-").trimResults()
                                          .splitToList(input);

    assertThat(result, contains("apple", "banana", "orange"));
}

请注意，trimResults() 会从结果子字符串中删除前导和尾随空格。

7. 使用Splitter从字符串创建Map

接下来 – 让我们看看如何使用 Splitter 从字符串创建Map。在以下示例中，我们使用 withKeyValueSeparator() 将 String 拆分为 Map：

@Test
public void whenCreateMapFromString_thenCreated() {
    String input = "John=first,Adam=second";
    Map<String, String> result = Splitter.on(",")
                                         .withKeyValueSeparator("=")
                                         .split(input);

    assertEquals("first", result.get("John"));
    assertEquals("second", result.get("Adam"));
}

8. 使用多个分隔符分割字符串

现在 – 让我们看看如何使用多个分隔符分割字符串。在下面的示例中，我们同时使用“.”和“,”来分割我们的字符串：

@Test
public void whenSplitStringOnMultipleSeparator_thenSplit() {
    String input = "apple.banana,,orange,,.";
    List<String> result = Splitter.onPattern("[.,]")
                                  .omitEmptyStrings()
                                  .splitToList(input);

    assertThat(result, contains("apple", "banana", "orange"));
}

请注意，omitEmptyStrings() 会忽略空字符串，并且不会将它们添加到结果 List 中。

9. 以特定长度分割字符串

接下来 – 让我们看一下如何以特定长度分割字符串。在下面的示例中，我们每 3 个字符分割 String：

@Test
public void whenSplitStringOnSpecificLength_thenSplit() {
    String input = "Hello world";
    List<String> result = Splitter.fixedLength(3).splitToList(input);

    assertThat(result, contains("Hel", "lo ", "wor", "ld"));
}

10. 限制分割结果

最后 – 让我们看看如何限制分割结果。如果您希望拆分器在特定数量的项目后停止拆分 - 请使用limit()，如下例所示：

@Test
public void whenLimitSplitting_thenLimited() {
    String input = "a,b,c,d,e";
    List<String> result = Splitter.on(",")
                                  .limit(4)
                                  .splitToList(input);

    assertEquals(4, result.size());
    assertThat(result, contains("a", "b", "c", "d,e"));
}

11. 结论

在本教程中，我们演示了如何使用 Guava 中的Joiner和Splitter在集合和字符串之间进行各种转换。

所有这些示例和代码片段的实现可以在 我的 Guava github 项目 – 这是一个基于 Eclipse 的项目，所以应该很容易导入并按原样运行。