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 Detail

      • 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