mapMulti i flatMap - komentarze

src/main/java/gotowe/p31_streamy/c_przeglad_operacji/C12_FlatMap.java

@@ -37,18 +37,26 @@ public class C12_FlatMap {
 		System.out.println();
 		System.out.println();
 
+		// W zwykłym map wynikowy strumień zawiera tyle samo elementów, co wejściowy.
+		// Jeśli funkcja mapuje wartości na kolekcje - wynikiem jest strumień kolekcji.
+		// Jeśli funkcja mapuje wartości na strumienie - wynikiem jest strumień strumieni.
 		System.out.println("Zwykłe mapowanie:");
 		Stream.of(1, 3, 0, 5)
 			.map(C12_FlatMap::generuj)
 			.forEach(x -> System.out.print(x + " | "));
 		System.out.println();
-		
+
+
 		Stream.of(1, 3, 0, 5)
 			.map(x -> C12_FlatMap.generuj(x).stream())
 			.forEach(x -> System.out.print(x + " | "));
 		System.out.println();
 		System.out.println();
 
+		// We flatMap funkcja powinna mapować wartość na strumień, a wynikiem jest konkatenacja wynikowych strumieni.
+		// Daje to możliwość mapowania pojedynczego elementu wejściowego na dowolną liczbę elementóœ wynikowych:
+		// zero (!), jeden, dowolną skończoną liczbę, a nawet nieskońćzoność.
+		// Funkcja mapuje wartości na strumienie - wynikiem jest strumień wartości.
 		System.out.println("Płaskie mapowanie:");
 		Stream.of(1, 3, 5)
 			.flatMap(x -> C12_FlatMap.generuj(x).stream())
@@ -67,5 +75,5 @@ public class C12_FlatMap {
 			.sum();
 		System.out.println(suma);
 	}
-
 }
+

src/main/java/gotowe/p31_streamy/c_przeglad_operacji/C13_MultiMap.java

@@ -13,6 +13,10 @@ public class C13_MultiMap {
 				.forEach(x -> System.out.print(x + " | "));
 		System.out.println();
 
+		// W mapMulti funkcja powinna przyjąć element strumienia wejściowego i wykonać odpowiednią ilość akcji
+		// na przekazanym do niej obiekcie Consumer.
+		// Wynikiem jest strumień składający się z tych wartości, które za pomocą accept zostały dostarczone do Consumera.
+		// Istotne jest, że wynikowy strumień może zawierać mniej lub więcej elementów, niż wejściowy (podobnie jak we flatMap).
 		System.out.println("mapMulti");
 		Stream.of(1, 3, 0, 5)
 				.mapMulti((n, c) -> {