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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.