mirror of
https://gitee.com/chinabugotech/hutool.git
synced 2025-05-09 23:51:34 +08:00
将EasyStream部分代理方法分离至公共父类
This commit is contained in:
huangchengxing
parent
f4fc7793eb
commit
9e20dbb7a0
@ -9,41 +9,15 @@ import cn.hutool.core.lang.mutable.MutableObj;
|
||||
import cn.hutool.core.map.MapUtil;
|
||||
import cn.hutool.core.text.StrUtil;
|
||||
import cn.hutool.core.util.ArrayUtil;
|
||||
import cn.hutool.core.util.ObjUtil;
|
||||
|
||||
import java.util.ArrayList;
|
||||
import java.util.Collection;
|
||||
import java.util.Comparator;
|
||||
import java.util.HashMap;
|
||||
import java.util.HashSet;
|
||||
import java.util.Iterator;
|
||||
import java.util.List;
|
||||
import java.util.Map;
|
||||
import java.util.Objects;
|
||||
import java.util.Optional;
|
||||
import java.util.Set;
|
||||
import java.util.Spliterator;
|
||||
import java.util.Spliterators;
|
||||
import java.util.*;
|
||||
import java.util.concurrent.ConcurrentHashMap;
|
||||
import java.util.concurrent.atomic.AtomicBoolean;
|
||||
import java.util.concurrent.atomic.AtomicInteger;
|
||||
import java.util.function.BiConsumer;
|
||||
import java.util.function.BiFunction;
|
||||
import java.util.function.BiPredicate;
|
||||
import java.util.function.BinaryOperator;
|
||||
import java.util.function.Consumer;
|
||||
import java.util.function.Function;
|
||||
import java.util.function.IntFunction;
|
||||
import java.util.function.Predicate;
|
||||
import java.util.function.Supplier;
|
||||
import java.util.function.ToDoubleFunction;
|
||||
import java.util.function.ToIntFunction;
|
||||
import java.util.function.ToLongFunction;
|
||||
import java.util.function.UnaryOperator;
|
||||
import java.util.function.*;
|
||||
import java.util.stream.Collector;
|
||||
import java.util.stream.Collectors;
|
||||
import java.util.stream.DoubleStream;
|
||||
import java.util.stream.IntStream;
|
||||
import java.util.stream.LongStream;
|
||||
import java.util.stream.Stream;
|
||||
import java.util.stream.StreamSupport;
|
||||
|
||||
@ -82,21 +56,19 @@ import java.util.stream.StreamSupport;
|
||||
* @see java.util.stream.Stream
|
||||
* @since 6.0.0
|
||||
*/
|
||||
public class EasyStream<T> implements Stream<T>, Iterable<T> {
|
||||
public class EasyStream<T> extends StreamWrapper<T, EasyStream<T>> implements Stream<T>, Iterable<T> {
|
||||
/**
|
||||
* 代表不存在的下标, 一般用于并行流的下标, 或者未找到元素时的下标
|
||||
*/
|
||||
private static final int NOT_FOUND_INDEX = -1;
|
||||
|
||||
protected final Stream<T> stream;
|
||||
|
||||
/**
|
||||
* 构造
|
||||
*
|
||||
* @param stream {@link Stream}
|
||||
*/
|
||||
EasyStream(final Stream<T> stream) {
|
||||
this.stream = null == stream ? Stream.empty() : stream;
|
||||
super(ObjUtil.isNull(stream) ? Stream.empty() : stream);
|
||||
}
|
||||
|
||||
// region Static method
|
||||
@ -280,18 +252,6 @@ public class EasyStream<T> implements Stream<T>, Iterable<T> {
|
||||
// --------------------------------------------------------------- Static method end
|
||||
// endregion
|
||||
|
||||
/**
|
||||
* 过滤元素，返回与指定断言匹配的元素组成的流
|
||||
* 这是一个无状态中间操作
|
||||
*
|
||||
* @param predicate 断言
|
||||
* @return 返回叠加过滤操作后的流
|
||||
*/
|
||||
@Override
|
||||
public EasyStream<T> filter(final Predicate<? super T> predicate) {
|
||||
return new EasyStream<>(stream.filter(predicate));
|
||||
}
|
||||
|
||||
/**
|
||||
* 过滤元素，返回与 指定操作结果 匹配 指定值 的元素组成的流
|
||||
* 这是一个无状态中间操作
|
||||
@ -414,42 +374,6 @@ public class EasyStream<T> implements Stream<T>, Iterable<T> {
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 和{@link EasyStream#map(Function)}一样，只不过函数的返回值必须为int类型
|
||||
* 这是一个无状态中间操作
|
||||
*
|
||||
* @param mapper 返回值为int类型的函数
|
||||
* @return 叠加操作后元素类型全为int的流
|
||||
*/
|
||||
@Override
|
||||
public IntStream mapToInt(final ToIntFunction<? super T> mapper) {
|
||||
return stream.mapToInt(mapper);
|
||||
}
|
||||
|
||||
/**
|
||||
* 和{@link EasyStream#map(Function)}一样，只不过函数的返回值必须为long类型
|
||||
* 这是一个无状态中间操作
|
||||
*
|
||||
* @param mapper 返回值为long类型的函数
|
||||
* @return 叠加操作后元素类型全为long的流
|
||||
*/
|
||||
@Override
|
||||
public LongStream mapToLong(final ToLongFunction<? super T> mapper) {
|
||||
return stream.mapToLong(mapper);
|
||||
}
|
||||
|
||||
/**
|
||||
* 和{@link EasyStream#map(Function)}一样，只不过函数的返回值必须为double类型
|
||||
* 这是一个无状态中间操作
|
||||
*
|
||||
* @param mapper 返回值为double类型的函数
|
||||
* @return 叠加操作后元素类型全为double的流
|
||||
*/
|
||||
@Override
|
||||
public DoubleStream mapToDouble(final ToDoubleFunction<? super T> mapper) {
|
||||
return stream.mapToDouble(mapper);
|
||||
}
|
||||
|
||||
/**
|
||||
* 扩散流操作，可能影响流元素个数，将原有流元素执行mapper操作, 转换为迭代器元素,
|
||||
* 最后返回所有迭代器的所有元素组成的流<br>
|
||||
@ -483,42 +407,6 @@ public class EasyStream<T> implements Stream<T>, Iterable<T> {
|
||||
return nonNull().flat(mapper).nonNull();
|
||||
}
|
||||
|
||||
/**
|
||||
* 扩散流操作，可能影响流元素个数，将原有流元素执行mapper操作，返回多个流所有元素组成的流
|
||||
* 这是一个无状态中间操作
|
||||
*
|
||||
* @param mapper 操作，返回IntStream
|
||||
* @return 返回叠加拆分操作后的IntStream
|
||||
*/
|
||||
@Override
|
||||
public IntStream flatMapToInt(final Function<? super T, ? extends IntStream> mapper) {
|
||||
return stream.flatMapToInt(mapper);
|
||||
}
|
||||
|
||||
/**
|
||||
* 扩散流操作，可能影响流元素个数，将原有流元素执行mapper操作，返回多个流所有元素组成的流
|
||||
* 这是一个无状态中间操作
|
||||
*
|
||||
* @param mapper 操作，返回LongStream
|
||||
* @return 返回叠加拆分操作后的LongStream
|
||||
*/
|
||||
@Override
|
||||
public LongStream flatMapToLong(final Function<? super T, ? extends LongStream> mapper) {
|
||||
return stream.flatMapToLong(mapper);
|
||||
}
|
||||
|
||||
/**
|
||||
* 扩散流操作，可能影响流元素个数，将原有流元素执行mapper操作，返回多个流所有元素组成的流
|
||||
* 这是一个无状态中间操作
|
||||
*
|
||||
* @param mapper 操作，返回DoubleStream
|
||||
* @return 返回叠加拆分操作后的DoubleStream
|
||||
*/
|
||||
@Override
|
||||
public DoubleStream flatMapToDouble(final Function<? super T, ? extends DoubleStream> mapper) {
|
||||
return stream.flatMapToDouble(mapper);
|
||||
}
|
||||
|
||||
/**
|
||||
* 扩散流操作，可能影响流元素个数，将原有流元素执行mapper操作，返回多个流所有元素组成的流，操作带一个方法，调用该方法可增加元素
|
||||
* 这是一个无状态中间操作
|
||||
@ -536,17 +424,6 @@ public class EasyStream<T> implements Stream<T>, Iterable<T> {
|
||||
});
|
||||
}
|
||||
|
||||
/**
|
||||
* 返回一个具有去重特征的流 非并行流(顺序流)下对于重复元素，保留遇到顺序中最先出现的元素，并行流情况下不能保证具体保留哪一个
|
||||
* 这是一个有状态中间操作
|
||||
*
|
||||
* @return 一个具有去重特征的流
|
||||
*/
|
||||
@Override
|
||||
public EasyStream<T> distinct() {
|
||||
return new EasyStream<>(stream.distinct());
|
||||
}
|
||||
|
||||
/**
|
||||
* 返回一个具有去重特征的流 非并行流(顺序流)下对于重复元素，保留遇到顺序中最先出现的元素，并行流情况下不能保证具体保留哪一个
|
||||
* 这是一个有状态中间操作
|
||||
@ -582,55 +459,6 @@ public class EasyStream<T> implements Stream<T>, Iterable<T> {
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 返回一个元素按自然顺序排序的流
|
||||
* 如果此流的元素不是{@code Comparable} ，则在执行终端操作时可能会抛出 {@code java.lang.ClassCastException}
|
||||
* 对于顺序流，排序是稳定的。 对于无序流，没有稳定性保证。
|
||||
* 这是一个有状态中间操作
|
||||
*
|
||||
* @return 一个元素按自然顺序排序的流
|
||||
*/
|
||||
@Override
|
||||
public EasyStream<T> sorted() {
|
||||
return new EasyStream<>(stream.sorted());
|
||||
}
|
||||
|
||||
/**
|
||||
* 返回一个元素按指定的{@link Comparator}排序的流
|
||||
* 如果此流的元素不是{@code Comparable} ，则在执行终端操作时可能会抛出{@code java.lang.ClassCastException}
|
||||
* 对于顺序流，排序是稳定的。 对于无序流，没有稳定性保证。
|
||||
* 这是一个有状态中间操作
|
||||
*
|
||||
* @param comparator 排序规则
|
||||
* @return 一个元素按指定的Comparator排序的流
|
||||
*/
|
||||
@Override
|
||||
public EasyStream<T> sorted(final Comparator<? super T> comparator) {
|
||||
return new EasyStream<>(stream.sorted(comparator));
|
||||
}
|
||||
|
||||
/**
|
||||
* 返回与指定函数将元素作为参数执行后组成的流。
|
||||
* 这是一个无状态中间操作
|
||||
*
|
||||
* @param action 指定的函数
|
||||
* @return 返回叠加操作后的FastStream
|
||||
* @apiNote 该方法存在的意义主要是用来调试
|
||||
* 当你需要查看经过操作管道某处的元素，可以执行以下操作:
|
||||
* <pre>{@code
|
||||
* .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>
|
||||
*/
|
||||
@Override
|
||||
public EasyStream<T> peek(final Consumer<? super T> action) {
|
||||
return new EasyStream<>(stream.peek(action));
|
||||
}
|
||||
|
||||
/**
|
||||
* 返回与指定函数将元素作为参数执行后组成的流。操作带下标，并行流时下标永远为-1
|
||||
* 这是一个无状态中间操作
|
||||
@ -656,6 +484,7 @@ public class EasyStream<T> implements Stream<T>, Iterable<T> {
|
||||
return peek(e -> action.accept(e, index.incrementAndGet()));
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 返回叠加调用{@link Console#log(Object)}打印出结果的流
|
||||
*
|
||||
@ -665,53 +494,6 @@ public class EasyStream<T> implements Stream<T>, Iterable<T> {
|
||||
return peek(Console::log);
|
||||
}
|
||||
|
||||
/**
|
||||
* 返回截取后面一些元素的流
|
||||
* 这是一个短路状态中间操作
|
||||
*
|
||||
* @param maxSize 元素截取后的个数
|
||||
* @return 截取后的流
|
||||
*/
|
||||
@Override
|
||||
public EasyStream<T> limit(final long maxSize) {
|
||||
return new EasyStream<>(stream.limit(maxSize));
|
||||
}
|
||||
|
||||
/**
|
||||
* 返回丢弃前面n个元素后的剩余元素组成的流，如果当前元素个数小于n，则返回一个元素为空的流
|
||||
* 这是一个有状态中间操作
|
||||
*
|
||||
* @param n 需要丢弃的元素个数
|
||||
* @return 丢弃前面n个元素后的剩余元素组成的流
|
||||
*/
|
||||
@Override
|
||||
public EasyStream<T> skip(final long n) {
|
||||
return new EasyStream<>(stream.skip(n));
|
||||
}
|
||||
|
||||
/**
|
||||
* 返回一个串行流，该方法可以将并行流转换为串行流
|
||||
*
|
||||
* @return 串行流
|
||||
*/
|
||||
@Override
|
||||
public EasyStream<T> sequential() {
|
||||
//noinspection ResultOfMethodCallIgnored
|
||||
stream.sequential();
|
||||
return this;
|
||||
}
|
||||
|
||||
/**
|
||||
* 对流里面的每一个元素执行一个操作
|
||||
* 这是一个终端操作
|
||||
*
|
||||
* @param action 操作
|
||||
*/
|
||||
@Override
|
||||
public void forEach(final Consumer<? super T> action) {
|
||||
stream.forEach(action);
|
||||
}
|
||||
|
||||
/**
|
||||
* 对流里面的每一个元素执行一个操作，操作带下标，并行流时下标永远为-1
|
||||
* 这是一个终端操作
|
||||
@ -728,17 +510,6 @@ public class EasyStream<T> implements Stream<T>, Iterable<T> {
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 对流里面的每一个元素按照顺序执行一个操作
|
||||
* 这是一个终端操作
|
||||
*
|
||||
* @param action 操作
|
||||
*/
|
||||
@Override
|
||||
public void forEachOrdered(final Consumer<? super T> action) {
|
||||
stream.forEachOrdered(action);
|
||||
}
|
||||
|
||||
/**
|
||||
* 对流里面的每一个元素按照顺序执行一个操作，操作带下标，并行流时下标永远为-1
|
||||
* 这是一个终端操作
|
||||
@ -755,216 +526,6 @@ public class EasyStream<T> implements Stream<T>, Iterable<T> {
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 返回一个包含此流元素的数组
|
||||
* 这是一个终端操作
|
||||
*
|
||||
* @return 包含此流元素的数组
|
||||
*/
|
||||
@Override
|
||||
public Object[] toArray() {
|
||||
return stream.toArray();
|
||||
}
|
||||
|
||||
/**
|
||||
* 返回一个包含此流元素的指定的数组，例如以下代码编译正常，但运行时会抛出 {@link ArrayStoreException}
|
||||
* <pre>{@code String[] strings = Stream.<Integer>builder().add(1).build().toArray(String[]::new); }</pre>
|
||||
*
|
||||
* @param generator 这里的IntFunction的参数是元素的个数，返回值为数组类型
|
||||
* @param <A> 给定的数组类型
|
||||
* @return 包含此流元素的指定的数组
|
||||
* @throws ArrayStoreException 如果元素转换失败，例如不是该元素类型及其父类，则抛出该异常
|
||||
*/
|
||||
@Override
|
||||
public <A> A[] toArray(final IntFunction<A[]> generator) {
|
||||
//noinspection SuspiciousToArrayCall
|
||||
return stream.toArray(generator);
|
||||
}
|
||||
|
||||
/**
|
||||
* 对元素进行聚合，并返回聚合后的值，相当于在for循环里写sum=sum+ints[i]
|
||||
* 这是一个终端操作<br>
|
||||
* 求和、最小值、最大值、平均值和转换成一个String字符串均为聚合操作
|
||||
* 例如这里对int进行求和可以写成：
|
||||
*
|
||||
* <pre>{@code
|
||||
* Integer sum = integers.reduce(0, (a, b) -> a+b);
|
||||
* }</pre>
|
||||
* <p>
|
||||
* 或者写成:
|
||||
*
|
||||
* <pre>{@code
|
||||
* Integer sum = integers.reduce(0, Integer::sum);
|
||||
* }</pre>
|
||||
*
|
||||
* @param identity 初始值，还用于限定泛型
|
||||
* @param accumulator 你想要的聚合操作
|
||||
* @return 聚合计算后的值
|
||||
*/
|
||||
@Override
|
||||
public T reduce(final T identity, final BinaryOperator<T> accumulator) {
|
||||
return stream.reduce(identity, accumulator);
|
||||
}
|
||||
|
||||
/**
|
||||
* 对元素进行聚合，并返回聚合后用 {@link Optional}包裹的值，相当于在for循环里写sum=sum+ints[i]
|
||||
* 该操作相当于：
|
||||
* <pre>{@code
|
||||
* boolean foundAny = false;
|
||||
* T result = null;
|
||||
* for (T element : this stream) {
|
||||
* if (!foundAny) {
|
||||
* foundAny = true;
|
||||
* result = element;
|
||||
* }
|
||||
* else
|
||||
* result = accumulator.apply(result, element);
|
||||
* }
|
||||
* return foundAny ? Optional.of(result) : Optional.empty();
|
||||
* }</pre>
|
||||
* 但它不局限于顺序执行，例如并行流等情况下
|
||||
* 这是一个终端操作<br>
|
||||
* 例如以下场景抛出 NPE ：
|
||||
* <pre>{@code
|
||||
* Optional<Integer> reduce = Stream.<Integer>builder().add(1).add(1).build().reduce((a, b) -> null);
|
||||
* }</pre>
|
||||
*
|
||||
* @param accumulator 你想要的聚合操作
|
||||
* @return 聚合后用 {@link Optional}包裹的值
|
||||
* @throws NullPointerException 如果给定的聚合操作中执行后结果为空，并用于下一次执行，则抛出该异常
|
||||
* @see #reduce(Object, BinaryOperator)
|
||||
* @see #min(Comparator)
|
||||
* @see #max(Comparator)
|
||||
*/
|
||||
@Override
|
||||
public Optional<T> reduce(final BinaryOperator<T> accumulator) {
|
||||
return stream.reduce(accumulator);
|
||||
}
|
||||
|
||||
/**
|
||||
* 对元素进行聚合，并返回聚合后的值，并行流时聚合拿到的初始值不稳定
|
||||
* 这是一个终端操作
|
||||
*
|
||||
* @param identity 初始值
|
||||
* @param accumulator 累加器，具体为你要的聚合操作
|
||||
* @param combiner 用于并行流时组合多个结果
|
||||
* @param <U> 初始值
|
||||
* @return 聚合操作的结果
|
||||
* @see #reduce(BinaryOperator)
|
||||
* @see #reduce(Object, BinaryOperator)
|
||||
*/
|
||||
@Override
|
||||
public <U> U reduce(final U identity, final BiFunction<U, ? super T, U> accumulator, final BinaryOperator<U> combiner) {
|
||||
return stream.reduce(identity, accumulator, combiner);
|
||||
}
|
||||
|
||||
/**
|
||||
* 对元素进行收集，并返回收集后的容器
|
||||
* 这是一个终端操作
|
||||
*
|
||||
* @param supplier 提供初始值的函数式接口，一般可以传入构造参数
|
||||
* @param accumulator 具体收集操作
|
||||
* @param combiner 用于并行流时组合多个结果
|
||||
* @param <R> 用于收集元素的容器，大多是集合
|
||||
* @return 收集后的容器
|
||||
* <pre>{@code
|
||||
* List<Integer> collect = Stream.iterate(1, i -> ++i).limit(10).collect(ArrayList::new, ArrayList::add, ArrayList::addAll);
|
||||
* }</pre>
|
||||
*/
|
||||
@Override
|
||||
public <R> R collect(final Supplier<R> supplier, final BiConsumer<R, ? super T> accumulator, final BiConsumer<R, R> combiner) {
|
||||
return stream.collect(supplier, accumulator, combiner);
|
||||
}
|
||||
|
||||
/**
|
||||
* 对元素进行收集，并返回收集后的元素
|
||||
* 这是一个终端操作
|
||||
*
|
||||
* @param collector 收集器
|
||||
* @param <R> 容器类型
|
||||
* @param <A> 具体操作时容器类型，例如 {@code List::add} 时它为 {@code List}
|
||||
* @return 收集后的容器
|
||||
*/
|
||||
@Override
|
||||
public <R, A> R collect(final Collector<? super T, A, R> collector) {
|
||||
return stream.collect(collector);
|
||||
}
|
||||
|
||||
/**
|
||||
* 获取最小值
|
||||
*
|
||||
* @param comparator 一个用来比较大小的比较器{@link Comparator}
|
||||
* @return 最小值
|
||||
*/
|
||||
@Override
|
||||
public Optional<T> min(final Comparator<? super T> comparator) {
|
||||
return stream.min(comparator);
|
||||
}
|
||||
|
||||
/**
|
||||
* 获取最大值
|
||||
*
|
||||
* @param comparator 一个用来比较大小的比较器{@link Comparator}
|
||||
* @return 最大值
|
||||
*/
|
||||
@Override
|
||||
public Optional<T> max(final Comparator<? super T> comparator) {
|
||||
return stream.max(comparator);
|
||||
}
|
||||
|
||||
/**
|
||||
* 返回流元素个数
|
||||
*
|
||||
* @return 流元素个数
|
||||
*/
|
||||
@Override
|
||||
public long count() {
|
||||
return stream.count();
|
||||
}
|
||||
|
||||
/**
|
||||
* 判断是否有任何一个元素满足给定断言
|
||||
*
|
||||
* @param predicate 断言
|
||||
* @return 是否有任何一个元素满足给定断言
|
||||
*/
|
||||
@Override
|
||||
public boolean anyMatch(final Predicate<? super T> predicate) {
|
||||
return stream.anyMatch(predicate);
|
||||
}
|
||||
|
||||
/**
|
||||
* 判断是否所有元素满足给定断言
|
||||
*
|
||||
* @param predicate 断言
|
||||
* @return 是否所有元素满足给定断言
|
||||
*/
|
||||
@Override
|
||||
public boolean allMatch(final Predicate<? super T> predicate) {
|
||||
return stream.allMatch(predicate);
|
||||
}
|
||||
|
||||
/**
|
||||
* 判断是否没有元素满足给定断言
|
||||
*
|
||||
* @param predicate 断言
|
||||
* @return 是否没有元素满足给定断言
|
||||
*/
|
||||
@Override
|
||||
public boolean noneMatch(final Predicate<? super T> predicate) {
|
||||
return stream.noneMatch(predicate);
|
||||
}
|
||||
|
||||
/**
|
||||
* 获取第一个元素
|
||||
*
|
||||
* @return 第一个元素
|
||||
*/
|
||||
@Override
|
||||
public Optional<T> findFirst() {
|
||||
return stream.findFirst();
|
||||
}
|
||||
|
||||
/**
|
||||
* 获取与给定断言匹配的第一个元素
|
||||
*
|
||||
@ -1057,48 +618,6 @@ public class EasyStream<T> implements Stream<T>, Iterable<T> {
|
||||
return of(array).parallel(isParallel()).onClose(stream::close);
|
||||
}
|
||||
|
||||
/**
|
||||
* 考虑性能，随便取一个，这里不是随机取一个，是随便取一个
|
||||
*
|
||||
* @return 随便取一个
|
||||
*/
|
||||
@Override
|
||||
public Optional<T> findAny() {
|
||||
return stream.findAny();
|
||||
}
|
||||
|
||||
/**
|
||||
* 返回流的迭代器
|
||||
*
|
||||
* @return 流的迭代器
|
||||
*/
|
||||
@Override
|
||||
public Iterator<T> iterator() {
|
||||
return stream.iterator();
|
||||
}
|
||||
|
||||
/**
|
||||
* 返回流的拆分器
|
||||
*
|
||||
* @return 流的拆分器
|
||||
*/
|
||||
@Override
|
||||
public Spliterator<T> spliterator() {
|
||||
return stream.spliterator();
|
||||
}
|
||||
|
||||
/**
|
||||
* 将流转换为并行
|
||||
*
|
||||
* @return 并行流
|
||||
*/
|
||||
@Override
|
||||
public EasyStream<T> parallel() {
|
||||
//noinspection ResultOfMethodCallIgnored
|
||||
stream.parallel();
|
||||
return this;
|
||||
}
|
||||
|
||||
/**
|
||||
* 更改流的并行状态
|
||||
*
|
||||
@ -1109,30 +628,6 @@ public class EasyStream<T> implements Stream<T>, Iterable<T> {
|
||||
return parallel ? parallel() : sequential();
|
||||
}
|
||||
|
||||
/**
|
||||
* 返回一个无序流(无手动排序)
|
||||
* <p>标记一个流是不在意元素顺序的, 在并行流的某些情况下可以提高性能</p>
|
||||
*
|
||||
* @return 无序流
|
||||
*/
|
||||
@Override
|
||||
public EasyStream<T> unordered() {
|
||||
return new EasyStream<>(stream.unordered());
|
||||
}
|
||||
|
||||
/**
|
||||
* 在流关闭时执行操作
|
||||
*
|
||||
* @param closeHandler 在流关闭时执行的操作
|
||||
* @return 流
|
||||
*/
|
||||
@Override
|
||||
public EasyStream<T> onClose(final Runnable closeHandler) {
|
||||
//noinspection ResultOfMethodCallIgnored
|
||||
stream.onClose(closeHandler);
|
||||
return this;
|
||||
}
|
||||
|
||||
/**
|
||||
* 与给定元素组成的流合并，成为新的流
|
||||
*
|
||||
@ -1187,57 +682,14 @@ public class EasyStream<T> implements Stream<T>, Iterable<T> {
|
||||
}
|
||||
|
||||
/**
|
||||
* 返回流的并行状态
|
||||
* 根据一个原始的流，返回一个新包装类实例
|
||||
*
|
||||
* @return 流的并行状态
|
||||
* @param stream 流
|
||||
* @return 实现类
|
||||
*/
|
||||
@Override
|
||||
public boolean isParallel() {
|
||||
return stream.isParallel();
|
||||
}
|
||||
|
||||
/**
|
||||
* 关闭流
|
||||
*
|
||||
* @see AutoCloseable#close()
|
||||
*/
|
||||
@Override
|
||||
public void close() {
|
||||
stream.close();
|
||||
}
|
||||
|
||||
/**
|
||||
* hashcode
|
||||
*
|
||||
* @return hashcode
|
||||
*/
|
||||
@Override
|
||||
public int hashCode() {
|
||||
return stream.hashCode();
|
||||
}
|
||||
|
||||
/**
|
||||
* equals
|
||||
*
|
||||
* @param obj 对象
|
||||
* @return 结果
|
||||
*/
|
||||
@Override
|
||||
public boolean equals(final Object obj) {
|
||||
if (obj instanceof Stream) {
|
||||
return stream.equals(obj);
|
||||
}
|
||||
return false;
|
||||
}
|
||||
|
||||
/**
|
||||
* toString
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
@Override
|
||||
public String toString() {
|
||||
return stream.toString();
|
||||
protected EasyStream<T> convertToStreamImpl(Stream<T> stream) {
|
||||
return new EasyStream<>(stream);
|
||||
}
|
||||
|
||||
/**
|
||||
|
||||
@ -0,0 +1,563 @@
|
||||
package cn.hutool.core.stream;
|
||||
|
||||
import java.util.*;
|
||||
import java.util.function.*;
|
||||
import java.util.stream.*;
|
||||
|
||||
/**
|
||||
* {@link Stream}的包装类，用于基于一个已有的流实例进行扩展
|
||||
*
|
||||
* @author huangchengxing
|
||||
* @see EasyStream
|
||||
*/
|
||||
abstract class StreamWrapper<T, I extends Stream<T>> implements Stream<T>, Iterable<T> {
|
||||
|
||||
/**
|
||||
* 原始的流实例
|
||||
*/
|
||||
protected final Stream<T> stream;
|
||||
|
||||
/**
|
||||
* 创建一个流包装器
|
||||
*
|
||||
* @param stream 包装的流对象
|
||||
*/
|
||||
protected StreamWrapper(Stream<T> stream) {
|
||||
Objects.requireNonNull(stream, "stream must not null");
|
||||
this.stream = stream;
|
||||
}
|
||||
|
||||
/**
|
||||
* 过滤元素，返回与指定断言匹配的元素组成的流
|
||||
* 这是一个无状态中间操作
|
||||
*
|
||||
* @param predicate 断言
|
||||
* @return 返回叠加过滤操作后的流
|
||||
*/
|
||||
@Override
|
||||
public I filter(Predicate<? super T> predicate) {
|
||||
return convertToStreamImpl(stream.filter(predicate));
|
||||
}
|
||||
|
||||
/**
|
||||
* 和{@link EasyStream#map(Function)}一样，只不过函数的返回值必须为int类型
|
||||
* 这是一个无状态中间操作
|
||||
*
|
||||
* @param mapper 返回值为int类型的函数
|
||||
* @return 叠加操作后元素类型全为int的流
|
||||
*/
|
||||
@Override
|
||||
public IntStream mapToInt(ToIntFunction<? super T> mapper) {
|
||||
return stream.mapToInt(mapper);
|
||||
}
|
||||
|
||||
/**
|
||||
* 和{@link EasyStream#map(Function)}一样，只不过函数的返回值必须为long类型
|
||||
* 这是一个无状态中间操作
|
||||
*
|
||||
* @param mapper 返回值为long类型的函数
|
||||
* @return 叠加操作后元素类型全为long的流
|
||||
*/
|
||||
@Override
|
||||
public LongStream mapToLong(ToLongFunction<? super T> mapper) {
|
||||
return stream.mapToLong(mapper);
|
||||
}
|
||||
|
||||
/**
|
||||
* 和{@link EasyStream#map(Function)}一样，只不过函数的返回值必须为double类型
|
||||
* 这是一个无状态中间操作
|
||||
*
|
||||
* @param mapper 返回值为double类型的函数
|
||||
* @return 叠加操作后元素类型全为double的流
|
||||
*/
|
||||
@Override
|
||||
public DoubleStream mapToDouble(ToDoubleFunction<? super T> mapper) {
|
||||
return stream.mapToDouble(mapper);
|
||||
}
|
||||
|
||||
/**
|
||||
* 扩散流操作，可能影响流元素个数，将原有流元素执行mapper操作，返回多个流所有元素组成的流
|
||||
* 这是一个无状态中间操作
|
||||
*
|
||||
* @param mapper 操作，返回IntStream
|
||||
* @return 返回叠加拆分操作后的IntStream
|
||||
*/
|
||||
@Override
|
||||
public IntStream flatMapToInt(Function<? super T, ? extends IntStream> mapper) {
|
||||
return stream.flatMapToInt(mapper);
|
||||
}
|
||||
|
||||
/**
|
||||
* 扩散流操作，可能影响流元素个数，将原有流元素执行mapper操作，返回多个流所有元素组成的流
|
||||
* 这是一个无状态中间操作
|
||||
*
|
||||
* @param mapper 操作，返回LongStream
|
||||
* @return 返回叠加拆分操作后的LongStream
|
||||
*/
|
||||
@Override
|
||||
public LongStream flatMapToLong(Function<? super T, ? extends LongStream> mapper) {
|
||||
return stream.flatMapToLong(mapper);
|
||||
}
|
||||
|
||||
/**
|
||||
* 扩散流操作，可能影响流元素个数，将原有流元素执行mapper操作，返回多个流所有元素组成的流
|
||||
* 这是一个无状态中间操作
|
||||
*
|
||||
* @param mapper 操作，返回DoubleStream
|
||||
* @return 返回叠加拆分操作后的DoubleStream
|
||||
*/
|
||||
@Override
|
||||
public DoubleStream flatMapToDouble(Function<? super T, ? extends DoubleStream> mapper) {
|
||||
return stream.flatMapToDouble(mapper);
|
||||
}
|
||||
|
||||
/**
|
||||
* 返回一个具有去重特征的流 非并行流(顺序流)下对于重复元素，保留遇到顺序中最先出现的元素，并行流情况下不能保证具体保留哪一个
|
||||
* 这是一个有状态中间操作
|
||||
*
|
||||
* @return 一个具有去重特征的流
|
||||
*/
|
||||
@Override
|
||||
public I distinct() {
|
||||
return convertToStreamImpl(stream.distinct());
|
||||
}
|
||||
|
||||
/**
|
||||
* 返回一个元素按自然顺序排序的流
|
||||
* 如果此流的元素不是{@code Comparable} ，则在执行终端操作时可能会抛出 {@code java.lang.ClassCastException}
|
||||
* 对于顺序流，排序是稳定的。 对于无序流，没有稳定性保证。
|
||||
* 这是一个有状态中间操作
|
||||
*
|
||||
* @return 一个元素按自然顺序排序的流
|
||||
*/
|
||||
@Override
|
||||
public I sorted() {
|
||||
return convertToStreamImpl(stream.sorted());
|
||||
}
|
||||
|
||||
/**
|
||||
* 返回一个元素按指定的{@link Comparator}排序的流
|
||||
* 如果此流的元素不是{@code Comparable} ，则在执行终端操作时可能会抛出{@code java.lang.ClassCastException}
|
||||
* 对于顺序流，排序是稳定的。 对于无序流，没有稳定性保证。
|
||||
* 这是一个有状态中间操作
|
||||
*
|
||||
* @param comparator 排序规则
|
||||
* @return 一个元素按指定的Comparator排序的流
|
||||
*/
|
||||
@Override
|
||||
public I sorted(Comparator<? super T> comparator) {
|
||||
return convertToStreamImpl(stream.sorted(comparator));
|
||||
}
|
||||
|
||||
/**
|
||||
* 返回与指定函数将元素作为参数执行后组成的流。
|
||||
* 这是一个无状态中间操作
|
||||
*
|
||||
* @param action 指定的函数
|
||||
* @return 返回叠加操作后的FastStream
|
||||
* @apiNote 该方法存在的意义主要是用来调试
|
||||
* 当你需要查看经过操作管道某处的元素，可以执行以下操作:
|
||||
* <pre>{@code
|
||||
* .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>
|
||||
*/
|
||||
@Override
|
||||
public I peek(Consumer<? super T> action) {
|
||||
return convertToStreamImpl(stream.peek(action));
|
||||
}
|
||||
|
||||
/**
|
||||
* 返回截取后面一些元素的流
|
||||
* 这是一个短路状态中间操作
|
||||
*
|
||||
* @param maxSize 元素截取后的个数
|
||||
* @return 截取后的流
|
||||
*/
|
||||
@Override
|
||||
public I limit(long maxSize) {
|
||||
return convertToStreamImpl(stream.limit(maxSize));
|
||||
}
|
||||
|
||||
/**
|
||||
* 返回丢弃前面n个元素后的剩余元素组成的流，如果当前元素个数小于n，则返回一个元素为空的流
|
||||
* 这是一个有状态中间操作
|
||||
*
|
||||
* @param n 需要丢弃的元素个数
|
||||
* @return 丢弃前面n个元素后的剩余元素组成的流
|
||||
*/
|
||||
@Override
|
||||
public I skip(long n) {
|
||||
return convertToStreamImpl(stream.skip(n));
|
||||
}
|
||||
|
||||
/**
|
||||
* 对流里面的每一个元素执行一个操作
|
||||
* 这是一个终端操作
|
||||
*
|
||||
* @param action 操作
|
||||
*/
|
||||
@Override
|
||||
public void forEach(Consumer<? super T> action) {
|
||||
stream.forEach(action);
|
||||
}
|
||||
|
||||
/**
|
||||
* 对流里面的每一个元素按照顺序执行一个操作
|
||||
* 这是一个终端操作
|
||||
*
|
||||
* @param action 操作
|
||||
*/
|
||||
@Override
|
||||
public void forEachOrdered(Consumer<? super T> action) {
|
||||
stream.forEachOrdered(action);
|
||||
}
|
||||
|
||||
/**
|
||||
* 返回一个包含此流元素的数组
|
||||
* 这是一个终端操作
|
||||
*
|
||||
* @return 包含此流元素的数组
|
||||
*/
|
||||
@Override
|
||||
public Object[] toArray() {
|
||||
return stream.toArray();
|
||||
}
|
||||
|
||||
/**
|
||||
* 返回一个包含此流元素的指定的数组，例如以下代码编译正常，但运行时会抛出 {@link ArrayStoreException}
|
||||
* <pre>{@code String[] strings = Stream.<Integer>builder().add(1).build().toArray(String[]::new); }</pre>
|
||||
*
|
||||
* @param generator 这里的IntFunction的参数是元素的个数，返回值为数组类型
|
||||
* @param <A> 给定的数组类型
|
||||
* @return 包含此流元素的指定的数组
|
||||
* @throws ArrayStoreException 如果元素转换失败，例如不是该元素类型及其父类，则抛出该异常
|
||||
*/
|
||||
@Override
|
||||
public <A> A[] toArray(IntFunction<A[]> generator) {
|
||||
return stream.toArray(generator);
|
||||
}
|
||||
|
||||
/**
|
||||
* 对元素进行聚合，并返回聚合后的值，相当于在for循环里写sum=sum+ints[i]
|
||||
* 这是一个终端操作<br>
|
||||
* 求和、最小值、最大值、平均值和转换成一个String字符串均为聚合操作
|
||||
* 例如这里对int进行求和可以写成：
|
||||
*
|
||||
* <pre>{@code
|
||||
* Integer sum = integers.reduce(0, (a, b) -> a+b);
|
||||
* }</pre>
|
||||
* <p>
|
||||
* 或者写成:
|
||||
*
|
||||
* <pre>{@code
|
||||
* Integer sum = integers.reduce(0, Integer::sum);
|
||||
* }</pre>
|
||||
*
|
||||
* @param identity 初始值，还用于限定泛型
|
||||
* @param accumulator 你想要的聚合操作
|
||||
* @return 聚合计算后的值
|
||||
*/
|
||||
@Override
|
||||
public T reduce(T identity, BinaryOperator<T> accumulator) {
|
||||
return stream.reduce(identity, accumulator);
|
||||
}
|
||||
|
||||
/**
|
||||
* 对元素进行聚合，并返回聚合后用 {@link Optional}包裹的值，相当于在for循环里写sum=sum+ints[i]
|
||||
* 该操作相当于：
|
||||
* <pre>{@code
|
||||
* boolean foundAny = false;
|
||||
* T result = null;
|
||||
* for (T element : this stream) {
|
||||
* if (!foundAny) {
|
||||
* foundAny = true;
|
||||
* result = element;
|
||||
* }
|
||||
* else
|
||||
* result = accumulator.apply(result, element);
|
||||
* }
|
||||
* return foundAny ? Optional.of(result) : Optional.empty();
|
||||
* }</pre>
|
||||
* 但它不局限于顺序执行，例如并行流等情况下
|
||||
* 这是一个终端操作<br>
|
||||
* 例如以下场景抛出 NPE ：
|
||||
* <pre>{@code
|
||||
* Optional<Integer> reduce = Stream.<Integer>builder().add(1).add(1).build().reduce((a, b) -> null);
|
||||
* }</pre>
|
||||
*
|
||||
* @param accumulator 你想要的聚合操作
|
||||
* @return 聚合后用 {@link Optional}包裹的值
|
||||
* @throws NullPointerException 如果给定的聚合操作中执行后结果为空，并用于下一次执行，则抛出该异常
|
||||
* @see #reduce(Object, BinaryOperator)
|
||||
* @see #min(Comparator)
|
||||
* @see #max(Comparator)
|
||||
*/
|
||||
@Override
|
||||
public Optional<T> reduce(BinaryOperator<T> accumulator) {
|
||||
return stream.reduce(accumulator);
|
||||
}
|
||||
|
||||
/**
|
||||
* 对元素进行聚合，并返回聚合后的值，并行流时聚合拿到的初始值不稳定
|
||||
* 这是一个终端操作
|
||||
*
|
||||
* @param identity 初始值
|
||||
* @param accumulator 累加器，具体为你要的聚合操作
|
||||
* @param combiner 用于并行流时组合多个结果
|
||||
* @param <U> 初始值
|
||||
* @return 聚合操作的结果
|
||||
* @see #reduce(BinaryOperator)
|
||||
* @see #reduce(Object, BinaryOperator)
|
||||
*/
|
||||
@Override
|
||||
public <U> U reduce(U identity, BiFunction<U, ? super T, U> accumulator, BinaryOperator<U> combiner) {
|
||||
return stream.reduce(identity, accumulator, combiner);
|
||||
}
|
||||
|
||||
/**
|
||||
* 对元素进行收集，并返回收集后的容器
|
||||
* 这是一个终端操作
|
||||
*
|
||||
* @param supplier 提供初始值的函数式接口，一般可以传入构造参数
|
||||
* @param accumulator 具体收集操作
|
||||
* @param combiner 用于并行流时组合多个结果
|
||||
* @param <R> 用于收集元素的容器，大多是集合
|
||||
* @return 收集后的容器
|
||||
* <pre>{@code
|
||||
* List<Integer> collect = Stream.iterate(1, i -> ++i).limit(10).collect(ArrayList::new, ArrayList::add, ArrayList::addAll);
|
||||
* }</pre>
|
||||
*/
|
||||
@Override
|
||||
public <R> R collect(Supplier<R> supplier, BiConsumer<R, ? super T> accumulator, BiConsumer<R, R> combiner) {
|
||||
return stream.collect(supplier, accumulator, combiner);
|
||||
}
|
||||
|
||||
/**
|
||||
* 对元素进行收集，并返回收集后的元素
|
||||
* 这是一个终端操作
|
||||
*
|
||||
* @param collector 收集器
|
||||
* @param <R> 容器类型
|
||||
* @param <A> 具体操作时容器类型，例如 {@code List::add} 时它为 {@code List}
|
||||
* @return 收集后的容器
|
||||
*/
|
||||
@Override
|
||||
public <R, A> R collect(Collector<? super T, A, R> collector) {
|
||||
return stream.collect(collector);
|
||||
}
|
||||
|
||||
/**
|
||||
* 获取最小值
|
||||
*
|
||||
* @param comparator 一个用来比较大小的比较器{@link Comparator}
|
||||
* @return 最小值
|
||||
*/
|
||||
@Override
|
||||
public Optional<T> min(Comparator<? super T> comparator) {
|
||||
return stream.min(comparator);
|
||||
}
|
||||
|
||||
/**
|
||||
* 获取最大值
|
||||
*
|
||||
* @param comparator 一个用来比较大小的比较器{@link Comparator}
|
||||
* @return 最大值
|
||||
*/
|
||||
@Override
|
||||
public Optional<T> max(Comparator<? super T> comparator) {
|
||||
return stream.max(comparator);
|
||||
}
|
||||
|
||||
/**
|
||||
* 返回流元素个数
|
||||
*
|
||||
* @return 流元素个数
|
||||
*/
|
||||
@Override
|
||||
public long count() {
|
||||
return stream.count();
|
||||
}
|
||||
|
||||
/**
|
||||
* 判断是否有任何一个元素满足给定断言
|
||||
*
|
||||
* @param predicate 断言
|
||||
* @return 是否有任何一个元素满足给定断言
|
||||
*/
|
||||
@Override
|
||||
public boolean anyMatch(Predicate<? super T> predicate) {
|
||||
return stream.anyMatch(predicate);
|
||||
}
|
||||
|
||||
/**
|
||||
* 判断是否所有元素满足给定断言
|
||||
*
|
||||
* @param predicate 断言
|
||||
* @return 是否所有元素满足给定断言
|
||||
*/
|
||||
@Override
|
||||
public boolean allMatch(Predicate<? super T> predicate) {
|
||||
return stream.allMatch(predicate);
|
||||
}
|
||||
|
||||
/**
|
||||
* 判断是否没有元素满足给定断言
|
||||
*
|
||||
* @param predicate 断言
|
||||
* @return 是否没有元素满足给定断言
|
||||
*/
|
||||
@Override
|
||||
public boolean noneMatch(Predicate<? super T> predicate) {
|
||||
return stream.noneMatch(predicate);
|
||||
}
|
||||
|
||||
/**
|
||||
* 获取第一个元素
|
||||
*
|
||||
* @return 第一个元素
|
||||
*/
|
||||
@Override
|
||||
public Optional<T> findFirst() {
|
||||
return stream.findFirst();
|
||||
}
|
||||
|
||||
/**
|
||||
* 考虑性能，随便取一个，这里不是随机取一个，是随便取一个
|
||||
*
|
||||
* @return 随便取一个
|
||||
*/
|
||||
@Override
|
||||
public Optional<T> findAny() {
|
||||
return stream.findAny();
|
||||
}
|
||||
|
||||
/**
|
||||
* 返回流的迭代器
|
||||
*
|
||||
* @return 流的迭代器
|
||||
*/
|
||||
@Override
|
||||
public Iterator<T> iterator() {
|
||||
return stream.iterator();
|
||||
}
|
||||
|
||||
/**
|
||||
* 返回流的拆分器
|
||||
*
|
||||
* @return 流的拆分器
|
||||
*/
|
||||
@Override
|
||||
public Spliterator<T> spliterator() {
|
||||
return stream.spliterator();
|
||||
}
|
||||
|
||||
/**
|
||||
* 返回流的并行状态
|
||||
*
|
||||
* @return 流的并行状态
|
||||
*/
|
||||
@Override
|
||||
public boolean isParallel() {
|
||||
return stream.isParallel();
|
||||
}
|
||||
|
||||
/**
|
||||
* 返回一个串行流，该方法可以将并行流转换为串行流
|
||||
*
|
||||
* @return 串行流
|
||||
*/
|
||||
@Override
|
||||
public I sequential() {
|
||||
return convertToStreamImpl(stream.sequential());
|
||||
}
|
||||
|
||||
/**
|
||||
* 将流转换为并行
|
||||
*
|
||||
* @return 并行流
|
||||
*/
|
||||
@Override
|
||||
public I parallel() {
|
||||
return convertToStreamImpl(stream.parallel());
|
||||
}
|
||||
|
||||
/**
|
||||
* 返回一个无序流(无手动排序)
|
||||
* <p>标记一个流是不在意元素顺序的, 在并行流的某些情况下可以提高性能</p>
|
||||
*
|
||||
* @return 无序流
|
||||
*/
|
||||
@Override
|
||||
public I unordered() {
|
||||
return convertToStreamImpl(stream.unordered());
|
||||
}
|
||||
|
||||
/**
|
||||
* 在流关闭时执行操作
|
||||
*
|
||||
* @param closeHandler 在流关闭时执行的操作
|
||||
* @return 流
|
||||
*/
|
||||
@Override
|
||||
public I onClose(Runnable closeHandler) {
|
||||
return convertToStreamImpl(stream.onClose(closeHandler));
|
||||
}
|
||||
|
||||
/**
|
||||
* 关闭流
|
||||
*
|
||||
* @see AutoCloseable#close()
|
||||
*/
|
||||
@Override
|
||||
public void close() {
|
||||
stream.close();
|
||||
}
|
||||
|
||||
/**
|
||||
* hashcode
|
||||
*
|
||||
* @return hashcode
|
||||
*/
|
||||
@Override
|
||||
public int hashCode() {
|
||||
return stream.hashCode();
|
||||
}
|
||||
|
||||
/**
|
||||
* equals
|
||||
*
|
||||
* @param obj 对象
|
||||
* @return 结果
|
||||
*/
|
||||
@Override
|
||||
public boolean equals(final Object obj) {
|
||||
if (obj instanceof Stream) {
|
||||
return stream.equals(obj);
|
||||
}
|
||||
return false;
|
||||
}
|
||||
|
||||
/**
|
||||
* toString
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
@Override
|
||||
public String toString() {
|
||||
return stream.toString();
|
||||
}
|
||||
|
||||
/**
|
||||
* 根据一个原始的流，返回一个新包装类实例
|
||||
*
|
||||
* @param stream 流
|
||||
* @return 实现类
|
||||
*/
|
||||
protected abstract I convertToStreamImpl(Stream<T> stream);
|
||||
|
||||
}
|
||||
Loading…
x
Reference in New Issue
Block a user