אירועים חוזרים מתוזמנים להתחלה

יש שלושה גורמים שונים שיכולים להפעיל אוטומציה מתוזמנת מראש:

1. Time.ScheduledTimeEvent
2. Time.RecurringClockTimeScheduledEvent
3. Time.RecurringSolarTimeScheduledEvent

הראשון, Time.ScheduledTimeEvent, מאפשר לתזמן אוטומציה שתתחיל ברגע מסוים בעתיד או באופן קבוע, על סמך השעה או אירוע שקשור לשמש (כלומר, זריחה או שקיעה).

לדוגמה, הסימן הזה לתחילת הפעולה מפעיל את הפעולה האוטומטית כל יום בשעה 22:00:

starter<_>(structure, Time.ScheduledTimeEvent) {
  parameter(Time.ScheduledTimeEvent.clockTime(LocalTime.of(22, 0, 0, 0)))
}

אפשר גם לציין אירוע לפי זמן השמש במקום לפי השעון. הפרמטר של סוג האירוע הזה הוא SolarTimeStruct שמורכב מהרכיבים הבאים:

1. ‫type, שהוא SolarTimeType.Sunrise או SolarTimeType.Sunset.
2. ‫offset, שמאפשרת להזיז את שעת ההתחלה ביחס לאירוע השמש בכל משך זמן. ערכים חיוביים יוצרים עיכוב אחרי אירוע השמש, וערכים שליליים גורמים להפעלת הגורם לפני אירוע השמש.

בדוגמה הבאה מוצג גורם שמפעיל את האוטומציה כל יום 15 דקות לפני הזריחה:

starter<_>(structure, Time.ScheduledTimeEvent) {
  parameter(
    Time.ScheduledTimeEvent.solarTime(
      SolarTimeStruct(SolarTimeType.Sunrise, java.time.Duration.ofMinutes(-15))
    )
  )
}

שני הגורמים הבאים הם גורמים מתוזמנים חוזרים, שמאפשרים ליצור פעולות אוטומטיות שפועלות מדי פעם לפי קריטריונים ספציפיים יותר, שיכולים לכלול תנאים שמבוססים על זמן ועל היומן.

Time.RecurringClockTimeScheduledEvent מאפשר לתזמן פעולה אוטומטית על סמך תנאי אחד או יותר של שעה או תאריך. הגורם הזה משתמש בתחביר שדומה לזה שמשמש את כלי השירות cron של Unix כדי לציין את לוח הזמנים של אוטומציה חוזרת.

Time.RecurringSolarTimeScheduledEvent מאפשר לתזמן אוטומציה לפי זמני הזריחה או השקיעה, בשילוב עם תנאי שמבוסס על היומן.

‫cron ביטויים

יכול להיות שאתם כבר מכירים את cron, פקודה שמשמשת במערכות Unix ו-Linux לתזמון משימות חוזרות.

התחביר של ביטויי התזמון של גורמים מפעילים של אירועים מתוזמנים חוזרים דומה לזה של cron, ולכן ביטויי התזמון שמשמשים את הגורמים המפעילים האלה נקראים ביטויי cron.

יש כמה "סוגים" שונים של cron, וכמה וריאציות של תחביר בהטמעות האלה. ביטויים של cron להפעלה של אירוע מתוזמן חוזר משתמשים באותו תחביר כמו המתזמן של Quartz. תחביר הביטויים של Quartz cron מוסבר במסמכי התיעוד של CronExpression של Quartz.

דוגמאות

הנה כמה דוגמאות להמחשה.

RecurringClockTimeScheduledEvent

בגורם מפעיל מסוג RecurringClockTimeScheduledEvent, מחרוזת הביטוי cron מוקצית לשדה Time.RecurringClockTimeScheduledEvent.cronExpression.

הדוגמה הבאה מראה גורם הפעלה מסוג RecurringClockTimeScheduledEvent שמפעיל את האוטומציה בשעה 20:00, בכל יום רביעי באפריל:

starter<_>(structure, event = Time.RecurringClockTimeScheduledEvent) {
  parameter(Time.RecurringClockTimeScheduledEvent.cronExpression("0 0 20 ? 4 4 *"))
}

RecurringSolarTimeScheduleEvent

הבלוק RecurringSolarTimeScheduleEvent כולל שני פרמטרים:

1. SolarTimeStruct.
2. ‫cronExpression: קבוצת משנה של ביטוי cron שמורכבת רק מהשדות Day-of-Month,‏ Month,‏ Day-of-Week ו-Year. הזמן הסולארי קובע את השעה המדויקת שבה הפעולה האוטומטית תתחיל, ולכן השדות של השניות, הדקות והשעות מושמטים.

בדוגמה הבאה מוצג גורם שמפעיל פעולה אוטומטית שעה אחרי הזריחה, בכל יום רביעי באפריל:

starter<_>(structure, event = Time.RecurringSolarTimeScheduledEvent) {
  parameter(
    Time.RecurringSolarTimeScheduledEvent.solarTime(
      TimeTrait.SolarTimeStruct(SolarTimeType.Sunrise, Duration.ofHours(1))
    )
  )
  parameter(Time.RecurringSolarTimeScheduledEvent.cronExpression("? 4 4 *"))
}