模块 wjybxx.commons.concurrent
程序包 cn.wjybxx.concurrent

接口 SingleThreadExecutor

所有超级接口:
Executor
所有已知子接口:
EventLoop
所有已知实现类:
AbstractEventLoop, DisruptorEventLoop
public interface SingleThreadExecutor extends Executor
单线程的Executor
作者:
wjybxx date - 2023/11/6

  • 方法概要

    修饰符和类型
    方法
    说明
    boolean
    inEventLoop()
    测试当前线程是否是Executor所在线程。
    boolean
    inEventLoop(Thread thread)
    测试给定线程是否是当前事件循环线程 1.注意：EventLoop接口约定是单线程的，不会并发执行提交的任务，但不约定整个生命周期都在同一个线程上，以允许在空闲的时候销毁线程。

    从接口继承的方法 java.util.concurrent.Executor

    execute

  • 方法详细资料

    • inEventLoop

      boolean inEventLoop()
      测试当前线程是否是Executor所在线程。 主要作用: 1.判断是否可访问线程封闭的数据。 2.防止死锁。

      警告：如果用户基于该测试实现分支逻辑，则可能导致时序错误，eg： 

       
 	if(eventLoop.inEventLoop()) {
 	    doSomething();
  } else{
 	    eventLoop.execute(() -> doSomething());
  }
      假设现在有3个线程：A、B、C，它们进行了约定，线程A投递任务后，告诉线程B，线程B投递后告诉线程C，线程C再投递，以期望任务按照A、B、C的顺序处理。 在某个巧合下，线程C可能就是执行者线程，结果C的任务可能在A和B的任务之前被处理，从而破坏了外部约定的时序。

      该方法一定要慎用，它有时候是无害的，有时候则是有害的，因此必须想明白是否需要提供全局时序保证！

    • inEventLoop

      boolean inEventLoop(Thread thread)
      测试给定线程是否是当前事件循环线程 1.注意：EventLoop接口约定是单线程的，不会并发执行提交的任务，但不约定整个生命周期都在同一个线程上，以允许在空闲的时候销毁线程。 如果当前线程死亡，EventLoop是可以开启新的线程的，因此外部如果捕获了当前线程的引用，该引用可能失效。 (有一个经典的示例：Netty的GlobalEventExecutor) 2.该方法可用于任务检测是否切换了线程，以确保任务运行在固定的线程中