speiger.src.collections.objects.functions

Interface ObjectTask<T>

Type Parameters:

T - the type of elements maintained by this Collection

All Superinterfaces:

java.util.concurrent.Future<T>, java.lang.Runnable, java.util.concurrent.RunnableFuture<T>

All Known Implementing Classes:

ObjectAsyncBuilder.BaseObjectTask

public interface ObjectTask<T>
extends java.util.concurrent.RunnableFuture<T>

A Type Specific Task interface that allows you to keep track of the task that is currently running.
It extends Runnable future and supports said functions but also provides quality of life functions like:
- isSuccesfull: which allows to detect if the task was completed properly and not interrupted or crashed. - pause/resume: which allows to pause/resume the task at any moment, making it easier to create thread-safe actions.

Method Summary

Modifier and Type	Method and Description
void	awaitPausing() Pauses the task, which lets the thread finish without completing the task.
boolean	isPaused() Helper function to detect if the task is currently paused.
boolean	isSuccessful() Quality of life function that allows to detect if no cancellation/exception was applied to this task and it completed on its own.
void	pause() Pauses the task, which lets the thread finish without completing the task.
void	resume() Continues the task if it wasn't already completed.

Methods inherited from interface java.util.concurrent.RunnableFuture

run

Methods inherited from interface java.util.concurrent.Future

cancel, get, get, isCancelled, isDone

Method Detail

isPaused

boolean isPaused()

Helper function to detect if the task is currently paused.

Returns:

true if paused

pause

void pause()

Pauses the task, which lets the thread finish without completing the task. Tasks are written in the way where they can pause without any issues. This won't be instant, as this function is applied asynchronous and doesn't check if the thread paused. So make sure it had the time to pause.

awaitPausing

void awaitPausing()

Pauses the task, which lets the thread finish without completing the task. Tasks are written in the way where they can pause without any issues. This won't be instant, as this function is applied asynchronous. It will await the pausing of the task.

resume

void resume()

Continues the task if it wasn't already completed. This is done by resubmitting the task to the executor provided.

isSuccessful

boolean isSuccessful()

Quality of life function that allows to detect if no cancellation/exception was applied to this task and it completed on its own.

Returns:

true if it was properly completed