Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / Java

Stream — cjevovodi za obradu elemenata

Stream<T> obrađuje reference na objekte pomoću lijenog cjevovoda. Upoznajte stvaranje tokova, rezultantna polja, preslikavanje u primitivne tipove i jamstva redoslijeda susreta.

Verzija: Java SE 21; repository runtime, production runtime not attested

Sintaksa

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> opisuje obradu elemenata, a ne kolekciju koja pohranjuje podatke. Cjevovod obuhvaća izvor, međukorake i završnu operaciju. Međukoraci su lijeni: obradu pokreće završna operacija.

Stream.of(T) stvara tok s jednim elementom; Stream.of(T... values) stvara sekvencijalan, uređen tok zadanih vrijednosti. Potrošeni tok nemojte ponovno upotrebljavati; za drugi izračun stvorite novi. Funkcije preslikavanja ne bi trebale mijenjati izvor ni ovisiti o promjenjivom stanju.

Stream.toArray() završava cjevovod i vraća Object[]. Preopterećenje Stream.toArray(String[]::new) stvara String[]; nekompatibilan tip elementa uzrokuje ArrayStoreException. Stream.mapToInt i Stream.mapToLong međukoraci su koji vraćaju IntStream, odnosno LongStream. Njihove metode toArray() vraćaju int[], odnosno long[], a ne polja objekata omotača.

Stream.forEachOrdered završava cjevovod i izvršava radnje redoslijedom susreta, ako je definiran, uključujući tijekom paralelne obrade. Ne sortira podatke i ne jamči da će radnje izvršavati samo jedna dretva. Nasuprot tome, paralelni forEach ne jamči redoslijed.

Opseg dokumentacije: Java SE 21; nije potvrđeno ni izvršno okruženje repozitorija ni produkcijsko izvršno okruženje.

Primjeri

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);
    }
}

Rezultat

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

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori