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

      All Methods Instance Methods Abstract Methods Default Methods 
      Modifier and Type Method Description
      java.lang.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.
      java.lang.Object getResult()
      Result of the last execution.
      default java.util.Date getRunEnd()
      The last time in which the task was completed.
      java.time.ZonedDateTime getRunEnd​(java.time.ZoneId zone)
      The time, in the specified time-zone, at which the most recent execution of the task completed running.
      default java.util.Date getRunStart()
      The last time in which the task started running.
      java.time.ZonedDateTime getRunStart​(java.time.ZoneId zone)
      The time, in the specified time-zone, at which the most recent execution of the task started running.
      default java.util.Date getScheduledStart()
      The last time in which task was scheduled to run.
      java.time.ZonedDateTime getScheduledStart​(java.time.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 Detail

      • getIdentityName

        java.lang.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

        java.lang.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 java.util.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

        java.time.ZonedDateTime getScheduledStart​(java.time.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 java.util.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

        java.time.ZonedDateTime getRunStart​(java.time.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 java.util.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

        java.time.ZonedDateTime getRunEnd​(java.time.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