CKTIS / Java
Function.identity(): de identiteitsfunctie en de finisher van een collector
`Function.identity()` levert een functie die dezelfde referentie teruggeeft. Als finisher van een collector geeft die het verzamelobject ongewijzigd terug.
Versie: 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() is een statische generieke methode van de interface java.util.function.Function, die sinds Java 8 beschikbaar is. De aanroep neemt geen argumenten aan en geeft een Function<T, T> terug, met hetzelfde invoer- en resultaattype. De methode apply(x) van die functie werkt als x -> x: ze geeft dezelfde referentie terug zonder het object te kopiëren of te wijzigen, en geeft null terug voor null.
In Collector<T, A, R> is T het type van de invoerelementen, A het type van het verzamelobject en R het uiteindelijke resultaattype. finisher() levert een Function<A, R>. Als A en R hetzelfde type hebben en het verzamelobject ongewijzigd het resultaat moet zijn, geef je Function.identity() mee aan de overload van Collector.of met een expliciete finisher. Moet het resultaat een kopie zijn of niet gewijzigd kunnen worden, gebruik dan een finisher die die omzetting uitvoert.
Door Function.identity() als finisher mee te geven, wordt IDENTITY_FINISH niet automatisch ingesteld. Met dit kenmerk mag de reductie de finisher-aanroep overslaan. Geef het alleen op als de finisher een identiteitsfunctie is en een ongecontroleerde cast van A naar R zal slagen. De overload van Collector.of zonder finisher-argument stelt het kenmerk zelf in.
Vereist een API een UnaryOperator<T>, gebruik dan UnaryOperator.identity(): het gedrag is hetzelfde, maar het gedeclareerde retourtype is UnaryOperator<T>, niet Function<T, T>.
Voorbeelden
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));
}
}Resultaat
true [Ada, Lin]
De eerste regel, `true`, laat zien dat `==` na een directe aanroep van de finisher dezelfde referentie vaststelt. De tweede, `[Ada, Lin]`, toont de inhoud die uit de stream is verzameld, niet of de stream de finisher heeft aangeroepen.
Gerelateerde lessen
- Java · Les 24 · Gevorderd · Versie: 2