CKTIS / Java
Collector — eigene mutable Stream-Reduktion
Collector<T, A, R> beschreibt, wie Stream-Elemente in einem veränderlichen Zustand gesammelt und in ein Ergebnis umgewandelt werden. Erfahre mehr über die Collector-Funktionen, die Anforderungen an parallele Verarbeitung und die Bedeutung der Eigenschaften in Java SE 21.
Version: Java SE 21; repository runtime, production runtime not attested
Syntax
Collector<T, A, R>
Collector.of(supplier, accumulator, combiner, characteristics...)
Collector.of(supplier, accumulator, combiner, finisher, characteristics...)Collector<T, A, R> beschreibt eine von Stream.collect verwendete mutable Reduktion: T ist das Element, A der Akkumulationszustand und R das Ergebnis. Verwechsle das Interface Collector nicht mit der Klasse Collectors, die fertige Collector bereitstellt. Geltungsbereich: Java SE 21; die Laufzeitumgebung des Repositorys und die Produktionsumgebung sind nicht bestätigt.
Collector.supplier() gibt eine Funktion zurück, die einen neuen veränderlichen Container erstellt; Collector.accumulator() eine Funktion, die ein Element hinzufügt; Collector.combiner() eine Funktion, die Teilzustände zusammenführt; Collector.finisher() eine Funktion, die A in R umwandelt. Collector.of erstellt aus diesen Funktionen einen Collector. Die Überladung ohne expliziten Finisher hat A = R und deklariert automatisch IDENTITY_FINISH.
Collector.characteristics() gibt eine unveränderliche Menge deklarierter Eigenschaften zurück. Collector.Characteristics.CONCURRENT erlaubt gleichzeitige Aufrufe des Accumulators auf demselben Container. Collector.Characteristics.UNORDERED bedeutet, dass die Reihenfolge des Auftretens nicht beibehalten werden muss. Gemeinsame gleichzeitige Akkumulation erfordert CONCURRENT und entweder UNORDERED oder einen ungeordneten Stream. Collector.Characteristics.IDENTITY_FINISH erlaubt es, den Finisher zu überspringen: Er muss eine Identitätstransformation sein, und die Umwandlung von A in R durch Cast muss gelingen. Flags beschreiben Garantien; sie stellen keine Synchronisierung bereit.
Das Zusammenführen muss assoziativ und mit der Akkumulation konsistent sein; das Zusammenführen eines leeren Zustands darf das Ergebnis nicht ändern. Ein Collector ohne CONCURRENT kann parallel ausgeführt werden: Die Bibliothek isoliert Teilzustände und führt sie anschließend zusammen. Teile nicht denselben veränderlichen Container über mehrere Aufrufe des Suppliers hinweg.
Das Beispiel erhält die Reihenfolge und verwendet StringBuilder als A und String als R. Es deklariert keine Eigenschaften: StringBuilder unterstützt keine gemeinsame gleichzeitige Akkumulation, und der Finisher ändert den Typ. Beide Sammelpfade sollen ABC ausgeben.
Beispiele
import java.util.List;
import java.util.stream.Collector;
public class Main {
public static void main(String[] args) {
Collector<String, StringBuilder, String> concatenate = Collector.of(
StringBuilder::new,
(buffer, value) -> buffer.append(value),
(left, right) -> { left.append(right); return left; },
StringBuilder::toString
);
List<String> values = List.of("A", "B", "C");
System.out.println(values.stream().collect(concatenate));
System.out.println(values.parallelStream().collect(concatenate));
System.out.println(concatenate.characteristics().isEmpty());
}
}Ergebnis
ABC ABC true
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.