Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / Java

Collector — reducción mutable personalizada de flujos

Collector<T, A, R> describe cómo acumular elementos de un flujo en un estado mutable y transformarlo en un resultado. Aprende las funciones del colector, los requisitos del procesamiento paralelo y el significado de sus características en Java SE 21.

Versión: Java SE 21; repository runtime, production runtime not attested

Sintaxis

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

Collector<T, A, R> describe una reducción mutable utilizada por Stream.collect: T es el elemento, A el estado de acumulación y R el resultado. No confundas la interfaz Collector con la clase Collectors, que proporciona colectores listos para usar. Ámbito: Java SE 21; no se han confirmado el entorno de ejecución del repositorio ni el de producción.

Collector.supplier() devuelve una función que crea un contenedor mutable nuevo; Collector.accumulator() devuelve una función que incorpora un elemento; Collector.combiner() devuelve una función que combina estados parciales; Collector.finisher() devuelve una función que convierte A en R. Collector.of crea un colector a partir de estas funciones. La sobrecarga sin un finalizador explícito tiene A = R y declara automáticamente IDENTITY_FINISH.

Collector.characteristics() devuelve un conjunto inmutable de propiedades declaradas. Collector.Characteristics.CONCURRENT permite llamadas simultáneas al acumulador sobre el mismo contenedor. Collector.Characteristics.UNORDERED significa que no hay compromiso de preservar el orden de encuentro. La acumulación concurrente compartida requiere CONCURRENT y UNORDERED o bien un flujo no ordenado. Collector.Characteristics.IDENTITY_FINISH permite omitir el finalizador: debe ser una transformación identidad y la conversión de A a R mediante una conversión de tipo debe tener éxito. Los indicadores describen garantías; no proporcionan sincronización.

La combinación debe ser asociativa y coherente con la acumulación; combinar un estado vacío no debe cambiar el resultado. Un colector sin CONCURRENT puede ejecutarse en paralelo: la biblioteca aísla los estados parciales y después los combina. No compartas un único contenedor mutable entre llamadas al proveedor.

El ejemplo conserva el orden y usa StringBuilder como A y String como R. No declara características: StringBuilder no admite la acumulación concurrente compartida y el finalizador cambia el tipo. Se espera que ambos métodos de recolección impriman ABC.

Ejemplos

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

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes