Package edu.cnu.mdi.sim.task

Class TaskCancelledException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

java.lang.IllegalStateException

java.util.concurrent.CancellationException

edu.cnu.mdi.sim.task.TaskCancelledException

All Implemented Interfaces:

Serializable

public final class TaskCancelledException
extends CancellationException

Internal control-flow exception raised by TaskContext.throwIfCancellationRequested().

Applications normally do not need to catch this exception. The MDI one-shot adapter catches it and completes the task with the CANCELLED status rather than treating cooperative cancellation as a failure — but only when the engine's cancellation flag is actually set at that point (i.e. this exception genuinely originated from TaskContext.throwIfCancellationRequested() in response to a real cancel() request). Constructing and throwing this exception directly, without a preceding cancellation request, is not equivalent to cooperative cancellation: the adapter finds the cancellation flag unset and rethrows it, completing the task as FAILED instead. It is public so task code may perform local cleanup in a catch block when necessary; cleanup that must always run is usually better placed in a finally block.

See Also:

• Serialized Form

Constructor Summary

Constructors

Constructor	Description
TaskCancelledException()	Creates an exception with a stable diagnostic message.

Method Summary

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

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

Constructor Details

TaskCancelledException

public TaskCancelledException()

Creates an exception with a stable diagnostic message.