Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

Function.identity(): identická funkce a finisher kolektoru

`Function.identity()` poskytuje funkci, která vrací stejnou referenci. Jako finisher kolektoru umožňuje vrátit akumulační kontejner beze změny.

Verze: Java SE 21

Syntaxe

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 statická generická metoda rozhraní java.util.function.Function, dostupného od Javy 8. Volání nepřijímá žádné argumenty a vrací Function<T, T>, jejíž vstup i výsledek mají stejný typ. Její apply(x) se chová jako x -> x: vrací stejnou referenci, aniž by objekt kopírovala nebo měnila, a pro null vrací null.

V Collector<T, A, R> je T typ vstupních prvků, A typ akumulačního kontejneru a R typ konečného výsledku. finisher() poskytuje funkci Function<A, R>. Pokud jsou A a R stejného typu a kontejner se má stát výsledkem beze změny, předej Function.identity() přetížené variantě Collector.of s explicitním finisherem. Pokud má být výsledkem kopie nebo výsledek nesmí být modifikovatelný, použij finisher, který tuto transformaci provede.

Předáním Function.identity() jako finisheru se příznak IDENTITY_FINISH automaticky nenastaví. Tento příznak umožňuje při redukci vynechat volání finisheru. Uveď ho jen tehdy, když je finisher identická funkce a nekontrolované přetypování z A na R uspěje. Varianta Collector.of bez argumentu finisheru nastaví příznak sama.

Pokud API vyžaduje UnaryOperator<T>, použij UnaryOperator.identity(): chování je stejné, ale deklarovaný návratový typ je UnaryOperator<T>, nikoli Function<T, T>.

Příklady

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

Výsledek

true
[Ada, Lin]

První řádek, `true`, ukazuje, že `==` po přímém volání finisheru potvrdí shodu referencí. Druhý, `[Ada, Lin]`, ukazuje obsah získaný ze streamu, nikoli to, zda stream finisher zavolal.

Související lekce

  • Java · Lekce 24 · Pokročilá · Verze: 2

Zdroje