【Java基础】Spliterator

2023-11-28 22:32
文章标签 java 基础 spliterator

本文主要是介绍【Java基础】Spliterator,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

Spliterator接口是1.8新加的不包含重复元素的集合。更正式地说,集合不包含元素对e1和e2,使得e1.equals(e2)和至多一个null元素。字面意思可分割的迭代器,不同以往的iterator需要顺序迭代,Spliterator可以分割为若干个小的迭代器进行并行操作,既可以实现多线程操作提高效率,又可以避免普通迭代器的fail-fast机制所带来的异常。Spliterator可以配合1.8新加的Stream进行并行流的实现,大大提高处理效率。

我们先看Spliterator接口的几个方法,然后结合我们之前看过的ArrayList中实现的ArrayListSpliterator进一步理解Spliterator:

属性

通过characteristics()方法返回的值,用来标识实现类所具有的的特征

public static final int ORDERED    = 0x00000010;//表示元素是有序的(每一次遍历结果相同)
public static final int DISTINCT   = 0x00000001;//表示元素不重复
public static final int SORTED     = 0x00000004;//表示元素是按一定规律进行排列(有指定比较器)
public static final int SIZED      = 0x00000040;//是否确定大小
public static final int NONNULL    = 0x00000100;//表示迭代器中没有null元素
public static final int IMMUTABLE  = 0x00000400;//表示元素不可变
public static final int CONCURRENT = 0x00001000;//表示迭代器可以多线程操作
public static final int SUBSIZED   = 0x00004000;//表示子Spliterators都具有SIZED特性

方法

  • boolean tryAdvance(Consumer<? super T> action);
    如果有剩余的元素存在,执行参数给定的操作,并返回true,否则就返回false。
    如果Spliterator对象具有ORDERED属性,那么tryAdvance也会按照相应的顺序去执行。

  • default void forEachRemaining(Consumer<? super T> action)
    对Spliterator的每一个对象执行tryAdvance操作

	default void forEachRemaining(Consumer<? super T> action) {do { } while (tryAdvance(action));}
  • Spliterator trySplit();
    如果这个Spliterator是可以被分割的,那么这个方法会返回一个Spliterator,与原来的Spliterator平分其中的元素,如果原Spliterator的元素个数单数,两个Spliterator的元素个数相差1,基本是相同的。 如果Spliterator不能再分割,那么会返回null

  • long estimateSize()
    返回一个预估的值,等于执行forEachRemaining方法时调用tryAdvance的次数。
    如果这个值过大,或者需要太复杂的计算过程,那么直接回返回long型的最大值

  • default long getExactSizeIfKnown()
    返回Spliterator对象确切的大小,如果存在SIZED属性,则返回estimateSize()方法的返回值,否则返回-1

	default long getExactSizeIfKnown() {return (characteristics() & SIZED) == 0 ? -1L : estimateSize();}
  • int characteristics();
    返回Spliterator对象的特征值,这个上面有介绍。一般实现类中的属性就是几个属性进行或操作之后的结果。

  • default boolean hasCharacteristics(int characteristics)
    根据characteristics()与参数相与的结果看Spliterator对象是否包含参数指定的属性

	default boolean hasCharacteristics(int characteristics) {return (characteristics() & characteristics) == characteristics;}
  • default Comparator<? super T> getComparator()
    如果Spliterator的具体实现具有SORTED属性,那么此方法会返回一个相应的比较器,否则会返回null
	default Comparator<? super T> getComparator() {throw new IllegalStateException();}

衍生接口

OfPrimitive

衍生借口的内容与Spliterator几乎无差别,只是将trySplit,tryAdvance,forEachRemaining三个方法中的参数类型做了一点小小的变化,更加适合基本参数类型。

 public interface OfPrimitive<T, T_CONS, T_SPLITR extends Spliterator.OfPrimitive<T, T_CONS, T_SPLITR>> extends Spliterator<T> {@OverrideT_SPLITR trySplit();@SuppressWarnings("overloads")boolean tryAdvance(T_CONS action);@SuppressWarnings("overloads")default void forEachRemaining(T_CONS action) {do { } while (tryAdvance(action));}
}

下面有相应的OfInt、OfLong、OfDouble三个借口专门提供给int、long、double类型的数据使用。

ArrayListSpliterator

接下来我们来看一看ArrayList中的具体实现ArrayListSpliterator,更进一步去理解一下这个接口

static final class ArrayListSpliterator<E> implements Spliterator<E>{}   private final ArrayList<E> list;//存储元素的listprivate int index; // 起始位置(当前的索引),可能被trySplit和tryAdvance操作修改private int fence; // 结束位置,ArrayListSpliterator未使用前为-1,使用后为list的sizeprivate int expectedModCount; //跟fence方法一样在getFence方法中进行初始化,值跟list的modCount一样ArrayListSpliterator(ArrayList<E> list, int origin, int fence, int expectedModCount) {this.list = list;this.index = origin;// 迭代器的起始位置this.fence = fence;// //初始无所谓,ArrayListSpliterator操作之后会跟list的modCount保持一致this.expectedModCount = expectedModCount;}// 获取结束位置:初始化对象的fence属性,list不为null同时初始化expectedModCount属性private int getFence() { int hi;ArrayList<E> lst;if ((hi = fence) < 0) {//-1的时候才会对fence进行初始化if ((lst = list) == null)hi = fence = 0;else {expectedModCount = lst.modCount;hi = fence = lst.size;}}return hi;}public ArrayListSpliterator<E> trySplit() {int hi = getFence(), lo = index, mid = (lo + hi) >>> 1;//可再分,产生新的ArrayListSpliterator,不能再分返回nullreturn (lo >= mid) ? null :  new ArrayListSpliterator<E>(list, lo, index = mid, expectedModCount);}        public boolean tryAdvance(Consumer<? super E> action) {if (action == null)throw new NullPointerException();int hi = getFence(), i = index;if (i < hi) {index = i + 1;//每正常执行一次,下标后移@SuppressWarnings("unchecked") E e = (E)list.elementData[i];action.accept(e);if (list.modCount != expectedModCount)//modcount检验:使用过程中禁止对list进行结构操作throw new ConcurrentModificationException();return true;//还有元素返回true}return false;//没有元素返回false}//对每一个元素进行操作,    public void forEachRemaining(Consumer<? super E> action) {int i, hi, mc; // hoist accesses and checks from loopArrayList<E> lst; Object[] a;if (action == null)throw new NullPointerException();if ((lst = list) != null && (a = lst.elementData) != null) {if ((hi = fence) < 0) {//fence小于0表示首次使用,expectedModCount和fence属性未进行初始化mc = lst.modCount;hi = lst.size;}elsemc = expectedModCount;if ((i = index) >= 0 && (index = hi) <= a.length) {for (; i < hi; ++i) {@SuppressWarnings("unchecked") E e = (E) a[i];action.accept(e);}if (lst.modCount == mc)return;//所有元素循环完之后确定结构未发生变化,否则抛错}}throw new ConcurrentModificationException();}//返回forEachRemaining方法循环的次数public long estimateSize() {return (long) (getFence() - index);}//ArrayListSpliterator具有有序,确定大小的特点,衍生出来的子比较器同样确定大小public int characteristics() {return Spliterator.ORDERED | Spliterator.SIZED | Spliterator.SUBSIZED;}
}

这篇关于【Java基础】Spliterator的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/430426

相关文章

springboot集成Lucene的详细指南

《springboot集成Lucene的详细指南》这篇文章主要为大家详细介绍了springboot集成Lucene的详细指南,文中的示例代码讲解详细,具有一定的借鉴价值,感兴趣的小伙伴可以跟随小编一起... 目录添加依赖创建配置类创建实体类创建索引服务类创建搜索服务类创建控制器类使用示例以下是 Spring

Java调用Python的四种方法小结

《Java调用Python的四种方法小结》在现代开发中,结合不同编程语言的优势往往能达到事半功倍的效果,本文将详细介绍四种在Java中调用Python的方法,并推荐一种最常用且实用的方法,希望对大家有... 目录一、在Java类中直接执行python语句二、在Java中直接调用Python脚本三、使用Run

Java根据IP地址实现归属地获取

《Java根据IP地址实现归属地获取》Ip2region是一个离线IP地址定位库和IP定位数据管理框架,这篇文章主要为大家详细介绍了Java如何使用Ip2region实现根据IP地址获取归属地,感兴趣... 目录一、使用Ip2region离线获取1、Ip2region简介2、导包3、下编程载xdb文件4、J

浅析如何使用xstream实现javaBean与xml互转

《浅析如何使用xstream实现javaBean与xml互转》XStream是一个用于将Java对象与XML之间进行转换的库,它非常简单易用,下面将详细介绍如何使用XStream实现JavaBean与... 目录1. 引入依赖2. 定义 JavaBean3. JavaBean 转 XML4. XML 转 J

SpringBoot中四种AOP实战应用场景及代码实现

《SpringBoot中四种AOP实战应用场景及代码实现》面向切面编程(AOP)是Spring框架的核心功能之一,它通过预编译和运行期动态代理实现程序功能的统一维护,在SpringBoot应用中,AO... 目录引言场景一:日志记录与性能监控业务需求实现方案使用示例扩展:MDC实现请求跟踪场景二:权限控制与

Java NoClassDefFoundError运行时错误分析解决

《JavaNoClassDefFoundError运行时错误分析解决》在Java开发中,NoClassDefFoundError是一种常见的运行时错误,它通常表明Java虚拟机在尝试加载一个类时未能... 目录前言一、问题分析二、报错原因三、解决思路检查类路径配置检查依赖库检查类文件调试类加载器问题四、常见

Java注解之超越Javadoc的元数据利器详解

《Java注解之超越Javadoc的元数据利器详解》本文将深入探讨Java注解的定义、类型、内置注解、自定义注解、保留策略、实际应用场景及最佳实践,无论是初学者还是资深开发者,都能通过本文了解如何利用... 目录什么是注解?注解的类型内置注编程解自定义注解注解的保留策略实际用例最佳实践总结在 Java 编程

Java 实用工具类Spring 的 AnnotationUtils详解

《Java实用工具类Spring的AnnotationUtils详解》Spring框架提供了一个强大的注解工具类org.springframework.core.annotation.Annot... 目录前言一、AnnotationUtils 的常用方法二、常见应用场景三、与 JDK 原生注解 API 的

Java controller接口出入参时间序列化转换操作方法(两种)

《Javacontroller接口出入参时间序列化转换操作方法(两种)》:本文主要介绍Javacontroller接口出入参时间序列化转换操作方法,本文给大家列举两种简单方法,感兴趣的朋友一起看... 目录方式一、使用注解方式二、统一配置场景:在controller编写的接口,在前后端交互过程中一般都会涉及

Java中的StringBuilder之如何高效构建字符串

《Java中的StringBuilder之如何高效构建字符串》本文将深入浅出地介绍StringBuilder的使用方法、性能优势以及相关字符串处理技术,结合代码示例帮助读者更好地理解和应用,希望对大家... 目录关键点什么是 StringBuilder?为什么需要 StringBuilder?如何使用 St