1. Обзор
В этом уроке мы узнаем, как использовать Joiner и Splitter в библиотеке Guava . Мы преобразуем коллекции в String с помощью Joiner и разделим String на коллекцию с помощью Splitter .
2. Преобразование списка в строку с помощью Joiner
Давайте начнем с простого примера объединения списка в строку с помощью Joiner . В следующем примере мы объединяем список имен в одну строку , используя запятую «,» в качестве разделителя:
@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
Далее — давайте посмотрим, как использовать Joiner для преобразования карты в строку . В следующем примере мы используем 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. Присоединяйтесь к вложенным коллекциям
Теперь давайте посмотрим, как объединить вложенные коллекции в 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("apple-banana-orange"));
}
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");
}
Если вы не хотите пропускать пустые значения и вместо этого хотите заменить их , используйте 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. Создать список из строки с помощью разделителя
Теперь давайте посмотрим, как разбить строку на список . В следующем примере мы используем разделитель «-», чтобы разделить входную строку на список :
@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. Создать карту из строки с помощью сплиттера
Далее — давайте посмотрим, как создать карту из строки с помощью разделителя. В следующем примере мы используем withKeyValueSeparator() для разделения строки на карту :
@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() игнорирует пустые строки и не добавляет их в результирующий список .
9. Разделить строку определенной длины
Далее — давайте посмотрим на разделение строки определенной длины. В следующем примере мы разделяем нашу строку каждые 3 символа:
@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. Ограничьте результат разделения
Наконец, давайте посмотрим, как ограничить результат разделения. Если вы хотите, чтобы Splitter прекратил разделение после определенного количества элементов, используйте 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. Заключение
В этом уроке мы показали, как использовать как Joiner , так и Splitter в Guava для выполнения различных преобразований между коллекциями и строками.
Реализацию всех этих примеров и фрагментов кода можно найти в моем проекте Guava на github — это проект на основе Eclipse, поэтому его легко импортировать и запускать как есть.