बार-बार होने वाले शेड्यूल किए गए इवेंट के स्टार्टर

ऑटोमेशन को पहले से शेड्यूल करने के लिए, तीन अलग-अलग स्टार्टर उपलब्ध हैं:

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

पहले विकल्प Time.ScheduledTimeEvent की मदद से, किसी ऑटोमेशन को शेड्यूल किया जा सकता है. इसे आने वाले समय में किसी एक तय समय पर शुरू किया जा सकता है. इसके अलावा, इसे बार-बार होने वाले इवेंट के तौर पर भी शेड्यूल किया जा सकता है. इसे घड़ी के समय या सौर इवेंट (जैसे, सूर्योदय या सूर्यास्त) के आधार पर शेड्यूल किया जा सकता है.

उदाहरण के लिए, यह स्टार्टर हर दिन रात 10: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 की मदद से, एक या उससे ज़्यादा समय या तारीख की शर्तों के आधार पर, ऑटोमेशन शेड्यूल किया जा सकता है. इस स्टार्टर में इस्तेमाल किया गया सिंटैक्स, Unix cron यूटिलिटी के सिंटैक्स जैसा ही है. इसका इस्तेमाल, बार-बार होने वाले ऑटोमेशन के शेड्यूल को तय करने के लिए किया जाता है.

Time.RecurringSolarTimeScheduledEvent की मदद से, सूरज के उगने या डूबने के समय के हिसाब से ऑटोमेशन शेड्यूल किया जा सकता है. इसके अलावा, कैलेंडर पर आधारित शर्त के साथ भी इसे शेड्यूल किया जा सकता है.

cron एक्सप्रेशन

ऐसा हो सकता है कि आपको cron के बारे में पहले से पता हो. यह एक ऐसा कमांड है जिसका इस्तेमाल Unix और Linux सिस्टम पर, बार-बार होने वाले कामों को शेड्यूल करने के लिए किया जाता है.

बार-बार शेड्यूल किए जाने वाले इवेंट के स्टार्टर, शेड्यूल करने के लिए ऐसे सिंटैक्स का इस्तेमाल करते हैं जो cron के सिंटैक्स से मिलता-जुलता है. इसलिए, इन स्टार्टर के साथ इस्तेमाल किए जाने वाले शेड्यूल करने के एक्सप्रेशन को cron एक्सप्रेशन कहा जाता है.

cron के कई अलग-अलग 'वर्शन' हैं. साथ ही, इन वर्शन में सिंटैक्स के कई बदलाव किए गए हैं. बार-बार शेड्यूल किए गए इवेंट के स्टार्टर cron एक्सप्रेशन, Quartz शेड्यूलर के सिंटैक्स का इस्तेमाल करते हैं. Quartz cron एक्सप्रेशन सिंटैक्स के बारे में, Quartz CronExpression के दस्तावेज़ में बताया गया है.

उदाहरण

यहां कुछ उदाहरण दिए गए हैं.

RecurringClockTimeScheduledEvent

RecurringClockTimeScheduledEvent स्टार्टर में, cron एक्सप्रेशन स्ट्रिंग को Time.RecurringClockTimeScheduledEvent.cronExpression फ़ील्ड में असाइन किया जाता है.

यहां RecurringClockTimeScheduledEvent स्टार्टर का एक उदाहरण दिया गया है. यह हर बुधवार को रात 8:00 बजे ऑटोमेशन शुरू करता है:

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

RecurringSolarTimeScheduleEvent

RecurringSolarTimeScheduleEvent स्टार्टर के दो पैरामीटर होते हैं:

1. SolarTimeStruct.
2. cronExpression: यह cron एक्सप्रेशन का सबसेट होता है. इसमें सिर्फ़ महीने का दिन, महीना, हफ़्ते का दिन, और साल वाले फ़ील्ड शामिल होते हैं. सौर समय से यह तय होता है कि ऑटोमेशन कब शुरू होगा. इसलिए, सेकंड, मिनट, और घंटे के फ़ील्ड शामिल नहीं किए जाते हैं.

यहां एक ऐसे स्टार्टर का उदाहरण दिया गया है जिसकी वजह से, अप्रैल के हर बुधवार को सूरज उगने के एक घंटे बाद ऑटोमेशन शुरू हो जाता है:

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