HashedWheelTimer (Netty API Reference (4.1.22.Final))

java.lang.Object
- io.netty.util.HashedWheelTimer

All Implemented Interfaces:

Timer
```
public class HashedWheelTimer
extends java.lang.Object
implements Timer
```
A Timer针对近似I / O超时调度进行了优化。
滴答时间
如“approximation”所述，此计时器不会按时执行计划的TimerTask 。 HashedWheelTimer ，每打勾一次，将检查日程表中是否有任何TimerTask ，并执行它们。
您可以通过在构造函数中指定更小或更大的滴答持续时间来增加或减少执行时间的精确度。在大多数网络应用程序中，I / O超时不需要准确。因此，默认的滴答持续时间为100毫秒，在大多数情况下您不需要尝试不同的配置。

每车轮擒纵轮（车轮尺寸）
HashedWheelTimer维护一个名为'wheel'的数据结构。简而言之，轮子是散列表TimerTask的散列表，其散列函数是“任务的死线”。每个轮子的缺省刻度数（即轮子的大小）为512.如果要安排大量超时，则可以指定较大的值。
不要创建多个实例。
HashedWheelTimer在实例化和启动时创建一个新线程。因此，您应该确保只创建一个实例并在整个应用程序中共享它。常见的错误之一就是为您的应用程序无响应，为每个连接创建一个新实例。
实施细节
HashedWheelTimer基于George Varghese和Tony Lauck的文章'Hashed and Hierarchical Timing Wheels: data structures to efficiently implement a timer facility' 。更全面的幻灯片位于here 。

Field Summary

Fields
Modifier and Type	Field and Description
`static int`	`WORKER_STATE_INIT`
`static int`	`WORKER_STATE_SHUTDOWN`
`static int`	`WORKER_STATE_STARTED`

构造方法摘要

构造方法
Constructor and Description
`HashedWheelTimer()` 使用默认线程工厂（ `Executors.defaultThreadFactory()` ），默认滴答持续时间以及每个轮子的缺省滴答数创建新计时器。
`HashedWheelTimer(long tickDuration, java.util.concurrent.TimeUnit unit)` 用默认线程工厂（ `Executors.defaultThreadFactory()` ）和每个轮子的缺省数量创建一个新的计时器。
`HashedWheelTimer(long tickDuration, java.util.concurrent.TimeUnit unit, int ticksPerWheel)` 用默认线程工厂创建一个新的定时器（ `Executors.defaultThreadFactory()` ）。
`HashedWheelTimer(java.util.concurrent.ThreadFactory threadFactory)` 使用默认的滴答持续时间和每个轮子的默认滴答数创建新的计时器。
`HashedWheelTimer(java.util.concurrent.ThreadFactory threadFactory, long tickDuration, java.util.concurrent.TimeUnit unit)` 使用每个轮子默认的滴答数创建一个新的计时器。
`HashedWheelTimer(java.util.concurrent.ThreadFactory threadFactory, long tickDuration, java.util.concurrent.TimeUnit unit, int ticksPerWheel)` 创建一个新的计时器。
`HashedWheelTimer(java.util.concurrent.ThreadFactory threadFactory, long tickDuration, java.util.concurrent.TimeUnit unit, int ticksPerWheel, boolean leakDetection)` 创建一个新的计时器。
`HashedWheelTimer(java.util.concurrent.ThreadFactory threadFactory, long tickDuration, java.util.concurrent.TimeUnit unit, int ticksPerWheel, boolean leakDetection, long maxPendingTimeouts)` 创建一个新的计时器。

方法摘要

所有方法接口方法具体的方法
Modifier and Type	Method and Description
`protected void`	`finalize()`
`Timeout`	`newTimeout(TimerTask task, long delay, java.util.concurrent.TimeUnit unit)` 在指定的延迟后安排指定的`TimerTask`执行一次执行。
`long`	`pendingTimeouts()` 返回此`Timer`的暂挂超时数。
`void`	`start()` 明确启动后台线程。
`java.util.Set<Timeout>`	`stop()` 释放由此`Timer`获取的所有资源并取消所有已安排但尚未执行的任务。

Methods inherited from class java.lang.Object
clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 字段详细信息
  - WORKER_STATE_INIT
```
public static final int WORKER_STATE_INIT
```
    另请参见：
    
    Constant Field Values
  - WORKER_STATE_STARTED
```
public static final int WORKER_STATE_STARTED
```
    另请参见：
    
    Constant Field Values
  - WORKER_STATE_SHUTDOWN
```
public static final int WORKER_STATE_SHUTDOWN
```
    另请参见：
    
    Constant Field Values
- 构造方法详细信息
  - HashedWheelTimer
```
public HashedWheelTimer()
```
    使用默认线程工厂（ Executors.defaultThreadFactory() ），默认滴答持续时间以及每个轮子的缺省滴答数创建新计时器。
  - HashedWheelTimer
```
public HashedWheelTimer(long tickDuration,
                        java.util.concurrent.TimeUnit unit)
```
    使用默认线程工厂（ Executors.defaultThreadFactory() ）和每个轮子的默认数量的刻度创建新的计时器。
    
    参数
    
    tickDuration - 勾号之间的时间间隔
    
    unit -所述的时间单位 tickDuration
    
    异常
    
    java.lang.NullPointerException - 如果 unit是 null
    
    java.lang.IllegalArgumentException - 如果 tickDuration <= 0
  - HashedWheelTimer
```
public HashedWheelTimer(long tickDuration,
                        java.util.concurrent.TimeUnit unit,
                        int ticksPerWheel)
```
    用默认线程工厂创建一个新的定时器（ Executors.defaultThreadFactory() ）。
    
    参数
    
    tickDuration - 勾号之间的持续时间
    
    unit -所述的时间单位 tickDuration
    
    ticksPerWheel - 轮子的大小
    
    异常
    
    java.lang.NullPointerException - 如果 unit是 null
    
    java.lang.IllegalArgumentException - 如果 tickDuration和 ticksPerWheel <= 0
  - HashedWheelTimer
```
public HashedWheelTimer(java.util.concurrent.ThreadFactory threadFactory)
```
    使用默认的滴答持续时间和每个轮子的默认滴答数创建新的计时器。
    
    参数
    
    threadFactory -一个ThreadFactory ，创建一个背景Thread专用于TimerTask执行。
    
    异常
    
    java.lang.NullPointerException - 如果 threadFactory是 null
  - HashedWheelTimer
```
public HashedWheelTimer(java.util.concurrent.ThreadFactory threadFactory,
                        long tickDuration,
                        java.util.concurrent.TimeUnit unit)
```
    使用每个轮子默认的滴答数创建一个新的计时器。
    
    参数
    
    threadFactory -一个ThreadFactory ，创建一个背景Thread专用于TimerTask执行。
    
    tickDuration - 勾号之间的持续时间
    
    unit -所述的时间单位 tickDuration
    
    异常
    
    java.lang.NullPointerException - 如果 threadFactory和 unit是 null
    
    java.lang.IllegalArgumentException - 如果 tickDuration <= 0
  - HashedWheelTimer
```
public HashedWheelTimer(java.util.concurrent.ThreadFactory threadFactory,
                        long tickDuration,
                        java.util.concurrent.TimeUnit unit,
                        int ticksPerWheel)
```
    创建一个新的计时器。
    
    参数
    
    threadFactory -一个ThreadFactory ，创建一个背景Thread专用于TimerTask执行。
    
    tickDuration - 勾号之间的时间间隔
    
    unit -所述的时间单位 tickDuration
    
    ticksPerWheel - 轮子的大小
    
    异常
    
    java.lang.NullPointerException - 如果 threadFactory和 unit任一个是 null
    
    java.lang.IllegalArgumentException - 如果 tickDuration和 ticksPerWheel <= 0
  - HashedWheelTimer
```
public HashedWheelTimer(java.util.concurrent.ThreadFactory threadFactory,
                        long tickDuration,
                        java.util.concurrent.TimeUnit unit,
                        int ticksPerWheel,
                        boolean leakDetection)
```
    创建一个新的计时器。
    
    参数
    
    threadFactory -一个ThreadFactory ，创建一个背景Thread专用于TimerTask执行。
    
    tickDuration - 勾号之间的持续时间
    
    unit -所述的时间单位 tickDuration
    
    ticksPerWheel - 轮子的大小
    
    leakDetection - true如果泄漏检测应始终启用，如果为false，则只有在辅助线程不是守护程序线程时才会启用泄漏检测。
    
    异常
    
    java.lang.NullPointerException - 如果 threadFactory和 unit是 null
    
    java.lang.IllegalArgumentException - 如果 tickDuration和 ticksPerWheel <= 0
  - HashedWheelTimer
```
public HashedWheelTimer(java.util.concurrent.ThreadFactory threadFactory,
                        long tickDuration,
                        java.util.concurrent.TimeUnit unit,
                        int ticksPerWheel,
                        boolean leakDetection,
                        long maxPendingTimeouts)
```
    创建一个新的计时器。
    
    参数
    
    threadFactory -一个ThreadFactory ，创建一个背景Thread专用于TimerTask执行。
    
    tickDuration - 勾号之间的时间间隔
    
    unit -所述的时间单位 tickDuration
    
    ticksPerWheel - 轮子的大小
    
    leakDetection - true如果泄漏检测应始终启用，如果为false，则只有在辅助线程不是守护线程时才会启用泄漏检测。
    
    maxPendingTimeouts - 最大呼叫newTimeout的挂起超时数将导致RejectedExecutionException被抛出。如果此值为0或负数，则不会假定最大待处理超时限制。
    
    异常
    
    java.lang.NullPointerException - 如果 threadFactory和 unit是 null
    
    java.lang.IllegalArgumentException - 如果 tickDuration和 ticksPerWheel任一个<= 0
- 方法详细信息
  - finalize
```
protected void finalize()
                 throws java.lang.Throwable
```
    重写：
    
    finalize在课堂上 java.lang.Object
    
    异常
    
    java.lang.Throwable
  - start
```
public void start()
```
    明确启动后台线程。即使您未调用此方法，后台线程也会按需自动启动。
    
    异常
    
    java.lang.IllegalStateException - 如果此计时器已经 stopped
  - stop
```
public java.util.Set<Timeout> stop()
```
    从接口Timer复制的描述
    
    释放由此Timer获取的所有资源并取消所有已安排但尚未执行的任务。
    
    Specified by:
    
    stop接口 Timer
    
    结果
    
    与通过此方法取消的任务关联的句柄
  - newTimeout
```
public Timeout newTimeout(TimerTask task,
                          long delay,
                          java.util.concurrent.TimeUnit unit)
```
    从接口Timer复制的描述
    
    在指定的延迟后安排指定的TimerTask一次性执行。
    
    Specified by:
    
    newTimeout接口 Timer
    
    结果
    
    与指定任务关联的句柄
  - pendingTimeouts
```
public long pendingTimeouts()
```
    返回此Timer的暂挂超时数。

Class HashedWheelTimer

滴答时间

每车轮擒纵轮（车轮尺寸）

不要创建多个实例。

实施细节

Field Summary

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

字段详细信息

WORKER_STATE_INIT

WORKER_STATE_STARTED

WORKER_STATE_SHUTDOWN

构造方法详细信息

HashedWheelTimer

HashedWheelTimer

HashedWheelTimer

HashedWheelTimer

HashedWheelTimer

HashedWheelTimer

HashedWheelTimer

HashedWheelTimer

方法详细信息

finalize

start

stop

newTimeout

pendingTimeouts