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

CKTIS / Java

Stream — pipelines de processamento de elementos

Stream<T> processa referências a objetos através de um pipeline lazy. Aprende a criar streams, obter arrays de resultados, mapear para tipos primitivos e conhecer as garantias da ordem de encontro.

Versão: Java SE 21; repository runtime, production runtime not attested

Sintaxe

Stream.of(values).mapToInt(mapper)
Stream.of(values).mapToLong(mapper)
Stream.of(values).toArray()
Stream.of(values).toArray(String[]::new)
Stream.of(values).forEachOrdered(action)

java.util.stream.Stream<T> descreve o processamento de elementos, não uma coleção que armazena dados. Um pipeline inclui uma origem, operações intermédias e uma operação terminal. As operações intermédias são lazy: a operação terminal inicia o processamento.

Stream.of(T) cria um stream com um único elemento; Stream.of(T... values) cria um stream sequencial e ordenado dos valores fornecidos. Não reutilizes um stream consumido; cria um novo para outro cálculo. As funções de mapeamento não devem modificar a origem nem depender de estado mutável.

Stream.toArray() termina o pipeline e devolve Object[]. A sobrecarga Stream.toArray(String[]::new) cria um String[]; um tipo de elemento incompatível causa ArrayStoreException. Stream.mapToInt e Stream.mapToLong são operações intermédias que devolvem, respetivamente, IntStream e LongStream. Os respetivos métodos toArray() devolvem int[] e long[], não arrays de objetos wrapper.

Stream.forEachOrdered termina o pipeline e executa as ações pela ordem de encontro, quando esta está definida, incluindo durante o processamento paralelo. Não ordena os dados nem garante que um único thread execute as ações. Em contrapartida, forEach em paralelo não garante a ordem.

A documentação refere-se ao Java SE 21, a versão usada no ambiente de execução do repositório. O ambiente de execução em produção não está confirmado.

Exemplos

import java.util.Arrays;
import java.util.stream.Stream;

public class Main {
    public static void main(String[] args) {
        String[] words = Stream.of("sun", "moon").toArray(String[]::new);
        int[] lengths = Stream.of(words).mapToInt(String::length).toArray();
        long[] sizes = Stream.of(words).mapToLong(s -> (long) s.length()).toArray();

        System.out.println(Arrays.toString(words));
        System.out.println(Arrays.toString(lengths));
        System.out.println(Arrays.toString(sizes));
        Stream.of(words).parallel().forEachOrdered(System.out::println);
    }
}

Resultado

[sun, moon]
[3, 4]
[3, 4]
sun
moon

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.

Fontes