io.reactivex.rxjava3.schedulers

Class TestScheduler

java.lang.Object

io.reactivex.rxjava3.core.Scheduler

io.reactivex.rxjava3.schedulers.TestScheduler

public final class TestScheduler
extends Scheduler

A special, non thread-safe scheduler for testing operators that require a scheduler without introducing real concurrency and allows manually advancing a virtual time.

Nested Class Summary

Nested classes/interfaces inherited from class io.reactivex.rxjava3.core.Scheduler

Scheduler.Worker

Constructor Summary

Constructors

Constructor and Description
TestScheduler() Creates a new TestScheduler with initial virtual time of zero.
TestScheduler(long delayTime, TimeUnit unit) Creates a new TestScheduler with the specified initial virtual time.

Method Summary

Modifier and Type	Method and Description
void	advanceTimeBy(long delayTime, TimeUnit unit) Moves the Scheduler's clock forward by a specified amount of time.
void	advanceTimeTo(long delayTime, TimeUnit unit) Moves the Scheduler's clock to a particular moment in time.
Scheduler.Worker	createWorker() Retrieves or creates a new Scheduler.Worker that represents sequential execution of actions.
long	now(TimeUnit unit) Returns the 'current time' of the Scheduler in the specified time unit.
void	triggerActions() Triggers any actions that have not yet been triggered and that are scheduled to be triggered at or before this Scheduler's present time.

Methods inherited from class io.reactivex.rxjava3.core.Scheduler

clockDriftTolerance, scheduleDirect, scheduleDirect, schedulePeriodicallyDirect, shutdown, start, when

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

TestScheduler

public TestScheduler()

Creates a new TestScheduler with initial virtual time of zero.

TestScheduler

public TestScheduler(long delayTime,
                     TimeUnit unit)

Creates a new TestScheduler with the specified initial virtual time.

Parameters:

delayTime - the point in time to move the Scheduler's clock to

unit - the units of time that delayTime is expressed in

Method Detail

now

public long now(@NonNull
                TimeUnit unit)

Description copied from class: Scheduler

Returns the 'current time' of the Scheduler in the specified time unit.

Overrides:

now in class Scheduler

Parameters:

unit - the time unit

Returns:

the 'current time'

advanceTimeBy

public void advanceTimeBy(long delayTime,
                          TimeUnit unit)

Moves the Scheduler's clock forward by a specified amount of time.

Parameters:

delayTime - the amount of time to move the Scheduler's clock forward

unit - the units of time that delayTime is expressed in

advanceTimeTo

public void advanceTimeTo(long delayTime,
                          TimeUnit unit)

Moves the Scheduler's clock to a particular moment in time.

Parameters:

delayTime - the point in time to move the Scheduler's clock to

unit - the units of time that delayTime is expressed in

triggerActions

public void triggerActions()

Triggers any actions that have not yet been triggered and that are scheduled to be triggered at or before this Scheduler's present time.

createWorker

@NonNull
public Scheduler.Worker createWorker()

Description copied from class: Scheduler

Retrieves or creates a new Scheduler.Worker that represents sequential execution of actions.

When work is completed, the Worker instance should be released by calling Disposable.dispose() to avoid potential resource leaks in the underlying task-execution scheme.

Work on a Scheduler.Worker is guaranteed to be sequential and non-overlapping.

Specified by:

createWorker in class Scheduler

Returns:

a Worker representing a serial queue of actions to be executed