Cron-avaldise parser

Cron-avaldise osad ja ülesehitus

Cron-avaldis on kompaktne tekstirida, mida kasutatakse operatsioonisüsteemides ja taustaprogrammides perioodiliste toimingute ajastamiseks. Standardne cron-avaldis koosneb viiest tühikutega eraldatud väljast, millest igaüks määrab konkreetse ajaühiku, millal seadistatud ülesanne peab käivituma. Need väljad on järgmises järjekorras:

1. Minut: Määrab tunnisisese aja, mil toiming käivitatakse.
2. Tund: Määrab ööpäevase tunni.
3. Kuupäev: Määrab kalendrikuu päeva.
4. Kuu: Määrab aasta kuu.
5. Nädalapäev: Määrab nädalapäeva, millal toiming käivitatakse.

Tööriist toetab standardset 5-väljalist süntaksit ning ei toeta kuuendat sekundite välja ega Quartz-spetsiifilisi laiendusi nagu L, W või #.

Iga välja väärtuste tõlgendamiseks kasutatakse kindlaid reegleid ja sümboleid. Kui väljal on tärn *, kuvatakse selle tähenduseks "Iga". Samuti toetatakse järgmisi vorminguid:

• Vahemikud: Näiteks 1-5 tähistab vahemikku esimesest viiendani.
• Sammud: Vorming */n tähistab korduvaid intervalle. Sõltuvalt väljast kuvatakse see kujul "Iga {n} minuti tagant", "Iga {n} tunni tagant", "Iga {n} päeva tagant" või "Iga {n} kuu tagant".
• Loendid: Komadega eraldatud väärtused, näiteks 1,15.
• Nimed: Kuude puhul saab kasutada kolmetähelisi lühendeid (näiteks JAN) ja nädalapäevade puhul samuti kolmetähelisi lühendeid (näiteks MON).

Lisaks standardsetele väljadele toetab parser mugavusotseteid, mis asendavad kogu viie välja kombinatsiooni üheainsa märgiga: @yearly, @monthly, @weekly, @daily ja @hourly.

Kuidas toimub cron-avaldise parsimine ja analüüs

Kui sisestate tööriista tekstiväljale "Cron-avaldis" (näiteks näidise */15 9-17 * * MON-FRI), analüüsib süsteem sisendit reaalajas. Kasutajal on võimalik määrata ka kuvatavate tulemuste arv väljal "Korduste arv", mis võib olla vahemikus 1 kuni 20.

Tööriist jagab avaldise osadeks ja kuvab jaotises "Graafiku üksikasjad" järgmised väljad:

• Minut
• Tund
• Kuupäev
• Kuu
• Nädalapäev

Kui sisestatud tekst on tühi, naaseb tööriist olekusse "Sisestage parsimiseks cron-avaldis.". Kui sisestatud avaldis sisaldab süntaksivigu või ei vasta 5-väljalisele standardile, kuvatakse veateade "Vigane cron-avaldis.".

Erandlikud reeglid ja võimatud graafikud

Cron-graafikute koostamisel kehtib spetsiifiline reegel olukorras, kus piirangud on seatud korraga nii kuupäeva (day of month) kui ka nädalapäeva (day of week) väljale (st kumbki väli ei ole *). Sellisel juhul ei pea mõlemad tingimused üheaegselt täituma. Toimingu käivitamiseks piisab sellest, kui täidetud on kas kuupäeva või nädalapäeva tingimus.

Teine oluline aspekt on loogiliselt võimatute graafikute tuvastamine. Kui avaldis on süntaktiliselt korrektne, kuid kirjeldab graafikut, mis ei saa reaalselt kunagi toimuda, kuvab tööriist veateate: "See graafik ei saa kunagi käivituda – kontrollige, kas valisite kuupäeva, mida mõnes valitud kuus ei eksisteeri.".

See olukord tekib tavaliselt siis, kui kuupäevaks on määratud 31, kuid valitud kuude hulka kuuluvad ainult kuud, milles on vähem päevi (näiteks aprill, juuni, september või november). Kuna nendes kuudes 31. kuupäeva ei eksisteeri, on sellise graafiku käivitumine välistatud.

Ajavööndite mõju käivitusaegadele

Tööriist kuvab jaotises "Järgmised käivitamised" nimekirja tulevastest aegadest, mil seadistatud graafik käivitub. Nende aegade kõrval kuvatakse märge "(teie kohalik aeg)", mis viitab sellele, et arvutused tehakse ja tulemused esitatakse kasutaja veebibrauseri kohaliku ajavööndi põhjal.

Tuleb arvestada, et standardne cron-avaldis ise ei sisalda teavet ajavööndi kohta. Cron-graafikuid käitav server või süsteem töötab sageli serveri süsteemses ajavööndis (mis on tihti UTC). Seetõttu on brauseris kuvatavad kohalikud ajad mõeldud eelvaateks ja kontrolliks, kuid tegelikus töökeskkonnas käivitumise tagamiseks tuleb alati veenduda, millises ajavööndis sihtserver töötab.

Privaatsus ja andmetöötlus brauseris

Selle tööriista kasutamisel on tagatud andmete privaatsus otsese kliendipoolse töötluse kaudu. Teie sisestatud cron-avaldis parsitakse otse brauseris. BroBroGo serverisse midagi ei saadeta. Kogu analüüs, vigade tuvastamine ja järgmiste käivitusaegade arvutamine toimub kohapeal teie seadmes, mis välistab andmete edastamise üle võrgu kolmandatele osapooltele.

Korduma kippuvad küsimused

Millist cron-süntaksit see tööriist toetab? Standardset 5-väljalist cron-sünfaksit – minut, tund, kuupäev, kuu ja nädalapäev – sealhulgas vahemikke (1-5), samme (*/15), loendeid (1,15), kuude ja nädalapäevade nimesid (JAN, MON) ning otseteid nagu @yearly/@monthly/@weekly/@daily/@hourly. Üks oluline reegel: kui piirang on seatud nii kuupäevale kui ka nädalapäevale (pole *), piisab kummagi tingimuse täitmisest – nad ei pea kattuma.

Millises ajavööndis kuvatakse järgmised käivitusajad? Teie brauseri kohalikku ajavööndit – sama, mida kasutab teie operatsioonisüsteem. Standardne cron ei sisalda ajavööndit; seda määrab taustal töötav tööde planeerija, seega käsitlege neid aegu kohaliku graafiku eelvaatena, mis ei pruugi ühtida serveri ajaga.

Miks kuvatakse teade, et see graafik ei saa kunagi käivituda? Tavaliselt on põhjuseks kuupäev, mida valitud kuudes ei eksisteeri – näiteks 31. kuupäev koos aprilli, juuni, septembri või novembriga. Valige kuupäev, mis on olemas kõigis loetletud kuudes, või jagage graafik eraldi avaldisteks.