Interface TimeBroker

  • All Known Implementing Classes:
    SimpleTimeBroker

    @Deprecated
    public interface TimeBroker
    Deprecated.
    TimeBroker is not currently used in the Quartz code base.

    NOTE: TimeBroker is not currently used in the Quartz code base.

    The interface to be implemented by classes that want to provide a mechanism by which the QuartzScheduler can reliably determine the current time.

    In general, the default implementation of this interface (SimpleTimeBroker- which simply uses System.getCurrentTimeMillis() )is sufficient. However situations may exist where this default scheme is lacking in its robustness - especially when Quartz is used in a clustered configuration. For example, if one or more of the machines in the cluster has a system time that varies by more than a few seconds from the clocks on the other systems in the cluster, scheduling confusion will result.

    Author:
    James House
    See Also:
    QuartzScheduler
    • Method Summary

      All Methods Instance Methods Abstract Methods Deprecated Methods 
      Modifier and Type Method Description
      java.util.Date getCurrentTime()
      Deprecated.
      Get the current time, as known by the TimeBroker.
      void initialize()
      Deprecated.
      Called by the QuartzScheduler before the TimeBroker is used, in order to give the it a chance to initialize.
      void shutdown()
      Deprecated.
      Called by the QuartzScheduler to inform the TimeBroker that it should free up all of it's resources because the scheduler is shutting down.
    • Method Detail

      • getCurrentTime

        java.util.Date getCurrentTime()
                               throws SchedulerException
        Deprecated.

        Get the current time, as known by the TimeBroker.

        Throws:
        SchedulerException - with the error code set to SchedulerException.ERR_TIME_BROKER_FAILURE
      • shutdown

        void shutdown()
        Deprecated.

        Called by the QuartzScheduler to inform the TimeBroker that it should free up all of it's resources because the scheduler is shutting down.