Net-Base Revija

03.11.2026

Delphi: INI/Config atomsko posodobiti – write-through s začasno datoteko, flush in odpornost proti zrušitvam

Če INI-datoteke po Crashu ali Kill postanejo pokvarjene, pomaga robusten vzorec zamenjave: začasna datoteka v ciljnem imeniku, Flush/Write-through in atomarna zamenjava prek ReplaceFile. Vključuje odločitveni potek, pasti in razhroščevanje.

03.11.2026

Od teme v reviji do projektne prakse

Ustrezne strani storitev in tehnični opisi k prispevku

Trenutek je neopazen: storitev se zaustavi, samodejni posodabljalnik zamenja datoteke, upravitelj opravil dobi en klik preveč – in prav takrat se shrani INI. Ob naslednjem zagonu se ne pojavi dialog „Konfiguracija manjka“, temveč resnična težava v obratovanju: storitev se ne zažene, vmesnik ostane nedostopen, vstopnica konča pri napačni ekipi in na koncu nekdo najde 0-bajtno INI v imeniku programa.

Če ste pred odločitvijo, ali uvesti Delphi: INI/Config atomsko posodabljanje, gre redko za „Clean Code“. Gre za konflikt ciljev: čim manj logike za I/O in poti napak proti zanesljivemu vedenju ob zrušitvi, prisilnemu prekinitvi procesa (Kill) ali izpadu električne energije. Kdor zapisuje konfiguracijo v okoljih blizu produkcije (Windows- in Linux-storitve, terminalni strežniki, kioski, načrtovane naloge), si pogosto ne more privoščiti naivne različice.

Ta prispevek sledi odločitveni poti: katere možnosti obstajajo, kaj v primeru napake v resnici naredijo, kateri Windows-mehanizmi stojijo za tem (Write-through, Flush, atomarni Replace) in kateri prvi korak vam takoj poveča varnost obratovanja – brez da bi iz INI naredili velik projekt.

Delphi: INI/Config atomsko posodabljanje v praksi

Testaufbau mit Rechnern und Netzschalter zur Simulation harter Abbrüche beim Speichern von Konfigdateien
Ponovljivi testi zrušitev: ponavljajoče shranjevanje in prisilno zaustavljanje v kontroliranih pogojih.
Arbeitsplatzszene mit Datenträger und unscharfem Diagnosefenster als Hinweis auf Handle- und Lock-Debugging
Če Replace občasno ne uspe, so pogosto vzrok odprti ročaji datotek in skenerji – odločajo kode napak.
Abstrakte Grafik eines Dateischreibpfads mit Temp-Datei, Flush-Schritt und atomarem Ersetzen der Zieldatei
Robusten potek kot sistemska veriga: pisanje, flush, atomska zamenjava – brez UI-podrobnosti.

Preden primerjate API-je, razjasnite razred tveganja. To ni akademska vaja, ampak določa, koliko »odpornosti proti zrušitvam« morate dejansko kupiti.

  • Nekritično: položaji oken, nazadnje odprti seznami, postavitev UI. Ponastavitev je sprejemljiva.
  • Relevantno: končne točke, poti, Feature-Toggles, parametri najemnika/licence. Napake povzročijo delo podpore in izgubo časa.
  • Kritično: parametri zagona storitve, upravljanje opravil, varnostno pomembni stikali. Napaka lahko povzroči izpade ali izniči zaščitne ukrepe.

Od »relevantno« je atomska zamenjava praviloma dobro vložen trud. Od »kritično« naj raje predpostavite, da je obvezno robustno vzorec shranjevanja – plus testi, ki dejansko zajamejo trenutek prekinitve procesa.

Možnosti v primerjavi: Kaj se ob zrušitvi resnično zgodi?

Tipična zmota: ocenjevanje opcij po „kolikokrat deluje“, ne pa po „koliko škode nastane, če gre narobe“. Spodnja matrika je zato namensko formulirana z vidika obratovanja.

Možnost Implementacijski napor Vedenje ob zrušitvi/prekinitvi Pogoste pasti Ustreza, če …
Pisanje neposredno v ciljno datoteko nizek Tveganje: delni zapis, 0 Bajtov, neveljavna oblika Prekinitev sredi pisanja; konkurenčni skenerji/indexerji Konfiguracija je potrošna in ni kritična za zagon
Pisanje v začasno datoteko, nato preimenovanje/premik srednji Po navadi konsistentno, vendar brez Flush-a ni nujno trajno Začasna datoteka na drugem volumnu; Copy+Delete namesto Rename; metapodatki v predpomnilniku Želite atomarnost, vendar ne maksimalne garancije trajnosti
Začasno + Flush + ReplaceFile (atomska zamenjava) srednji Zelo robustno: stara ali nova datoteka, redko »vmes« Konflikti pri deljenju (sharing violations), pravice/ACL, pravilo o volume, pot do varnostne kopije Konfiguracija je pomembna/kritična ali upravljate storitve/kioske
Dnevnik/transakcijski format (Append + Commit) visok Maksimalni nadzor (replay/rollback možen) Več testov, migracija, orodja, rotacija dnevnikov Veliko zapisov, več piscev ali potrebne avditabilne spremembe

Osnovni konflikt: atomarnost ni enako kot trajnost

Mnoga ekipa se ustavi pri »temp-datoteka + preimenovanje« – razumljivo, saj prepreči neposredno prepisovanje. Vendar ima varnost pred zrušitvami dve plati:

  • Atomarnost: bralci naj vidijo bodisi staro ali novo verzijo, ne vmesnega stanja.
  • Persistenca („durable write“): Po izpadu elektrike mora biti nova različica res zapisana na nosilec podatkov – ne le v predpomnilniku.

Windows običajno shrani zapisne operacije v sistemski predpomnilnik. Brez izrecnega flush-a odloča algoritem predpomnilnika, kdaj podatki pridejo na nosilec podatkov.[Quelle] Praktična posledica: vzorec lahko deluje „logično čist“ in vseeno pri izpadu napajanja slabo konča, če ne uporabljate Write-through ali ne izvedete flush.

V številnih podjetniških aplikacijah je atomarnost večji vzvod (brez pokvarjene INI). Persistenca postane kritična tam, kjer se naprave izklapljajo na silo, so prisotna vdelana/industrijska okolja ali so spremembe konfiguracije redke, a v primeru napake povzročijo največ škode.

Robustna pot: začasna datoteka, Write-through/Flush, nato atomska zamenjava

Če se odločite za „robustno“, naj bo vaš vzorec shranjevanja jasen in preverljiv. Ne kot čarobni pripomoček, temveč kot zaporedje preverljivih korakov:

  1. Ustvarite začasno datoteko v ciljni mapi (ali vsaj zagotovite, da je na istem volumnu). To je pogoj, da je Replace res Replace – in ne Copy+Delete.
  2. Popolnoma zapisati v začasno datoteko (vključno z odločitvijo o kodiranju; datoteko zapreti, da se predpomnilniki prenesejo v I/O-sklad).
  3. Vzdržnost sprožiti: odpreti ročaj datoteke z FILE_FLAG_WRITE_THROUGH in/ali poklicati FlushFileBuffers. Microsoft opisuje Write-through kot zapis „brez zamika“ iz predpomnilnika; za metapodatke in end-to-end trajnost dokumentacija CreateFile še vedno navaja FlushFileBuffers.[Quelle]
  4. Atomsko zamenjati: uporabite ReplaceFileW (opcijsko z varnostno kopijo). To zapakira zamenjavo kot enotno operacijo in je zgrajeno za ta namen.
  5. Naredite vidne poti napak: Kaj se zgodi pri Sharing-Violation, pri pomanjkanju dovoljenj, pri odsotnosti ciljne datoteke? Zalogirajte korak in kodo napake.

En podrobnost ni pogajljiva: ReplaceFileW zahteva, da sta zamenjana datoteka in nadomestna datoteka na istem volumnu.[Quelle] Ravno zato je „Temp in %TEMP%“ nevarna privzeta nastavitev: v Roaming-/VDI-scenarijih ali pri preusmerjenih profilih se lahko volumen razlikuje, in vaš „atomski“ korak nenadoma ni več atomaren.

Delphi-INI-razrede pravilno uvrstiti: UpdateFile ni vaš varnostni sidro pri zrušitvah

TIniFile und TMemIniFile sta priročna in v številnih projektih povsem zadostna. Osnovna razlika je: TMemIniFile zbira spremembe v pomnilniku in jih zapisuje združeno; TIniFile dela bližje datoteki (odvisno od implementacije/različice). Za zanesljivost pri zrušitvah pa je odločilno, kaj „Update“ na koncu dejansko pomeni.

Dokumentacija RAD Studio za System.IniFiles.TIniFile.UpdateFile opisuje zapisovanje predpomnjenih podatkov, vendar učinek postavi v zgodovinski kontekst (pod NT naj bi imel „ničelni učinek“).[Vir] Praktična posledica: UpdateFile je smiseln za rešitev problema „iz Delphi-predpomnjenja“, vendar ni zadnji korak pri zavarovanju pred zrušitvami ali izgubo napajanja.

Če je vaša konfiguracija kritična za delovanje, obravnavajte zapise v INI kot vsako drugo trajno spremembo: potrebujete vzorec, ki je pravilen na ravni ročaja datoteke in datotečnega sistema.

ReplaceFileW oder MoveFileEx? Odločite se glede na semantiko

Oba pristopa lahko „zamenjata“, vendar semantika ni identična. Prav te nianse odločajo, ali bo vaša podpora kasneje videla „sporadične okvare“ ali „jasno kodo napake“.

ReplaceFileW: zamenjava z neobvezno varnostno kopijo

ReplaceFileW je prilagojen primeru uporabe „zamenjava ciljne datoteke z nadomestno datoteko“. Opcijsko lahko ustvarite varnostno kopijo datoteke in v mnogih primerih ohranite atribute ciljnega objekta. Za konfiguracijo je to pogosto ustrezna izbira, saj varnostna kopija v primeru napake omogoči najhitrejši Rollback – tudi brez debuggerja.

MoveFileEx: splošnejše preimenovanje/premik, z zastavicami

MoveFileEx z MOVEFILE_REPLACE_EXISTING lahko prav tako izvede zamenjavo. V običajnih headerjih obstaja tudi MOVEFILE_WRITE_THROUGH, ki omogoča write-through obravnavo koraka premika/zamenjave. Težava ni toliko „ne more“, temveč „moraš sam zgraditi želeno semantiko“ (varnostna kopija, atributi, obravnava napak, testi).

Za INI, ki vpliva na zagon storitve, je ReplaceFileW pogosto jasnejša izbira. Za zelo preproste primere lahko zadostuje MoveFileEx – vendar morate v tem primeru zavestno sprejeti in testirati posledice (brez varnostne kopije, drugačna semantika).

Pasti, ki v praksi res ustvarijo tikete

Začasna datoteka v napačnem imeniku (in nenadoma postane Copy+Delete)

Če začasna datoteka in cilj nista na istem volumu, zamenjava ne more biti atomska. To je posebej zahrbtno, ker je na razvijalskih računalnikih »vedno delovalo« in se pokaže šele v okolju strank (preusmerjeni profili, drugačne dodelitve pogonov, App‑V/VDI).

AV/Indexer/Backup-Agent kratko drži cilj odprt

Konfiguracijske datoteke se pogosto skenirajo ali indeksirajo. Tedaj Replace občasno odpove z napako Sharing-Violation. To ni razlog, da zavržete vzorec – vendar je razlog, da beležite kode napak in uvedete kratek, omejen retry z backoffom (npr. nekaj poskusov v okviru nekaj sto milisekund). Pomembno: retries ne smejo blokirati gašenja/ustavitve servisa.

ACLs und Ownership: Po Replace pravice niso več pravilne

Če je izvorno datoteko nameščen ustvaril z določenimi ACL-ji, lahko novo ustvarjena datoteka nosi druge pravice. ReplaceFile lahko ohrani atribute, a to ni izgovor, da ne preverite. Za obratovanje šteje na koncu le: ali lahko Service-Identity po posodobitvi bere in piše? Načrtujte ta testni primer, zlasti pri Program Files v primerjavi z ProgramData.

Več zapisovalcev: atomsko zamenjano, a logično izgubljeno

Atomska zamenjava prepreči »polovično zapisano«, ne pa »prepisano«. Če dva procesa izvajata »beri → spremeni → zapiši«, zmaga zadnji. Če imate res dva writerja (servis + orodje za upravljanje), potrebujete koordinacijo: Mutex, lock‑datoteko ali centralno mesto, ki serializira zapise. Sicer odpravite en problem in ustvarite novega.

Pristop za razhroščevanje: tako reproducirate robni številčen scenarij izpada

Zaupanje v odpornost ob zrušitvi ni dovolj; to morate sprožiti. Uporaben test ni eleganten, je pa nedvoumen.

  1. Intenzivno pisanje: Shranjujte zaporedoma in spreminjajte dolžino/vsebino, da se ustvarijo različni vzorci zapisov.
  2. Prisilno prekinjanje procesa: Ubijte proces med shranjevanjem (npr. taskkill /F). Ne »Close«, ne »Exit«.
  3. Po vsakem ponovnem zagonu validirajte: datoteka ne sme biti 0 bajtov, mora biti parseable, obvezni ključi morajo obstajati.
  4. Postopen logging: Ne beležite samo »Save OK«, ampak: temp ustvarjen, temp zapisan, Flush OK/hibna koda, Replace OK/hibna koda, Backup da/ne.
  5. Spreminjajte okolje: SSD/HDD, VM s prisilnim izklopom, profil terminalskega strežnika, omrežni share (če relevantno).

Če v logih pozneje vidite samo »Settings saved«, to nikomur ne pomaga. Če pa vidite »Replace fehlgeschlagen: Sharing violation«, je naslednji ukrep jasen: prilagodite retry‑okno, preverite pot/skener, ovrednotite koncepte zaklepanja.

Kdaj robustna koda ni upravičena – in kaj je vseeno obvezno

Obstajajo projekti, kjer je popolna Replace/Flush‑pot nesorazmerna: orodje za enega uporabnika, konfiguracija je zgolj kozmetična, zapisi so redki in reset je sprejemljiv. V takih primerih je lahko »navadno shranjevanje« upravičeno.

Dve stvari vseeno ne smeta manjkati:

  • Obnova pri nalaganju: Če INI ni mogoče razparsati, ne prekinjajte delovanja. Nastavite privzete vrednosti; po potrebi poškodovano datoteko varnostno kopirajte in ponovno zapišite.
  • Minimalna validacija: Preverite obvezne sekcije in obvezne ključe, da „navidezno veljavno“ ne vodi do zaporednih napak, ki bi jih kasneje napačno razlagali kot mrežni ali podatkovno-bazni problem.

To je pravi vzvod učinkovitosti: preprečite, da poškodovana besedilna datoteka postane motnja v obratovanju – ne glede na to, ali ste že implementirali maksimalno robustno pot zapisa.

Prvi korak: kratek kontrolni seznam za odločanje v ekipi

  • Se lahko proces med shranjevanjem trdo zaključi? (Service-Shutdown, Update, Kiosk) Če da: predvidite Replace-Pattern.
  • Je konfiguracija kritična za zagon? Če da: zamenjavo izvedite atomarno in predvidite možnost varnostne kopije.
  • Ali datoteka res leži lokalno na NTFS? Če ne: obseg testiranja se poveča, vzorec pa ostaja smiseln.
  • A obstaja več piscev? Če da: dodatno načrtujte zaklepanje/serializacijo.
  • Ali so poti napak vidne? Če ne: najprej dodajte beleženje na ravni koraka.

Če na dve ali več točk odgovorite z „da“, je verjetnost velika, da si boste z atomarno zamenjavo prihranili tikete, ki se sicer pojavljajo le občasno – in so zato posebej dragi.

Zaključek: Atomarno posodabljanje pomeni upoštevati obratovanje

Datoteke INI so majhne, vendar njihov vpliv pogosto ni. Robustni vzorec za „Delphi: INI/Config atomarno posodabljanje“ ni luksuz: začasna datoteka v ciljni mapi, Flush/Write-through tam, kjer šteje, in atomarna zamenjava (tipično ReplaceFileW) ter sledljivi poti napak. Tako v primeru resnih težav ne boste imeli le nedotaknjene datoteke, temveč tudi odgovor na podporno vprašanje „Kaj se je natančno zgodilo?“

Če želite vzorec v obstoječih rešitvah dosledno uvesti (vključno s testno strategijo, konceptom zaklepanja in migracijskim potekom za več konfiguracijskih mest), se to najhitreje razjasni v kratkem tehničnem usklajevanju: vzpostavite stik.

Viri in dodatne informacije

Strokovne jedrne trditve so bile uredniško umeščene na podlagi naslednjih zunanjih virov.

  1. Flushing System-Buffered I/O Data to Disk – Win32 apps | Microsoft Learn (learn.microsoft.com)
    Windows bufferira zapise datotek; brez eksplicitnega Flush-a algoritmi predpomnilnika določajo, kdaj podatki dejansko prispejo na nosilec, zato je FlushFileBuffers pomemben za Durable Writes.
  2. CreateFileA function (fileapi.h) – Win32 apps | Microsoft Learn (learn.microsoft.com)
    FILE_FLAG_WRITE_THROUGH opisuje Write-through vedenje pri CreateFile; za vzdržnost metapodatkov se še vedno sklicuje na FlushFileBuffers.
  3. ReplaceFileW function (winbase.h) – Win32 apps | Microsoft Learn (learn.microsoft.com)
    ReplaceFileW izvaja zamenjavo datoteke in predpostavlja, da se izvorna datoteka in nadomestna datoteka nahajata na istem volumnu.
  4. System.IniFiles.TIniFile.UpdateFile – RAD Studio API Documentation (docwiki.embarcadero.com)
    TIniFile.UpdateFile je dokumentiran kot flush predpomnjenih sprememb in je v zgodovinskem oziroma kontekstualnem pogledu postavljen v odnos do NT-sistemov.

Za to temo sta pomembna tudi atomska zamenjava datoteke in Replacefilew Delphi. Prispevek te vidike jasno umešča in pokaže, na kaj je v praksi treba paziti.

Posvetujte se o projektu ali modernizacijskem načrtu z Net-Base.

naslednji korak

Ko iz teme nastane resničen projekt, je treba arhitekturo, obstoječe sisteme in obratovanje zgodaj obravnavati skupaj.

Ne podpiramo le pri posameznih vprašanjih, ampak tudi takrat, ko iz izrezkov izvorne kode, legacy-tem ali idej za portale nastane zanesljiv podjetniški projekt.

  • Obstoječe stanje, ciljno stanje in tehnična tveganja se ocenjujejo skupaj.
  • REST, dostop do podatkov, portali in Rollout ne bodo prestavljeni v kasnejše faze.
  • Že zgodaj vidite, katera pot je ekonomsko in operativno vzdržna.

Deli objavo

Deli ta prispevek neposredno

LinkedIn, X, Facebook, WhatsApp und E-Mail sind sofort verfügbar. für Instagram bereiten wir Link und Kurztext direkt vor.

E-pošta

Instagram se odpre v novem zavihku. Povezava in kratek opis se pred tem kopirata v odložišče.

Dodaj komentar

Deine E-Mail-Adresse wird nicht veröffentlicht. Erforderliche Felder sind mit * markiert