Java8新特性：Stream API

一 Stream API简介

java8新添加了一个特性：流Stream。Stream让开发者能够以一种声明的方式处理数据源（集合、数组等），它专注于对数据源进行各种高效的聚合操作（aggregate operation）和大批量数据操作 (bulk data operation)。

Stream API将处理的数据源看做一种Stream（流），Stream（流）在Pipeline（管道）中传输和运算，支持的运算包含筛选、排序、聚合等，当到达终点后便得到最终的处理结果。

注意：
①Stream 自己不会存储元素。
②Stream 不会改变源对象。相反，他们会返回一个持有结果的新Stream。
③Stream 操作是延迟执行的。这意味着他们会等到需要结果的时候才执行。

二 Stream操作三个步骤

1. 创建 Stream（4种方式）由一个数据源（如：集合、数组）获取一个流 
2. 中间操作（筛选与切片、映射、排序）一个中间操作链，对数据源的数据进行处理 
3. 终止操作(也称为终端操作) 一个终止操作，执行中间操作链，并产生结果

三 创建Stream

//1. 创建 Stream（四种方式）
	@Test
	public void test(){
		//1. Collection 提供了两个方法  stream() 与 parallelStream()
		List<String> list = new ArrayList<>();
		Stream<String> stream = list.stream(); //获取一个顺序流
		Stream<String> parallelStream = list.parallelStream(); //获取一个并行流
		
		//2. 通过 Arrays 中的 stream() 获取一个数组流
		Integer[] nums = new Integer[10];
		Stream<Integer> stream1 = Arrays.stream(nums);
		
		//3. 通过 Stream 类中静态方法 of()
		Stream<Integer> stream2 = Stream.of(1,2,3,4,5,6);
		
		//4. 创建无限流
		//4.1 迭代
		Stream<Integer> stream3 = Stream.iterate(0, (x) -> x + 2).limit(10);
		stream3.forEach(System.out::println);
		
		//4.2 生成
		Stream<Double> stream4 = Stream.generate(Math::random).limit(2);
		stream4.forEach(System.out::println);
		
	}

四 中间操作

多个中间操作可以连接起来形成一个流水线，除非流水 线上触发终止操作，否则中间操作不会执行任何的处理！ 而在终止操作时一次性全部处理，称为**“惰性求值”**。

4.1 筛选与切片

方法	描述
filter(Predicate p)	接收 Lambda，从流中排除某些元素
distinct()	筛选，通过流所生成元素的 hashCode() 和 equals() 去除重复元素
limit(long maxSize)	截断流，使其元素不超过给定数量
skip(long n)	跳过元素，返回一个扔掉了前 n 个元素的流。若流中元素 不足 n 个，则返回一个空流。与 limit(n) 互补

4.1.1 代码测试

• 实体类Employee

import lombok.Data;
@Data
public class Employee {
    public Integer id;

    public String  name;

    public Integer age;

    public Integer price;

    public Employee(Integer id, String name, Integer age, Integer price) {
        this.id = id;
        this.name = name;
        this.age = age;
        this.price = price;
    }
}

• 测试类

import org.junit.Test;

import java.util.Arrays;
import java.util.Iterator;
import java.util.List;
import java.util.stream.Stream;

public class Oauth2DemoApplicationTests {
    //2. 中间操作
    List<Employee> emps = Arrays.asList(
            new Employee(101, "王一", 59, 6666),
            new Employee(102, "李二", 18, 9999),
            new Employee(103, "张三", 28, 3333),
            new Employee(105, "王五", 8, 7777),
            new Employee(105, "王五", 8, 7777),
            new Employee(106, "赵六", 8, 77777),
            new Employee(107, "田七", 38, 5555)
    );

    /*
	  筛选与切片
		filter(Lambda)——接收 Lambda ，从流中排除某些元素。
		limit(n)——截断流，使其元素不超过给定数量n。
		skip(n) —— 跳过元素，返回一个扔掉了前 n 个元素的流。若流中元素不足 n 个，则返回一个空流。与 limit(n) 互补
		distinct()——筛选，通过流所生成元素的 hashCode() 和 equals() 去除重复元素
	 */
    //filter(Predicate p)
    //内部迭代：迭代操作 Stream API 内部完成
    @Test
    public void test1(){
        Stream<Employee> employeeStream = emps.stream().filter((e) -> {
                    return e.getAge() >= 15;
                }
        );
        //属于懒执行  当所有的中间流走完再执行
        employeeStream.forEach(System.out :: println);
    }

    //外部迭代
    /*
    Iterator Java中的迭代器
    迭代器 it 的基本操作是 next 、hasNext 和 remove。
    调用 it.next() 会返回迭代器的下一个元素，并且更新迭代器的状态。
    调用 it.hasNext() 用于检测集合中是否还有元素。
    调用 it.remove() 将迭代器返回的元素删除
     */
    @Test
    public void test3() {
        Iterator<Employee> it = emps.iterator();
        //使用迭代器后 用while循环比较方便
        while (it.hasNext()) {
            System.out.println(it.next());
        }
    }
    //limit(long maxSize)
    /*
    因为stream 是顺序流 确定MaxSize后 首先保留的是前三位
     */
    @Test
    public void test4(){
        emps.stream()
                .limit(3)
                .forEach(System.out::println);

        emps.stream().filter(e ->{
            System.out.println("过滤数据");
            return e.getPrice()>5000;
        }).limit(2).forEach(System.out::println);
    }
    //skip(long n)
    @Test
    public void test5(){
       // emps.parallelStream().skip(3).forEach(System.out::println);

        emps.stream().skip(2).forEach(System.out::println);
    }

    //distinct()
    @Test
    public void test6(){
        emps.stream().distinct().forEach(System.out::println);
    }

}

4.2 映射

方法	描述
map(Function f)	接收一个函数作为参数，该函数会被应用到每个元素上，并将其映射成一个新的元素
mapToDouble(ToDoubleFunction f)	接收一个函数作为参数，该函数会被应用到每个元素上，产生一个新的 DoubleStream
mapToInt(ToIntFunction f)	接收一个函数作为参数，该函数会被应用到每个元素上，产生一个新的 IntStream
mapToLong(ToLongFunction f)	接收一个函数作为参数，该函数会被应用到每个元素上，产生一个新的 LongStream
flatMap(Function f)	接收一个函数作为参数，将流中的每个值都换成另一个流，然后把所有流连接成一个流

• 代码实现

import org.junit.Test;

import java.util.ArrayList;
import java.util.Arrays;
import java.util.List;
import java.util.stream.Stream;

public class test2 {
    List<Employee> emps = Arrays.asList(
            new Employee(101, "王一", 59, 6666),
            new Employee(102, "李二", 18, 9999),
            new Employee(103, "张三", 28, 3333),
            new Employee(105, "王五", 8, 7777),
            new Employee(105, "王五", 8, 7777),
            new Employee(106, "赵六", 8, 77777),
            new Employee(107, "田七", 38, 5555)
    );
    /*
      映射
      map——接收 Lambda,将元素转换成其他形式或提取信息。接收一个函数作为参数，
该函数会被应用到每个元素上，并将其映射成一个新的元素。
      flatMap——接收一个函数作为参数，将流中的每个值都换成另一个流，然后把所有流连接成一个流
    */
    @Test
    public void test1(){
        Stream<Object> str = emps.stream()
                .map((e) -> e.getName());

        str.forEach(System.out::println);

        System.out.println("-------------------------------------------");

        List<String> strList = Arrays.asList("aaa", "bbb", "ccc", "ddd", "eee");

        //注意map中的方法 String 是方法的类 :: 后面是方法
        Stream<String> stream = strList.stream()
                .map(String::toUpperCase); //toUpperCase 将字符串小写字符转换为大写

        stream.forEach(System.out::println);
        //stream2：流中元素是流Stream<Character>，因为filterCharacter返回的是一个流
        Stream<Stream<Character>> stream2 = strList.stream()
                .map(test2::filterCharacter);
        //{{a,a,a},{b,b,b},{c,c,c},{d,d,d},{e,e,e}},filterCharacter返回的小流在大流中
        stream2.forEach((e) -> {
            e.forEach(System.out::println);
        });

        System.out.println("---------------------------------------------");
        //flatMap将filterCharacter返回的所有流连接成了一个流，可以理解为
//将filterCharacter返回的流中元素取出来放到流stream3中
        Stream<Character> stream3 = strList.stream()
                .flatMap(test2::filterCharacter);
        //{a,a,a,b,b,b,c,c,c,d,d,d,e,e,e}，将filterCharacter返回的小流连接成大流
        stream3.forEach(System.out::println);
    }

    public static Stream<Character> filterCharacter(String str){
        List<Character> list = new ArrayList<>();

        for (Character ch : str.toCharArray()) {
            list.add(ch);
        }

        return list.stream();
    }
}

4.3 排序

方法	描述
sorted()	产生一个新流，其中按自然顺序排序
sorted(Comparator comp)	产生一个新流，其中按比较器顺序排序

• 代码实现

import com.jin.oauth2demo.domain.Employee;
import org.junit.Test;

import java.util.Arrays;
import java.util.List;

public class test3 {
    List<Employee> emps = Arrays.asList(
            new Employee(101, "王一", 59, 6666),
            new Employee(102, "李二", 18, 9999),
            new Employee(103, "张三", 28, 3333),
            new Employee(105, "王五", 8, 7777),
            new Employee(105, "王五", 8, 7777),
            new Employee(106, "赵六", 8, 77777),
            new Employee(107, "田七", 38, 5555)
    );
   /*
      排序
      sorted()——自然排序（Comparable中的comparaTo方法）
      sorted(Comparator com)——定制排序
    */
    @Test
    public void test2(){
        emps.stream()
                .map(Employee::getName)
                .sorted()//自然排序：String实现了Comparable接口并重写了comparaTo方法
                .forEach(System.out::println);

        System.out.println("------------------------------------");

        //Comparator 接口的认识
        emps.stream()
                .sorted((x, y) -> {
                    if(x.getAge() == y.getAge()){
                        return x.getName().compareTo(y.getName());
                    }else{
                        return Integer.compare(x.getAge(), y.getAge());
                    }
                }).forEach(System.out::println);
    }
}

对于定制排序，需要使用Lambda表达式取代Comparator函数式接口的匿名内部实现类重写compare方法。

五 终止操作

5.1 查找和匹配

方法	描述
allMatch(Predicate p)	检查是否匹配所有元素
anyMatch(Predicate p)	检查是否至少匹配一个元素
noneMatch(Predicate p)	检查是否没有匹配所有元素
findFirst()	返回第一个元素
findAny()	返回当前流中的任意元素
count()	返回流中元素总数
max(Comparator c)	返回流中最大值
min(Comparator c)	返回流中最小值
forEach(Consumer c)	内部迭代(使用 Collection 接口需要用户去做迭代，称为外部迭代。相反，Stream API 使用内部迭代)

• 代码实现

import org.junit.Test;

import java.util.Arrays;
import java.util.List;
import java.util.Optional;

public class test4 {
    /*
      查找与匹配
      allMatch——检查是否匹配所有元素
      anyMatch——检查是否至少匹配一个元素
      noneMatch——检查是否没有匹配的元素
      findFirst——返回第一个元素
      findAny——返回当前流中的任意元素
      count——返回流中元素的总个数
      max——返回流中最大值
      min——返回流中最小值
    */
    List<Employee> emps = Arrays.asList(
            new Employee(101, "王一", 59, 6666),
            new Employee(102, "李二", 18, 9999),
            new Employee(103, "张三", 28, 3333),
            new Employee(105, "王五", 8, 7777),
            new Employee(105, "王五", 8, 7777),
            new Employee(106, "赵六", 8, 77777),
            new Employee(107, "田七", 38, 5555)
    );
    //allMatch——检查是否匹配所有元素
    //anyMatch——检查是否至少匹配一个元素
    //noneMatch——检查是否没有匹配的元素
    @Test
    public void test1(){
        boolean allMatch = emps.stream().allMatch(e -> e.getAge() == 8);
        System.out.println("-----allMatch-----"+allMatch);
        boolean anyMatch = emps.stream().anyMatch(e -> e.getAge() == 8);
        System.out.println("-----anyMatch-----"+anyMatch);
        boolean noneMatch = emps.stream().noneMatch(e -> e.getAge() == 8);
        System.out.println("-----noneMatch-----"+noneMatch);

    }
//    findFirst——返回第一个元素
//    findAny——返回当前流中的任意元素
//    count——返回流中元素的总个数
//    max——返回流中最大值
//    min——返回流中最小值
    @Test
    public void test2(){
        Optional<Integer> first = emps.stream().map(Employee::getAge).sorted().findFirst();
        System.out.println("-----findFirst-----"+first);
        Optional<Employee> any = emps.parallelStream().filter(e -> e.getAge()==59).sorted().findAny();
        System.out.println("-----findAny-----"+any);

        long count = emps.stream().count();
        System.out.println("-----count-----"+count);

        Optional<Integer> integerOptional = emps.stream()
                .map(Employee::getAge)
                .max(Integer::compare);//最大值
        System.out.println("-----max-----"+integerOptional.get());

        Optional<Employee> employeeOptional = emps.stream()
                .min((x, y) -> Integer.compare(x.getAge(),  y.getPrice())); // 最小值
        System.out.println("-----min-----"+employeeOptional.get());
        

    }
}

5.2 归约

方法	描述
reduce(T iden, BinaryOperator b)	可以将流中元素反复结合起来，得到一个值。 返回 T
reduce(BinaryOperator b)	可以将流中元素反复结合起来，得到一个值。 返回 Optional< T>

• ​ 代码实现

@Test
public void test3() {
    List<Integer> list = Arrays.asList(1, 2, 3, 4, 5, 6, 7, 8, 9, 10);

    Integer sum = list.stream()
            .reduce(1, (x, y) -> x + y);
    System.out.println(sum);
}

5.3 收集

方法	描述
collect(Collector c)	将流转换为其他形式。接收一个 Collector接口的 实现，用于给Stream中元素做汇总的方法

收集案例

//3. 终止操作
/*
	收集
	collect(Collector c)：将流转换为其他形式。接收一个 Collector接口的实现，用于给Stream中元素做汇总的方法
	Collector 接口中方法的实现决定了如何对流执行收集操作(如收集到 List、Set、Map)。但是 Collectors 实用类
	提供了很多静态方法，可以方便地创建常见收集器实例
 */
//collect——将流转换为其他形式。接收一个 Collector接口的实现，用于给Stream中元素做汇总的方法
@Test
public void test3(){
	//收集到List
	//如果不使用stream，需要遍历emps，逐个getName后，添加到List
	List<String> list = emps.stream()
		.map(Employee::getName)
		.collect(Collectors.toList());
	
	list.forEach(System.out::println);
	
	System.out.println("----------------------------------");
	//收集到Set（去重）
	Set<String> set = emps.stream()
		.map(Employee::getName)
		.collect(Collectors.toSet());//List，Set，Map，ConcurrentMap类直接to
	
	set.forEach(System.out::println);
 
	System.out.println("----------------------------------");
	//收集到HashSet
	HashSet<String> hs = emps.stream()
		.map(Employee::getName)
		.collect(Collectors.toCollection(HashSet::new));//toCollection(Supplier<C> collectionFactory)
	//List，Set，Map，ConcurrentMap类直接to，其他集合需要toCollection(其他集合::new)后重新造
	hs.forEach(System.out::println);
}

@Test
public void test4(){
	//获取工资的最大值（返回工资）
	Optional<Double> max = emps.stream()
		.map(Employee::getSalary)
		.collect(Collectors.maxBy(Double::compare));
	
	System.out.println(max.get());
 
	//获取工资最小的员工（返回员工）
	Optional<Employee> op = emps.stream()
		.collect(Collectors.minBy((e1, e2) -> Double.compare(e1.getSalary(), e2.getSalary())));
	
	System.out.println(op.get());
	//获取员工工资的总和
	Double sum = emps.stream()
		.collect(Collectors.summingDouble(Employee::getSalary));
	
	System.out.println(sum);
	//获取员工工资的平均值
	Double avg = emps.stream()
		.collect(Collectors.averagingDouble(Employee::getSalary));
	
	System.out.println(avg);
	获取员工数量
	Long count = emps.stream()
		.collect(Collectors.counting());
	
	System.out.println(count);
	
	System.out.println("--------------------------------------------");
	//得到最大值，最小值，平均值等的另一种方式
	DoubleSummaryStatistics dss = emps.stream()
		.collect(Collectors.summarizingDouble(Employee::getSalary));
	
	System.out.println(dss.getMax());
	System.out.println(dss.getMin());
	System.out.println(dss.getAverage());
	System.out.println(dss.getSum());
}

//分组
@Test
public void test5(){
	//按员工状态分组（注意：分组后的返回值应该是一个Map，key是Status，value是List<Employee>）
	Map<Status, List<Employee>> map = emps.stream()
		.collect(Collectors.groupingBy(Employee::getStatus));
	
	System.out.println(map);
	//遍历输出
	for(Map.Entry entry:map.entrySet()){
		System.out.println(entry.getKey()+"--->"+entry.getValue());
	}
}

//多级分组
@Test
public void test6(){
	//先按状态分组，再按年龄分组（注意：分组后的返回值是一个Map，key是Status，value是Map<String, List<Employee>>）
	Map<Status, Map<String, List<Employee>>> map = emps.stream()
		.collect(Collectors.groupingBy(Employee::getStatus, Collectors.groupingBy((e) -> {
			if(e.getAge() >= 60)
				return "老年";
			else if(e.getAge() >= 35)
				return "中年";
			else
				return "成年";
		})));
	
	System.out.println(map);
	//遍历输出
	for(Map.Entry entry:map.entrySet()) {
		Map<String, List<Employee>> map1 = (Map<String, List<Employee>>) entry.getValue();
		for (Map.Entry entry1 : map1.entrySet()) {
			System.out.println(entry.getKey() + "={" + entry1.getKey() + "=" + entry1.getValue()+"}");
		}
	}
}

//分区
@Test
public void test7(){
	//安工资是否大于等于5000分为两个区
	Map<Boolean, List<Employee>> map = emps.stream()
		.collect(Collectors.partitioningBy((e) -> e.getSalary() >= 5000));
	
	System.out.println(map);
}

//
@Test
public void test8(){
	//将员工姓名连接在一起，用逗号隔开（会自动去掉第一个和最后一个的逗号），并在首尾添加（----）
	String str = emps.stream()
		.map(Employee::getName)
		.collect(Collectors.joining("," , "----", "----"));
	
	System.out.println(str);
}

@Test
public void test9(){
	Optional<Double> sum = emps.stream()
		.map(Employee::getSalary)
		.collect(Collectors.reducing(Double::sum));
	
	System.out.println(sum.get());
}