Автор оригинала: Eugen Paraschiv.
1. Обзор
В этом уроке мы проиллюстрируем, как фильтровать и преобразовывать коллекции с помощью Guava .
Мы будем фильтровать с помощью предикатов , преобразовывать с помощью функций, предоставляемых библиотекой, и, наконец, мы увидим, как сочетать фильтрацию и преобразование.
Дальнейшее чтение:
Новый поток, Компаратор и коллектор в Гуаве 21
Путеводитель по Гуаве Multimap
Руководство по набору ассортимента Гуавы
2. Отфильтруйте коллекцию
Давайте начнем с простого примера фильтрации коллекции . Мы будем использовать готовый предикат, предоставленный библиотекой и созданный с помощью Предикатов служебного класса:
@Test public void whenFilterWithIterables_thenFiltered() { Listnames = Lists.newArrayList("John", "Jane", "Adam", "Tom"); Iterable result = Iterables.filter(names, Predicates.containsPattern("a")); assertThat(result, containsInAnyOrder("Jane", "Adam")); }
Как вы можете видеть, мы фильтруем Список имен, чтобы получить только имена, содержащие символ “а”, – и мы используем Iterables.filter() для этого.
В качестве альтернативы мы также можем эффективно использовать Collections2.filter() API:
@Test public void whenFilterWithCollections2_thenFiltered() { Listnames = Lists.newArrayList("John", "Jane", "Adam", "Tom"); Collection result = Collections2.filter(names, Predicates.containsPattern("a")); assertEquals(2, result.size()); assertThat(result, containsInAnyOrder("Jane", "Adam")); result.add("anna"); assertEquals(5, names.size()); }
Здесь следует отметить несколько вещей – во – первых, вывод Collections.filter() является живым представлением исходной коллекции – изменения в одной будут отражены в другой.
Также важно понимать, что теперь результат ограничен предикатом – если мы добавим элемент , который не удовлетворяет этому Предикату , будет выдано исключение IllegalArgumentException :
@Test(expected = IllegalArgumentException.class) public void givenFilteredCollection_whenAddingInvalidElement_thenException() { Listnames = Lists.newArrayList("John", "Jane", "Adam", "Tom"); Collection result = Collections2.filter(names, Predicates.containsPattern("a")); result.add("elvis"); }
3. Напишите Пользовательский Предикат Фильтра
Далее – давайте напишем наш собственный Предикат вместо использования предиката, предоставленного библиотекой. В следующем примере мы определим предикат, который получает только имена, начинающиеся с “A” или “J”:
@Test public void whenFilterCollectionWithCustomPredicate_thenFiltered() { Predicatepredicate = new Predicate () { @Override public boolean apply(String input) { return input.startsWith("A") || input.startsWith("J"); } }; List names = Lists.newArrayList("John", "Jane", "Adam", "Tom"); Collection result = Collections2.filter(names, predicate); assertEquals(3, result.size()); assertThat(result, containsInAnyOrder("John", "Jane", "Adam")); }
4. Объедините Несколько Предикатов
Мы можем объединить несколько Предикатов, используя Предикаты.или() и Предикаты.и() .
В следующем примере – мы фильтруем Список
имен, чтобы получить имена, которые начинаются с “J” или не содержат “a”:
@Test public void whenFilterUsingMultiplePredicates_thenFiltered() { Listnames = Lists.newArrayList("John", "Jane", "Adam", "Tom"); Collection result = Collections2.filter(names, Predicates.or(Predicates.containsPattern("J"), Predicates.not(Predicates.containsPattern("a")))); assertEquals(3, result.size()); assertThat(result, containsInAnyOrder("John", "Jane", "Tom")); }
5. Удалите нулевые значения При фильтрации коллекции
Мы можем очистить значения null из коллекции, отфильтровав ее с помощью Предикатов.NotNull() как в следующем примере:
@Test public void whenRemoveNullFromCollection_thenRemoved() { Listnames = Lists.newArrayList("John", null, "Jane", null, "Adam", "Tom"); Collection result = Collections2.filter(names, Predicates.notNull()); assertEquals(4, result.size()); assertThat(result, containsInAnyOrder("John", "Jane", "Adam", "Tom")); }
6. Проверьте, Соответствуют ли все элементы в коллекции Условию
Далее давайте проверим, соответствуют ли все элементы в коллекции определенному условию. Мы будем использовать Iterables.all () , чтобы проверить, содержат ли все имена “n” или “m”, затем мы проверим, содержат ли все элементы “a”:
@Test public void whenCheckingIfAllElementsMatchACondition_thenCorrect() { Listnames = Lists.newArrayList("John", "Jane", "Adam", "Tom"); boolean result = Iterables.all(names, Predicates.containsPattern("n|m")); assertTrue(result); result = Iterables.all(names, Predicates.containsPattern("a")); assertFalse(result); }
7. Преобразуйте коллекцию
Теперь – давайте посмотрим, как преобразовать коллекцию с помощью функции Guava |/. В следующем примере – мы преобразуем Список имен в Список Целых чисел (длина имени) с помощью Iterables.transform() :
@Test public void whenTransformWithIterables_thenTransformed() { Functionfunction = new Function () { @Override public Integer apply(String input) { return input.length(); } }; List names = Lists.newArrayList("John", "Jane", "Adam", "Tom"); Iterable result = Iterables.transform(names, function); assertThat(result, contains(4, 4, 4, 3)); }
Мы также можем использовать Collections2.transform() API, как в следующем примере:
@Test public void whenTransformWithCollections2_thenTransformed() { Functionfunc = new Function (){ @Override public Integer apply(String input) { return input.length(); } }; List names = Lists.newArrayList("John", "Jane", "Adam", "Tom"); Collection result = Collections2.transform(names, func); assertEquals(4, result.size()); assertThat(result, contains(4, 4, 4, 3)); result.remove(3); assertEquals(3, names.size()); }
Обратите внимание, что вывод Collections.transform() является живым представлением оригинала Коллекции – изменения в одном влияют на другое.
И – как и раньше – если мы попытаемся добавить элемент в выходную Коллекцию , будет выдано исключение UnsupportedOperationException .
8. Создайте функцию из предиката
Мы также можем создать Функцию из Предиката , используя Функции.из предиката() . Это, конечно, будет функция , которая преобразует входные данные в Логическое значение в соответствии с условием предиката.
В следующем примере мы преобразуем Список имен в список логических значений, где каждый элемент представляет, содержит ли имя “m”:
@Test public void whenCreatingAFunctionFromAPredicate_thenCorrect() { Listnames = Lists.newArrayList("John", "Jane", "Adam", "Tom"); Collection result = Collections2.transform(names, Functions.forPredicate(Predicates.containsPattern("m"))); assertEquals(4, result.size()); assertThat(result, contains(false, false, true, true)); }
9. Состав из двух функций
Далее – давайте рассмотрим, как преобразовать коллекцию с помощью составленной функции .
Functions.compose() возвращает состав двух функций при применении второй Функции на выходе первой Функции .
В следующем примере – первая Функция преобразует имя в его длину, затем вторая Функция преобразует длину в логическое значение, которое представляет, четна ли длина имени:
@Test public void whenTransformingUsingComposedFunction_thenTransformed() { Functionf1 = new Function (){ @Override public Integer apply(String input) { return input.length(); } }; Function f2 = new Function (){ @Override public Boolean apply(Integer input) { return input % 2 == 0; } }; List names = Lists.newArrayList("John", "Jane", "Adam", "Tom"); Collection result = Collections2.transform(names, Functions.compose(f2, f1)); assertEquals(4, result.size()); assertThat(result, contains(true, true, true, false)); }
10. Комбинируйте фильтрацию и преобразование
А теперь – давайте посмотрим еще один классный API, который есть у Guava, – тот, который фактически позволит нам объединять фильтрацию и преобразование в цепочку – FluentIterable .
В следующем примере – мы фильтруем Список имен, а затем преобразуем его с помощью FluentIterable :
@Test public void whenFilteringAndTransformingCollection_thenCorrect() { Predicatepredicate = new Predicate () { @Override public boolean apply(String input) { return input.startsWith("A") || input.startsWith("T"); } }; Function func = new Function (){ @Override public Integer apply(String input) { return input.length(); } }; List names = Lists.newArrayList("John", "Jane", "Adam", "Tom"); Collection result = FluentIterable.from(names) .filter(predicate) .transform(func) .toList(); assertEquals(2, result.size()); assertThat(result, containsInAnyOrder(4, 3)); }
Стоит отметить, что в некоторых случаях императивная версия более удобочитаема и должна быть предпочтительнее функционального подхода.
11. Заключение
Наконец, мы узнали, как фильтровать и преобразовывать коллекции с помощью Guava. Мы использовали Collections2.filter() и Iterables.filter() API для фильтрации, а также Collections2.transform() и Iterables.transform() для преобразования коллекций.
Наконец, мы быстро взглянули на очень интересный FluentIterable fluent API для объединения фильтрации и преобразования.
Реализацию всех этих примеров и фрагментов кода можно найти в проекте GitHub – это проект на основе Maven, поэтому его должно быть легко импортировать и запускать как есть.