Module jakarta.concurrency

Package jakarta.enterprise.concurrent

Interface LastExecution

public interface LastExecution

Contains information about the last execution of a task. This is used by the methods in the Trigger class to determine the next scheduled timeout or whether a run should be skipped.

Since:

1.0

Method Summary

Modifier and Type	Method	Description
String	getIdentityName()	The name or ID of the identifiable object, as specified in the ManagedTask.IDENTITY_NAME execution property of the task if it also implements the ManagedTask interface.
Object	getResult()	Result of the last execution.
default Date	getRunEnd()	The last time in which the task was completed.
ZonedDateTime	getRunEnd(ZoneId zone)	The time, in the specified time-zone, at which the most recent execution of the task completed running.
default Date	getRunStart()	The last time in which the task started running.
ZonedDateTime	getRunStart(ZoneId zone)	The time, in the specified time-zone, at which the most recent execution of the task started running.
default Date	getScheduledStart()	The last time in which task was scheduled to run.
ZonedDateTime	getScheduledStart(ZoneId zone)	The time, in the specified time-zone, at which the most recent execution of the task was expected to start, per its schedule.

Method Details

getIdentityName

String getIdentityName()

The name or ID of the identifiable object, as specified in the ManagedTask.IDENTITY_NAME execution property of the task if it also implements the ManagedTask interface.

Returns:

the name or ID of the identifiable object.

getResult

Object getResult()

Result of the last execution.

Returns:

The result of the last execution. It could return null if the last execution did not complete, or the result of the task was null.

getScheduledStart

default Date getScheduledStart()

The last time in which task was scheduled to run.

The default implementation delegates to the method signature that accepts a ZoneId.

Returns:

The last date/time in which the task was scheduled to run.

getScheduledStart

ZonedDateTime getScheduledStart(ZoneId zone)

The time, in the specified time-zone, at which the most recent execution of the task was expected to start, per its schedule.

Parameters:

zone - time-zone ID.

Returns:

the date/time, in the specified time-zone, at which the most recent execution of the task was expected to start, per its schedule.

Since:

3.0

getRunStart

default Date getRunStart()

The last time in which the task started running.

The default implementation delegates to the method signature that accepts a ZoneId.

Returns:

the last date/time in which the task started running, or null if the task was canceled before it was started.

getRunStart

ZonedDateTime getRunStart(ZoneId zone)

The time, in the specified time-zone, at which the most recent execution of the task started running.

Parameters:

zone - time-zone ID.

Returns:

the date/time, in the specified time-zone, at which the most recent execution of the task started running, or null if the task was canceled before it was started.

Since:

3.0

getRunEnd

default Date getRunEnd()

The last time in which the task was completed.

The default implementation delegates to the method signature that accepts a ZoneId.

Returns:

the last date/time in which the task was completed, or null if the task was canceled before it was completed.

getRunEnd

ZonedDateTime getRunEnd(ZoneId zone)

The time, in the specified time-zone, at which the most recent execution of the task completed running.

Parameters:

zone - time-zone ID.

Returns:

the date/time, in the specified time-zone, at which the most recent execution of the task completed, or null if the task was canceled before it was completed.

Since:

3.0