CKTIS / Java
Collector — vlastní mutabilní redukce proudu
Collector<T, A, R> popisuje shromažďování prvků proudu do mutabilního stavu a jeho převod na výsledek. Seznamte se s funkcemi collectoru, požadavky na paralelní zpracování a významem jeho vlastností v Java SE 21.
Verze: Java SE 21; repository runtime, production runtime not attested
Syntaxe
Collector<T, A, R>
Collector.of(supplier, accumulator, combiner, characteristics...)
Collector.of(supplier, accumulator, combiner, finisher, characteristics...)Collector<T, A, R> popisuje mutabilní redukci používanou metodou Stream.collect: T je prvek, A akumulační stav a R výsledek. Nezaměňujte rozhraní Collector za třídu Collectors, která poskytuje hotové collectory. Rozsah: Java SE 21; běhové prostředí repozitáře ani produkční prostředí nejsou potvrzeny.
Collector.supplier() vrací funkci, která vytváří nový mutabilní kontejner; Collector.accumulator() vrací funkci, která přidá prvek; Collector.combiner() vrací funkci, která slučuje dílčí stavy; Collector.finisher() vrací funkci, která převádí A na R. Collector.of vytvoří collector z těchto funkcí. Přetížení bez explicitního finisheru má A = R a automaticky deklaruje IDENTITY_FINISH.
Collector.characteristics() vrací neměnnou množinu deklarovaných vlastností. Collector.Characteristics.CONCURRENT dovoluje současná volání accumulatoru nad stejným kontejnerem. Collector.Characteristics.UNORDERED znamená, že není zaručeno zachování pořadí výskytu. Sdílená souběžná akumulace vyžaduje CONCURRENT a buď UNORDERED, nebo neuspořádaný stream. Collector.Characteristics.IDENTITY_FINISH umožňuje vynechat finisher: musí jít o identickou transformaci a přetypování A na R musí uspět. Příznaky popisují záruky; neposkytují synchronizaci.
Slučování musí být asociativní a v souladu s akumulací; sloučení prázdného stavu nesmí změnit výsledek. Collector bez CONCURRENT může běžet paralelně: knihovna izoluje dílčí stavy a potom je sloučí. Nesdílejte jeden mutabilní kontejner mezi voláními supplieru.
Příklad zachovává pořadí a používá StringBuilder jako A a String jako R. Nedeklaruje žádné vlastnosti: StringBuilder nepodporuje sdílenou souběžnou akumulaci a finisher mění typ. Očekává se, že oba způsoby sběru vypíší ABC.
Příklady
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());
}
}Výsledek
ABC ABC true
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.