RFR 8028516 Java doc error in Int/Long/Double/Stream.peek
Paul Sandoz
paul.sandoz at oracle.com
Fri Nov 22 11:24:26 UTC 2013
Hi,
https://bugs.openjdk.java.net/browse/JDK-8028516
An attendee of the Devoxx lambda hackathon spotted some doc bugs in code samples of the stream peek methods.
I updated those samples to be stand alone samples and verified they compile.
Paul.
diff -r 4bc37b6c4133 src/share/classes/java/util/stream/DoubleStream.java
--- a/src/share/classes/java/util/stream/DoubleStream.java Thu Nov 21 16:02:16 2013 -0800
+++ b/src/share/classes/java/util/stream/DoubleStream.java Fri Nov 22 12:23:30 2013 +0100
@@ -207,12 +207,12 @@
* @apiNote This method exists mainly to support debugging, where you want
* to see the elements as they flow past a certain point in a pipeline:
* <pre>{@code
- * list.stream()
- * .filter(filteringFunction)
- * .peek(e -> System.out.println("Filtered value: " + e));
- * .map(mappingFunction)
- * .peek(e -> System.out.println("Mapped value: " + e));
- * .collect(Collectors.toDoubleSummaryStastistics());
+ * DoubleStream.of(1, 2, 3, 4)
+ * .filter(e -> e > 2)
+ * .peek(e -> System.out.println("Filtered value: " + e))
+ * .map(e -> e * e)
+ * .peek(e -> System.out.println("Mapped value: " + e))
+ * .sum();
* }</pre>
*
* @param action a <a href="package-summary.html#NonInterference">
diff -r 4bc37b6c4133 src/share/classes/java/util/stream/IntStream.java
--- a/src/share/classes/java/util/stream/IntStream.java Thu Nov 21 16:02:16 2013 -0800
+++ b/src/share/classes/java/util/stream/IntStream.java Fri Nov 22 12:23:30 2013 +0100
@@ -200,12 +200,12 @@
* @apiNote This method exists mainly to support debugging, where you want
* to see the elements as they flow past a certain point in a pipeline:
* <pre>{@code
- * list.stream()
- * .filter(filteringFunction)
- * .peek(e -> System.out.println("Filtered value: " + e));
- * .map(mappingFunction)
- * .peek(e -> System.out.println("Mapped value: " + e));
- * .collect(Collectors.toIntSummaryStastistics());
+ * IntStream.of(1, 2, 3, 4)
+ * .filter(e -> e > 2)
+ * .peek(e -> System.out.println("Filtered value: " + e))
+ * .map(e -> e * e)
+ * .peek(e -> System.out.println("Mapped value: " + e))
+ * .sum();
* }</pre>
*
* @param action a <a href="package-summary.html#NonInterference">
diff -r 4bc37b6c4133 src/share/classes/java/util/stream/LongStream.java
--- a/src/share/classes/java/util/stream/LongStream.java Thu Nov 21 16:02:16 2013 -0800
+++ b/src/share/classes/java/util/stream/LongStream.java Fri Nov 22 12:23:30 2013 +0100
@@ -205,12 +205,12 @@
* @apiNote This method exists mainly to support debugging, where you want
* to see the elements as they flow past a certain point in a pipeline:
* <pre>{@code
- * list.stream()
- * .filter(filteringFunction)
- * .peek(e -> System.out.println("Filtered value: " + e));
- * .map(mappingFunction)
- * .peek(e -> System.out.println("Mapped value: " + e));
- * .collect(Collectors.toLongSummaryStastistics());
+ * LongStream.of(1, 2, 3, 4)
+ * .filter(e -> e > 2)
+ * .peek(e -> System.out.println("Filtered value: " + e))
+ * .map(e -> e * e)
+ * .peek(e -> System.out.println("Mapped value: " + e))
+ * .sum();
* }</pre>
*
* @param action a <a href="package-summary.html#NonInterference">
diff -r 4bc37b6c4133 src/share/classes/java/util/stream/Stream.java
--- a/src/share/classes/java/util/stream/Stream.java Thu Nov 21 16:02:16 2013 -0800
+++ b/src/share/classes/java/util/stream/Stream.java Fri Nov 22 12:23:30 2013 +0100
@@ -403,12 +403,12 @@
* @apiNote This method exists mainly to support debugging, where you want
* to see the elements as they flow past a certain point in a pipeline:
* <pre>{@code
- * list.stream()
- * .filter(filteringFunction)
- * .peek(e -> System.out.println("Filtered value: " + e));
- * .map(mappingFunction)
- * .peek(e -> System.out.println("Mapped value: " + e));
- * .collect(Collectors.intoList());
+ * Stream.of("one", "two", "three", "four")
+ * .filter(e -> e.length() > 3)
+ * .peek(e -> System.out.println("Filtered value: " + e))
+ * .map(String::toUpperCase)
+ * .peek(e -> System.out.println("Mapped value: " + e))
+ * .collect(Collectors.toList());
* }</pre>
*
* @param action a <a href="package-summary.html#NonInterference">
More information about the core-libs-dev
mailing list