编辑“︁Java Stream创建”︁（章节）

== Stream 的创建方式 ==

Java 提供了多种方式来创建 Stream，下面是最常用的几种方法。

=== 1. 从集合创建 ===

最常用的方式是从现有的集合（如 List 或 Set）创建 Stream。所有集合类都实现了 `Collection` 接口，该接口提供了 `stream()` 和 `parallelStream()` 方法。

<syntaxhighlight lang="java">
import java.util.Arrays;
import java.util.List;
import java.util.stream.Stream;

public class StreamCreation {
    public static void main(String[] args) {
        List<String> names = Arrays.asList("Alice", "Bob", "Charlie");
        
        // 创建顺序流
        Stream<String> stream = names.stream();
        stream.forEach(System.out::println);
        
        // 创建并行流
        Stream<String> parallelStream = names.parallelStream();
        parallelStream.forEach(System.out::println);
    }
}
</syntaxhighlight>

'''输出：'''
<pre>
Alice
Bob
Charlie
Charlie
Bob
Alice
</pre>

注意并行流的输出顺序可能不同，因为元素是并行处理的。

=== 2. 从数组创建 ===

可以使用 `Arrays.stream()` 方法从数组创建 Stream：

<syntaxhighlight lang="java">
import java.util.Arrays;
import java.util.stream.Stream;

public class ArrayToStream {
    public static void main(String[] args) {
        String[] languages = {"Java", "Python", "JavaScript"};
        
        // 创建流
        Stream<String> stream = Arrays.stream(languages);
        stream.forEach(System.out::println);
        
        // 也可以指定范围
        Stream<String> partialStream = Arrays.stream(languages, 1, 3);
        partialStream.forEach(System.out::println);
    }
}
</syntaxhighlight>

'''输出：'''
<pre>
Java
Python
JavaScript
Python
JavaScript
</pre>

=== 3. 使用 Stream.of() ===

`Stream` 类提供了静态方法 `of()` 可以直接创建流：

<syntaxhighlight lang="java">
import java.util.stream.Stream;

public class StreamOfExample {
    public static void main(String[] args) {
        Stream<String> stream = Stream.of("Apple", "Banana", "Orange");
        stream.forEach(System.out::println);
        
        // 也可以用于基本类型
        Stream<Integer> numberStream = Stream.of(1, 2, 3, 4, 5);
        numberStream.forEach(System.out::println);
    }
}
</syntaxhighlight>

'''输出：'''
<pre>
Apple
Banana
Orange
1
2
3
4
5
</pre>

=== 4. 使用 Stream.generate() ===

`Stream.generate()` 方法接受一个 `Supplier` 函数式接口，可以生成无限流：

<syntaxhighlight lang="java">
import java.util.stream.Stream;

public class StreamGenerate {
    public static void main(String[] args) {
        // 生成随机数流
        Stream<Double> randomStream = Stream.generate(Math::random);
        
        // 限制前5个元素
        randomStream.limit(5).forEach(System.out::println);
    }
}
</syntaxhighlight>

'''输出（示例）：'''
<pre>
0.123456789
0.987654321
0.555555555
0.111111111
0.999999999
</pre>

=== 5. 使用 Stream.iterate() ===

`Stream.iterate()` 方法可以创建基于初始值和一元操作符的无限流：

<syntaxhighlight lang="java">
import java.util.stream.Stream;

public class StreamIterate {
    public static void main(String[] args) {
        // 创建从0开始，每次加2的无限流
        Stream<Integer> evenNumbers = Stream.iterate(0, n -> n + 2);
        
        // 取前10个偶数
        evenNumbers.limit(10).forEach(System.out::println);
    }
}
</syntaxhighlight>

'''输出：'''
<pre>
0
2
4
6
8
10
12
14
16
18
</pre>

Java 9 对 `iterate()` 进行了增强，可以添加终止条件：

<syntaxhighlight lang="java">
Stream.iterate(0, n -> n < 100, n -> n + 2).forEach(System.out::println);
</syntaxhighlight>

=== 6. 从文件创建 ===

可以使用 `Files.lines()` 方法从文件创建流：

<syntaxhighlight lang="java">
import java.io.IOException;
import java.nio.file.Files;
import java.nio.file.Paths;
import java.util.stream.Stream;

public class FileToStream {
    public static void main(String[] args) {
        try (Stream<String> lines = Files.lines(Paths.get("data.txt"))) {
            lines.forEach(System.out::println);
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}
</syntaxhighlight>

=== 7. 基本类型流 ===

Java 为基本类型提供了专门的流类（`IntStream`、`LongStream`、`DoubleStream`），可以避免自动装箱的开销：

<syntaxhighlight lang="java">
import java.util.stream.IntStream;

public class PrimitiveStream {
    public static void main(String[] args) {
        // 创建范围流
        IntStream.range(1, 5).forEach(System.out::println);
        
        // 创建包含结束值的范围流
        IntStream.rangeClosed(1, 5).forEach(System.out::println);
    }
}
</syntaxhighlight>

'''输出：'''
<pre>
1
2
3
4
1
2
3
4
5
</pre>