База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / Java

Collector — персонализирана променяема редукция на поток

Collector<T, A, R> описва натрупването на елементи от поток в променяемо състояние и преобразуването му в резултат. Научете за функциите на колектора, изискванията за паралелна обработка и значението на характеристиките му в Java SE 21.

Версия: Java SE 21; repository runtime, production runtime not attested

Синтаксис

Collector<T, A, R>
Collector.of(supplier, accumulator, combiner, characteristics...)
Collector.of(supplier, accumulator, combiner, finisher, characteristics...)

Collector<T, A, R> описва променяема редукция, използвана от Stream.collect: T е елементът, A е състоянието за натрупване, а R е резултатът. Не бъркайте интерфейса Collector с класа Collectors, който предоставя готови колектори. Обхват: Java SE 21; средата за изпълнение на хранилището и производствената среда не са потвърдени.

Collector.supplier() връща функция, която създава нов променяем контейнер; Collector.accumulator() връща функция, която добавя елемент; Collector.combiner() връща функция, която обединява частични състояния; Collector.finisher() връща функция, която преобразува A в R. Collector.of изгражда колектор от тези функции. Версията без изричен finisher има A = R и автоматично декларира IDENTITY_FINISH.

Collector.characteristics() връща непроменяем набор от декларираните свойства. Collector.Characteristics.CONCURRENT разрешава едновременни извиквания на accumulator върху един и същ контейнер. Collector.Characteristics.UNORDERED означава, че няма ангажимент за запазване на реда на срещане. Споделеното конкурентно натрупване изисква CONCURRENT и или UNORDERED, или неупорядочен поток. Collector.Characteristics.IDENTITY_FINISH позволява пропускането на finisher: той трябва да е тъждествено преобразуване, а преобразуването чрез привеждане на A към R трябва да е успешно. Флаговете описват гаранции; те не осигуряват синхронизация.

Обединяването трябва да е асоциативно и съгласувано с натрупването; обединяването на празно състояние не бива да променя резултата. Колектор без CONCURRENT може да се изпълнява паралелно: библиотеката изолира частичните състояния и след това ги обединява. Не споделяйте един променяем контейнер между извикванията на доставчика.

Примерът запазва реда и използва StringBuilder като A и String като R. Не декларира характеристики: StringBuilder не поддържа споделено конкурентно натрупване, а finisher променя типа. Очаква се и двата начина на събиране да отпечатат ABC.

Примери

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());
    }
}

Резултат

ABC
ABC
true

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници