Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / Java

Function.identity(): identitetna funkcija in zaključna funkcija zbiralnika

`Function.identity()` vrne funkcijo, ki vrne isto referenco. Kot zaključna funkcija zbiralnika vrne akumulacijski vsebnik brez pretvorbe.

Različica: 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() je statična generična metoda vmesnika java.util.function.Function, ki je na voljo od Jave 8. Klic ne sprejme argumentov in vrne Function<T, T>, pri kateri sta vhod in rezultat istega tipa. Njen apply(x) deluje kot x -> x: vrne isto referenco, ne da bi kopiral ali spreminjal objekt, za null pa vrne null.

V Collector<T, A, R> je T tip vhodnih elementov, A tip akumulacijskega vsebnika, R pa tip končnega rezultata. finisher() poda funkcijo Function<A, R>. Če sta A in R istega tipa in naj vsebnik postane rezultat brez sprememb, podaj Function.identity() preobremenjeni različici Collector.of z izrecno zaključno funkcijo. Če mora biti rezultat kopija ali ga ne sme biti mogoče spreminjati, uporabi zaključno funkcijo, ki izvede to pretvorbo.

Če kot zaključno funkcijo podaš Function.identity(), se IDENTITY_FINISH ne nastavi samodejno. Ta lastnost omogoča, da redukcija izpusti klic zaključne funkcije. Navedi jo le, če je zaključna funkcija identitetna in bo nepreverjena pretvorba tipa iz A v R uspela. Različica Collector.of brez argumenta za zaključno funkcijo to lastnost nastavi sama.

Če API zahteva UnaryOperator<T>, uporabi UnaryOperator.identity(): vedenje je enako, toda deklarirani vračani tip je UnaryOperator<T>, ne Function<T, T>.

Primeri

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]

Prva vrstica, `true`, pokaže, da `==` po neposrednem klicu zaključne funkcije potrdi isto referenco. Druga, `[Ada, Lin]`, pokaže vsebino, zbrano iz toka, ne pa tega, ali je tok poklical zaključno funkcijo.

Povezane lekcije

  • Java · Lekcija 24 · Napredna · Različica: 2

Viri