brooklyn.management
Interface Task<T>

All Superinterfaces:

Future<T>, TaskStub

public interface Task<T>
extends TaskStub, Future<T>

Represents a unit of work for execution. When used with an ExecutionManager or ExecutionContext it will record submission time, execution start time, end time, and any result. A task can be submitted to the ExecutionManager or ExecutionContext, in which case it will be returned, or it may be created by submission of a Runnable or Callable and thereafter it can be treated just like a Future.

Method Summary

void	blockUntilEnded() Causes calling thread to block until the task is ended.
void	blockUntilStarted() Causes calling thread to block until the task is started.
String	getDescription()
String	getDisplayName()
long	getEndTimeUtc()
long	getStartTimeUtc()
String	getStatusDetail(boolean multiline) Returns detailed status, suitable for a hover.
String	getStatusSummary()
Task<?>	getSubmittedByTask() task which submitted this task, if was submitted by a task
long	getSubmitTimeUtc()
Set<Object>	getTags()
Thread	getThread() The thread where the task is running, if it is running.
T	getUnchecked() As get, but propagating checked exceptions as unchecked for convenience.
boolean	isBegun() Whether task has started running.
boolean	isError() Whether the task threw an error, including cancellation (implies Future.isDone())
boolean	isSubmitted() Whether task has been submitted Submitted tasks are normally expected to start running then complete, but unsubmitted tasks are sometimes passed around for someone else to submit them.

Methods inherited from interface brooklyn.management.TaskStub

getId

Methods inherited from interface java.util.concurrent.Future

cancel, get, get, isCancelled, isDone

Method Detail

getTags

Set<Object> getTags()

getSubmitTimeUtc

long getSubmitTimeUtc()

getStartTimeUtc

long getStartTimeUtc()

getEndTimeUtc

long getEndTimeUtc()

getDisplayName

String getDisplayName()

getDescription

String getDescription()

getSubmittedByTask

Task<?> getSubmittedByTask()

task which submitted this task, if was submitted by a task

getThread

Thread getThread()

The thread where the task is running, if it is running.

isSubmitted

boolean isSubmitted()

Whether task has been submitted Submitted tasks are normally expected to start running then complete, but unsubmitted tasks are sometimes passed around for someone else to submit them.

isBegun

boolean isBegun()

Whether task has started running. Will remain true after normal completion or non-cancellation error. will be true on cancel iff the thread did actually start.

isError

boolean isError()

Whether the task threw an error, including cancellation (implies Future.isDone())

blockUntilStarted

void blockUntilStarted()

Causes calling thread to block until the task is started.

blockUntilEnded

void blockUntilEnded()

Causes calling thread to block until the task is ended. Either normally or by cancellation or error, but without throwing error on cancellation or error. (Errors are logged at debug.)

getStatusSummary

String getStatusSummary()

getStatusDetail

String getStatusDetail(boolean multiline)

Returns detailed status, suitable for a hover. Plain-text format, with new-lines (and sometimes extra info) if multiline enabled.

getUnchecked

T getUnchecked()

As get, but propagating checked exceptions as unchecked for convenience.