Гуава - объединение и разделение коллекций

1. обзор

В этом руководстве мы узнаем, как использоватьthe Joiner and Splitter in the Guava library. Мы преобразуем коллекции в String сJoiner и разделим String на коллекцию сSplitter.

2. ПреобразоватьList вString с помощьюJoiner

Давайте начнем с простого примера, чтобы присоединитьList кString с помощьюJoiner. В следующем примере мы объединяемList имен в одинString, используя запятую «,» в качестве разделителя:

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

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

3. ПреобразоватьMap вString с помощьюJoiner

Далее - давайте посмотрим, как использоватьJoiner для преобразованияMap вString. В следующем примере мы используемwithKeyValueSeparator() для соединения ключа с его значением:

@Test
public void whenConvertMapToString_thenConverted() {
    Map 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. Присоединяйтесь к вложенным коллекциям

А теперь давайте посмотрим, как объединить вложенные коллекции вString. В следующем примере мы объединяем результат преобразования каждогоList вString:

@Test
public void whenJoinNestedCollections_thenJoined() {
    List> 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, String>() {
          @Override
          public String apply(List input) {
              return Joiner.on("-").join(input);
          }
      }));

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

5. Обработка нулевых значений при использованииJoiner

Теперь - давайте посмотрим, как можно обрабатывать нулевые значения при использовании объединения.

Дляskip null values при присоединении к коллекции используйтеskipNulls(), как в следующем примере:

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

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

Если вы не хотите пропускать нулевые значения и хотите использоватьreplace them instead, используйтеuseForNull(), как в следующем примере:

@Test
public void whenUseForNull_thenUsed() {
    List 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. СоздайтеList изString, используяSplitter

А теперь давайте посмотрим, как разделитьString наList. В следующем примере мы используем разделитель «-», чтобы разделить вводString наList:

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

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

Обратите внимание, чтоtrimResults() удаляет начальные и конечные пробелы из результирующих подстрок.

7. СоздайтеMap изString, используяSplitter

Далее - давайте посмотрим, как создать карту из строки с помощью Splitter. В следующем примере мы используемwithKeyValueSeparator(), чтобы разделитьString наMap:

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

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

**8. РазделитьString с несколькими разделителями**

А теперь давайте посмотрим, как разделитьString с помощью нескольких разделителей. В следующем примере мы используем оба «.» и «,», чтобы разделить нашString:

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

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

Обратите внимание, чтоomitEmptyStrings() игнорирует пустые строки и не добавляет их к результирующемуList.

9. Разделить aString на определенную длину

Далее - давайте посмотрим, как разделитьString на определенную длину. В следующем примере мы разделяем нашString каждые 3 символа:

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

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

10. Ограничьте результат разделения

Наконец, давайте посмотрим, как ограничить результат разделения. Если вы хотите, чтобыSplitter былоstop splitting after specific number of items - используйтеlimit(), как в следующем примере:

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

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

11. Заключение

В этом руководстве мы показали, как использовать какJoiner, так иSplitter в Guava для выполнения различных преобразований между коллекциями и строками.

Реализация всех этих примеров и фрагментов кодаcan be found in my Guava github project - это проект на основе Eclipse, поэтому его должно быть легко импортировать и запускать как есть.

TOC

Гуава - объединение и разделение коллекций