org.gradle.launcher.daemon.server.exec

Class DaemonCommandExecution

java.lang.Object

org.gradle.launcher.daemon.server.exec.DaemonCommandExecution

public class DaemonCommandExecution
extends Object

A continuation style object used to model the execution of a command.

Facilitates processing ?chains?, making it easier to break up processing logic into discrete actions.

The given actions will be executed in the order given to the constructor, and should use the proceed() method to allow the next action to run. If an action does not call proceed(), it will be the last action that executes.

Constructor Summary

Constructors

Constructor and Description
DaemonCommandExecution(DisconnectAwareConnection<Object> connection, Command command, DaemonContext daemonContext, DaemonStateCoordinator daemonStateCoordinator, List<DaemonCommandAction> actions)

Method Summary

Methods

Modifier and Type	Method and Description
void	addFinalizer(Runnable runnable)
void	executeFinalizers()
Command	getCommand() The command to execute.
DisconnectAwareConnection<Object>	getConnection()
DaemonContext	getDaemonContext()
DaemonStateCoordinator	getDaemonStateCoordinator()
Throwable	getException() The currently nominated error that occurred during executing the commmand.
Object	getResult() The currently nominated result for the execution.
boolean	proceed() Continues (or starts) execution.
void	setException(Throwable exception) If an exception happens in actioning the command that is to be expected (e.g.
void	setResult(Object result) Sets what is to be considered the result of executing the command.
String	toString()

Methods inherited from class java.lang.Object

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

Constructor Detail

DaemonCommandExecution

public DaemonCommandExecution(DisconnectAwareConnection<Object> connection,
                      Command command,
                      DaemonContext daemonContext,
                      DaemonStateCoordinator daemonStateCoordinator,
                      List<DaemonCommandAction> actions)

Method Detail

getConnection

public DisconnectAwareConnection<Object> getConnection()

getCommand

public Command getCommand()

The command to execute.

If the client disconnects before sending a command, this will be null.

getDaemonContext

public DaemonContext getDaemonContext()

getDaemonStateCoordinator

public DaemonStateCoordinator getDaemonStateCoordinator()

setResult

public void setResult(Object result)

Sets what is to be considered the result of executing the command.

This may be called multiple times to do things like wrap the result in another type.

getResult

public Object getResult()

The currently nominated result for the execution.

If getException() returns non null, the actual ?result? of executing the command should be considered to be that exception and not what is returned by this method.

May be null if no action has set the result yet.

setException

public void setException(Throwable exception)

If an exception happens in actioning the command that is to be expected (e.g. a build failure or error in the build)

getException

public Throwable getException()

The currently nominated error that occurred during executing the commmand.

proceed

public boolean proceed()

Continues (or starts) execution.

Each action should call this method if it determines that execution should continue.

Returns:

true if execution did occur, false if this execution has already occurred.

toString

public String toString()

Overrides:

toString in class Object

addFinalizer

public void addFinalizer(Runnable runnable)

executeFinalizers

public void executeFinalizers()