public interface ManagedTask
ManagedScheduledExecutorServicecan optionally implement this interface to provide identifying information about the task, to provide a
ManagedTaskListenerto get notification of lifecycle events of the task, or to provide additional execution properties.
|Modifier and Type||Field and Description|
Constant for the "SUSPEND" value of the TRANSACTION execution property.
Constant for the "USE_TRANSACTION_OF_EXECUTION_THREAD" value of the TRANSACTION execution property.
static final String LONGRUNNING_HINT
ContextService.createContextualProxy()to provide hint about whether the task could take a long time to complete. Jakarta™ EE Product Providers may make use of this hint value to decide how to allocate thread resource for running this task. Valid values are "true" or "false".
static final String TRANSACTION
ContextService.createContextualProxy()to inform the Jakarta EE Product Provider under which transaction should the task or proxy method of contextual proxy object be executed in. Valid values are:
"SUSPEND" (the default if unspecified) - Any transaction that is currently
active on the thread will be suspended and a
jakarta.transaction.UserTransaction (accessible in the local
JNDI namespace as "java:comp/UserTransaction") will be available. The
original transaction, if any was active on the thread, will be resumed
when the task or contextual proxy object method returns.
"USE_TRANSACTION_OF_EXECUTION_THREAD" - The contextual proxy object method
will run within the transaction (if any) of the execution thread. A
jakarta.transaction.UserTransaction will only be available if it is
also available in the execution thread (for example, when the proxy method
is invoked from a Servlet or Bean Managed Transaction). When there is
no existing transaction on the execution thread, such as when running tasks
that are submitted to a
ManagedExecutorService or a
jakarta.transaction.UserTransaction will be available.
static final String SUSPEND
static final String USE_TRANSACTION_OF_EXECUTION_THREAD
static final String IDENTITY_NAME
ContextService.createContextualProxy()to provide a String that identifies the task. It may be the name or ID that allow management facilities to inspect the task to determine the intent of the task and its state. Implementations should not depend upon any thread execution context and should typically return only readily-available instance data to identify the task.
ManagedTaskListenerto receive notification of lifecycle events of this task.
ManagedTaskListenerto receive notification of lifecycle events of this task, or null if it is not necessary to get notified of such events.
ManagedScheduledExecutorServicewhen executing this task.
Some standard property keys are defined in this class. Custom property keys may be defined but must not begin with "jakarta.enterprise.concurrent.".
Copyright © 2018,2020 Eclipse Foundation.
Use is subject to license terms.