Package org.jenkinsci.plugins.workflow.steps

Class AbstractSynchronousStepExecution<T>

java.lang.Object

org.jenkinsci.plugins.workflow.steps.StepExecution

org.jenkinsci.plugins.workflow.steps.AbstractStepExecutionImpl

org.jenkinsci.plugins.workflow.steps.AbstractSynchronousStepExecution<T>

Type Parameters:

T - the type of the return value (may be Void)

All Implemented Interfaces:

Serializable

@Deprecated
public abstract class AbstractSynchronousStepExecution<T>
extends AbstractStepExecutionImpl

Deprecated.

Extend SynchronousStepExecution and avoid Guice.

StepExecution that always executes synchronously. This API should be used for short-lived tasks that return almost instantly. To call legacy Jenkins APIs which are potentially long-running and interruptible yet offer no asynchronous mode (for example because they block on a remoting call) use AbstractSynchronousNonBlockingStepExecution. Also note that long-lived tasks which do not need to run within a Java method call should use the more general AbstractStepExecutionImpl

Author:

Kohsuke Kawaguchi

See Also:

• Serialized Form

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	AbstractSynchronousStepExecution()	Deprecated.
protected	AbstractSynchronousStepExecution(StepContext context)	Deprecated.

Method Summary

Modifier and Type	Method	Description
protected abstract T	run()	Deprecated. Meat of the execution.
final boolean	start()	Deprecated. Start execution of something and report the end result back to the given callback.
void	stop(Throwable cause)	Deprecated. If the computation is going synchronously, try to cancel that.

Methods inherited from class org.jenkinsci.plugins.workflow.steps.AbstractStepExecutionImpl

inject, onResume

Methods inherited from class org.jenkinsci.plugins.workflow.steps.StepExecution

applyAll, applyAll, blocksRestart, getContext, getStatus, getStatusBounded

Methods inherited from class java.lang.Object

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

Constructor Details

AbstractSynchronousStepExecution

protected AbstractSynchronousStepExecution()

Deprecated.

AbstractSynchronousStepExecution

protected AbstractSynchronousStepExecution(StepContext context)

Deprecated.

Method Details

run

protected abstract T run()
                  throws Exception

Deprecated.

Meat of the execution. When this method returns, a step execution is over.

Throws:

Exception

start

public final boolean start()
                    throws Exception

Deprecated.

Description copied from class: StepExecution

Start execution of something and report the end result back to the given callback.

Arguments are passed when instantiating steps.

This method will run in the CPS VM thread and as such should not perform I/O or block. Use SynchronousNonBlockingStepExecution or GeneralNonBlockingStepExecution as needed.

Specified by:

start in class StepExecution

Returns:

true if the execution of this step has synchronously completed before this method returns. It is the callee's responsibility to set the return value via StepContext.onSuccess(Object) or FutureCallback.onFailure(Throwable). false if the asynchronous execution has started and that StepContext will be notified when the result comes in. (Note that the nature of asynchrony is such that it is possible for the StepContext to be already notified before this method returns.)

Throws:

Exception - if any exception is thrown, Step is assumed to have completed abnormally synchronously (as if FutureCallback.onFailure(java.lang.Throwable) is called and the method returned true.)

stop

public void stop(Throwable cause)
          throws Exception

Deprecated.

If the computation is going synchronously, try to cancel that.

Overrides:

stop in class StepExecution

Parameters:

cause - Contextual information that lets the step know what resulted in stopping an executing step, passed in the hope that this will assist diagnostics.

Throws:

Exception