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.