com.google.gerrit.server.config

Class ScheduleConfig

java.lang.Object

com.google.gerrit.server.config.ScheduleConfig

public abstract class ScheduleConfig
extends java.lang.Object

This class reads a schedule for running a periodic background job from a Git config.

A schedule configuration consists of two parameters:

• interval: Interval for running the periodic background job. The interval must be larger than zero. The following suffixes are supported to define the time unit for the interval:
  • s, sec, second, seconds
  • m, min, minute, minutes
  • h, hr, hour, hours
  • d, day, days
  • w, week, weeks (1 week is treated as 7 days)
  • mon, month, months (1 month is treated as 30 days)
  • y, year, years (1 year is treated as 365 days)
• startTime: The start time defines the first execution of the periodic background job. If the configured interval is shorter than startTime - now the start time will be preponed by the maximum integral multiple of interval so that the start time is still in the future. startTime must have one of the following formats:
  • <day of week> <hours>:<minutes>
  • <hours>:<minutes>
  The placeholders can have the following values:
  • <day of week>: Mon, Tue, Wed, Thu, Fri, Sat, Sun
  • <hours>: 00-23
  • <minutes>: 00-59
  The timezone cannot be specified but is always the system default time-zone.

The section and the subsection from which the interval and startTime parameters are read can be configured.

Examples for a schedule configuration:

•  foo.startTime = Fri 10:30
   foo.interval  = 2 day
   

  Assuming that the server is started on Mon 7:00 then startTime - now is 4 days 3:30 hours. This is larger than the interval hence the start time is preponed by the maximum integral multiple of the interval so that start time is still in the future, i.e. preponed by 4 days. This yields a start time of Mon 10:30, next executions are Wed 10:30, Fri 10:30. etc.

•  foo.startTime = 06:00
   foo.interval = 1 day
   

  Assuming that the server is started on Mon 7:00 then this yields the first run on next Tuesday at 6:00 and a repetition interval of 1 day.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ScheduleConfig.Builder
static class	ScheduleConfig.Schedule

Constructor Summary

Constructors

Constructor and Description
ScheduleConfig()

Method Summary

Modifier and Type	Method and Description
static ScheduleConfig.Builder	builder(org.eclipse.jgit.lib.Config config, java.lang.String section)
static java.util.Optional<ScheduleConfig.Schedule>	createSchedule(org.eclipse.jgit.lib.Config config, java.lang.String section)
java.util.Optional<ScheduleConfig.Schedule>	schedule()
java.lang.String	toString()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

ScheduleConfig

public ScheduleConfig()

Method Detail

createSchedule

public static java.util.Optional<ScheduleConfig.Schedule> createSchedule(org.eclipse.jgit.lib.Config config,
                                                                         java.lang.String section)

builder

public static ScheduleConfig.Builder builder(org.eclipse.jgit.lib.Config config,
                                             java.lang.String section)

schedule

@Memoized
public java.util.Optional<ScheduleConfig.Schedule> schedule()

toString

public final java.lang.String toString()

Overrides:

toString in class java.lang.Object