Package dk.netarkivet.harvester.datamodel

Class DailyFrequency

  • public class DailyFrequency
extends Frequency
    This class implements a frequency of a number of days.

    • Constructor Summary

      Constructors 
      Constructor Description
      DailyFrequency​(int numUnits)
      Create a new daily frequency that happens every numUnits days, anytime.
      DailyFrequency​(int numUnits, int hour, int minute)
      Create a new daily frequency that happens every numUnits days, on the given hour and minute.

    • Method Summary

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      boolean equals​(Object o)
      Autogenerated equals.
      Date getFirstEvent​(Date startTime)
      Given a starting time, tell us when the first event should happen.
      int getHour()
      If not anytime, the hour at which events should start.
      int getMinute()
      If not anytime, the minute at which events should start.
      Date getNextEvent​(Date lastEvent)
      Given when the last event happened, tell us when the next event should happen (even if the new event is in the past).
      Integer getOnDayOfMonth()
      Return the exact day of month event should happen on, or null if this is an anyTime event or doesn't define what day of month it should happen on.
      Integer getOnDayOfWeek()
      Return the exact day of week event should happen on, or null if this is an anyTime event or doesn't define what day of week it should happen on.
      Integer getOnHour()
      Return the exact hour event should happen on, or null if this is an anyTime event or doesn't define what hour it should happen on.
      Integer getOnMinute()
      Return the exact minute event should happen on, or null if this is an anyTime event or doesn't define what minute it should happen on.
      int hashCode()
      Autogenerated hashcode method.
      int ordinal()
      Return an integer that can be used to identify the kind of frequency.
      String toString()
      Human readable representation of this object.

    • Constructor Detail

      • DailyFrequency

        public DailyFrequency​(int numUnits)
        Create a new daily frequency that happens every numUnits days, anytime.
        Parameters:
        numUnits - Number of days from event to event.
        Throws:
        ArgumentNotValid - if numUnits if 0 or negative

      • DailyFrequency

        public DailyFrequency​(int numUnits,
                      int hour,
                      int minute)
        Create a new daily frequency that happens every numUnits days, on the given hour and minute.
        Parameters:
        numUnits - Number of days from event to event.
        hour - The hour on which the event should happen.
        minute - The minute of hour on which the event should happen.
        Throws:
        ArgumentNotValid - if numUnits if 0 or negative or hours is <0 or >23 or minutes is <0 or >59

    • Method Detail

      • getNextEvent

        public Date getNextEvent​(Date lastEvent)
        Given when the last event happened, tell us when the next event should happen (even if the new event is in the past).

        The time of the next event is guaranteed to be later that lastEvent. For certain frequencies (e.g. once a day, any time of day), the time of the next event is derived from lastEvent, for others (e.g. once a day at 13:00) the time of the next event is the first matching time after lastEvent.

        Specified by:
        getNextEvent in class Frequency
        Parameters:
        lastEvent - A time from which the next event should be calculated.
        Returns:
        At what point the event should happen next.

      • getFirstEvent

        public Date getFirstEvent​(Date startTime)
        Given a starting time, tell us when the first event should happen.
        Specified by:
        getFirstEvent in class Frequency
        Parameters:
        startTime - The earliest time the event can happen.
        Returns:
        At what point the event should happen the first time.

      • getMinute

        public int getMinute()
        If not anytime, the minute at which events should start.
        Returns:
        the minute

      • getHour

        public int getHour()
        If not anytime, the hour at which events should start.
        Returns:
        the hour

      • equals

        public boolean equals​(Object o)
        Autogenerated equals.
        Overrides:
        equals in class Frequency
        Parameters:
        o - The object to compare with
        Returns:
        Whether objects are equal

      • hashCode

        public int hashCode()
        Autogenerated hashcode method.
        Overrides:
        hashCode in class Frequency
        Returns:
        the hashcode

      • getOnMinute

        public Integer getOnMinute()
        Return the exact minute event should happen on, or null if this is an anyTime event or doesn't define what minute it should happen on.
        Specified by:
        getOnMinute in class Frequency
        Returns:
        the exact minute event should happen on, or null if this is an anyTime event or doesn't define what minute it should happen on

      • getOnHour

        public Integer getOnHour()
        Return the exact hour event should happen on, or null if this is an anyTime event or doesn't define what hour it should happen on.
        Specified by:
        getOnHour in class Frequency
        Returns:
        the exact hour event should happen on, or null if this is an anyTime event or doesn't define what hour it should happen on

      • getOnDayOfWeek

        public Integer getOnDayOfWeek()
        Return the exact day of week event should happen on, or null if this is an anyTime event or doesn't define what day of week it should happen on.
        Specified by:
        getOnDayOfWeek in class Frequency
        Returns:
        the exact day of week event should happen on, or null if this is an anyTime event or doesn't define what day of week it should happen on

      • getOnDayOfMonth

        public Integer getOnDayOfMonth()
        Return the exact day of month event should happen on, or null if this is an anyTime event or doesn't define what day of month it should happen on.
        Specified by:
        getOnDayOfMonth in class Frequency
        Returns:
        the exact day of month event should happen on, or null if this is an anyTime event or doesn't define what day of month it should happen on

      • ordinal

        public int ordinal()
        Return an integer that can be used to identify the kind of frequency. No two subclasses should use the same integer
        Specified by:
        ordinal in class Frequency
        Returns:
        an integer that can be used to identify the kind of frequency

      • toString

        public String toString()
        Human readable representation of this object.
        Overrides:
        toString in class Object
        Returns:
        Human readable representation