Java filter() w praktyce - od filtra do operacji końcowej

15 listopada 2026

Metalowa obudowa z logo AKSFILTER, producenta filtrów powietrza. Idealne rozwiązanie do filtrowania strumienia powietrza.

Lista zamówień zawiera rekordy, których nie chcesz pokazać na ekranie, więc filtrujesz ją przed wyświetleniem. W Javie zrobisz to metodą filter(), która przepuszcza elementy spełniające warunek, choć wynik zobaczysz dopiero po wykonaniu operacji końcowej.

Schemat potoku Java: źródło, java stream filter, map, distinct, sortowanie, collect. Wynik: [93, 80, 68].

Filtruj warunkiem, a wynik odbierz operacją końcową

  • filter() przyjmuje warunek typu Predicate i zostawia pasujące elementy.
  • Operacja pośrednia nie uruchamia przetwarzania, dopóki potok nie zostanie użyty.
  • findFirst() i anyMatch() mogą zakończyć pracę wcześniej, gdy wynik jest już znany.
  • Warunek powinien być bez efektów ubocznych, szczególnie gdy strumień działa równolegle.

filter() przepuszcza tylko elementy spełniające warunek

Masz listę zamówień i chcesz wyświetlić wyłącznie te opłacone? Przekaż do filter() funkcję, która dla każdego elementu zwraca true albo false. Pierwsza wartość oznacza „zostaw”, druga „pomiń”.

List paidOrders = orders.stream()
    .filter(Order::isPaid)
    .toList();

Order::isPaid to referencja do metody, która sprawdza stan zamówienia. Ten zapis działa wtedy, gdy metoda pasuje typem do predykatu; równoważny wariant z lambdą wygląda tak: .filter(order -> order.isPaid()). Uważam, że referencja jest czytelniejsza, jeśli warunek ma już własną, dobrze nazwaną metodę.

Metoda filter(Predicate) zwraca kolejny strumień, a nie od razu listę. Tak opisuje ją dokumentacja Stream w Java SE 26; zebraniem wyniku do listy zajmuje się tutaj toList().

Potok zaczyna działać dopiero przy operacji końcowej

Wywołanie samego filter() nie przegląda jeszcze elementów. Tworzy etap potoku, który zacznie pracować, gdy pojawi się operacja końcowa, na przykład toList(), count() albo findFirst().

Stream paidStream = orders.stream()
    .filter(Order::isPaid);

// Dopiero operacja końcowa uruchamia przetwarzanie
List paidOrders = paidStream.toList();

To wyjaśnia częsty błąd: samo przypisanie wyniku filtrowania do zmiennej nie tworzy przefiltrowanej kolekcji. Strumień jest też jednorazowy. Po wykonaniu operacji końcowej nie użyjesz go ponownie, więc przy kolejnym przetwarzaniu pobierz nowy strumień ze źródła.

Jest jeszcze pułapka diagnostyczna. Jeśli strumień nie ma operacji końcowej, ustawione w warunku logowanie również się nie wykona; log pokaże przebieg dopiero podczas terminalnej operacji, a operacje skracające potok mogą ominąć część elementów. Dokumentacja pakietu java.util.stream opisuje operacje pośrednie jako leniwe, co ma praktyczny skutek właśnie tutaj.

Kolejność filtrów dobierz do kosztu warunków

Gdy kilka warunków sprawdza to samo, ich kolejność może ograniczyć liczbę kosztownych wywołań. Jeśli pierwszy warunek szybko odrzuca część elementów, drugi nie musi być dla nich obliczany.

orders.stream()
    .filter(Order::isPaid)
    .filter(order -> inventoryService.isAvailable(order))
    .toList();

W tym przykładzie najpierw sprawdzany jest prosty stan zamówienia, a dopiero później dostępność, która może wymagać droższej operacji. Reguła jest prosta: ustaw wcześniej warunek tani i selektywny, jeśli nie zmienia to znaczenia wyniku. Jeśli dopiero przekształcenie przez map() tworzy wartość potrzebną do filtrowania, kolejność musi wynikać z logiki danych, nie z domysłów o szybkości.

Nie traktuj kolejności jako gwarantowanego przyspieszenia. Wynik zależy od kosztu predykatów, liczby odrzuconych elementów, źródła danych i sposobu wykonania potoku. Przy małej kolekcji czytelny warunek zwykle jest lepszym wyborem niż przedwczesne strojenie.

findFirst() kończy przeglądanie, gdy znajdzie pasujący element

Jeśli potrzebujesz jednego zamówienia, nie zbieraj wszystkich dopasowań do listy. Połącz filtr z findFirst(), a strumień może zakończyć przeglądanie po znalezieniu pierwszego pasującego elementu.

Optional firstPaidOrder = orders.stream()
    .filter(Order::isPaid)
    .findFirst();

Wynik ma typ Optional, bo pasującego zamówienia może nie być. Taki wariant jest sensowny, gdy potrzebujesz pierwszego elementu zgodnie z kolejnością źródła. Dla samej odpowiedzi „czy istnieje choć jedno dopasowanie?” wybierz anyMatch(); tworzenie listy lub opcjonalnej wartości byłoby wtedy zbędne.

Mit do odrzucenia: filter() sam z siebie nie przerywa działania po znalezieniu pierwszego dopasowania. To findFirst() jest operacją końcową skracającą przetwarzanie; sam filtr przepuszcza dalej wszystkie elementy spełniające warunek, których potrzebuje dalsza część potoku.

Tabela pomaga dobrać operację do wyniku

Najczęstsze pomyłki wynikają z tego, że kod mówi „filtruj”, ale potrzeba dotyczy innego wyniku: pojedynczego elementu, odpowiedzi logicznej albo kolekcji. Zestawienie poniżej pozwala szybko dopasować operację.

Potrzeba Co się stanie Co wybrać
Potrzebujesz wszystkich pasujących elementów Strumień przejdzie przez elementy potrzebne do zbudowania wyniku. filter(...).toList()
Potrzebujesz jednego, pierwszego dopasowania Przetwarzanie może skończyć się po jego znalezieniu. filter(...).findFirst()
Chcesz sprawdzić, czy istnieje dopasowanie Wynik jest logiczny, a przegląd może zakończyć się wcześniej. anyMatch(...)
Predicate zmienia zewnętrzny stan Wynik może zależeć od kolejności lub równoległości przetwarzania. Usuń efekt uboczny z warunku.
Warunek odwołuje się do pola, które może być null Wywołanie metody na pustej referencji może rzucić NullPointerException. Sprawdź null jawnie albo użyj Objects::nonNull dla samych elementów.

Przy potencjalnym null rozróżnij sam element od jego pola. .filter(Objects::nonNull) usuwa elementy będące null, ale nie ochroni przed wywołaniem order.getCustomer().isActive(), jeśli klient jest pusty. W takim przypadku warunek musi sprawdzić również tę referencję.

Dobry filtr jest krótki, czysty i mówi prawdę

Predicate powinien odpowiadać na jedno pytanie i nie zmieniać danych ani stanu zewnętrznego. Zwiększa to przewidywalność kodu, a przy parallelStream() unika problemów z równoczesnym zapisem do wspólnej kolekcji lub licznika.

Jeżeli warunek zaczyna zajmować kilka linijek, przenieś go do nazwanej metody, na przykład isEligibleForShipment(order). Nazwa pokaże intencję, a test jednostkowy łatwiej obejmie reguły brzegowe, takie jak brak klienta czy anulowane zamówienie.

W praktyce wybór zależy od tego, co ma wyjść z potoku: kolekcja, pojedynczy element czy wartość logiczna. Gdy potrzebujesz tylko pierwszego trafienia, wybrałbym findFirst(); gdy kompletnego zestawu, dopiero wtedy zebrałbym wynik po filter().

FAQ - Najczęstsze pytania

filter() jest operacją pośrednią i działa leniwie, więc jedynie dodaje etap do potoku. Przetwarzanie rozpoczyna się dopiero po operacji końcowej, takiej jak toList(), count() albo findFirst(). Po wykonaniu operacji końcowej strumień jest zużyty i do kolejnego przetwarzania trzeba pobrać nowy strumień ze źródła.

Wybierz filter(...).toList(), gdy potrzebujesz wszystkich elementów spełniających warunek. filter(...).findFirst() zwraca Optional i pasuje do sytuacji, w której potrzebujesz pierwszego dopasowania zgodnie z kolejnością źródła. Jeśli chcesz tylko sprawdzić, czy istnieje choć jeden pasujący element, użyj anyMatch(), ponieważ przeglądanie może zakończyć się wcześniej bez tworzenia listy.

Jeśli nie zmienia to znaczenia wyniku, umieść wcześniej warunek tani i selektywny. Na przykład najpierw można sprawdzić, czy zamówienie jest opłacone, a dopiero potem wykonać droższe sprawdzenie dostępności w magazynie. Nie jest to gwarantowane przyspieszenie, ponieważ efekt zależy również od kosztu predykatów, liczby odrzuconych elementów i źródła danych.

filter(Objects::nonNull) usuwa elementy będące null, ale nie zabezpiecza przed pustym polem wewnątrz obiektu, takim jak klient zamówienia. Taki warunek musi sprawdzić również zagnieżdżoną referencję. Predicate powinien być czysty i nie zmieniać zewnętrznego stanu, szczególnie przy użyciu parallelStream(), aby wynik nie zależał od kolejności lub równoległości przetwarzania.
Oceń artykuł

Średnia: 0.0 / 5 · 0 ocen

Tagi

java strumienie optional predykaty operacje końcowe

Udostępnij artykuł

Komentarze (0)
Dodaj komentarz