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