CKTIS / Java
Collector — redução mutável personalizada de fluxos
Collector<T, A, R> descreve a acumulação de elementos de um fluxo num estado mutável e a sua transformação num resultado. Conheça as funções do collector, os requisitos do processamento paralelo e o significado das suas características em Java SE 21.
Versão: Java SE 21; repository runtime, production runtime not attested
Sintaxe
Collector<T, A, R>
Collector.of(supplier, accumulator, combiner, characteristics...)
Collector.of(supplier, accumulator, combiner, finisher, characteristics...)Collector<T, A, R> descreve uma redução mutável utilizada por Stream.collect: T é o elemento, A o estado de acumulação e R o resultado. Não confunda a interface Collector com a classe Collectors, que disponibiliza collectors predefinidos. Âmbito: Java SE 21; os ambientes de execução do repositório e de produção não estão confirmados.
Collector.supplier() devolve uma função que cria um novo contentor mutável; Collector.accumulator() devolve uma função que incorpora um elemento; Collector.combiner() devolve uma função que combina estados parciais; Collector.finisher() devolve uma função que converte A em R. Collector.of constrói um collector a partir destas funções. A sobrecarga sem finisher explícito tem A = R e declara automaticamente IDENTITY_FINISH.
Collector.characteristics() devolve um conjunto imutável das propriedades declaradas. Collector.Characteristics.CONCURRENT permite chamadas simultâneas do accumulator no mesmo contentor. Collector.Characteristics.UNORDERED significa que não existe o compromisso de preservar a ordem de encontro. A acumulação concorrente partilhada exige CONCURRENT e UNORDERED ou um fluxo não ordenado. Collector.Characteristics.IDENTITY_FINISH permite ignorar o finisher: este tem de ser uma transformação identidade e o cast de A para R tem de ser bem-sucedido. Os indicadores descrevem garantias; não fornecem sincronização.
A combinação tem de ser associativa e consistente com a acumulação; combinar um estado vazio não pode alterar o resultado. Um collector sem CONCURRENT pode ser executado em paralelo: a biblioteca isola os estados parciais e combina-os depois. Não partilhe um único contentor mutável entre chamadas do supplier.
O exemplo preserva a ordem e utiliza StringBuilder como A e String como R. Não declara características: StringBuilder não suporta acumulação concorrente partilhada e o finisher altera o tipo. Espera-se que ambos os percursos de recolha imprimam ABC.
Exemplos
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());
}
}Resultado
ABC ABC true
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.