hudson.model

Interface Queue.Executable

All Superinterfaces:

Runnable

All Known Implementing Classes:

AbstractBuild, Build, FreeStyleBuild

Enclosing class:

Queue

@StaplerAccessibleType
public static interface Queue.Executable
extends Runnable

Represents the real meat of the computation run by Executor.

Views

Implementation must have executorCell.jelly, which is used to render the HTML that indicates this executable is executing.

Method Summary

Modifier and Type	Method and Description
default long	getEstimatedDuration() Estimate of how long will it take to execute this executable.
SubTask	getParent() Task from which this executable was created.
default Queue.Executable	getParentExecutable() An umbrella executable (such as a Run) of which this is one part.
void	run() Called by Executor to perform the task.
String	toString() Used to render the HTML.

Method Detail

getParent

@NonNull
SubTask getParent()

Task from which this executable was created.

Since this method went through a signature change in 1.377, the invocation may results in AbstractMethodError. Use Executables.getParentOf(Queue.Executable) that avoids this.

getParentExecutable

@CheckForNull
default Queue.Executable getParentExecutable()

An umbrella executable (such as a Run) of which this is one part. If getParent() has a distinct SubTask.getOwnerTask(), then it should be the case that getParentExecutable().getParent() == getParent().getOwnerTask().

Returns:

a distinct executable (never this, unlike the default of SubTask.getOwnerTask()!); or null if this executable was already at top level

Since:

TODO, but implementations can already implement this with a lower core dependency.

run

void run()
  throws AsynchronousExecution

Called by Executor to perform the task.

Specified by:

run in interface Runnable

Throws:

AsynchronousExecution - if you would like to continue without consuming a thread

getEstimatedDuration

default long getEstimatedDuration()

Estimate of how long will it take to execute this executable. Measured in milliseconds.

Returns:

-1 if it's impossible to estimate; default, SubTask.getEstimatedDuration()

Since:

1.383

toString

String toString()

Used to render the HTML. Should be a human readable text of what this executable is.

Overrides:

toString in class Object