CKTIS / Java
Stream — cevovodi za obdelavo elementov
Stream<T> obdeluje reference na objekte z uporabo lenega cevovoda. Spoznajte ustvarjanje tokov, rezultatske matrike, preslikavo v primitivne tipe in jamstva glede vrstnega reda pojavitve.
Različica: 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 obdelavo elementov, ne pa zbirke, ki shranjuje podatke. Cevovod sestavljajo vir, vmesne operacije in zaključna operacija. Vmesne operacije so lene: obdelavo sproži zaključna operacija.
Stream.of(T) ustvari tok z enim elementom; Stream.of(T... values) ustvari zaporeden, urejen tok podanih vrednosti. Porabljenega toka ne uporabite znova; za nov izračun ustvarite novega. Funkcije za preslikavo naj ne spreminjajo vira in naj ne bodo odvisne od spremenljivega stanja.
Stream.toArray() zaključi cevovod in vrne Object[]. Preobremenitev Stream.toArray(String[]::new) ustvari String[]; nezdružljiv tip elementa povzroči ArrayStoreException. Stream.mapToInt in Stream.mapToLong sta vmesni operaciji, ki vrneta IntStream oziroma LongStream. Njuni metodi toArray() vrneta int[] oziroma long[], ne pa matrik objektov ovojnic.
Stream.forEachOrdered zaključi cevovod in izvede dejanja v vrstnem redu pojavitve, kadar je ta določen, tudi pri vzporedni obdelavi. Podatkov ne razvršča in ne zagotavlja, da bo dejanja izvajala samo ena nit. Vzporedni forEach pa vrstnega reda ne zagotavlja.
Obseg dokumentacije: Java SE 21; niti izvajalno okolje repozitorija niti produkcijsko izvajalno okolje ni potrjeno.
Primeri
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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.