إجراءات بدء الأحداث المتكرّرة والمجدوَلة

تتيح لك ثلاثة إجراءات تفعيل مختلفة جدولة عملية تشغيل آلي مسبقًا:

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 يتيح لك جدولة عملية تشغيل آلي استنادًا إلى شرط واحد أو أكثر من شروط الوقت أو التاريخ. يستخدم إجراء التفعيل هذا بنية مشابهة لتلك التي تستخدمها أداة cron في نظام Unix لتحديد الجدول الزمني لعملية تشغيل آلي متكرّرة.

Time.RecurringSolarTimeScheduledEvent يتيح لك جدولة عملية تشغيل آلي استنادًا إلى وقت شروق الشمس أو غروبها، أو بشكل اختياري بالاشتراك مع شرط يستند إلى التقويم.

تعبيرات cron

قد تكون على دراية بـ cron، وهو أمر يُستخدم على أنظمة Unix وLinux لجدولة المهام المتكرّرة.

تستخدم إجراءات تفعيل الأحداث المجدولة المتكرّرة بنية تعبير جدولة مشابهة لتلك التي تستخدمها cron، ولهذا السبب، يُشار إلى تعابير الجدولة المستخدَمة مع إجراءات التفعيل هذه باسم تعبيرات cron.

هناك عدة "أنواع" مختلفة من cron، وعدة اختلافات في البنية بين عمليات التنفيذ هذه. تستخدم تعابير cron في إجراءات تفعيل الأحداث المجدولة المتكرّرة البنية نفسها التي يستخدمها برنامج Quartz للجدولة. يتم شرح بنية تعبير cron في Quartz في مستندات في QuartzCronExpression.

أمثلة

في ما يلي بعض الأمثلة لتوضيح ذلك.

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. A 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 *"))
}