CKTIS / Java
Estadísticas de valores double con Collectors.summarizingDouble
Obtén el recuento, la suma, el mínimo, el máximo y la media en un solo recorrido de un flujo de objetos, indicando cómo extraer un double de cada elemento.
Versión: Java SE 21
Sintaxis
public static <T> Collector<T, ?, DoubleSummaryStatistics> summarizingDouble(ToDoubleFunction<? super T> mapper)Collectors.summarizingDouble() es una forma abreviada de nombrar el método estático de java.util.stream.Collectors. No tiene una sobrecarga sin argumentos: requiere una ToDoubleFunction<? super T> que produzca un double primitivo por cada elemento del flujo. Puedes pasar esta función como una lambda o una referencia a un método.
La llamada crea un colector. Pásalo a la operación terminal Stream.collect(...) para obtener un objeto java.util.DoubleSummaryStatistics en un solo recorrido. getCount() devuelve el recuento como long; getSum(), getMin(), getMax() y getAverage() devuelven la suma, el mínimo, el máximo y la media aritmética como valores double. Si ya tienes un DoubleStream, llama a su método summaryStatistics() sin función de transformación.
Si el flujo está vacío, el recuento es 0, la suma y la media son 0.0, el mínimo es Double.POSITIVE_INFINITY y el máximo es Double.NEGATIVE_INFINITY. Comprueba getCount() == 0 antes de interpretar el mínimo y el máximo como valores presentes en los datos.
Debido al redondeo de coma flotante, la suma y la media pueden depender del orden de las sumas. Si algún valor producido por la función es NaN, la suma, el mínimo, el máximo y la media serán NaN; ese valor también se incluye en el recuento.
Ejemplos
import java.util.DoubleSummaryStatistics;
import java.util.List;
import java.util.stream.Collectors;
public class Main {
record Parcel(double weightKg) {}
public static void main(String[] args) {
List<Parcel> parcels = List.of(
new Parcel(1.5), new Parcel(2.5), new Parcel(3.5));
DoubleSummaryStatistics stats = parcels.stream()
.collect(Collectors.summarizingDouble(Parcel::weightKg));
System.out.println("count=" + stats.getCount());
System.out.println("sum=" + stats.getSum());
System.out.println("min=" + stats.getMin());
System.out.println("max=" + stats.getMax());
System.out.println("average=" + stats.getAverage());
}
}Resultado
count=3 sum=7.5 min=1.5 max=3.5 average=2.5
`Parcel::weightKg` extrae el peso en kilogramos de cada paquete. El colector cuenta los tres valores y calcula sus estadísticas; el ejemplo imprime cada resultado por separado.
Lecciones relacionadas
- Java · Lección 67 · Básico · Versión: 2