CKTIS / Java
Collector.of: vlastný kolektor so štyrmi funkciami
Vytvorte vlastný kolektor prúdu, ktorý založí pracovný stav, pridáva prvky, zlučuje čiastkové výsledky a prevedie stav na konečnú hodnotu.
Verzia: Java SE 21
Syntax
import java.util.stream.Collector;
// Static overloads declared by java.util.stream.Collector:
static <T, A, R> Collector<T, A, R> of(
Supplier<A> supplier, BiConsumer<A, T> accumulator,
BinaryOperator<A> combiner, Function<A, R> finisher,
Collector.Characteristics... characteristics);
static <T, R> Collector<T, R, R> of(
Supplier<R> supplier, BiConsumer<R, T> accumulator,
BinaryOperator<R> combiner,
Collector.Characteristics... characteristics);Collector.of je statická továrenská metóda rozhrania java.util.stream.Collector. Vytvára kolektor, ktorý odovzdáte koncovej operácii Stream.collect(collector). V type Collector<T, A, R> označuje T typ vstupných prvkov, A typ meniteľného medzistavu a R typ konečného výsledku.
V preťažení so štyrmi funkciami supplier pri každom volaní vytvorí nový prázdny kontajner typu A; accumulator ho aktualizuje o jeden prvok typu T a nič nevracia; combiner zlúči dva čiastkové výsledky a vráti zlúčený stav typu A; finisher prevedie výsledný stav typu A na typ R. Za funkciami možno uviesť voliteľné príznaky typu Collector.Characteristics. Obe preťaženia vyvolajú NullPointerException, ak má niektorý argument hodnotu null.
Pri paralelnej redukcii sa môžu naplniť oddelené kontajnery a potom sa zlúčiť. Redukcia s rozdelením vstupu aj bez neho musí dať rovnocenné výsledky. Pri kolektore s príznakom UNORDERED môžu byť výsledky rovnocenné, aj keď sa líšia iba poradím. Zlúčenie čiastkového výsledku s prázdnym kontajnerom ako druhým argumentom musí dať rovnocenný výsledok. Z supplier nevracajte zdieľaný meniteľný kontajner a CONCURRENT nastavte len vtedy, ak accumulator dokáže bezpečne aktualizovať ten istý kontajner z viacerých vlákien naraz.
Preťaženie s tromi funkciami neprijíma finisher: vracia Collector<T, R, R> a automaticky nastavuje IDENTITY_FINISH. Je to príznak, nie metóda Collector.identityFinish; redukcia vďaka nemu môže vynechať finisher. Nenastavujte ho, ak finisher robí potrebnú transformáciu. Ak chcete iba spájať texty v poradí, v akom sa prvky v prúde vyskytujú, použite hotový kolektor Collectors.joining.
Príklady
import java.util.List;
import java.util.stream.Collector;
public class Main {
record Totals(long count, long totalLength) {}
public static void main(String[] args) {
Collector<String, long[], Totals> lengthTotals = Collector.of(
() -> new long[2],
(state, word) -> {
state[0]++;
state[1] += word.length();
},
(left, right) -> {
left[0] += right[0];
left[1] += right[1];
return left;
},
state -> new Totals(state[0], state[1])
);
Totals totals = List.of("ant", "bear", "ox")
.parallelStream()
.collect(lengthTotals);
System.out.println("count=" + totals.count()
+ ", totalLength=" + totals.totalLength());
}
}Výsledok
count=3, totalLength=9
Pole `long[]` obsahuje počet reťazcov a súčet ich hodnôt `String.length()`. `combiner` sčíta zodpovedajúce položky a `finisher` vytvorí záznam `Totals`. Pre tieto údaje dá paralelný aj sekvenčný prúd výsledok `count=3, totalLength=9`.
Súvisiace lekcie
- Java · Lekcia 45 · Stredne pokročilá · Verzia: 2