Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / Java

Function.identity(): funkcija identiteta i završna funkcija sakupljača

`Function.identity()` vraća funkciju koja vraća istu referencu. Kao završna funkcija sakupljača vraća spremnik za akumulaciju bez pretvorbe.

Verzija: Java SE 21

Sintaksa

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() statička je generička metoda sučelja java.util.function.Function, dostupnog od Jave 8. Poziv ne prima argumente i vraća Function<T, T>, čiji su ulaz i rezultat istog tipa. Njezin apply(x) ponaša se kao x -> x: vraća istu referencu bez kopiranja ili mijenjanja objekta, a za null vraća null.

U Collector<T, A, R> je T tip ulaznih elemenata, A tip spremnika za akumulaciju, a R tip konačnog rezultata. finisher() daje funkciju Function<A, R>. Kad su A i R istog tipa i spremnik treba postati rezultat bez promjena, proslijedi Function.identity() preopterećenoj inačici metode Collector.of s eksplicitnom završnom funkcijom. Ako rezultat treba biti kopija ili ga ne smije biti moguće mijenjati, upotrijebi završnu funkciju koja obavlja tu pretvorbu.

Prosljeđivanje Function.identity() kao završne funkcije ne postavlja automatski IDENTITY_FINISH. To svojstvo omogućuje redukciji da preskoči poziv završne funkcije. Navedi ga samo ako je završna funkcija funkcija identiteta i ako će neprovjerena pretvorba tipa iz A u R uspjeti. Inačica metode Collector.of bez argumenta za završnu funkciju sama postavlja to svojstvo.

Ako API zahtijeva UnaryOperator<T>, upotrijebi UnaryOperator.identity(): ponašanje je isto, ali deklarirani povratni tip je UnaryOperator<T>, a ne Function<T, T>.

Primjeri

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));
    }
}

Rezultat

true
[Ada, Lin]

Prvi redak, `true`, pokazuje da `==` nakon izravnog poziva završne funkcije potvrđuje istu referencu. Drugi, `[Ada, Lin]`, prikazuje sadržaj prikupljen iz toka, a ne je li tok pozvao završnu funkciju.

Povezane lekcije

  • Java · Lekcija 24 · Napredno · Verzija: 2

Izvori