Net-Base Časopis

03.11.2026

Delphi: Atomarno ažuriranje INI/Config – Write-through s privremenom datotekom, flushom i otpornošću na pad sustava

Ako INI-datoteke postanu oštećene nakon crasha ili Kill, robustan Replace-pattern pomaže: privremena datoteka u ciljanom direktoriju, Flush/Write-through i atomska zamjena putem ReplaceFile. Uključuje put odlučivanja, uobičajene zamke i smjernice za debugiranje.

03.11.2026

Od teme magazina do projektne prakse

Povezane stranice usluga i tehnologije za članak

Trenutak je neupadljiv: ein Service fährt herunter, ein Autoupdater tauscht Dateien, der Task-Manager bekommt einen Klick zu viel – und ausgerechnet währenddessen wird eine INI gespeichert. Pri sljedećem pokretanju ne pojavljuje se dijalog „Konfig fehlt“, već stvarni operativni problem: Dienst startet nicht, Schnittstelle bleibt down, das Ticket landet beim falschen Team, und am Ende findet jemand eine 0-Byte-INI im Programmverzeichnis.

Ako se nalazite pred odlukom implementirati Delphi: INI/Config atomar aktualisieren, rijetko se radi o „Clean Code“. Radi se o sukobu ciljeva: što manje I/O- i logike za putove pogrešaka nasuprot pouzdanom ponašanju pri padu, prisilnom prekidu procesa ili nestanku struje. Tko piše konfiguraciju u proizvodno bliskim okruženjima (Windows- und Linux-Services, Terminalserver, Kiosk, geplante Jobs), često si ne može priuštiti naivnu varijantu.

Ovaj članak slijedi put odlučivanja: koje su opcije, što one u slučaju pogreške zaista rade, koji Windows-mehanizmi stoje iza toga (Write-through, Flush, atomsko zamjenjivanje) i koji prvi korak vam odmah daje operativnu sigurnost – bez da od INI napravite veliki projekt.

Delphi: INI/Config atomsko ažuriranje u praksi

Testni postav s računalima i prekidačem napajanja za simulaciju tvrdih prekida pri spremanju konfiguracijskih datoteka
Reproducibilni crash-testovi: ponovljeno spremanje i nasilno zatvaranje u kontroliranim uvjetima.
Scena radnog mjesta s medijem za pohranu i zamućenim dijagnostičkim prozorom kao naznaka za debugiranje handle-a i lockova
Ako Replace povremeno zakaže, često su uzrok otvoreni Handles i skeneri – kodovi pogrešaka odlučuju.
Apstraktna grafika puta zapisivanja datoteke s privremenom datotekom, korakom flush i atomskim zamjenjivanjem ciljne datoteke
Robustan postupak kao sustavna lančana operacija: pisanje, flushanje, atomsko zamjenjivanje – bez UI-detalja.

Prije nego što uspoređujete API-je, razjasnite klasu rizika. To nije akademska vježba, već određuje koliko „otpornosti na pad sustava“ zapravo morate nabaviti.

  • Nekritično: pozicije prozora, zadnje otvoreni popisi, UI-raspored. Reset je prihvatljiv.
  • Relevantno: krajnje točke, putanje, feature-togglei, parametri tenanta/licence. Pogreške stvaraju rad za podršku i gubitak vremena.
  • Kritično: parametri pokretanja servisa, upravljanje jobovima, sigurnosno relevantni prekidači. Pogreška može prouzročiti downtime ili onesposobiti mjere zaštite.

Od „relevantno“ atomska zamjena obično je dobro uložen trud. Od „kritično“ trebate računati da je robustan model pohrane obavezan – plus testovi koji zaista pogode trenutak prekida procesa.

Opcije u usporedbi: Što se zapravo događa pri padu?

Tipična zamka: opcije se procjenjuju po „koliko često uspije“, a ne po „koliko je štete kad zakaže“. Slijedeća matrica je stoga namjerno formulirana iz operativne perspektive.

Opcija Implementacijski napor Ponašanje pri Crash/Kill Česte zamke Odgovara kad …
Pisati izravno u ciljnu datoteku mali Rizik: djelomično stanje, 0 bajtova, nevažeći format Prekid usred zapisa; konkurentni skeneri/indexeri Konfiguracija je potrošna i nije kritična za pokretanje
Zapis u privremenu datoteku, zatim Rename/Move srednji Uglavnom konzistentno, ali bez nužne postojanosti bez flush-a Privremena datoteka na drugom volumenu; Copy+Delete umjesto Rename; metapodaci u cacheu Želite atomarnost, ali ne i maksimalnu garanciju postojanosti
Temp + Flush + ReplaceFile (atomar ersetzen) srednji Vrlo robustno: stara ili nova datoteka, rijetko „između“ Sharing-Violations, prava/ACL-i, pravilo volumena, put za backup Konfiguracija je relevantna/kritična ili upravljate servisa/kiosk okruženjem
Journal/Transaktionsformat (Append + Commit) visok Maksimalna kontrola (Replay/Rollback moguć) Više testova, migracija, alatna podrška, rotacija logova Mnogi zapisi, više writera ili potrebne auditabilne promjene

Suštinski sukob: atomarnost nije isto što i postojanost

Mnogi timovi se zadovolje s „Temp-Datei + Rename“ – razumljivo, jer to sprječava izravno prepisivanje. No sigurnost pri padu ima dvije razine:

  • Atomizität: Čitatelji bi trebali vidjeti ili staru ili novu verziju, a ne međustanje.
  • Persistencija („durable write“): Nakon nestanka struje nova verzija mora zaista biti na mediju za pohranu – ne samo u cacheu.

Windows obično kešira operacije pisanja u sistemskom cacheu. Bez eksplicitnog flush‑a cache‑algoritam odlučuje kada će podaci biti zapisani na medij za pohranu.[Izvor] Praktični zaključak: Obrazac može djelovati „logički čist“ i ipak kod Power‑Loss završiti neusretno ako ne koristite Write‑through niti izvršite flush.

U mnogim poslovnim aplikacijama atomarnost je veći poluga (nema oštećene INI). Persistencija postaje kritična tamo gdje se uređaji hardverski isključuju, u Embedded/Industrial‑okruženjima ili kada su promjene konfiguracije rijetke, ali u slučaju kvara posebno bolne.

Robusni put: Temp‑datoteka, Write‑through/Flush, zatim atomska zamjena

Ako se odlučite za „robustno“, vaš obrazac pohrane trebao bi biti jasan i provjerljiv. Ne kao magični alat, već kao niz provjerljivih koraka:

  1. Stvorite Temp‑datoteku u ciljnom direktoriju (ili barem zajamčeno na istom volumenu). To je preduvjet da zamjena zaista bude zamjena – a ne kopiranje + brisanje.
  2. U potpunosti zapisati u Temp‑datoteku (uključujući odluku o enkodiranju; zatvoriti datoteku da bi se bufferi poslali u I/O‑stack).
  3. Inicirajte persistenciju: otvorite handle datoteke s FILE_FLAG_WRITE_THROUGH i/ili pozovite FlushFileBuffers. Microsoft opisuje Write‑through kao zapis „bez odgode“ iz cachea; za metapodatke i end‑to‑end izdržljivost dokumentacija CreateFile i dalje upućuje na FlushFileBuffers.[Izvor]
  4. Izvedite atomsku zamjenu: koristite ReplaceFileW (opcionalno s backupom). To enkapsulira zamjenu kao operaciju i namijenjeno je za tu svrhu.
  5. Učinite putove pogrešaka vidljivima: Što se događa pri Sharing‑Violation, pri nedostatku prava, pri nedostajućoj ciljnoj datoteci? Zabilježite korak i kod pogreške.

Jedan detalj nije za pregovore: ReplaceFileW zahtijeva da zamijenjena datoteka i zamjenska datoteka leže na istom volumenu.[Izvor] Upravo zbog toga je „Temp in %TEMP%“ opasan zadani izbor: u Roaming‑/VDI‑scenarijima ili kod preusmjerenih profila volumen može varirati, i vaš „atomski“ korak odjednom više nije atomski.

Delphi-INI-klase pravilno svrstati: UpdateFile nije vaš sigurnosni oslonac pri padu

TIniFile i TMemIniFile su praktični i u mnogim projektima potpuno dovoljni. Razlika je otprilike: TMemIniFile skuplja promjene u memoriji i zapisuje ih u jednom bloku; TIniFile radi bliže datoteci (ovisno o implementaciji/verziji). Za sigurnost pri padu aplikacije presudno je što „Update“ na kraju zapravo znači.

RAD-Studio dokumentacija za System.IniFiles.TIniFile.UpdateFile opisuje zapis baferiranih podataka, ali relativizira učinak povijesno (na NT to „može imati nikakav efekt“).[Izvor] Praktični zaključak: UpdateFile je smislen za problem „izlaska iz Delphi-bufferiranja“, ali nije posljednji korak za scenarije padova ili gubitka napajanja.

Ako je vaša konfiguracija kritična za rad, tretirajte pisanje INI-ja kao svaku drugu perzistentnu promjenu: trebate obrazac koji je ispravan na razini file-handlea i datotečnog sustava.

ReplaceFileW oder MoveFileEx? Odlučite prema semantici

Oba pristupa mogu „zamijeniti“, ali semantika nije identična. Upravo te nijanse odlučuju hoće li vaš support kasnije viđati „povremeno pokvareno“ ili „jasan kod pogreške“.

ReplaceFileW: zamjena s opcionalnim backupom

ReplaceFileW je prilagođen use-caseu „zamjena ciljane datoteke zamjenskom datotekom“. Možete opcionalno omogućiti stvaranje backup-datoteke i u mnogim slučajevima sačuvati atribute ciljnog objekta. Za konfiguracije je to često prikladno jer backup u slučaju greške omogućuje najbrži rollback – čak i bez debugger-a.

MoveFileEx: općeniti Rename/Move, s flagovima

MoveFileEx s MOVEFILE_REPLACE_EXISTING također može zamijeniti. U uobičajenim headerima postoji i MOVEFILE_WRITE_THROUGH za tretiranje koraka move/replace kao write-through. Caka nije u „ne može“, nego u tome da morate sami sastaviti željenu semantiku (backup, atributi, obrada grešaka, testovi).

Za INI koja utječe na pokretanje servisa, ReplaceFileW je često jasniji izbor. Za vrlo jednostavne slučajeve MoveFileEx može biti dovoljan – ali tada svjesno prihvatite i testirajte posljedice (nema backup-a, druga semantika).

Zamke koje u praksi zaista stvaraju tikete

Temp-Datei im falschen Verzeichnis (und plötzlich ist es Copy+Delete)

Ako privremena datoteka i cilj nisu na istom volumenu, zamjena ne može biti atomarna. To je posebno varljivo, jer je na razvojnim strojevima „uvijek radilo“ i tek u korisničkim okruženjima (preusmjerene profile, druga dodjela diskova, App-V/VDI) iskrsne problem.

AV/Indexer/Backup-Agent drže cilj kratko otvoren

Konfiguracijske datoteke se često skeniraju ili indeksiraju. Tada Replace povremeno zakaže s Sharing-Violation. To nije razlog za odbacivanje obrasca – ali je razlog za logiranje kodova pogrešaka i implementaciju kratkog, ograničenog ponovnog pokušaja s postupnim razmakom (npr. nekoliko pokušaja unutar nekoliko stotina milisekundi). Važno: ponovni pokušaji ne smiju blokirati Shutdown/Service-Stop.

ACL-i i Ownership: Nakon Replace prava više ne odgovaraju

Ako je izvorna datoteka stvorena od strane instalera s određenim ACL-ovima, nova datoteka može imati drugačije dozvole. ReplaceFile može zadržati atribute, ali to nije opravdanje da se ne provjeri. Za rad u produkciji na kraju jedino vrijedi: može li Service-Identity nakon ažuriranja čitati i pisati? Uplanirajte ovaj testni slučaj, osobito kod Program Files vs. ProgramData.

Više pisaca: atomarno zamijenjeno, ali logički izgubljeno

Atomarni Replace sprečava „polupisano“, ne „prepisano“. Ako dva procesa rade „čitati → mijenjati → pisati“, pobjeđuje posljednji. Ako zaista imate dva writera (servis + admin-alat), trebate koordinaciju: Mutex, lock-datoteka ili centralno mjesto koje serijalizira upise. Inače rješavate samo jedan problem i stvarate novi.

Debugging-pristup: Kako reproducirati crash-randfall

Crash-otpornost se ne smije samo „vjerovati“, mora se izazvati. Upotrebljiv test nije elegantan, ali je jasan.

  1. Stress-pisanje: Spremate u brzoj sekvenci i varirate duljinu/sadržaj, kako bi nastali različiti obrasci upisa.
  2. Prisilno gašenje: Prekinite proces silom tijekom spremanja (npr. taskkill /F). Ne „Close“, ne „Exit“.
  3. Nakon svakog ponovnog pokretanja validirati: datoteka ne smije biti 0 bajtova, mora se parsirati, obavezni ključevi moraju postojati.
  4. Postupno logiranje: Ne logirajte samo „Save OK“, nego: Temp stvorena, Temp zapisana, Flush OK/šifra pogreške, Replace OK/šifra pogreške, Backup da/ne.
  5. Varirajte okolinu: SSD/HDD, VM s naglim isključenjem napajanja, terminalserver profil, mrežni share (ako je relevantno).

Ako u logovima kasnije vidite samo „Settings saved“, to nikome ne pomaže. Ako pak vidite „Replace fehlgeschlagen: Sharing violation“, sljedeća mjera je jasna: prilagoditi prozor ponovnog pokušaja, provjeriti put/skener, ocijeniti koncept locking-a.

Kada robustan kod nije isplativ – i što je ipak obavezno

Postoje projekti u kojima je kompletan Replace/Flush-pat nepotreban: alat za jednog korisnika, konfiguracija je isključivo kozmetička, upisi su rijetki, a reset je prihvatljiv. U tom slučaju „normalno spremanje“ može biti opravdano.

Dva su elementa koja tada ipak ne smijete izostaviti:

  • Recovery beim Laden: Ako se INI ne može parsirati, ne prekidajte proces. Postavite zadane vrijednosti, po potrebi spremite oštećenu datoteku i ponovno je napišite.
  • Minimale Validierung: Provjerite obavezne sekcije i obavezne ključeve, kako „djelomično valjano“ ne bi dovelo do naknadnih pogrešaka koje se kasnije pogrešno protumače kao mrežni ili problem s bazom podataka.

Ovo je pravi poluga za učinkovitost: sprječavate da oštećena tekstualna datoteka postane poremećaj rada – neovisno o tome jeste li već implementirali najrobustniji put zapisa.

Prvi korak: Kratki kontrolni popis za odluku u timu

  • Može li se proces tijekom spremanja tvrdo prekinuti? (gašenje servisa, ažuriranje, kiosk) Ako da: planirajte Replace-Pattern.
  • Je li konfiguracija kritična za pokretanje? Ako da: atomarno zamijeniti i osigurati opciju sigurnosne kopije.
  • Je li datoteka zaista lokalno na NTFS? Ako ne: opseg testiranja raste, ali obrazac ostaje smislen.
  • Postoji li više zapisivača? Ako da: dodatno osmislite zaključavanje/serijalizaciju.
  • Jesu li putevi grešaka vidljivi? Ako ne: prvo dopunite logiranje na razini koraka.

Ako na dva ili više pitanja odgovorite „da“, velika je vjerojatnost da ćete atomarnom zamjenom izbjeći tikete koji se inače pojavljuju sporadično – i stoga su posebno skupi.

Zaključak: Atomarno ažuriranje znači uzeti u obzir rad sustava

INI datoteke su male, ali njihov utjecaj često nije. Robustan obrazac za „Delphi: INI/Config atomarno ažuriranje“ nije luksuz: privremena datoteka u ciljnoj mapi, Flush/Write-through tamo gdje je važno, i atomska zamjena (tipično ReplaceFileW) plus jasni putovi pogrešaka. Tako u slučaju problema imate ne samo netaknutu datoteku, već i odgovor na support pitanje „Was ist genau passiert?“

Ako želite dosljedno primijeniti taj obrazac u postojećem sustavu (uključujući strategiju testiranja, koncept zaključavanja i migracijski put za više mjesta konfiguracije), to se najbrže razjasni u kratkom tehničkom usuglašavanju: Kontaktirajte nas.

Izvori i daljnje informacije

Stručne ključne tvrdnje urednički su kategorizirane na temelju sljedećih vanjskih izvora.

  1. Flushing System-Buffered I/O Data to Disk – Win32 apps | Microsoft Learn (learn.microsoft.com)
    Windows pufrira zapis datoteka; bez eksplicitnog flusha cache-algoritmi odlučuju kada podaci stvarno dospijevaju na medij, zbog čega je FlushFileBuffers relevantan za Durable Writes.
  2. CreateFileA function (fileapi.h) – Win32 apps | Microsoft Learn (learn.microsoft.com)
    FILE_FLAG_WRITE_THROUGH opisuje Write-through ponašanje pri CreateFile; za trajnost metapodataka i dalje se referencira FlushFileBuffers.
  3. ReplaceFileW function (winbase.h) – Win32 apps | Microsoft Learn (learn.microsoft.com)
    ReplaceFileW enkapsulira zamjenu datoteke i pretpostavlja da se zamijenjena datoteka i zamjenska datoteka nalaze na istom volumenu.
  4. System.IniFiles.TIniFile.UpdateFile – RAD Studio API Documentation (docwiki.embarcadero.com)
    TIniFile.UpdateFile dokumentiran je kao operacija flush-a baferiranih promjena i povijesno/kontekstualno se odnosi na NT sustave.

Za ovu temu važni su i atomska zamjena datoteke i Replacefilew Delphi. Članak jasno svrstava ove aspekte i pokazuje na što treba paziti u svakodnevnoj praksi.

Razgovarajte o projektu ili modernizacijskom zahvatu s Net-Base.

sljedeći korak

Ako se tema pretvori u stvarni projekt, arhitekturu, postojeće sustave i operacije trebalo bi rano zajednički razmotriti.

Podržavamo vas ne samo u pojedinačnim pitanjima, već i kada iz isječaka izvornog koda, naslijeđenih sustava ili ideja za portale treba nastati pouzdan poslovni projekt.

  • Postojeće stanje, ciljna slika i tehnički rizici procjenjuju se zajedno.
  • REST, pristup podacima, portali i rollout neće biti odgođeni kao naknadne posljedice.
  • Rano prepoznajete koji je put ekonomski i operativno održiv.

Podijeli objavu

Izravno proslijedite ovu objavu

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 otvara u novoj kartici. Link i kratki tekst se prethodno kopiraju u međuspremnik.

Napišite komentar

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