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