Hi\u00e7 \u00fczerinde \u00e7al\u0131\u015ft\u0131\u011f\u0131n\u0131z \u00f6nemli bir kod par\u00e7as\u0131n\u0131 kaydetmeyi unutup, bilgisayar\u0131n\u0131z\u0131 yeniden ba\u015flatt\u0131\u011f\u0131n\u0131zda derin bir pi\u015fmanl\u0131k ya\u015fad\u0131n\u0131z m\u0131? Ya da bir \u00f6zelli\u011fi geli\u015ftirirken, farkl\u0131 yakla\u015f\u0131mlar\u0131 denemek i\u00e7in ge\u00e7ici notlar veya kod taslaklar\u0131 tutma ihtiyac\u0131 hissettiniz mi? \u00c7o\u011fu geli\u015ftirici bu senaryolarla s\u0131k s\u0131k kar\u015f\u0131la\u015f\u0131r. \u0130\u015fte tam da bu noktada, bir VS Code uzant\u0131s\u0131 i\u00e7erisinde evrensel bir taslak sistemi in\u015fa etmek, geli\u015ftirme s\u00fcrecinizi \u00e7ok daha verimli ve g\u00fcvenli hale getirebilir. Bu makalede, b\u00f6yle bir sistemin temelini olu\u015fturan veri tiplerini nas\u0131l tan\u0131mlayaca\u011f\u0131m\u0131z\u0131 ve bu taslaklar\u0131 kal\u0131c\u0131 olarak nas\u0131l depolayaca\u011f\u0131m\u0131z\u0131 ad\u0131m ad\u0131m inceleyece\u011fiz. Bu ilk b\u00f6l\u00fcm, sistemin omurgas\u0131n\u0131 olu\u015fturarak, ileriki a\u015famalarda kullan\u0131c\u0131 aray\u00fcz\u00fc ve komut entegrasyonu i\u00e7in sa\u011flam bir zemin haz\u0131rlayacak.<\/p>\n
Modern yaz\u0131l\u0131m geli\u015ftirme s\u00fcre\u00e7leri, h\u0131z, esneklik ve s\u00fcrekli ba\u011flam (context) de\u011fi\u015ftirme yetene\u011fi gerektirir. Bir geli\u015ftirici olarak, ayn\u0131 anda birden fazla proje \u00fczerinde \u00e7al\u0131\u015fabilir, farkl\u0131 g\u00f6revler aras\u0131nda ge\u00e7i\u015f yapabilir veya yaln\u0131zca bir fikri h\u0131zl\u0131ca not almak isteyebilirsiniz. VS Code gibi g\u00fc\u00e7l\u00fc bir entegre geli\u015ftirme ortam\u0131 (IDE) bile, bu t\u00fcr ge\u00e7ici ihtiya\u00e7lar i\u00e7in her zaman en ideal \u00e7\u00f6z\u00fcm\u00fc sunmayabilir. Mevcut dosya kaydetme mekanizmalar\u0131, genellikle belirli bir projeye veya dosya yap\u0131s\u0131na ba\u011fl\u0131d\u0131r. Bu durum, h\u0131zl\u0131ca bir kod par\u00e7as\u0131n\u0131 denemek, bir API yan\u0131t\u0131n\u0131 depolamak veya bir algoritma tasla\u011f\u0131n\u0131 kaydetmek istedi\u011finizde gereksiz dosya kirlili\u011fine veya ba\u011flam kayb\u0131na yol a\u00e7abilir.<\/p>\n
Diyelim ki, bir e-ticaret platformunda hem sipari\u015f y\u00f6netimi mod\u00fcl\u00fc \u00fczerinde \u00e7al\u0131\u015f\u0131yorsunuz hem de arka planda m\u00fc\u015fteri geri bildirimlerini analiz eden bir mikroservis i\u00e7in yeni bir algoritma deniyorsunuz. Sipari\u015f y\u00f6netimi mod\u00fcl\u00fcnde kritik bir hata d\u00fczeltmesi yaparken, akl\u0131n\u0131za yeni algoritma i\u00e7in parlak bir fikir gelir. Bu fikri hemen denemeniz gerekebilir, ancak mevcut projenizin dosya yap\u0131s\u0131n\u0131 bozmak istemezsiniz. \u0130\u015fte bu noktada, evrensel bir taslak sistemi devreye girer. Bu sistem sayesinde, mevcut \u00e7al\u0131\u015fma ortam\u0131n\u0131zdan ayr\u0131lmadan, bu yeni fikri bir taslak olarak kaydedebilir, \u00fczerinde \u00e7al\u0131\u015fabilir ve i\u015finiz bittikten sonra kolayca silebilir veya kal\u0131c\u0131 hale getirebilirsiniz. Bu, sadece bir dosya kaydetmekten \u00e7ok daha fazlas\u0131d\u0131r; ba\u011flamdan ba\u011f\u0131ms\u0131z, h\u0131zl\u0131 eri\u015filebilir ve y\u00f6netilebilir bir bilgi deposu sunar.<\/p>\n
Evrensel bir taslak sistemi, geli\u015ftiricilere a\u015fa\u011f\u0131daki temel faydalar\u0131 sa\u011flar:<\/p>\n
* Verimlilik Art\u0131\u015f\u0131:<\/strong> H\u0131zl\u0131 not alma ve kod deneme imkan\u0131 sayesinde ba\u011flam de\u011fi\u015ftirme maliyetini d\u00fc\u015f\u00fcr\u00fcr. Geli\u015ftiriciler, fikirlerini kaybetme korkusu olmadan deney yapabilirler. \u00d6rne\u011fin, bir geli\u015ftirici ekibinin yeni bir \u00f6deme a\u011f ge\u00e7idi entegrasyonu \u00fczerinde \u00e7al\u0131\u015ft\u0131\u011f\u0131n\u0131 varsayal\u0131m. Ekip \u00fcyelerinden biri, farkl\u0131 senaryolar\u0131 test etmek i\u00e7in API istek ve yan\u0131t \u00f6rneklerini kaydetmek istiyor. Geleneksel y\u00f6ntemle bu verileri ayr\u0131 ayr\u0131 Evrensel bir taslak sisteminin temelini, taslaklar\u0131n ne t\u00fcr veriler i\u00e7erdi\u011fini ve bu verileri nas\u0131l yap\u0131land\u0131raca\u011f\u0131m\u0131z\u0131 belirleyen g\u00fc\u00e7l\u00fc bir tip tan\u0131m\u0131 olu\u015fturur. TypeScript (veya benzeri tip g\u00fcvenli bir dil), bu noktada bize b\u00fcy\u00fck avantajlar sa\u011flar. Her bir tasla\u011f\u0131n benzersiz bir \u015fekilde tan\u0131mlanabilmesi, i\u00e7eri\u011finin ne oldu\u011fu, ne zaman olu\u015fturuldu\u011fu ve hangi dilde yaz\u0131ld\u0131\u011f\u0131 gibi bilgileri bar\u0131nd\u0131rmas\u0131 \u00f6nemlidir. Bu bilgiler, taslaklar\u0131n daha sonra filtrelenmesi, aranmas\u0131 ve d\u00fczg\u00fcn bir \u015fekilde g\u00f6r\u00fcnt\u00fclenmesi i\u00e7in kritik \u00f6neme sahiptir.<\/p>\n Bir taslak i\u00e7in temel bir veri yap\u0131s\u0131 olu\u015ftururken, a\u015fa\u011f\u0131daki \u00f6zellikleri g\u00f6z \u00f6n\u00fcnde bulundurmal\u0131y\u0131z:<\/p>\n * Bu \u00f6zellikleri bir araya getirdi\u011fimizde, TypeScript’te a\u015fa\u011f\u0131daki gibi bir <\/code>\n<\/div>\n Bu Farkl\u0131 t\u00fcrdeki taslaklar\u0131 ele almak i\u00e7in bu aray\u00fcz\u00fc geni\u015fletebilir veya farkl\u0131 aray\u00fczler tan\u0131mlayabiliriz. \u00d6rne\u011fin, sadece kod par\u00e7ac\u0131klar\u0131 i\u00e7in \u00f6zel bir \u00d6rne\u011fin, bir geli\u015ftirici, farkl\u0131 veritaban\u0131 sorgular\u0131n\u0131 denemek i\u00e7in bir VS Code uzant\u0131lar\u0131 i\u00e7in veri depolama, uzant\u0131n\u0131n i\u015flevselli\u011finin temel bir par\u00e7as\u0131d\u0131r. Taslak sistemimiz i\u00e7in se\u00e7ti\u011fimiz depolama mekanizmas\u0131, taslaklar\u0131n kal\u0131c\u0131l\u0131\u011f\u0131n\u0131, eri\u015filebilirli\u011fini ve performans\u0131n\u0131 do\u011frudan etkileyecektir. VS Code uzant\u0131 geli\u015ftirme API'si, bize \u00e7e\u015fitli depolama se\u00e7enekleri sunar ve her birinin kendine g\u00f6re avantajlar\u0131 ve dezavantajlar\u0131 bulunur. Do\u011fru se\u00e7imi yapmak, uzant\u0131m\u0131z\u0131n \u00f6l\u00e7eklenebilirli\u011fi ve kullan\u0131c\u0131 deneyimi a\u00e7\u0131s\u0131ndan kritik \u00f6neme sahiptir.<\/p>\n VS Code uzant\u0131lar\u0131 i\u00e7in ba\u015fl\u0131ca depolama se\u00e7enekleri \u015funlard\u0131r:<\/p>\n 1. Evrensel bir taslak sistemi i\u00e7in, taslaklar\u0131n t\u00fcm VS Code pencereleri ve \u00e7al\u0131\u015fma alanlar\u0131 aras\u0131nda eri\u015filebilir olmas\u0131 gerekti\u011finden ### Dosya Sistemi Tabanl\u0131 Depolama Uygulamas\u0131<\/p>\n Taslaklar\u0131m\u0131z\u0131 bir JSON dosyas\u0131 i\u00e7inde depolamak, hem okunabilirlik hem de y\u00f6netilebilirlik a\u00e7\u0131s\u0131ndan pratik bir \u00e7\u00f6z\u00fcmd\u00fcr. T\u00fcm taslaklar\u0131 bir dizi olarak tutan tek bir JSON dosyas\u0131 ( \u00d6ncelikle, VS Code'un <\/code>\n<\/div>\n Yukar\u0131daki ### G\u00fcvenlik ve Performans Konular\u0131: Depolamada Dikkat Edilmesi Gerekenler<\/p>\n Depolama mekanizmas\u0131 se\u00e7imi ve uygulamas\u0131 s\u0131ras\u0131nda g\u00fcvenlik ve performans gibi kritik konular g\u00f6z ard\u0131 edilmemelidir. \u00d6zellikle bir uzant\u0131 geli\u015ftirdi\u011fimizde, kullan\u0131c\u0131 deneyimi ve veri b\u00fct\u00fcnl\u00fc\u011f\u00fc b\u00fcy\u00fck \u00f6nem ta\u015f\u0131r.<\/p>\n * Veri B\u00fct\u00fcnl\u00fc\u011f\u00fc ve Hata Y\u00f6netimi:<\/strong> Dosya sistemi operasyonlar\u0131 (okuma\/yazma) her zaman ba\u015far\u0131l\u0131 olmayabilir. Disk dolulu\u011fu, izin sorunlar\u0131 veya dosya bozulmalar\u0131 gibi durumlar meydana gelebilir. Bu nedenle, Bu konular\u0131 g\u00f6z \u00f6n\u00fcnde bulundurarak taslak sistemimizin depolama katman\u0131n\u0131 in\u015fa etmek, hem sa\u011flam hem de kullan\u0131c\u0131 dostu bir uzant\u0131 olu\u015fturmam\u0131z\u0131 sa\u011flayacakt\u0131r.<\/p>\n \u015eimdiye kadar, evrensel taslak sistemimiz i\u00e7in gerekli olan veri tiplerini tan\u0131mlad\u0131k ve bu taslaklar\u0131 kal\u0131c\u0131 olarak depolamak i\u00e7in bir mekanizma geli\u015ftirdik. Ancak bir sistemin ger\u00e7ek de\u011feri, geli\u015ftiricinin g\u00fcnl\u00fck i\u015f ak\u0131\u015f\u0131na ne kadar sorunsuz entegre oldu\u011fuyla \u00f6l\u00e7\u00fcl\u00fcr. Bir senaryo \u00fczerinden, bu sistemin nas\u0131l hayata ge\u00e7irilebilece\u011fini ve geli\u015ftirici verimlili\u011fini nas\u0131l art\u0131rabilece\u011fini inceleyelim.<\/p>\n Senaryo: Bir \u00d6n U\u00e7 Geli\u015ftiricinin Component Geli\u015ftirme S\u00fcreci<\/strong><\/p>\n Ay\u015fe, b\u00fcy\u00fck bir web uygulamas\u0131n\u0131n \u00f6n u\u00e7 geli\u015ftiricisidir. Yeni bir \"\u00fcr\u00fcn kart\u0131\" (product card) bile\u015feni \u00fczerinde \u00e7al\u0131\u015f\u0131yor. Bu bile\u015fenin farkl\u0131 varyantlar\u0131 (indirimli \u00fcr\u00fcn, stokta olmayan \u00fcr\u00fcn, favorilere eklenmi\u015f \u00fcr\u00fcn vb.) olmas\u0131 gerekiyor. Ayr\u0131ca, bile\u015fenin etkile\u015fimli \u00f6zelliklerini test etmek i\u00e7in ge\u00e7ici JavaScript kod par\u00e7ac\u0131klar\u0131 yazmas\u0131 ve tasar\u0131m ekibinden gelen geri bildirimleri not almas\u0131 gerekiyor.<\/p>\n Ay\u015fe'nin mevcut i\u015f ak\u0131\u015f\u0131nda kar\u015f\u0131la\u015ft\u0131\u011f\u0131 zorluklar:<\/p>\n 1. Ge\u00e7ici Kod Par\u00e7ac\u0131klar\u0131:<\/strong> Farkl\u0131 varyantlar i\u00e7in h\u0131zl\u0131ca denemeler yaparken, bu kodlar\u0131 mevcut dosyas\u0131na kaydetmek istemiyor \u00e7\u00fcnk\u00fc bunlar nihai kod de\u011fil ve sadece test ama\u00e7l\u0131. \u0130\u015fte evrensel taslak sistemimiz, Ay\u015fe'nin bu zorluklar\u0131n \u00fcstesinden gelmesine nas\u0131l yard\u0131mc\u0131 olabilir:<\/p>\n 1. \"Aktif Edit\u00f6r\u00fc Taslak Olarak Kaydet\" Komutu:<\/strong><\/p>\n Ay\u015fe, \u00fcr\u00fcn kart\u0131n\u0131n bir varyant\u0131 \u00fczerinde \u00e7al\u0131\u015f\u0131rken, mevcut kodunu bir taslak olarak kaydetmek ister. VS Code'da bir klavye k\u0131sayolu veya komut paleti arac\u0131l\u0131\u011f\u0131yla \"Aktif Edit<\/p>\n","protected":false},"excerpt":{"rendered":"VS Code Uzant\u0131s\u0131 ile Evrensel Taslak Sistemi: Tip ve Depolama Y\u00f6netimi Hi\u00e7 \u00fczerinde \u00e7al\u0131\u015ft\u0131\u011f\u0131n\u0131z \u00f6nemli bir kod par\u00e7as\u0131n\u0131 kaydetmeyi unutup, bilgisayar\u0131n\u0131z\u0131 yeniden ba\u015flatt\u0131\u011f\u0131n\u0131zda derin bir pi\u015fmanl\u0131k ya\u015fad\u0131n\u0131z m\u0131?","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"csco_page_header_type":"","csco_page_load_nextpost":"","csco_page_subscribe_form":"","csco_page_contact_form":"","footnotes":""},"categories":[1],"tags":[],"class_list":{"0":"post-41430","1":"post","2":"type-post","3":"status-publish","4":"format-standard","6":"category-genel","7":"cs-entry","8":"cs-video-wrap"},"yoast_head":"\n
\n* Veri Kayb\u0131n\u0131 \u00d6nleme:<\/strong> Otomatik kaydetme veya h\u0131zl\u0131 taslak olu\u015fturma \u00f6zellikleri sayesinde, beklenmedik sistem kapanmalar\u0131 veya uygulama \u00e7\u00f6kmeleri durumunda \u00f6nemli bilgilerin kaybolmas\u0131n\u0131 engeller.
\n* D\u00fczenli \u00c7al\u0131\u015fma Ortam\u0131:<\/strong> Ge\u00e7ici dosyalar\u0131n proje klas\u00f6rlerini kirletmesini engeller. Her taslak, merkezi bir sistemde d\u00fczenli bir \u015fekilde tutulur.
\n* Esneklik:<\/strong> Taslaklar, belirli bir projeye veya dosya t\u00fcr\u00fcne ba\u011fl\u0131 de\u011fildir. Markdown notlar\u0131ndan, JSON yap\u0131land\u0131rmalar\u0131na, hatta tam te\u015fekk\u00fcll\u00fc kod bloklar\u0131na kadar her t\u00fcrl\u00fc metin tabanl\u0131 i\u00e7eri\u011fi bar\u0131nd\u0131rabilir.
\n* \u00d6\u011frenme ve Deneme Alan\u0131:<\/strong> Yeni bir dil \u00f6zelli\u011fi, k\u00fct\u00fcphane veya API denerken h\u0131zl\u0131 bir kum havuzu g\u00f6revi g\u00f6r\u00fcr. \u00d6\u011frenme s\u00fcrecini h\u0131zland\u0131r\u0131r ve deneme yan\u0131lma y\u00f6ntemini te\u015fvik eder.<\/p>\n.txt<\/code> veya .json<\/code> dosyalar\u0131 olarak kaydetmek, projenin k\u00f6k dizinini gereksiz yere \u015fi\u015firebilir ve bu ge\u00e7ici dosyalar\u0131 daha sonra temizlemeyi zorla\u015ft\u0131rabilir. Evrensel taslak sistemi ile bu veriler, merkezi bir depoda, kolayca eri\u015filebilir ve y\u00f6netilebilir bir \u015fekilde tutulur. Bu, hem geli\u015ftiricinin i\u015f ak\u0131\u015f\u0131n\u0131 h\u0131zland\u0131r\u0131r hem de projenin temiz kalmas\u0131n\u0131 sa\u011flar. K\u0131sacas\u0131, bir evrensel taslak sistemi, geli\u015ftiricinin dijital not defteri, h\u0131zl\u0131 deneme tahtas\u0131 ve ge\u00e7ici bilgi deposu olarak g\u00f6rev yaparak, modern geli\u015ftirme ihtiya\u00e7lar\u0131na kritik bir yan\u0131t sunar.<\/p>\nTaslak Verilerini Nas\u0131l Tan\u0131mlamal\u0131y\u0131z: Tip Y\u00f6netimi (Types)?<\/h2>\n
id<\/code> (Benzersiz Kimlik):<\/strong> Her tasla\u011f\u0131n birbirinden ay\u0131rt edilmesini sa\u011flayan, evrensel olarak benzersiz bir tan\u0131mlay\u0131c\u0131 (UUID gibi). Bu, taslaklar\u0131 depolarken, g\u00fcncellerken veya silerken hedeflememizi kolayla\u015ft\u0131r\u0131r.
\n* content<\/code> (\u0130\u00e7erik):<\/strong> Tasla\u011f\u0131n as\u0131l metinsel i\u00e7eri\u011fi. Bu bir kod par\u00e7as\u0131, bir Markdown notu, bir JSON yap\u0131land\u0131rmas\u0131 veya herhangi bir d\u00fcz metin olabilir.
\n* timestamp<\/code> (Zaman Damgas\u0131):<\/strong> Tasla\u011f\u0131n ne zaman olu\u015fturuldu\u011funu veya en son ne zaman g\u00fcncellendi\u011fini g\u00f6steren bir zaman bilgisi. Bu, taslaklar\u0131 kronolojik s\u0131raya g\u00f6re s\u0131ralamak i\u00e7in faydal\u0131d\u0131r.
\n* languageId<\/code> (Dil Kimli\u011fi):<\/strong> VS Code’un tan\u0131d\u0131\u011f\u0131 bir dil tan\u0131mlay\u0131c\u0131s\u0131 (\u00f6rne\u011fin, “typescript”, “javascript”, “markdown”, “json”). Bu bilgi, taslak bir edit\u00f6rde a\u00e7\u0131ld\u0131\u011f\u0131nda do\u011fru s\u00f6zdizimi vurgulamas\u0131n\u0131 (syntax highlighting) ve dil \u00f6zelliklerini sa\u011flamak i\u00e7in kullan\u0131l\u0131r.
\n* name<\/code> (\u0130sim – \u0130ste\u011fe Ba\u011fl\u0131):<\/strong> Kullan\u0131c\u0131n\u0131n tasla\u011fa verdi\u011fi, daha anla\u015f\u0131l\u0131r bir isim. “API Yan\u0131t\u0131 \u00d6rne\u011fi”, “Hata D\u00fczeltme Tasla\u011f\u0131” gibi isimler, taslak listesinde gezinirken b\u00fcy\u00fck kolayl\u0131k sa\u011flar.
\n* origin<\/code> (Kaynak – \u0130ste\u011fe Ba\u011fl\u0131):<\/strong> Tasla\u011f\u0131n nereden geldi\u011fine dair ek bilgi. \u00d6rne\u011fin, bir dosya yolundan kopyaland\u0131ysa o dosyan\u0131n yolu, belirli bir projeye aitse projenin ad\u0131 gibi. Bu, taslaklar\u0131n ba\u011flam\u0131n\u0131 anlamaya yard\u0131mc\u0131 olur.<\/p>\nDraft<\/code> aray\u00fcz\u00fc (interface) tan\u0131mlayabiliriz:<\/p>\n\ninterface Draft {\n id: string; \/\/ Benzersiz taslak kimli\u011fi (UUID)\n name: string; \/\/ Kullan\u0131c\u0131n\u0131n verece\u011fi a\u00e7\u0131klay\u0131c\u0131 isim\n content: string; \/\/ Tasla\u011f\u0131n as\u0131l metinsel i\u00e7eri\u011fi\n languageId: string; \/\/ VS Code dil kimli\u011fi (\u00f6rn: 'typescript', 'markdown')\n createdAt: number; \/\/ Olu\u015fturulma zaman damgas\u0131 (Unix epoch)\n updatedAt: number; \/\/ Son g\u00fcncelleme zaman damgas\u0131 (Unix epoch)\n origin?: string; \/\/ Tasla\u011f\u0131n geldi\u011fi kaynak (iste\u011fe ba\u011fl\u0131)\n}\n <\/pre>\nDraft<\/code> aray\u00fcz\u00fc, sistemimizin temel veri modelini olu\u015fturur. createdAt<\/code> ve updatedAt<\/code> gibi zaman damgalar\u0131n\u0131 number<\/code> (say\u0131) olarak tutmak, kar\u015f\u0131la\u015ft\u0131rma ve s\u0131ralama i\u015flemlerini kolayla\u015ft\u0131r\u0131r. id<\/code> alan\u0131 i\u00e7in uuid<\/code> gibi bir k\u00fct\u00fcphane kullanarak benzersiz kimlikler \u00fcretebiliriz. name<\/code> alan\u0131, taslaklar\u0131n kullan\u0131c\u0131 taraf\u0131ndan kolayca tan\u0131nmas\u0131n\u0131 sa\u011flar; e\u011fer kullan\u0131c\u0131 bir isim vermezse, i\u00e7eri\u011fin ilk birka\u00e7 sat\u0131r\u0131 veya otomatik olu\u015fturulan bir isim kullan\u0131labilir.<\/p>\nCodeDraft<\/code> veya Markdown notlar\u0131 i\u00e7in MarkdownDraft<\/code> tan\u0131mlamak yerine, languageId<\/code> alan\u0131 sayesinde tek bir Draft<\/code> aray\u00fcz\u00fcyle evrenselli\u011fi koruyabiliriz. \u00c7\u00fcnk\u00fc temelde hepsi metin tabanl\u0131 i\u00e7eriktir ve ayr\u0131m, languageId<\/code> \u00fczerinden sa\u011flan\u0131r. Bu yakla\u015f\u0131m, kod taban\u0131n\u0131 daha sade tutar ve gelecekte yeni dil t\u00fcrleri eklendi\u011finde esneklik sunar.<\/p>\nSQL<\/code> tasla\u011f\u0131 olu\u015fturabilirken, ba\u015fka bir geli\u015ftirici bir JavaScript<\/code> fonksiyonunu test etmek i\u00e7in bir taslak kullanabilir. Her iki durumda da, Draft<\/code> aray\u00fcz\u00fc bu bilgileri tutmak i\u00e7in yeterlidir. languageId<\/code> de\u011feri, VS Code'un bu taslaklar\u0131 a\u00e7t\u0131\u011f\u0131nda do\u011fru renklendirme ve otomatik tamamlama \u00f6zelliklerini sunmas\u0131n\u0131 sa\u011flayacakt\u0131r. Bu tip y\u00f6netimi, taslak sistemimizin sadece verileri depolamakla kalmay\u0131p, ayn\u0131 zamanda onlar\u0131 ak\u0131ll\u0131ca anlamas\u0131n\u0131 ve sunmas\u0131n\u0131 sa\u011flar.<\/p>\nTaslaklar\u0131 Nerede ve Nas\u0131l Depolamal\u0131y\u0131z: Depolama Mekanizmalar\u0131 (Storage)?<\/h2>\n
vscode.ExtensionContext.globalState<\/code><\/strong>: Bu, uzant\u0131n\u0131z\u0131n t\u00fcm VS Code pencereleri ve \u00e7al\u0131\u015fma alanlar\u0131 aras\u0131nda kal\u0131c\u0131 veri depolamas\u0131na olanak tan\u0131yan bir anahtar-de\u011fer deposudur. Kullan\u0131c\u0131n\u0131n bilgisayar\u0131nda uzant\u0131ya \u00f6zel bir dizinde saklan\u0131r.
\n * Avantajlar\u0131:<\/strong> Kolay kullan\u0131m, basit anahtar-de\u011fer depolama, t\u00fcm \u00e7al\u0131\u015fma alanlar\u0131nda eri\u015filebilir. K\u00fc\u00e7\u00fck ve orta \u00f6l\u00e7ekli veri k\u00fcmeleri i\u00e7in idealdir.
\n * Dezavantajlar\u0131:<\/strong> B\u00fcy\u00fck veri bloklar\u0131n\u0131 depolamak i\u00e7in tasarlanmam\u0131\u015ft\u0131r (performans sorunlar\u0131 ya\u015fanabilir), do\u011frudan dosya sistemi eri\u015fimi sunmaz, karma\u015f\u0131k veri yap\u0131lar\u0131n\u0131 y\u00f6netmek i\u00e7in ek serile\u015ftirme (serialization) gerektirir.
\n2. vscode.ExtensionContext.workspaceState<\/code><\/strong>: Bu da bir anahtar-de\u011fer deposudur, ancak veriler yaln\u0131zca mevcut \u00e7al\u0131\u015fma alan\u0131na (workspace) \u00f6zeldir. Farkl\u0131 bir \u00e7al\u0131\u015fma alan\u0131 a\u00e7\u0131ld\u0131\u011f\u0131nda bu verilere eri\u015filemez.
\n * Avantajlar\u0131:<\/strong> \u00c7al\u0131\u015fma alan\u0131na \u00f6zg\u00fc veriler i\u00e7in ideal, kolay kullan\u0131m.
\n * Dezavantajlar\u0131:<\/strong> Taslak sistemimiz \"evrensel\" olmay\u0131 hedefledi\u011fi i\u00e7in, farkl\u0131 \u00e7al\u0131\u015fma alanlar\u0131 aras\u0131nda eri\u015filebilirlik sa\u011flamaz. Bu nedenle taslaklar i\u00e7in uygun de\u011fildir.
\n3. Dosya Sistemi (File System)<\/strong>: Uzant\u0131n\u0131n globalStorageUri<\/code> veya storageUri<\/code> gibi URI'lar arac\u0131l\u0131\u011f\u0131yla eri\u015febilece\u011fi, kullan\u0131c\u0131 bilgisayar\u0131ndaki dosya sistemi. Bu, daha karma\u015f\u0131k ve b\u00fcy\u00fck veri yap\u0131lar\u0131n\u0131 depolamak i\u00e7in esneklik sunar.
\n * Avantajlar\u0131:<\/strong> B\u00fcy\u00fck veri k\u00fcmelerini depolayabilir, karma\u015f\u0131k dosya yap\u0131lar\u0131 olu\u015fturabilir, performans a\u00e7\u0131s\u0131ndan daha esnek (\u00f6rne\u011fin, sadece gerekli k\u0131s\u0131mlar\u0131 y\u00fckleme), di\u011fer uygulamalarla potansiyel entegrasyon.
\n * Dezavantajlar\u0131:<\/strong> globalState<\/code>'e g\u00f6re daha fazla y\u00f6netim (dosya okuma\/yazma, hata y\u00f6netimi, serile\u015ftirme\/deserile\u015ftirme), senkronizasyon ve \u00e7ak\u0131\u015fma y\u00f6netimi gerektirebilir.<\/p>\nworkspaceState<\/code> uygun de\u011fildir. globalState<\/code> basit taslaklar i\u00e7in iyi bir ba\u015flang\u0131\u00e7 noktas\u0131 olabilirken, daha fazla taslak depoland\u0131\u011f\u0131nda veya taslaklar\u0131n i\u00e7eri\u011fi b\u00fcy\u00fcd\u00fc\u011f\u00fcnde performans sorunlar\u0131 ya\u015fayabilir. Bu nedenle, taslak sistemimizin \u00f6l\u00e7eklenebilirli\u011fini ve esnekli\u011fini sa\u011flamak i\u00e7in dosya sistemi tabanl\u0131 bir depolama yakla\u015f\u0131m\u0131<\/strong> en uygun se\u00e7enek gibi g\u00f6r\u00fcnmektedir. \u00d6zellikle extensionContext.globalStorageUri<\/code> alt\u0131nda bir dizin olu\u015fturarak, uzant\u0131m\u0131za \u00f6zel ve kal\u0131c\u0131 bir depolama alan\u0131 sa\u011flayabiliriz.<\/p>\ndrafts.json<\/code>) kullanabiliriz.<\/p>\nfs<\/code> (file system) mod\u00fcl\u00fcn\u00fc ve path<\/code> mod\u00fcl\u00fcn\u00fc kullanmam\u0131z gerekecek. vscode.Uri<\/code> nesnesi, dosya yollar\u0131n\u0131 y\u00f6netmek i\u00e7in kullan\u0131l\u0131r.<\/p>\n\nimport * as vscode from 'vscode';\nimport * as path from 'path';\nimport * as fs from 'fs'; \/\/ Node.js dosya sistemi mod\u00fcl\u00fc\n\n\/\/ Draft aray\u00fcz\u00fcm\u00fcz (\u00f6nceki b\u00f6l\u00fcmden)\ninterface Draft {\n id: string;\n name: string;\n content: string;\n languageId: string;\n createdAt: number;\n updatedAt: number;\n origin?: string;\n}\n\nexport class DraftStorage {\n private draftsFilePath: vscode.Uri;\n private drafts: Draft[] = [];\n\n constructor(context: vscode.ExtensionContext) {\n \/\/ Uzant\u0131n\u0131n global depolama dizini i\u00e7inde bir 'drafts.json' dosyas\u0131 olu\u015ftur\n this.draftsFilePath = vscode.Uri.joinPath(context.globalStorageUri, 'drafts.json');\n }\n\n \/\/ Taslaklar\u0131 dosyadan y\u00fckle\n async loadDrafts(): PromiseDraftStorage<\/code> s\u0131n\u0131f\u0131, taslaklar\u0131 y\u00f6netmek i\u00e7in temel CRUD (Create, Read, Update, Delete) operasyonlar\u0131n\u0131 sa\u011flar. Uzant\u0131 etkinle\u015ftirildi\u011finde (activate edildi\u011finde) bu s\u0131n\u0131f\u0131n bir \u00f6rne\u011fi olu\u015fturulur ve loadDrafts()<\/code> metodu \u00e7a\u011fr\u0131larak mevcut taslaklar belle\u011fe y\u00fcklenir. Her addDraft<\/code>, updateDraft<\/code> veya deleteDraft<\/code> i\u015fleminden sonra saveDrafts()<\/code> metodu \u00e7a\u011fr\u0131larak de\u011fi\u015fiklikler kal\u0131c\u0131 olarak dosyaya yaz\u0131l\u0131r. JSON.stringify(this.drafts, null, 2)<\/code> kullan\u0131m\u0131, JSON dosyas\u0131n\u0131 okunabilir (indentli) bir formatta kaydetmeyi sa\u011flar.<\/p>\ntry-catch<\/code> bloklar\u0131 kullanarak olas\u0131 hatalar\u0131 yakalamak ve kullan\u0131c\u0131ya anlaml\u0131 geri bildirimler sunmak elzemdir. DraftStorage<\/code> s\u0131n\u0131f\u0131m\u0131zda bu temel hata y\u00f6netimi prensipleri uygulanm\u0131\u015ft\u0131r. Ayr\u0131ca, taslak verilerinin y\u00fcklenememesi durumunda uzant\u0131n\u0131n \u00e7\u00f6kmesini engellemek i\u00e7in this.drafts = [];<\/code> gibi varsay\u0131lan de\u011fer atamalar\u0131 yapmak \u00f6nemlidir.
\n* Performans Optimizasyonu:<\/strong> Taslak say\u0131s\u0131 artt\u0131k\u00e7a veya taslak i\u00e7erikleri b\u00fcy\u00fcd\u00fck\u00e7e, her de\u011fi\u015fiklikte t\u00fcm taslaklar\u0131 dosyaya yazmak performans sorunlar\u0131na yol a\u00e7abilir. Bu durumu optimize etmek i\u00e7in:
\n * Debounce\/Throttle:<\/strong> S\u0131k yap\u0131lan kaydetme i\u015flemlerini belirli bir s\u00fcre geciktirerek veya birim zamanda belirli bir say\u0131da i\u015flemle s\u0131n\u0131rlayarak dosya yazma operasyonlar\u0131n\u0131n say\u0131s\u0131n\u0131 azaltabiliriz. \u00d6rne\u011fin, kullan\u0131c\u0131 bir tasla\u011f\u0131 yazarken her tu\u015f vuru\u015funda kaydetmek yerine, yazmay\u0131 b\u0131rakt\u0131ktan 1-2 saniye sonra kaydetme i\u015flemini tetikleyebiliriz.
\n * K\u0131smi Kaydetme:<\/strong> E\u011fer taslaklar ayr\u0131 ayr\u0131 dosyalar olarak depolan\u0131yorsa, yaln\u0131zca de\u011fi\u015fen tasla\u011f\u0131n dosyas\u0131n\u0131 g\u00fcncellemek t\u00fcm taslaklar\u0131 i\u00e7eren b\u00fcy\u00fck bir JSON dosyas\u0131n\u0131 yeniden yazmaktan daha verimli olabilir. Ancak bu, dosya y\u00f6netimi karma\u015f\u0131kl\u0131\u011f\u0131n\u0131 art\u0131r\u0131r. Mevcut drafts.json<\/code> yakla\u015f\u0131m\u0131nda, taslak say\u0131s\u0131 \u00e7ok fazla olmad\u0131\u011f\u0131 s\u00fcrece t\u00fcm diziyi kaydetmek daha basittir.
\n * Asenkron \u0130\u015flemler:<\/strong> Dosya okuma ve yazma i\u015flemleri do\u011fas\u0131 gere\u011fi yava\u015ft\u0131r. Bu i\u015flemleri async\/await<\/code> ile asenkron olarak y\u00fcr\u00fctmek, uzant\u0131n\u0131n ana i\u015f par\u00e7ac\u0131\u011f\u0131n\u0131 (main thread) bloke etmesini ve VS Code'un donmas\u0131n\u0131 engeller. \u00d6rnek kodda bu prensip uygulanm\u0131\u015ft\u0131r.
\n* Veri G\u00fcvenli\u011fi ve Gizlili\u011fi:<\/strong> Taslaklar\u0131n hassas bilgiler (API anahtarlar\u0131, parolalar vb.) i\u00e7erme potansiyeli varsa, bu verilerin \u015fifrelenerek saklanmas\u0131 gerekebilir. VS Code API'si do\u011frudan bir \u015fifreleme mekanizmas\u0131 sunmasa da, Node.js'in crypto<\/code> mod\u00fcl\u00fc kullan\u0131larak manuel \u015fifreleme ve \u015fifre \u00e7\u00f6zme i\u015flemleri uygulanabilir. Ancak bu, uzant\u0131n\u0131n karma\u015f\u0131kl\u0131\u011f\u0131n\u0131 art\u0131r\u0131r ve \u015fifreleme anahtar\u0131n\u0131n g\u00fcvenli bir \u015fekilde y\u00f6netilmesi gibi yeni zorluklar ortaya \u00e7\u0131kar\u0131r. \u00c7o\u011fu taslak sistemi i\u00e7in d\u00fcz metin depolama yeterli olsa da, hassas veriler s\u00f6z konusu oldu\u011funda bu konu ciddi \u015fekilde ele al\u0131nmal\u0131d\u0131r.
\n* \u00c7ak\u0131\u015fma Y\u00f6netimi:<\/strong> E\u011fer birden fazla s\u00fcre\u00e7 veya uzant\u0131 ayn\u0131 drafts.json<\/code> dosyas\u0131na ayn\u0131 anda yazmaya \u00e7al\u0131\u015f\u0131rsa veri bozulmas\u0131 ya\u015fanabilir. VS Code uzant\u0131lar\u0131 genellikle tek bir ana i\u015f par\u00e7ac\u0131\u011f\u0131nda \u00e7al\u0131\u015ft\u0131\u011f\u0131 i\u00e7in bu durum pek olas\u0131 de\u011fildir. Ancak, e\u011fer farkl\u0131 bir mekanizma (\u00f6rne\u011fin, arka plan s\u00fcre\u00e7leri) kullan\u0131l\u0131yorsa, kilit mekanizmalar\u0131 (file locking) veya s\u00fcr\u00fcm kontrol\u00fc gibi stratejiler d\u00fc\u015f\u00fcn\u00fclmelidir. Mevcut vscode.workspace.fs<\/code> API'si, atomik yazma i\u015flemleri sa\u011flamaya yard\u0131mc\u0131 olur, bu da veri b\u00fct\u00fcnl\u00fc\u011f\u00fcn\u00fc art\u0131r\u0131r.<\/p>\nGer\u00e7ek D\u00fcnya Senaryosu: Geli\u015ftirici \u0130\u015f Ak\u0131\u015f\u0131na Entegrasyon<\/h2>\n
\n2. Notlar ve Geri Bildirimler:<\/strong> Tasar\u0131m ekibinden gelen \"ba\u015fl\u0131k fontu biraz daha b\u00fcy\u00fck olmal\u0131\" veya \"fiyat etiketi k\u0131rm\u0131z\u0131 olmal\u0131\" gibi geri bildirimleri, projenin README.md<\/code>'sine eklemek istemiyor \u00e7\u00fcnk\u00fc bunlar ge\u00e7ici.
\n3. H\u0131zl\u0131 Ba\u011flam De\u011fi\u015fimi:<\/strong> Bir yandan \u00fcr\u00fcn kart\u0131 \u00fczerinde \u00e7al\u0131\u015f\u0131rken, di\u011fer yandan acil bir hata d\u00fczeltmesi i\u00e7in ba\u015fka bir dosyaya ge\u00e7mesi gerekebilir. Mevcut i\u015fini kaybetmeden h\u0131zl\u0131ca ge\u00e7i\u015f yapabilmeli.<\/p>\n