Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Java

DoubleStream: contagem e média das cargas da CPU

Cria um fluxo de valores primitivos `double`, seleciona as cargas da CPU iguais ou superiores a `0.50` e calcula separadamente a contagem e a média de ambos os grupos.

Versão: Java SE 21

Sintaxe

import java.util.OptionalDouble;
import java.util.function.DoublePredicate;
import java.util.stream.DoubleStream;

// Signatures declared by DoubleStream
static DoubleStream of(double value)
static DoubleStream of(double... values)
DoubleStream filter(DoublePredicate predicate)
long count()
OptionalDouble average()

Em Java SE 21, java.util.stream.DoubleStream processa valores primitivos double em vez de objetos Double. O método estático de criação DoubleStream.of(double) cria um fluxo sequencial com um único elemento. A sobrecarga DoubleStream.of(double...) aceita zero ou mais argumentos double ou um array double[] e cria um fluxo ordenado e sequencial.

DoubleStream.filter é uma operação intermédia de avaliação diferida: devolve um fluxo que contém apenas os valores para os quais o DoublePredicate devolve true. O predicado não deve modificar a origem nem depender de um estado variável. Quando a carga da CPU é expressa como fração, load -> load >= 0.50 inclui exatamente 0.50 (50%); > excluiria esse valor. A comparação devolve false para NaN.

DoubleStream.count é uma operação terminal que devolve o número de elementos como long, ou 0L se o fluxo estiver vazio. Se for possível determinar a contagem sem percorrer os elementos, count() pode saltar operações intermédias, pelo que não deves depender dos seus efeitos secundários. A operação terminal DoubleStream.average devolve a média aritmética num java.util.OptionalDouble; se o fluxo estiver vazio, o resultado é vazio e não 0.0. A média está sujeita a arredondamentos em vírgula flutuante. Verifica isPresent() antes de chamar getAsDouble(), que lança NoSuchElementException se o resultado estiver vazio.

Um fluxo só pode ser utilizado uma vez: depois de count(), não chames average() no mesmo fluxo. Se a reutilização for detetada, pode ocorrer uma IllegalStateException. Cria um novo fluxo a partir das mesmas medições para cada estatística e aplica o filtro apenas ao grupo das cargas elevadas.

Exemplos

import java.util.OptionalDouble;
import java.util.function.DoublePredicate;
import java.util.stream.DoubleStream;

public class CpuLoads {
    public static void main(String[] args) {
        double[] cpuLoads = {0.125, 0.375, 0.50, 0.75};
        DoublePredicate highLoad = load -> load >= 0.50;

        long allCount = DoubleStream.of(cpuLoads).count();
        OptionalDouble allAverage = DoubleStream.of(cpuLoads).average();
        long highCount = DoubleStream.of(cpuLoads).filter(highLoad).count();
        OptionalDouble highAverage = DoubleStream.of(cpuLoads).filter(highLoad).average();

        System.out.println("All: count=" + allCount + ", average=" + display(allAverage));
        System.out.println("High: count=" + highCount + ", average=" + display(highAverage));
    }

    private static String display(OptionalDouble average) {
        return average.isPresent() ? Double.toString(average.getAsDouble()) : "n/a";
    }
}

Resultado

All: count=4, average=0.4375
High: count=2, average=0.625

Das quatro medições, `0.50` e `0.75` atingem o limiar. `n/a` significa que não há média, não que a média seja zero.

Lições relacionadas

  • Java · Lição 46 · Intermédio · Versão: 2

Fontes