Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / Java

Function.identity(): identická funkcia a finisher kolektora

`Function.identity()` poskytuje funkciu, ktorá vracia tú istú referenciu. Ako finisher kolektora umožňuje vrátiť akumulačný kontajner bez zmeny.

Verzia: Java SE 21

Syntax

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á metóda rozhrania java.util.function.Function, dostupného od Javy 8. Volanie neprijíma argumenty a vracia Function<T, T>, ktorej vstup aj výsledok majú rovnaký typ. Jej apply(x) sa správa ako x -> x: vracia tú istú referenciu bez kopírovania či zmeny objektu a pre null vracia null.

V Collector<T, A, R> je T typ vstupných prvkov, A typ akumulačného kontajnera a R typ konečného výsledku. finisher() poskytuje funkciu Function<A, R>. Ak sú A a R rovnakého typu a kontajner má byť výsledkom bez zmeny, odovzdaj Function.identity() preťaženej verzii Collector.of s explicitným finisherom. Ak má byť výsledkom kópia alebo sa výsledok nesmie dať meniť, použi finisher, ktorý túto transformáciu vykoná.

Odovzdanie Function.identity() ako finishera automaticky nenastaví príznak IDENTITY_FINISH. Tento príznak dovoľuje pri redukcii vynechať volanie finishera. Uveď ho len vtedy, keď je finisher identická funkcia a nekontrolované pretypovanie z A na R bude úspešné. Verzia Collector.of bez argumentu finishera nastaví príznak sama.

Ak API vyžaduje UnaryOperator<T>, použi UnaryOperator.identity(): správanie je rovnaké, ale deklarovaný návratový typ je UnaryOperator<T>, nie Function<T, T>.

Prí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ýsledok

true
[Ada, Lin]

Prvý riadok, `true`, ukazuje, že `==` po priamom zavolaní finishera potvrdí zhodu referencií. Druhý, `[Ada, Lin]`, ukazuje obsah získaný zo streamu, nie to, či stream zavolal finisher.

Súvisiace lekcie

  • Java · Lekcia 24 · Pokročilá · Verzia: 2

Zdroje