com.github.dm.jrt.android.runner

Class Runners

java.lang.Object

com.github.dm.jrt.runner.Runners

com.github.dm.jrt.android.runner.Runners

public class Runners
extends Runners

Utility class for creating and sharing runner instances, employing specific Android classes.

Created by davide-maestroni on 09/28/2014.

Constructor Summary

Constructors

Constructor and Description
Runners()

Method Summary

Methods

Modifier and Type	Method and Description
static Runner	handlerRunner(HandlerThread thread) Returns a runner employing the specified handler thread.
static Runner	looperRunner(Looper looper) Returns a runner employing the specified looper. Note that, when the invocation runs in the looper thread, the executions with a delay of 0 will be performed synchronously, while the ones with a positive delay will be posted on the same thread.
static Runner	looperRunner(Looper looper, Runner sameThreadRunner) Returns a runner employing the specified looper. Note that, based on the choice of the runner to be used when the invocation runs in the looper thread, waiting for results in the very same thread may result in a deadlock exception.
static Runner	mainRunner() Returns the shared runner employing the main thread looper. Note that, when the invocation runs in the main thread, the executions with a delay of 0 will be performed synchronously, while the ones with a positive delay will be posted on the main thread.
static Runner	myRunner() Returns a runner employing the calling thread looper.
static Runner	taskRunner() Returns a runner employing async tasks.
static Runner	taskRunner(Executor executor) Returns a runner employing async tasks running on the specified executor.

Methods inherited from class com.github.dm.jrt.runner.Runners

dynamicPoolRunner, poolRunner, poolRunner, priorityRunner, scheduledRunner, sharedRunner, syncRunner, throttlingRunner

Methods inherited from class java.lang.Object

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

Constructor Detail

Runners

public Runners()

Method Detail

handlerRunner

@Nonnull
public static Runner handlerRunner(@Nonnull
                           HandlerThread thread)

Returns a runner employing the specified handler thread.

Parameters:

thread - the thread.

Returns:

the runner instance.

looperRunner

@Nonnull
public static Runner looperRunner(@Nonnull
                          Looper looper)

Returns a runner employing the specified looper.
Note that, when the invocation runs in the looper thread, the executions with a delay of 0 will be performed synchronously, while the ones with a positive delay will be posted on the same thread.

Parameters:

looper - the looper instance.

Returns:

the runner instance.

looperRunner

@Nonnull
public static Runner looperRunner(@Nonnull
                          Looper looper,
                          @Nullable
                          Runner sameThreadRunner)

Returns a runner employing the specified looper.
Note that, based on the choice of the runner to be used when the invocation runs in the looper thread, waiting for results in the very same thread may result in a deadlock exception.

Parameters:

looper - the looper instance.

sameThreadRunner - the runner to be used when the specified looper is called on its own thread. If null, the invocation will be posted on the same looper.

Returns:

the runner instance.

mainRunner

@Nonnull
public static Runner mainRunner()

Returns the shared runner employing the main thread looper.
Note that, when the invocation runs in the main thread, the executions with a delay of 0 will be performed synchronously, while the ones with a positive delay will be posted on the main thread.

Returns:

the runner instance.

myRunner

@Nonnull
public static Runner myRunner()

Returns a runner employing the calling thread looper.

Returns:

the runner instance.

taskRunner

@Nonnull
public static Runner taskRunner()

Returns a runner employing async tasks.

Beware of the caveats of using AsyncTasks especially on some platform versions.

Returns:

the runner instance.

taskRunner

@Nonnull
public static Runner taskRunner(@Nullable
                        Executor executor)

Returns a runner employing async tasks running on the specified executor.

Beware of the caveats of using AsyncTasks especially on some platform versions.

Note also that the executor instance will be ignored on platforms with API level less than 11.

Parameters:

executor - the executor.

Returns:

the runner instance.