Bu API, geli\u015ftiricilere uygulamalar\u0131n\u0131n bir hata nedeniyle sonlanaca\u011f\u0131n\u0131 bilme ve kritik bilgileri saklayabilme \u015fans\u0131 vermekte. Dolay\u0131s\u0131yla da son kullan\u0131c\u0131 a\u00e7\u0131s\u0131ndan, deyin yerindeyse, daha iyi<\/em> bir uygulama hata deneyimi sunmakta. E\u011fer Office uygulamalar\u0131n\u0131n g\u00fcncel s\u00fcr\u00fcmlerini kullan\u0131yorsan\u0131z bunu fark etme olas\u0131l\u0131\u011f\u0131n\u0131z olduk\u00e7a y\u00fcksek. Hatta, Visual Studio ile \u00e7al\u0131\u015f\u0131yorsan\u0131z (ki sitemi takip ediyorsan\u0131z \u00f6yle oldu\u011funuzu d\u00fc\u015f\u00fcnmem ka\u00e7\u0131n\u0131lmazd\u0131r<\/em>) bunu pek \u00e7ok kereler g\u00f6rm\u00fc\u015fs\u00fcn\u00fczd\u00fcr; Visual Studio\u2019nun \u00e7al\u0131\u015fmas\u0131 hata nedeniyle sonlanmas\u0131 durumunda Windows yeniden ba\u015flatmak isteyip istemedi\u011fimizi sormakta ve olumlu yan\u0131tta da yeniden ba\u015flatmakta. \u00dcstelik bunu yaparken de hata \u00f6ncesi a\u00e7\u0131k olan proje, kurtarma verisi ile birlikte, yeniden a\u00e7\u0131lmakta. Benzer bir i\u015fleve kendi geli\u015ftirdi\u011fimiz uygulamalar\u0131m\u0131z\u0131n da sahip olmas\u0131 ne kadar g\u00fczel olurdu de\u011fil mi! \u00d6rne\u011fin; kullan\u0131c\u0131 uygulamam\u0131zda login olmu\u015f ve x,y,z ekranlar\u0131n\u0131 a\u00e7m\u0131\u015f. Ard\u0131ndan ald\u0131\u011f\u0131 hata sonras\u0131nda uygulama yeniden ba\u015flat\u0131ld\u0131\u011f\u0131nda yeniden login olmaya ve ekranlar\u0131 a\u00e7maya gerek kalmadan uygulama bu i\u015flemleri otomatik ger\u00e7ekle\u015ftirse!!?? \u0130\u015fte ba\u015far\u0131l\u0131 bir uygulama, y\u00fcksek kullan\u0131c\u0131 deneyimi diye buna denir, de\u011fil mi! Bu makalemde i\u015fte tam da bu konuya de\u011finiyor olaca\u011f\u0131m; hata an\u0131nda uygulamalar\u0131m\u0131zda nas\u0131l daha iyi bir kullan\u0131c\u0131 deneyimi sunabilece\u011fimizi anlat\u0131yor olaca\u011f\u0131m.<\/p>\n\n\n\n \u00d6rnek bir uygulama \u00fczerinden anlat\u0131yor olmak, san\u0131r\u0131m size konuyu daha rahat anlatabilmemi sa\u011flayacakt\u0131r. Olabildi\u011fince konuya odaklanabilmek ad\u0131na bir Windows Forms uygulamas\u0131 yerine bir konsol uygulamas\u0131n\u0131 ele alal\u0131m;<\/p>\n\n\n\n Yukar\u0131daki \u00f6rnek konsol uygulamas\u0131 kullan\u0131c\u0131 ad\u0131 ve \u015fifre bilgilerini alarak kontrol etmekte, bilgilerin do\u011fru olmas\u0131 durumunda kullan\u0131c\u0131y\u0131 kar\u015f\u0131lamakta. \u00f6rnek i\u015f mant\u0131\u011f\u0131n\u0131 temsilen uygulama 60 saniye boyunca bekletilmekte, ard\u0131nda da bir hata olu\u015fmakta. Bu uygulamay\u0131 Visual Studio d\u0131\u015f\u0131ndan \u00e7al\u0131\u015ft\u0131r\u0131p kullan\u0131c\u0131 ad\u0131 olarak fatih, \u015fifre olarak da 1234 girdi\u011fimizde 60 saniye sonra a\u015fa\u011f\u0131daki ekranla kar\u015f\u0131 kar\u015f\u0131ya kal\u0131r\u0131z;<\/p>\n\n\n\n Windows hatay\u0131 fark etmekte ve hata hakk\u0131nda bilgi toplamakta. K\u0131sa bir bekleyi\u015f ard\u0131ndan hata ay\u0131klama ya da program\u0131 kapatma se\u00e7enekleri kar\u015f\u0131m\u0131za gelecektir;<\/p>\n\n\n\n Bu durumda, elimizde kaynak kodlar yoksa (ki son kullan\u0131c\u0131da olmayaca\u011f\u0131 kesin<\/em>) program\u0131 kapatmak d\u0131\u015f\u0131nda da bir se\u00e7ene\u011fimiz kalm\u0131yor. Uygulamay\u0131 yeniden ba\u015flatt\u0131\u011f\u0131m\u0131zda, hata \u00f6ncesinde kald\u0131\u011f\u0131m\u0131z noktaya yeniden gelebilmek i\u00e7in yapabilece\u011fimiz tek \u015fey bu bilgileri yeniden vermek olacakt\u0131r.<\/p>\n\n\n\n Bu noktadan sonra; uygulamam\u0131za kurtarma deste\u011fi sunabilmek ad\u0131na Application Recovery API\u2019sini kullanabiliriz. Kernel32.dll alt\u0131nda yer alan bu API fonksiyonlar\u0131na a\u015fa\u011f\u0131daki \u015fekilde C# i\u00e7erisinden ula\u015fabiliriz;<\/p>\n\n\n\n API\u2019yi kullan\u0131rken yapmam\u0131z gereken ilk i\u015f Windows\u2019a uygulamam\u0131z\u0131n hata durumunda yeniden ba\u015flat\u0131lmay\u0131 istedi\u011fini belirtmektir. Bunun i\u00e7in API i\u00e7erisinde yer alan RegisterApplicationRestart<\/strong> fonksiyonunu kullanabiliriz. Ard\u0131ndan hata an\u0131nda kurtarma bilgisini saklayabilece\u011fimiz i\u00e7in bu durumu bize bildirecekleri bir geri bildirim fonksiyonu belirtmeliyiz; ki bunu da RegisterApplicationRecoveryCallback<\/strong> yard\u0131m\u0131yla yapabiliriz. Bu geri bildirim s\u0131ras\u0131nda kurtarma verisini olu\u015fturmak d\u0131\u015f\u0131nda a\u00e7\u0131lm\u0131\u015f olan i\u015fletim sistemleri kaynaklar\u0131n\u0131n kapat\u0131lmas\u0131 da (\u00f6rne\u011fin a\u00e7\u0131k dosyalar\u0131 kapatmak<\/em>) ger\u00e7ekle\u015ftirilebilir. Kurtarma i\u015flemi s\u0131ras\u0131nda da uygulaman\u0131n kilitlenebilece\u011fini ve bir death lock olu\u015fabilece\u011fini hesaba katan i\u015fletim sistemi geli\u015ftiricileri, bu durumu engellemek ad\u0131na, belirli aralarla uygulaman\u0131n yan\u0131t verip vermedi\u011fini kontrol etmekte ve yan\u0131t vermemesi durumunda uygulamay\u0131 sonland\u0131rmaktad\u0131r. Uygulama belirli aral\u0131klarla yan\u0131t verebildi\u011fini kan\u0131tlayabilmek ad\u0131na ApplicationRecoveryInProgress<\/strong> fonksiyonu yard\u0131m\u0131yla kurtarma i\u015flemini devam etti\u011fini belirtmelidir. T\u00fcm s\u00fcre\u00e7 sona ererek gerekli kurtarma i\u015flemlerinin bitti\u011fi i\u015fletim sistemine ApplicationRecoveryFinished<\/strong> fonksiyonu yard\u0131m\u0131yla iletilmelidir. Herhangi bir sebeple, uygulamam\u0131z\u0131n kurtarma deste\u011finin kalkt\u0131\u011f\u0131n\u0131n i\u015fletim sistemine belirtmek i\u00e7in ise UnregisterApplicationRestart<\/strong> fonksiyonu kullan\u0131lmal\u0131d\u0131r.<\/p>\n\n\n\n RegisterApplicationRestart fonksiyonu bizden iki parametre isteyecektir;<\/p>\n\n\n\n Bu bilgileri uygulamam\u0131za uygulayacak olursak Main fonksiyonumuz a\u015fa\u011f\u0131daki \u015fekilde olacakt\u0131r;<\/p>\n\n\n\n G\u00f6r\u00fcld\u00fc\u011f\u00fc gibi uygulamam\u0131z\u0131n hemen ba\u015f\u0131nda uygulaman\u0131n bir hata sonras\u0131 yeniden ba\u015flat\u0131l\u0131p ba\u015flat\u0131lmad\u0131\u011f\u0131 kontrol edilmekte. Bunu belirlemek i\u00e7in de uygulamaya ge\u00e7ilen bir parametre (HATA_SONRASI_BASLATMA<\/em>) kullan\u0131lmakta. E\u011fer uygulama hata sonras\u0131 yeniden ba\u015flat\u0131ld\u0131 ise veriler bilgileriKurtar<\/em> fonksiyonu yard\u0131m\u0131yla kurtar\u0131lmakta. Bu kontrol sonras\u0131nda ise RegisterApplicationRestart fonksiyonu yard\u0131m\u0131yla i\u015fletim sistemine uygulaman\u0131n hatalarda kurtarma verisi i\u00e7in i\u015flem yapaca\u011f\u0131n\u0131 belirtecektir. Devam\u0131nda RegisterApplicationRecoveryCallback \u00e7a\u011fr\u0131s\u0131 yap\u0131larak hata durumunda tetiklenecek olan fonksiyon belirtilmekte.<\/p>\n\n\n\n RegisterApplicationRecoveryCallback<\/strong> fonksiyonu bizden d\u00f6rt parametre isteyecektir;<\/p>\n\n\n\n A\u015fa\u011f\u0131da, hata olmas\u0131 durumunda i\u015fletim sistemince \u00e7a\u011f\u0131r\u0131lacak olan HataVeriKurtarma fonksiyonunu bulabilirsiniz;<\/p>\n\n\n\n Buradaki en kritik nokta veri kurtarman\u0131n bitmesi sonras\u0131nda ApplicationRecoveryFinished<\/em> fonksiyonunun \u00e7a\u011fr\u0131larak i\u015fletim sistemine i\u015flemin bitti\u011finin haber verilmesidir. Hat\u0131rlarsan\u0131z veri kurtarma i\u015flemi s\u0131ras\u0131nda belirli aral\u0131klarla i\u015flemin devam etti\u011finin i\u015fletim sistemine bildirilmesi gerekti\u011finden bahsetmi\u015ftim. Yukar\u0131daki fonksiyonda bu i\u015flem, olu\u015fturulan timer nesnesi \u00fczerinden yap\u0131lmaktad\u0131r. Timer belirli aral\u0131klarla i\u00e7eri\u011fi a\u015fa\u011f\u0131da verilen CanliTut fonksiyonunu tetiklemektedir.<\/p>\n\n\n\n Dikkat edecek olursan\u0131z bu fonksiyon i\u00e7erisinde i\u015fletim sistemine ApplicationRecoveryInProgress fonksiyonu yard\u0131m\u0131yla i\u015flemin s\u00fcrd\u00fc bildirilmekte. E\u011fer bu i\u015flem s\u0131ras\u0131nda kullan\u0131c\u0131 aray\u00fcz \u00fczerinden i\u015flemi iptal edecek olursa, bu bilgi geri bildirimde uygulamaya iletilmektedir.Uygulama, yukar\u0131da islemiIptalEt parametresinde oldu\u011fu gibi d\u00f6nen de\u011fere g\u00f6re i\u015fleme devam etmeli ya da sonland\u0131rmal\u0131d\u0131r.<\/p>\n\n\n\n T\u00fcm bu ad\u0131mlar sonras\u0131nda uygulamam\u0131z\u0131 \u00e7al\u0131\u015ft\u0131rd\u0131\u011f\u0131m\u0131zda bizi a\u015fa\u011f\u0131daki ekran kar\u015f\u0131layacakt\u0131r;<\/p>\n\n\n\n Bu ekranda bir s\u00fcre bekledikten sonra uygulamam\u0131zda hata olu\u015facak ve Windows\u2019un hata kurtarma ekran\u0131 kar\u015f\u0131m\u0131za \u00e7\u0131kacak. Bu s\u0131rada Windows uygulamam\u0131z HataVeriKurtarma fonksiyonunu \u00e7a\u011f\u0131racak ve gerekli i\u015flemlerin tamamlanmas\u0131 beklenecektir. Kullan\u0131c\u0131n\u0131n bu ekranda iptal butonuna basmas\u0131 durumunda ise ApplicationRecoveryInProgress \u00e7a\u011fr\u0131s\u0131nda false de\u011feri uygulamaya iletilecek ve uygulaman\u0131n hata kurtarma i\u015flemini sonland\u0131rmas\u0131 beklenecektir.<\/p>\n\n\n\nusing System;\nusing System.Threading;\n\nnamespace UygulamaKurtarma {\n public class Program {\n private static string kullaniciAdi;\n private static string sifre;\n\n static void Main(string[] args) {\n var kullaniciBilgileriDogru = false;\n\n while (!kullaniciBilgileriDogru) {\n Console.Write(\"L\u00fctfen kullan\u0131c\u0131 ad\u0131n\u0131 giriniz : \");\n kullaniciAdi = Console.ReadLine();\n\n Console.Write(\"L\u00fctfen \u015fifrenizi giriniz : \");\n sifre = Console.ReadLine();\n\n kullaniciBilgileriDogru = KullaniciBilgileriDogruMu(kullaniciAdi, sifre);\n }\n\n Console.WriteLine();\n Console.WriteLine(\"===============================\");\n Console.WriteLine(\"Uygulamaya ho\u015f geldin, \" + kullaniciAdi);\n\n Thread.Sleep(60000);\n\n throw new Exception(\"Hi\u00e7 beklenmedik bir hata\");\n }\n\n private static bool KullaniciBilgileriDogruMu(string kullaniciAdi, string sifre) {\n return kullaniciAdi == \"fatih\" && sifre == \"1234\";\n }\n }\n}<\/pre>\n\n\n\n![\"uygulama_hatasi\"\/](\"https:\/\/fatihboy.com\/wp-content\/uploads\/2011\/07\/uygulama_hatasi.png\")
<\/a><\/figure>\n\n\n\n<\/a><\/figure>\n\n\n\n[DllImport(\"kernel32.dll\", CharSet = CharSet.Auto)]\nstatic extern uint RegisterApplicationRestart(string pwzCommandLine, RestartFlags dwFlags);\n\n[DllImport(\"kernel32.dll\")]\nstatic extern uint RegisterApplicationRecoveryCallback(APPLICATION_RECOVERY_CALLBACK pRecoveryCallback, object pvParameter, int dwPingInterval, int dwFlags);\n\n[DllImport(\"kernel32.dll\")]\nstatic extern uint ApplicationRecoveryInProgress(out bool pbCancelled);\n\n[DllImport(\"kernel32.dll\")]\nstatic extern uint ApplicationRecoveryFinished(bool bSuccess);\n\n[Flags]\nenum RestartFlags {\n NONE = 0,\n RESTART_CYCLICAL = 1,\n RESTART_NOTIFY_SOLUTION = 2,\n RESTART_NOTIFY_FAULT = 4,\n RESTART_NO_CRASH = 8,\n RESTART_NO_HANG = 16,\n RESTART_NO_PATCH = 32,\n RESTART_NO_REBOOT = 64\n}\n\ndelegate int APPLICATION_RECOVERY_CALLBACK(object pvParameter);<\/pre>\n\n\n\nprivate const string HATA_SONRASI_BASLATMA = \"hataSonrasi\";\n\nstatic void Main(string[] args) {\n var kullaniciBilgileriDogru = false;\n\n if (args.Length < 0 && args[0] == HATA_SONRASI_BASLATMA) {\n Console.ForegroundColor = ConsoleColor.Red;\n Console.WriteLine(\"Uygulama Hata sonras\u0131 yeniden ba\u015flat\u0131ld\u0131!\");\n Console.ResetColor();\n\n bilgileriKurtar();\n\n kullaniciBilgileriDogru = KullaniciBilgileriDogruMu(kullaniciAdi, sifre);\n }\n\n uint islemSonucu = RegisterApplicationRestart(HATA_SONRASI_BASLATMA, RestartFlags.NONE);\n if (islemSonucu == 0) {\n Console.ForegroundColor = ConsoleColor.Yellow;\n Console.WriteLine(\"Uygulama hata kurtarma kayd\u0131 yap\u0131ld\u0131...\");\n Console.ResetColor();\n\n islemSonucu = RegisterApplicationRecoveryCallback(HataVeriKurtarma, null, 50000, 0);\n\n Console.ForegroundColor = ConsoleColor.Yellow;\n Console.WriteLine(\"Uygulama hata kurtarma geri bildirim kayd\u0131 yap\u0131ld\u0131...\");\n Console.ResetColor();\n }\n else {\n Console.ForegroundColor = ConsoleColor.Red;\n Console.WriteLine(\"Uygulama hata kurtarma kayd\u0131 yap\u0131lamad\u0131...\");\n Console.ResetColor();\n }\n\n while (!kullaniciBilgileriDogru) {\n Console.Write(\"L\u00fctfen kullan\u0131c\u0131 ad\u0131n\u0131 giriniz : \");\n kullaniciAdi = Console.ReadLine();\n\n Console.Write(\"L\u00fctfen \u015fifrenizi giriniz : \");\n sifre = Console.ReadLine();\n\n kullaniciBilgileriDogru = KullaniciBilgileriDogruMu(kullaniciAdi, sifre);\n }\n\n Console.WriteLine();\n Console.WriteLine(\"===============================\");\n Console.WriteLine(\"Uygulamaya ho\u015f geldin, \" + kullaniciAdi);\n\n Thread.Sleep(60000);\n\n throw new Exception(\"Hi\u00e7 beklenmedik bir hata\");\n}<\/pre>\n\n\n\nprivate static int HataVeriKurtarma(object parametre) {\n Console.ForegroundColor = ConsoleColor.Yellow;\n Console.WriteLine(\"Uygulama verileri kurtar\u0131lmak \u00fczere saklan\u0131yor ... \");\n Console.ResetColor();\n\n var timer = new Timer(CanliTut, null, 1000, 1000);\n\n \/\/Kritik veriler saklan\u0131yor\n using (var kurtarmaVeriDosyasi = File.CreateText(KURTARMA_VERI_DOSYASI_ADI)) {\n kurtarmaVeriDosyasi.WriteLine(kullaniciAdi);\n kurtarmaVeriDosyasi.WriteLine(sifre);\n }\n\n File.Encrypt(KURTARMA_VERI_DOSYASI_ADI);\n\n Thread.Sleep(20000);\n\n ApplicationRecoveryFinished(true);\n\n return 0;\n}<\/pre>\n\n\n\nprivate static void CanliTut(object parametre) {\n bool islemiIptalEt;\n ApplicationRecoveryInProgress(out islemiIptalEt);\n\n if (islemiIptalEt) {\n Console.ForegroundColor = ConsoleColor.Red;\n Console.WriteLine(\"Hata veri kurtarma i\u015flemi iptal edildi\");\n Console.ResetColor();\n\n Environment.FailFast(\"Hata veri kurtarma i\u015flemi iptal edildi\");\n }\n}<\/pre>\n\n\n\n<\/a><\/figure>\n\n\n\n<\/a><\/figure>\n\n\n\n