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

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

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

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. يمكنك الاطّلاع على مستندات CronExpression في Quartz لمعرفة بنية تعبيرات cron.

أمثلة

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

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