Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

Function.identity(): funkcja tożsamościowa i finisher kolektora

`Function.identity()` tworzy funkcję, która zwraca tę samą referencję. Jako finisher kolektora pozwala zwrócić kontener akumulacji bez przekształcania go.

Wersja: Java SE 21

Składnia

import java.util.function.Function;

// Static method declaration in java.util.function.Function:
static <T> Function<T, T> identity()

// Typical use:
Function<String, String> same = Function.identity();

Function.identity() to statyczna metoda generyczna interfejsu java.util.function.Function, dostępnego od Javy 8. Samo wywołanie nie przyjmuje argumentów; zwraca Function<T, T>, czyli funkcję o tym samym typie wejścia i wyniku. Jej apply(x) działa jak x -> x: zwraca tę samą referencję bez kopiowania i modyfikowania obiektu, a dla null zwraca null.

W Collector<T, A, R> typ T oznacza element wejściowy, A — kontener akumulacji, a R — wynik końcowy. finisher() udostępnia funkcję Function<A, R>. Gdy A i R są tym samym typem i kontener ma być wynikiem bez zmian, można przekazać Function.identity() do przeciążenia Collector.of z jawnym finisherem. Jeśli wynik ma być kopią lub ma być niemodyfikowalny, potrzebna jest odpowiednia transformacja.

Przekazanie Function.identity() jako finishera nie ustawia automatycznie IDENTITY_FINISH. Ta cecha pozwala pominąć wywołanie finishera; deklaruj ją tylko wtedy, gdy finisher jest tożsamościowy, a niesprawdzane rzutowanie z A na R powiedzie się. Przeciążenie Collector.of bez argumentu finishera samo ustawia tę cechę.

Jeśli API wymaga UnaryOperator<T>, użyj UnaryOperator.identity(): zachowanie jest takie samo, ale zadeklarowany typ zwracany to UnaryOperator<T>, a nie Function<T, T>.

Przykłady

import java.util.ArrayList;
import java.util.List;
import java.util.function.Function;
import java.util.stream.Collector;

public class IdentityFinisherDemo {
    public static void main(String[] args) {
        Collector<String, List<String>, List<String>> collector = Collector.of(
                ArrayList::new,
                List::add,
                (left, right) -> {
                    left.addAll(right);
                    return left;
                },
                Function.identity(),
                Collector.Characteristics.IDENTITY_FINISH);

        List<String> input = List.of("Ada", "Lin");
        List<String> buffer = collector.supplier().get();
        input.forEach(name -> collector.accumulator().accept(buffer, name));
        List<String> result = collector.finisher().apply(buffer);

        System.out.println(result == buffer);
        System.out.println(input.stream().collect(collector));
    }
}

Wynik

true
[Ada, Lin]

Pierwszy wiersz, `true`, pokazuje, że `==` potwierdza tę samą referencję po bezpośrednim wywołaniu finishera. Drugi, `[Ada, Lin]`, pokazuje zawartość wyniku zbierania strumienia, a nie to, czy strumień wywołał finisher.

Powiązane lekcje

  • Java · Lekcja 24 · Zaawansowany · Wersja: 2

Źródła