<?xml version="1.0" encoding="UTF-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0" xmlns:cc="http://cyber.law.harvard.edu/rss/creativeCommonsRssModule.html">
    <channel>
        <title><![CDATA[Stories by Adem Olguner on Medium]]></title>
        <description><![CDATA[Stories by Adem Olguner on Medium]]></description>
        <link>https://medium.com/@ademolguner?source=rss-a068d8b0ac3------2</link>
        <image>
            <url>https://cdn-images-1.medium.com/fit/c/150/150/1*D3Z0GonPmCv_wHjMQ5nI7A.jpeg</url>
            <title>Stories by Adem Olguner on Medium</title>
            <link>https://medium.com/@ademolguner?source=rss-a068d8b0ac3------2</link>
        </image>
        <generator>Medium</generator>
        <lastBuildDate>Wed, 18 Nov 2026 16:33:12 GMT</lastBuildDate>
        <atom:link href="https://medium.com/@ademolguner/feed" rel="self" type="application/rss+xml"/>
        <webMaster><![CDATA[yourfriends@medium.com]]></webMaster>
        <atom:link href="http://medium.superfeedr.com/" rel="hub"/>
        <item>
            <title><![CDATA[Yazılım dünyasında “Design Pattern” (Tasarım Kalıpları) bilmek, çoğu zaman bir prestij göstergesi…]]></title>
            <link>https://medium.com/devopsturkiye/yaz%C4%B1l%C4%B1m-d%C3%BCnyas%C4%B1nda-design-pattern-tasar%C4%B1m-kal%C4%B1plar%C4%B1-bilmek-%C3%A7o%C4%9Fu-zaman-bir-prestij-g%C3%B6stergesi-4c2a24efdaaf?source=rss-a068d8b0ac3------2</link>
            <guid isPermaLink="false">https://medium.com/p/4c2a24efdaaf</guid>
            <category><![CDATA[design-patterns]]></category>
            <category><![CDATA[clean-code]]></category>
            <category><![CDATA[clean-architecture]]></category>
            <category><![CDATA[design-decision]]></category>
            <category><![CDATA[software-architecture]]></category>
            <dc:creator><![CDATA[Adem Olguner]]></dc:creator>
            <pubDate>Fri, 27 Feb 2026 06:46:51 GMT</pubDate>
            <atom:updated>2026-02-27T06:46:51.039Z</atom:updated>
            <content:encoded><![CDATA[<blockquote>Design Pattern Seçilmez, Hak Edilir: Doğru Sorularla Mimariyi Keşfetmek</blockquote><figure><img alt="" src="https://cdn-images-1.medium.com/max/1016/0*kse0ldCScrWhZpb6" /></figure><p>Yazılım dünyasında “Design Pattern” (Tasarım Kalıpları) bilmek, çoğu zaman bir prestij göstergesi gibi taşınır. Yeni öğrenilen bir pattern, geliştiricinin elinde bir çekiç gibidir; artık gördüğü her problem ona çakılması gereken bir çivi gibi görünmeye başlar. Ancak bu yaklaşım bizi, gereksiz karmaşıklığa (<em>over-engineering</em>) götüren en kısa yoldur.</p><p>Bir “legacy” (miras) projeyi devraldığımızda, bazen kendimizi bir arkeolog gibi hissederiz, bazen de bir olay yeri inceleme uzmanı gibi.</p><p>Kodu açarsınız ve karşınızda bir “Interface Mezarlığı” bulursunuz. Her şeyin bir arayüzü vardır: IStringYazdirici, IBooleanCevirici, ISadeceIkiSayiyiToplayanHesaplayici…</p><p>Birisi zamanında “bağımlılıkları soyutlamak” istemiş ama işin dozunu kaçırıp, N katmanlı bir mimari kurmuştur. O an yazılımcının ne kadar zeki olduğunu değil, ne kadar acı çektiğini düşünürüz.</p><p>Bir önceki yazımızda, <a href="https://medium.com/devopsturkiye/yanl%C4%B1%C5%9F-kararla-yaz%C4%B1lan-clean-code-sadece-daha-temiz-bir-problemdir-e619b571b834"><strong>“Yanlış Kararla Yazılan Clean Code, Sadece Daha Temiz Bir Problemdir”</strong></a> başlığıyla, kodun <em>nasıl</em> yazıldığına (Clean Code) odaklanıp, <em>ne</em> ve <em>neden</em> yazıldığına (Mimari Kararlar) dikkat etmemenin tehlikelerini konuşmuştuk.</p><p>Peki o “<strong>doğru kararı</strong>” nasıl vereceğiz?</p><p>Çoğu geliştirici, Design Pattern’lara bir ürün kataloğu gibi yaklaşır:</p><p>“Bu problem için hangi pattern var?”</p><p>Oysa Design Pattern bir seçim değil; doğru sorular sorulduğunda, problemin doğasından ortaya çıkan bir sonuçtur.</p><p>Bu makalede kendimize bir harita çıkaracağız. Bu harita ile önce hangi kıtada (Kategori) olduğunuzu bulacak, sonra hangi ülkede (Pattern) yaşamanız gerektiğine karar vereceğiz.</p><h3>Bölüm 1: Kategorilerin Anlam Dünyası (Kodun Neresi Ağrıyor?)</h3><p>Design Pattern’lara girmeden önce, sorunun kaynağını doğru teşhis etmeliyiz. Tıpta nasıl “Başın mı ağrıyor, miden mi?” ayrımı varsa, yazılımda da bu ayrımı Creational, Structural ve Behavioral kategorileri yapar.</p><p>Peki, hangi kategoride olduğumuzu nasıl anlayacağız? İşte kodumuzun bize verdiği sinyaller:</p><h3>1. Creational (Yaratımsal) — “Hazırlık Çilesi”</h3><p>Kodun asıl işi yapan kısmına (Business Logic) bir türlü geçemiyoruz, sürekli nesneleri <em>hazırlamakla</em> uğraştığımızda!</p><p><strong>Hissedilen Acı</strong></p><blockquote><em>“Bir Sipariş nesnesi oluşturacağım ama önce Müşteri’yi bul, sonra Adres’i ayarla, sonra Ayarları yükle… Sadece nesneyi ayağa kaldırmak için 20 satır kod yazıyorum. Bu hazırlık kodunu her yerde kopyala–yapıştır yapmaktan yoruldum.”</em></blockquote><p><strong>Teşhis</strong> : Nesnenin doğumunda. Nesneyi oluşturmak, onu kullanmaktan daha zor hale gelmiş.</p><p><strong>Odak</strong> : Nesne Yaratımı (Object Creation)</p><h3>2. Structural (Yapısal) — “Uyumsuz Parçalar”</h3><p>Elimizdeki malzemeler kaliteli ama birbirine uymuyor. Ya da bir yapıyı bozmadan üzerine kat çıkmak istiyoruz ama temel izin vermiyor.</p><p><strong>Hissedilen Acı</strong></p><blockquote><em>“Harika bir Banka Modülü var ama sistemime uymuyor. Koduna dokunamam (kütüphane/legacy). Ya da bir sınıfa yeni özellik eklemek istiyorum ama inheritance her şeyi bozuyor.”</em></blockquote><p><strong>Teşhis</strong> : Sorun parçaların montajında. Yapı çok katı (rigid), esnemiyor.</p><p><strong>Odak</strong> : Sınıf ve Nesne Kompozisyonu (Composition)</p><h3>3. Behavioral (Davranışsal) — “Trafik Sıkışıklığı”</h3><p>Herkes işini yapıyor ama ortada kaos var. Kimin kime emir verdiği, işin sırası karışmış.</p><p><strong>Hissedilen Acı</strong></p><blockquote><em>“Sipariş onaylanınca fatura kesilsin, stok düşsün, mail atılsın… Ama Fatura sınıfı Mail’i çağırıyor, Mail gidip Stok’u çağırıyor. Birini değiştirsem hepsi patlıyor.”</em></blockquote><p><strong>Teşhis</strong> : Sorun nesnelerin iletişiminde.</p><p><strong>Odak</strong> : Nesneler Arası İletişim (Communication)</p><h3>Özet: Kök Soruyu Sor</h3><p>Karar anında kendinize şu soruyu sorun:</p><ul><li>“Bu nesneyi nasıl oluşturacağım?” → Creational</li><li>“Bu parçaları nasıl bağlayacağım?” → Structural</li><li>“Bu işi kim, hangi sırayla yapacak?” → Behavioral</li></ul><blockquote><em>Pattern’ı değil, ağrıyı teşhis edelim.</em></blockquote><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*5xCojTQrJsj79y9P" /></figure><h3>Pattern ≠ Principle ≠ Architecture</h3><p>Burada kısa ama önemli bir mola verelim.</p><ul><li>SOLID → <em>Neden</em> böyle yapmalıyız?</li><li>Architecture → <em>Sistemin büyük resmi</em></li><li>Design Pattern → Prensiplerin kod üzerindeki somutlaşmış hali</li></ul><p>Örneğin:</p><ul><li>Strategy → Open/Closed</li><li>Observer → Loose Coupling</li><li>Decorator → Composition over Inheritance</li></ul><p>Bazen doğru bir prensip kararı, pattern’a hiç ihtiyaç bırakmaz. Pattern, prensipler yetmediğinde devreye giren ağır silahtır.</p><h3>Bölüm 2: Tetikleyici Sorular</h3><p>Kategoriyi hissettik. Peki hangi Pattern? Daha iyi hayal edebilmek ve akılda kalıcılığı sağlamak için gerçek bir E-Ticaret projesinin kaosuna girelim :)</p><p>İşte benzer işi yapıyormuş gibi görünen ama ince farklarla ayrılan o kritik yol ayrımları:</p><p>Design Pattern seçmeye pattern listesinden değil, hissedilen problemden başlanır.</p><p>Şimdi sahaya iniyoruz.</p><p>Aynı e-ticaret projesinde, farklı günlerde karşılaşılan problemler üzerinden:</p><ul><li><em>“Ben şu an hangi kategorideyim?”</em></li><li><em>“Bu acı bana ne söylüyor?”</em></li></ul><p>sorularını birlikte cevaplayacağız.</p><h3>2.1 Structural Pattern’lar</h3><p>Structural problemler genelde şu cümleyle başlar:</p><blockquote><em>“Elimde çalışan bir şey var ama sisteme entegre edemiyorum.”</em></blockquote><p>Bu problemler; Algoritma problemi değildir, Davranış problemi değildir, Yapı ve bağlantı problemidir.</p><h3>2.1.1. Adapter Pattern</h3><p>Uyumsuz Parçaları Konuşturmak</p><p>Sahne: Yeni sipariş sisteminiz modern JSON — REST- Clean interface’ler var, ama banka POS servisi bize XML-SOAP-10 yıllık legacy kod ile dönüş sağlıyor!</p><p>Yaşadığımız gerçek acı</p><blockquote><em>“Banka servisi XML dönüyor ama benim tüm sistemim JSON bekliyor. Her yerde XML parse mi edeceğim? Sipariş kodum banka kodu mu bilmek zorunda?”</em></blockquote><p>Yanlış refleks: XML parse işlemini her çağrıda yapmak. OrderService içine banka detaylarını gömmek.</p><p>Teşhis</p><blockquote><em>Sorun hesaplama değil, sorun arayüz uyumsuzluğu.“Ben bu sistemi değiştirmiyorum,sistemi </em>ona uyduruyorum<em>.”</em></blockquote><h3>2.1.2. Decorator Pattern</h3><p>Ürün fiyatı hesaplanıyor</p><p>Ürün fiyatı, KDV,Kargo,Hediye paketi. Başlangıçta her şey basit.</p><p>toplam = fiyat + kdv + kargo</p><p>Bir ay sonra: Kampanya eklendi,VIP ücreti geldi,Özel paketleme geldi</p><p>Kod: Sürekli değişiyor,Her değişiklik başka bir yeri bozuyor.</p><p>Hissedilen acı</p><blockquote><em>“Sınıfa yeni özellik eklemek istiyorum ama her seferinde eski kodu bozuyorum.”</em></blockquote><p>Teşhis</p><blockquote><em>Sorun matematik değil, Sorun genişleyemeyen yapı</em></blockquote><p>Zihinsel not</p><blockquote><em>“Inheritance değil, katman katman sarmalama.”</em></blockquote><h3>2.1.3. Proxy Pattern</h3><p>“Şimdi Yükleme, Gerekince Yükle”</p><p>Sahne</p><p>Ürün listeleme sayfasında: 50 ürün, Her ürünün 4 MB’lık görseli var</p><p>Sayfa: Geç açılıyor, Kullanıcı scroll etmeden bile tüm resimler yükleniyor</p><p>Hissedilen acı</p><blockquote><em>“Kullanıcı bu resmi görmeden neden indiriyoruz?”</em></blockquote><p>Teşhis :</p><blockquote><em>Sorun UI değil, Sorun gereksiz erken yükleme</em></blockquote><p>Zihinsel not</p><blockquote><em>“Gerçek nesne pahalıysa, araya vekil koy.”</em></blockquote><h3>2.1.4. Facade Pattern</h3><p>“Bu Karmaşıklığı Bana Yansıtma”</p><p>Sahne</p><p>Sipariş verildiğinde: Ödeme alınacak, Stok düşecek, Kargo kaydı açılacak, Mail gönderilecek</p><p>Frontend geliştiricisi soruyor:</p><blockquote><em>“Ben bunların hepsini tek tek mi çağıracağım?”</em></blockquote><p>Hissedilen acı</p><blockquote><em>Alt sistemler karmaşık, Kullanıcı bu karmaşıklığı bilmemeli</em></blockquote><p>Zihinsel not</p><blockquote><em>“Karmaşıklık içeride kalsın, dışarıya sade bir kapı ver.”</em></blockquote><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*snyWwNhQsXUr1bFm" /></figure><h3>2.2 Behavioral Pattern’lar</h3><p>“Kod Çalışıyor Ama Kim Ne Yapıyor Belli Değil”</p><p>Behavioral problemler genelde şuradan anlaşılır:</p><blockquote><em>“Bir şeyi değiştirdim, alakasız bir yer bozuldu.”</em></blockquote><p>Bu, davranışların ve iletişimin iç içe geçtiğinin sinyalidir.</p><h3>2.2.1. Strategy Pattern</h3><p>Mantık Labirentinden Çıkış</p><p>Sahne: Kargo Hesaplama</p><p>Başlangıç: Sabit kargo ücreti, kargo = 50 TL</p><p>Sonra: Ağırlığa göre, Desiye göre, Anlaşmalı kargo,Ücretsiz kargo kampanyası</p><p>3 ay sonra: If bloğu 200 satır, Her yeni kural ana sınıfı değiştiriyor, Testler sürekli kırılıyor…</p><p>Artık sorulması gereken gerçek soru</p><blockquote><em>“Bu hesaplama, kullanıcının seçimine göre sipariş anında farklı şekillerde mi çalışıyor? Ve bu kurallar zamanla artacak mı?”</em></blockquote><p>Cevap EVET ise Strategy Pattern</p><p>Zihinsel not</p><blockquote><em>“If-else uzuyorsa, davranış ayrılmak istiyordur.”</em></blockquote><h3>2.2.2. Observer Pattern</h3><p>“Bunu Ben mi Yapmalıyım, Yoksa Sadece Haber mi Vermeliyim?”</p><p>Sahne: Sipariş tamamlandı ve ardından Mail gönder, SMS gönder, Stok düş,Log yaz…</p><p>Hatalı Refleks:</p><p>OrderService de: MailService, SmsService, StockService ile kodu devam ettirmek. Bu durum risklidir. Bir servis çöker → sipariş süreci çöker.</p><p>Hissedilen acı</p><blockquote><em>“OrderService her şeyi biliyor. Çok fazla sorumluluğu var.”</em></blockquote><p>Teşhis</p><blockquote><em>Sipariş servisi iş yapmamalı,Sadece haber vermeli</em></blockquote><p>Zihinsel not</p><blockquote><em>“Ben bağırırım, dinlemek isteyen dinler.”</em></blockquote><h3>2.2.3. Mediator Pattern</h3><p>“Herkes Herkesle Konuşmasın”</p><p>Checkout ekranı:</p><ul><li>Ülke seç → Şehirler değişiyor</li><li>Şehir seç → Kargo firmaları değişiyor</li><li>Kargo seç → Toplam tutar değişiyor</li></ul><p>Her input diğerini tanıyor.</p><p>Sonuç: Zincirleme bug’lar, Değişiklik yapmak korkutucu</p><p>Teşhis : Nesneler arası doğrudan iletişim fazla</p><p>Zihinsel not</p><blockquote><em>“Herkes yöneticisine konuşsun.”</em></blockquote><h3>2.2.4. Chain of Responsibility</h3><p>“Bu Kontrolü Kim Yapacak?”</p><p>Sahne : Kullanıcı kupon girdi:</p><ul><li>Tarihi geçerli mi?</li><li>Minimum tutar sağlandı mı?</li><li>Kategori uygun mu?</li></ul><p>Tek metot, İç içe if’ler …</p><p>Teşhis</p><blockquote><em>Sorumluluklar ayrılabilir, Sıra önemli</em></blockquote><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*aJFBxdFz5l92tnL1" /></figure><h3>2.3 Creational Pattern’lar</h3><p>“Bu Nesneyi Ayağa Kaldırmak Asıl Dert”</p><p>Creational problemler genelde şöyle hissedilir:</p><blockquote><em>“Asıl işe geçene kadar çok fazla hazırlık yapıyorum.”</em></blockquote><h3>2.3.1. Builder Pattern</h3><p>Okunabilirlik Krizi</p><p>Sahne</p><p>Order constructor: Order(user, address, billing, products, coupon, giftNote, …)</p><p>Hissedilen Acı</p><blockquote><em>“Bu parametrelerin sırası neydi?”</em></blockquote><p>Zihinsel not</p><blockquote><em>“Nesne oluşturmak da okunabilir olmalı.”</em></blockquote><h3>2.3.2. Factory Method</h3><p>“Hangisini Üreteceğimi Ben Bilmeyeyim”</p><p>Sahne</p><p>Bildirim gönderilecek: SMS, Email, Push</p><p>Seçim: Kullanıcı tercihine bağlı</p><p>Teşhis</p><blockquote><em>Business logic, concrete class bilmemeli</em></blockquote><h3>2.3.3. Singleton Pattern</h3><p>Kontrollü Ama Tehlikeli</p><p>Sahne</p><p>Uygulama genelinde: Vergi oranları, Feature flag’ler, Konfigürasyon</p><p>Refleks</p><blockquote><em>“Static yapalım.”</em></blockquote><p>Uyarı</p><blockquote><em>Singleton = kontrollü global state Yanlış kullanılırsa test edilemez yapı üretir.</em></blockquote><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*Epi1r0yn1ASCEG8a" /></figure><h3>Bölüm 3: Karar Anları ve “Pattern Kullanmama” Sanatı</h3><p>Her sorunun cevabı bir Design Pattern değildir. Bazen en iyi mimari karar, hiçbir pattern kullanmamaktır.</p><h3>Vaka Analizi -1 : Kaostan Düzene</h3><p>Teori bitti, laboratuvara girelim. Aşağıdaki “Spaghetti Code” örneği, gerçek hayatta sıkça karşılaştığımız bir durumdur.</p><h3>Hasta Kod (Before)</h3><p>Bu kod çalışır mı? Evet. Ama sağlıklı mı? Hayır. Open/Closed prensibi ihlal edilmiş ve sıkı bağımlılıklar (tight coupling) var.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*t873KFQRQYI8BvFr" /></figure><p>Hasta Kod :)</p><h3>Tedavi Süreci (Refactoring) — Bu Kod Artık Neden “Dayanılmaz”?</h3><p>Bu noktada artık gelecek tahmini yapmaya gerek yok. Kodu okurken kendimize şu soruları soruyoruz artık.</p><h3>Mevcut acılar:</h3><ul><li>HepsiJet kargo kuralını değiştirince HepsiXL bozuluyor</li><li>HepsiPay tarafında yapılan bir fix → kapıda ödeme testini kırıyor</li><li>Analytics ekibi yeni event istiyor → PlaceOrder’a giriyorsun1 method = 6 farklı sorumluluk</li><li>Soru: Ödeme yöntemi sürekli değişiyor mu? Evet. -&gt; <em>Reçete: Strategy Pattern</em></li><li><em>Soru: </em>Kargo yöntemi sürekli değişiyor mu? Evet. -&gt; <em>Reçete: Strategy Pattern</em></li><li>Soru: Sipariş bitince kimin ne yapacağına OrderService mi karar vermeli, yoksa sadece haber mi vermeli? Sadece haber vermeli. -&gt; <em>Reçete: Observer Pattern</em></li></ul><p>İç sesimiz artık net:</p><blockquote><em>“Buraya dokunmaya korkuyorum.”</em></blockquote><p>İşte bu, pattern zamanının geldiği an.</p><h3>Teşhis: Artık Ne Oldu?</h3><p>Bu kod:</p><ul><li>“ileride büyüyebilir” değil</li><li>defalarca değişmiş</li><li>defalarca bug üretmiş</li><li>tek bir davranışı değiştirmek tüm akışı etkiliyor</li></ul><blockquote><em>Sorun if-else değil. Sorun, birden fazla değişken davranışın kilitlenmiş olması.</em></blockquote><p>Refactor Sonrası İyileşen Kod :)</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/961/0*kNkrq9zOhI9uuZkX" /></figure><p>Ne Kazandık?</p><ul><li>Okunabilirlik: Metot sadeleşti, ana iş akışı netleşti.</li><li>Gelişime Açıklık: Yeni bir ödeme yöntemi (örn: Bitcoin) eklendiğinde OrderService sınıfına dokunmayız. Sadece BitcoinStrategy sınıfı yazarız.</li><li>Bağımsızlık: SMS servisi çalışmazsa veya değişirse, sipariş akışı bozulmaz.</li></ul><h3>Vaka Analizi -2 : Ürün Listeleme &amp; Kampanya Motoru Kaosu</h3><h3>Senaryo: “Ürün Listeleme Sayfası”</h3><p>Bir kategori sayfasını düşün:</p><ul><li>Filtreler: Marka, fiyat, satıcı, kargo tipi</li><li>Kampanyalar: Sepete özel, kullanıcıya özel, kategoriye özel</li><li>Sıralama: En çok satan, önerilen, fiyat</li><li>Performans kritik (sayfa &lt; 300 ms)</li></ul><p>Ve bu iş… tek bir servisle çözülmeye çalıştığımızı düşünelim. Şimdiye kadar kod burada yazılmış ama artık bir sadelik ihtiyacı hissediyoruz. Yeni bir ister geldiğinde var olan kodu okumak, test etmek ve bozulmayacağını garanti etmek zorlaştı !!!!</p><p>Hasta kod :</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/838/0*aGdtZzIh6VmBHmnm" /></figure><h3>Kodun Gerçek Hayat Acıları</h3><p>Bu artık “ileride büyür” değil, şu an yanıyor.</p><h3>Yaşananlar:</h3><ul><li>Kampanya ekibi cuma indirimi değiştirdi → tüm listeleme bozuldu</li><li>Filtre eklemek için aynı method’a giriliyor</li><li>DTO alanı değişti → her şey etkileniyor</li><li>Test yazmak neredeyse imkânsız</li></ul><p>iç sesimiz:</p><blockquote><em>“Ben filtre ekleyecektim, fiyat niye değişti?”</em></blockquote><h3>Teşhis — Doğru Sorular</h3><p>Soru 1 : “Bu sınıf kaç farklı işi yapıyor?”</p><p>Cevap : (Veri çekme, Filtreleme, Kampanya uygulama, Sıralama, Mapping)</p><p>Soru 2 : “Bu karmaşıklığı kullanan herkes bilmek zorunda mı?”</p><p>Cevap: Hayır ise (Facade Pattern zamanı)</p><p>Soru 3 : “Kampanya kuralları birbirine zincir gibi mi ekleniyor?”</p><p>Cevap: Bir kampanya geçmezse diğeri denenecek. ( Chain of Responsibility )</p><p>Soru 4 : “Ürün DTO’ya dönüşüm her yerde aynı mı?”</p><p>Cevap: Builder Pattern</p><h3>Ne Kullanmadık? (Bilinçli)</h3><ul><li>Strategy → Davranış değişimi yok, süreç parçalama var</li><li>Observer → Event yok, senkron listeleme</li><li>Singleton → Global state riski</li><li>Factory → Şu an nesne seçimi yok</li></ul><p>Bu da over-engineering’den kaçınmanın canlı örneği</p><blockquote><em>Pattern kullanmadığımız yerler, kullandığımız yerler kadar değerlidir.</em></blockquote><p>Bu vaka şunu öğretiyor:</p><ul><li>Her problem Strategy değildir</li><li>Her event Observer değildir</li><li>Ama her karmaşa bir soruya cevap ister</li></ul><h3>Sonuç</h3><p>Design Pattern bilmek, kalıpları ezberlemek değil; hangi acının hangi ilacı gerektirdiğini bilmektir. Kod yazarken durun ve kendinize sorun:</p><ol><li>Hangi kategorideyim? (Yaratılış, Yapı, İletişim?)</li><li>Beni hangi soru tetikliyor? (Sarmalama mı, Haberleşme mi, Algoritma seçimi mi?)</li></ol><p>Doğru soruyu sorduğunuzda, Design Pattern bir seçenek olmaktan çıkar, kodun kaçınılmaz bir parçası haline gelir.</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=4c2a24efdaaf" width="1" height="1" alt=""><hr><p><a href="https://medium.com/devopsturkiye/yaz%C4%B1l%C4%B1m-d%C3%BCnyas%C4%B1nda-design-pattern-tasar%C4%B1m-kal%C4%B1plar%C4%B1-bilmek-%C3%A7o%C4%9Fu-zaman-bir-prestij-g%C3%B6stergesi-4c2a24efdaaf">Yazılım dünyasında “Design Pattern” (Tasarım Kalıpları) bilmek, çoğu zaman bir prestij göstergesi…</a> was originally published in <a href="https://medium.com/devopsturkiye">Devops &amp; AI Türkiye☁️ 🐧 🐳 ☸️</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Yanlış Kararla Yazılan Clean Code, Sadece Daha Temiz Bir Problemdir]]></title>
            <description><![CDATA[<div class="medium-feed-item"><p class="medium-feed-image"><a href="https://medium.com/devopsturkiye/yanl%C4%B1%C5%9F-kararla-yaz%C4%B1lan-clean-code-sadece-daha-temiz-bir-problemdir-e619b571b834?source=rss-a068d8b0ac3------2"><img src="https://cdn-images-1.medium.com/max/1536/1*HnbDR3HEnVAGvrh_jwvGJA.png" width="1536"></a></p><p class="medium-feed-snippet">Bir zamanlar game tak&#x131;m&#x131;nda, herkesin &#x201C;basit&#x201D; dedi&#x11F;i bir i&#x15F; vard&#x131;. K&#xFC;&#xE7;&#xFC;k bir kural, iki ihtimal, bir if kodu &#xE7;al&#x131;&#x15F;&#x131;yordu, prod ayaktayd&#x131;&#x2026;</p><p class="medium-feed-link"><a href="https://medium.com/devopsturkiye/yanl%C4%B1%C5%9F-kararla-yaz%C4%B1lan-clean-code-sadece-daha-temiz-bir-problemdir-e619b571b834?source=rss-a068d8b0ac3------2">Continue reading on Devops &amp; AI Türkiye☁️   ☸️ »</a></p></div>]]></description>
            <link>https://medium.com/devopsturkiye/yanl%C4%B1%C5%9F-kararla-yaz%C4%B1lan-clean-code-sadece-daha-temiz-bir-problemdir-e619b571b834?source=rss-a068d8b0ac3------2</link>
            <guid isPermaLink="false">https://medium.com/p/e619b571b834</guid>
            <category><![CDATA[software-design]]></category>
            <category><![CDATA[engineering-leadership]]></category>
            <category><![CDATA[design-patterns]]></category>
            <category><![CDATA[clean-code]]></category>
            <category><![CDATA[software-architecture]]></category>
            <dc:creator><![CDATA[Adem Olguner]]></dc:creator>
            <pubDate>Sun, 18 Jan 2026 11:03:31 GMT</pubDate>
            <atom:updated>2026-01-19T13:33:58.929Z</atom:updated>
        </item>
        <item>
            <title><![CDATA[CancellationToken ile Uygulamalarda Kontrollü Durdurma: .NET’te İptalin Sanatı]]></title>
            <description><![CDATA[<div class="medium-feed-item"><p class="medium-feed-image"><a href="https://medium.com/devopsturkiye/cancellationtoken-ile-uygulamalarda-kontroll%C3%BC-durdurma-nette-i%CC%87ptalin-sanat%C4%B1-3b0d8b03b9e3?source=rss-a068d8b0ac3------2"><img src="https://cdn-images-1.medium.com/max/1536/1*3y1NPE-OgsdXmV4FzfPH-A.png" width="1536"></a></p><p class="medium-feed-snippet">Modern uygulamalarda, her &#x15F;eyin h&#x131;zla ger&#xE7;ekle&#x15F;mesini isteriz, bazen durdurmak, devam etmekten daha ak&#x131;ll&#x131;cad&#x131;r. &#x130;&#x15F;te CancellationToken&#x2026;</p><p class="medium-feed-link"><a href="https://medium.com/devopsturkiye/cancellationtoken-ile-uygulamalarda-kontroll%C3%BC-durdurma-nette-i%CC%87ptalin-sanat%C4%B1-3b0d8b03b9e3?source=rss-a068d8b0ac3------2">Continue reading on Devops &amp; AI Türkiye☁️   ☸️ »</a></p></div>]]></description>
            <link>https://medium.com/devopsturkiye/cancellationtoken-ile-uygulamalarda-kontroll%C3%BC-durdurma-nette-i%CC%87ptalin-sanat%C4%B1-3b0d8b03b9e3?source=rss-a068d8b0ac3------2</link>
            <guid isPermaLink="false">https://medium.com/p/3b0d8b03b9e3</guid>
            <category><![CDATA[asynchronous]]></category>
            <category><![CDATA[microservices]]></category>
            <category><![CDATA[cancellationtoken]]></category>
            <category><![CDATA[exception]]></category>
            <category><![CDATA[cancellationtokensource]]></category>
            <dc:creator><![CDATA[Adem Olguner]]></dc:creator>
            <pubDate>Fri, 31 Oct 2025 09:31:06 GMT</pubDate>
            <atom:updated>2025-11-04T08:41:04.391Z</atom:updated>
        </item>
        <item>
            <title><![CDATA[Async/Await Tuzakları ConfigureAwait(false)’dan Fazlası]]></title>
            <description><![CDATA[<div class="medium-feed-item"><p class="medium-feed-image"><a href="https://medium.com/devopsturkiye/async-await-tuzaklar%C4%B1-configureawait-false-dan-fazlas%C4%B1-e0cbf1932a81?source=rss-a068d8b0ac3------2"><img src="https://cdn-images-1.medium.com/max/1080/1*vVe_2fm4kEB8kaVHw4jwNw.jpeg" width="1080"></a></p><p class="medium-feed-snippet">&#x201C;Gece yar&#x131;s&#x131; production&#x2019;da bir API yan&#x131;t vermeyi durdurdu. Loglarda exception yoktu. Ama thread&#x2019;ler asla geri d&#xF6;nm&#xFC;yordu. Birbirini&#x2026;</p><p class="medium-feed-link"><a href="https://medium.com/devopsturkiye/async-await-tuzaklar%C4%B1-configureawait-false-dan-fazlas%C4%B1-e0cbf1932a81?source=rss-a068d8b0ac3------2">Continue reading on Devops &amp; AI Türkiye☁️   ☸️ »</a></p></div>]]></description>
            <link>https://medium.com/devopsturkiye/async-await-tuzaklar%C4%B1-configureawait-false-dan-fazlas%C4%B1-e0cbf1932a81?source=rss-a068d8b0ac3------2</link>
            <guid isPermaLink="false">https://medium.com/p/e0cbf1932a81</guid>
            <category><![CDATA[configureawait]]></category>
            <category><![CDATA[asyncawait]]></category>
            <category><![CDATA[concurrency]]></category>
            <category><![CDATA[observability]]></category>
            <category><![CDATA[scalability]]></category>
            <dc:creator><![CDATA[Adem Olguner]]></dc:creator>
            <pubDate>Wed, 22 Oct 2025 14:21:16 GMT</pubDate>
            <atom:updated>2025-10-23T17:27:35.304Z</atom:updated>
        </item>
        <item>
            <title><![CDATA[Specification Design Pattern: Karmaşıklığı Basitlikle Yönetmenin Sanatı]]></title>
            <link>https://medium.com/devopsturkiye/specification-design-pattern-karma%C5%9F%C4%B1kl%C4%B1%C4%9F%C4%B1-basitlikle-y%C3%B6netmenin-sanat%C4%B1-415835115cc0?source=rss-a068d8b0ac3------2</link>
            <guid isPermaLink="false">https://medium.com/p/415835115cc0</guid>
            <category><![CDATA[software-design-principle]]></category>
            <category><![CDATA[specifications]]></category>
            <category><![CDATA[domain-driven-design]]></category>
            <category><![CDATA[business-strategy]]></category>
            <category><![CDATA[specification-pattern]]></category>
            <dc:creator><![CDATA[Adem Olguner]]></dc:creator>
            <pubDate>Tue, 21 Jan 2025 17:42:45 GMT</pubDate>
            <atom:updated>2025-01-22T10:21:03.236Z</atom:updated>
            <content:encoded><![CDATA[<p>Muhteşem kasımlar, mükemmel cumalar, yıldızlı haftasonları, şekerli bayramlar derken e-ticaret müşterisini elde tutmak ve kullanıcılarının faydasını düşünen, alışveriş yaparken keyif alabileceği, uygun kampanyalı ürünler, hizmetler ve hediyeler sunabilmek için koca bir girdaptan geçiyor, yaşayan bilir :)</p><p><strong>Filtreler ve kurallar çoğaldıkça:</strong></p><ul><li>Kodun karmaşıklığı arttı, geliştiricilerin hangi filtrelerin nerede çalıştığını anlaması zorlaştı.</li><li>Yeni kuralların eklenmesi veya mevcutların güncellenmesi sırasında, diğer kuralların yanlışlıkla etkilenmesi sıkça yaşandı.</li><li>Performans sorunları baş gösterdi çünkü birbirine zincirleme bağlanan filtreler, sorgu işlemlerini yavaşlatıyordu.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*G7UwTIa8nON6VlPd32a90g.png" /></figure><p>Modern yazılım geliştirme süreçleri, bir uygulamanın yalnızca çalışmasını değil, aynı zamanda <strong><em>ölçeklenebilir</em></strong>, <strong><em>sürdürülebilir</em></strong> ve <strong><em>esnek olmasını</em></strong> da gerektiriyor. <em>Peki, karmaşık iş kurallarını kodunuzda nasıl temiz ve yönetilebilir bir şekilde tanımlarsınız</em>? İşte burada, yazılım tasarım dünyasının gizli hazinelerinden biri olan <strong>Specification Design Pattern</strong> devreye giriyor. Bu tasarım deseni, yalnızca iş kurallarını birleştirilebilir ve yeniden kullanılabilir hale getirmekle kalmaz, aynı zamanda kodunuzun okunabilirliğini ve test edilebilirliğini de büyük ölçüde artırır.</p><p>Bu makalede, Specification Design Pattern’in temel prensiplerinden başlayarak, gerçek dünyadaki uygulama senaryolarına kadar her yönünü ele alacağız. Eğer kodunuzun iş kurallarını hem güçlü hem de esnek bir şekilde ifade etmek istiyorsanız, bu yazı tam size göre. Haydi, yazılım dünyasının bu etkileyici çözümünü birlikte keşfedelim!</p><h3>Temel Nitelikler ve Kullanım Alanları</h3><ol><li><strong>Yeniden Kullanılabilirlik</strong>: Farklı iş kuralları, bir “spesifikasyon” sınıfında temsil edilir ve <em>birden fazla yerde yeniden kullanılabilir</em>.</li><li><strong>Bileşiklik (Composability)</strong>: Spesifikasyonlar, birleştirilebilir; örneğin, iki spesifikasyonu <em>VE</em>, <em>VEYA</em>, <em>DEĞİL</em> gibi mantıksal operatörlerle birleştirebilirsiniz.</li><li><strong>Test Edilebilirlik</strong>: Spesifikasyonlar bağımsızdır ve ayrı ayrı test edilebilir.</li><li><strong>Okunabilirlik ve Bakım Kolaylığı</strong>: İş kuralları ve sorgu kriterleri açık bir şekilde tanımlandığından, kod daha anlaşılır ve bakımı kolay olur.</li></ol><h3>SENARYO-1</h3><p>Hikaye: “<strong>Hepsiburada Yarıyıl Tatili Büyük Alışveriş Festivali</strong>”</p><p>E-ticaret platformu <a href="https://www.hepsiburada.com/"><strong>Hepsiburada</strong></a>, kullanıcılarına semester tatili için özel kampanyalar sunmaktadır. Hepsiburada kullanıcısı <a href="https://sanaozel.hepsiburada.com/"><strong>sana özel</strong></a> sayfasına girdiğinde faydalanabileceği yeni kampanyaları görüntüleyecek ve bu kampanyalar ile çeşitli <strong><em>indirim</em></strong>, <strong><em>hepsipara</em></strong> (papel) gibi fırsatlardan faydalanabilecek.</p><p>Kampanyalar ve kuralları:</p><ol><li><strong>Sadık Müşteri Kampanyası<br></strong>Kayıt süresi en az 3 yıl olan, <strong>VE <br></strong>Alışveriş tutarı en az 1000 TL olan müşteriler.</li><li><strong>Yeni Müşteri ve Büyük Şehir İndirimi<br></strong>Kayıt süresi 1 yıldan az olan, <strong>VE<br></strong>Şehir: İstanbul, Ankara veya İzmir olan, <strong>VE<br></strong>Alışveriş tutarı en az 500 TL olan müşteriler.</li><li><strong>Üyelik Düzeyi Özel Teklifi<br></strong>Premium üyeler, <strong>VEYA<br></strong>Gold üyelerden olup en az 2000 TL alışveriş yapan, <strong>VE<br></strong>Kayıt süresi en az 2 yıl olan müşteriler.</li><li><strong>Genel Hariç Tutma<br></strong>Blacklist’te olan müşteriler <strong>KAMPANYALARA UYGUN DEĞİL</strong>. <br>(Blacklist olarak şehirleri kullanacağız)</li></ol><blockquote>Sorgu kriterleri — iş kuralları operasyonu senaryosu</blockquote><h3>SENARYO-2</h3><p><strong>Altın Çark</strong> ismindeki kampanya ya uygun kullanıcı listesini çekmek ve uygunluk durumu olan Hepsiburada kullanıcılarına Push Notification ile kampanyadan haberdar edecek.</p><p><em>Kampanya koşulları</em></p><ul><li>En az 500 TL alışveriş yapmış</li><li>Gold seviyesinde üyeliğe sahip</li><li>25-45 yaş aralığında</li></ul><blockquote>Sorgu kriterleri — database operasyonu senaryosu</blockquote><h3>PROJE ANALİZİ</h3><p>Bir <strong>Web Api</strong> Projesi oluşturalım ve <strong>Customer</strong> Domain modeli ile belirli iş kuralları ve database sorguları ile Specification nesneleri oluşturup mantıksal operatörler ile birleştirip karışık specification nesneleri oluşturalım.</p><h3><strong>İşlem Adımlarımız:</strong></h3><p><strong>1- Specification tanımlamamızı yapacağız.</strong></p><p>ISpecification&lt;T&gt;</p><p><strong>2- Mantıksal Operatörler Specification nesneleri oluşturacağız.</strong></p><p>AndSpecification<br>OrSpecification<br>NotSpecification<br>EqualsSpecification<br>NotEqualsSpecification</p><p><strong>3- Domain Model Specification sınıflarımızı oluşturacağız. </strong><br>(Senaryoları dikkate alarak gerekli domain alanları için yapacağız)<br> <br> - Kayıt süresi =&gt; Kayıt süresi en az 2 yıl olan müşteriler.<br> RegistrationDurationSpecification <br> - Alışveriş Tutarı =&gt; Alışveriş tutarı en az 500 TL olan MinimumPurchaseAmountSpecification<br> - Şehir =&gt; Şehir: İstanbul, Ankara veya İzmir olan <br>CitySpecification<br> - Üyelik Düzeyi =&gt; Gold üyelerden olup <br>MemberShipLevelSpecification</p><p>4- Kampanya koşullarına göre Müşterilerin hangi kampanyalara uygun olduğunu bulan <strong>birleştirilmiş Specification</strong> metotlarımızı yazacağız. <strong>Mantıksal Operatör Specification</strong> ve <strong>Domain Model Specification</strong> nesnelerini kampanya koşullarına göre <strong><em>birleşik specification</em></strong> metotlarını yazacağız.</p><h3>Senaryo-1</h3><ul><li><strong>SemesterHolidays </strong>Kampanyası (<strong>Hepsiburada Yarıyıl Tatili </strong>) şartlarına göre özel birleştirilmiş Specification yazılması</li></ul><p>BlackListCityCampaignCheck =&gt; <strong>Genel Hariç Tutma </strong><br>LoyalCustomerCampaignCheck =&gt; <strong>Sadık Müşteri Kampanyası</strong><br>NewCustomerCityCampaignCheck =&gt; <strong>Yeni Müşteri ve Büyük Şehir Kampanyası </strong><br>SpecialMembershipOffersCampaignCheck=&gt; <strong>Üyelik Düzeyi Özel Teklif</strong></p><h3>Senaryo-2</h3><ul><li><strong>SurpriseWheel </strong>kampanyası <strong>( Hepsiburada </strong>Altın Çark) için özel birleştirilmiş Specification yazılması.</li></ul><p>SurpriseWheelCampaignCheck=&gt; AltınÇark Kampanyası</p><h3>Kodlamaya Başlayalım</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/0*c-EVwzi8B57dESUU.gif" /></figure><p><strong>Web Api Uygulamasını ve alt katman projelerini oluşturalım</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/280/1*9Sxcc3GrDHc4VKNvQNNj2Q.png" /></figure><h3><strong>1- Specification Design Pattern nesnelerini oluşturalım</strong></h3><pre>public interface ISpecification&lt;T&gt;<br>{<br>    bool IsSatisfiedBy(T candidate);<br>    Expression&lt;Func&lt;T, bool&gt;&gt; ConvertToExpression();<br>}</pre><p><strong>IsSatisfiedBy</strong> :İş kuralları için kullanılacak metot.<br><strong>ConvertToExpression</strong> : Database operasyonu için kullanılacak metot.</p><blockquote>Metot isimlendirmelerine takılmayalım, anlam bütünlüğünü bozmadan farklı isimlendirmeler kullanılabilir.</blockquote><h3><strong>2- </strong>Mantıksal Operator<strong> </strong>Specification <strong>nesnelerimizi oluşturalım</strong></h3><p><strong>AndSpecification</strong>: İki ayrı specification objesini <strong>VE</strong> koşulu ile karşılaştıran nesnemizdir.</p><pre>public class AndSpecification&lt;T&gt;(ISpecification&lt;T&gt; specificationLeft, <br>                                 ISpecification&lt;T&gt; specificationRight) <br>             : ISpecification&lt;T&gt;<br>{<br>    public bool IsSatisfiedBy(T candidate)<br>    {<br>           return specificationLeft.IsSatisfiedBy(candidate) <br>               &amp;&amp; specificationRight.IsSatisfiedBy(candidate);<br>    }<br><br>    public Expression&lt;Func&lt;T, bool&gt;&gt; ConvertToExpression()<br>    {<br>        var expr1 = specificationLeft.ConvertToExpression();<br>        var expr2 = specificationRight.ConvertToExpression();<br><br>        var parameter = Expression.Parameter(typeof(T));<br>        var body = Expression.AndAlso(<br>            Expression.Invoke(expr1, parameter),<br>            Expression.Invoke(expr2, parameter)<br>        );<br><br>        return Expression.Lambda&lt;Func&lt;T, bool&gt;&gt;(body, parameter);<br>    }<br>}</pre><p><strong>OrSpecification</strong>: İki ayrı specification objesini <strong>VEYA</strong> koşulu ile karşılaştıran. nesnemizdir.</p><pre>public class OrSpecification&lt;T&gt;(ISpecification&lt;T&gt; specification1, <br>                                ISpecification&lt;T&gt; specification2) <br>             : ISpecification&lt;T&gt;<br>{<br>    public bool IsSatisfiedBy(T candidate)<br>    {<br>        return specification1.IsSatisfiedBy(candidate) <br>               || specification2.IsSatisfiedBy(candidate);<br>    }<br><br>    public Expression&lt;Func&lt;T, bool&gt;&gt; ConvertToExpression()<br>    {<br>        var expression1 = specification1.ConvertToExpression();<br>        var expression2 = specification2.ConvertToExpression();<br><br>        var parameter = Expression.Parameter(typeof(T));<br>        var body = Expression.OrElse(<br>            Expression.Invoke(expression1, parameter),<br>            Expression.Invoke(expression2, parameter)<br>        );<br><br>        return Expression.Lambda&lt;Func&lt;T, bool&gt;&gt;(body, parameter);<br>    }<br>}</pre><p><strong>NotSpecification</strong>: specification objesini <strong>olumsuzlayan</strong> veya bir <em>kriterin tam tersini</em> ifade eden nesnemizdir.</p><pre>public class NotSpecification&lt;T&gt;(ISpecification&lt;T&gt; specification) <br>             : ISpecification&lt;T&gt;<br>{<br>    public bool IsSatisfiedBy(T candidate)<br>    {<br>        return !specification.IsSatisfiedBy(candidate);<br>    }<br><br>    public Expression&lt;Func&lt;T, bool&gt;&gt; ConvertToExpression()<br>    {<br>        var expression = specification.ConvertToExpression();<br>        var parameter = expression.Parameters.Single();<br>        var body = Expression.Not(expression.Body);<br><br>        return Expression.Lambda&lt;Func&lt;T, bool&gt;&gt;(body, parameter);<br>    }<br>}</pre><p><strong>EqualsSpecification</strong>: Bir nesne ve değer alıp karşılaştırma — eşitlik kontrolü yapar</p><pre>public class EqualsSpecification&lt;T, TProperty&gt;(Expression&lt;Func&lt;T, TProperty&gt;&gt; propertyExpression, TProperty value)<br>    : ISpecification&lt;T&gt;<br>{<br>    public bool IsSatisfiedBy(T candidate)<br>    {<br>        var compiledExpression = propertyExpression.Compile();<br>        return EqualityComparer&lt;TProperty&gt;.Default.Equals(compiledExpression(candidate), value);<br>    }<br><br>    public Expression&lt;Func&lt;T, bool&gt;&gt; ConvertToExpression()<br>    {<br>        var parameter = propertyExpression.Parameters.Single();<br>        var body = Expression.Equal(propertyExpression.Body, Expression.Constant(value, typeof(TProperty)));<br>        return Expression.Lambda&lt;Func&lt;T, bool&gt;&gt;(body, parameter);<br>    }<br>}</pre><p><strong>NotEqualsSpecification</strong>: Bir nesne ve değer alıp karşılaştırma — eşitsizlik kontrolü yapar</p><pre>public class NotEqualsSpecification&lt;T, TProperty&gt;(Expression&lt;Func&lt;T, TProperty&gt;&gt; propertyExpression, TProperty value)<br>    : ISpecification&lt;T&gt;<br>{<br>    public bool IsSatisfiedBy(T candidate)<br>    {<br>        var compiledExpression = propertyExpression.Compile();<br>        return !EqualityComparer&lt;TProperty&gt;.Default.Equals(compiledExpression(candidate), value);<br>    }<br><br>    public Expression&lt;Func&lt;T, bool&gt;&gt; ConvertToExpression()<br>    {<br>        var parameter = propertyExpression.Parameters.Single();<br>        var body = Expression.NotEqual(propertyExpression.Body, Expression.Constant(value, typeof(TProperty)));<br>        return Expression.Lambda&lt;Func&lt;T, bool&gt;&gt;(body, parameter);<br>    }<br>}</pre><p>Bu Specification tiplerini farklı kombinasyonlarınıda üretebiliriz. <strong>And</strong> ile <strong>Or</strong> birlikte kullanıldığında <strong>AndOr</strong> specification oluşturulması gibi…</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/748/1*iD62KC_8MPIdkY80fMu1-A.png" /></figure><h3>3- Kampanya koşulları için gerekli olan <strong>Domain Model</strong> Specification nesneleri tanımlayalım.</h3><p>Kampanya koşullarına geçmeden önce örnek olarak (<strong>Customer</strong>) bir domain nesnesi aggregate modelimizi tanımlayalım.</p><pre>public class Customer:IAggreegateRoot, IEntity<br>{<br>    public Guid Id { get; protected set; }<br>    public string Name { get; protected set ; }<br>    public decimal TotalPurchaseAmount { get; protected set; }<br>    public MembershipLevel MembershipLevel { get; protected set; }<br>    public DateTime RegistrationDate { get; protected set; }<br>    public int Age { get; protected set; }<br>    public string City { get; protected set; }<br>}</pre><p><strong>CitySpecification</strong>: Burada bir veya birden çok şehir bilgisi istenebileceği ihtimali ile kampanyada istenen şehirlerden en az birini içeren nesneyi kabul edeceğiz. (<strong>Contains</strong>)</p><pre>public class CitySpecification(params string[] validCities) <br>             : ISpecification&lt;Customer&gt;<br>{<br>    private readonly List&lt;string&gt; _validCities = validCities.ToList();<br><br>    public bool IsSatisfiedBy(Customer candidate)<br>    {<br>        return _validCities.Contains(candidate.City);<br>    }<br><br>    public Expression&lt;Func&lt;Customer, bool&gt;&gt; ConvertToExpression()<br>    {<br>        return customer =&gt; _validCities.Contains(customer.City);<br>    }<br>}</pre><p><strong>RegistrationDurationSpecification: </strong>Müşteriye ait kayıt süresinin kontrolünü sağlayacak specification nesnesi. (Kayıt süresi 1 olan vb..)</p><pre>public class RegistrationDurationSpecification(int minYears) <br>             : ISpecification&lt;Customer&gt;<br>{<br>  private static readonly DateTime CurrentDate = DateTime.Now;<br><br>  public bool IsSatisfiedBy(Customer candidate)<br>  {<br>        return (CurrentDate - candidate.RegistrationDate).TotalDays <br>                   / 365 &gt;= minYears;<br>  }<br><br>  public Expression&lt;Func&lt;Customer, bool&gt;&gt; ConvertToExpression()<br>  {<br>      return customer =&gt;(CurrentDate-customer.RegistrationDate).TotalDays <br>                 / 365 &gt;= minYears<br>  }<br>}</pre><p><strong>MinimumPurchaseAmountSpecification</strong>: Müşterinin yaptığı alışveriş tutarı şartlarını kontrol edeceğimiz specification nesnemiz. (Alışveriş tutarı en az 500 TL vb..)</p><pre>public class MinimumPurchaseAmountSpecification(decimal minAmount) <br>             : ISpecification&lt;Customer&gt;<br>{<br>    public bool IsSatisfiedBy(Customer candidate)<br>    {<br>        return candidate.TotalPurchaseAmount &gt;= minAmount;<br>    }<br><br>    public Expression&lt;Func&lt;Customer, bool&gt;&gt; ConvertToExpression()<br>    {<br>        return candidate =&gt; candidate.TotalPurchaseAmount &gt;= minAmount;<br>    }<br>}</pre><p><strong>MembershipLevelSpecification: </strong>Müşterinin üyelik durumu kontrolünü yapan specification nesnemiz. İstenen şartlar birden çok olabileceği için contains nesnesi ile kontrol edeceğiz.</p><pre>public class MembershipLevelSpecification(params MembershipLevel[] levels) <br>             : ISpecification&lt;Customer&gt;<br>{<br>   private readonly List&lt;MembershipLevel&gt; _validLevels = levels.ToList();<br><br>    public bool IsSatisfiedBy(Customer customer){<br>        return _validLevels<br>               .Contains(customer.MembershipLevel);<br>    }<br><br>    public Expression&lt;Func&lt;Customer, bool&gt;&gt; ConvertToExpression()<br>    {<br>        return customer=&gt; _validLevels<br>                          .Contains(customer.MembershipLevel);<br>    }<br>}</pre><h3><strong>4- Şimdi sıra geldi senaryoda her bir kampanya (senaryo) için gerekli (birleştirilmiş) specification nesnelerini yazmaya.</strong></h3><p><strong>Senaryo - 1 </strong>için 4 farklı kampanyamız var, zaman içerisinde kampanya azalabilir vey artabilir bu durum için Senaryo-1 e ait kampanyaları etiketleyebilmek için bir interface imzası oluşturacağız. <br>(Nedenini ve neye yaradığını ilerleyen satırlarda detaylandıracağız)</p><p>Ortak referans nesnesi kullanılacakları için bunları ortak bir interface metodu ile tasarlayalım.</p><pre>public  interface ICampaignCheck&lt;in T&gt;<br>{<br>    string? CheckEligibility(T model);<br>}</pre><blockquote><strong><em>Blacklist’te olan müşteriler KAMPANYALARA UYGUN DEĞİL.</em></strong></blockquote><p>BlackList listesinde var olan şehirlerden biri ise geriye false , değilse true dönmeli. BlackList listemizde olan şehirler var bu şehirler kampanya dışı şehirler olarak düşünelim ve müşteri bu şehirlerden birinde ise kampanya ya uygun değildir şeklinde dönüş sağlayacağız.</p><p>Burada dikkat etmemiz gereken nokta <strong>CitySpecification</strong> ve <strong>NotSpecification</strong> ile kullanımı. <strong>CitySpecification</strong> müşteriye ait şehir kontrolü yapıyor ve <strong>NotSpecification</strong> ile dönen değerini <em>değilini</em> alıyoruz.</p><pre>/// &lt;summary&gt;<br>/// Blacklist’te olan müşteriler KAMPANYALARA UYGUN DEĞİL.<br>/// &lt;/summary&gt;<br>public class BlacklistCampaignCheck : ICampaignCheck&lt;Customer&gt;<br>{<br>    public string? CheckEligibility(Customer customer)<br>    {<br>        var blacklistSpecification = new NotSpecification&lt;Customer&gt;(<br>          new CitySpecification(ApplicationConstant.BlackCities.ToArray())<br>        );<br><br>        return blacklistSpecification.IsSatisfiedBy(customer) <br>            ? &quot;- Blacklist’te olduğu için kampanyaya uygun değil.&quot; <br>            : null;<br>    }<br>}</pre><blockquote><strong>Sadık müşteri kampanyası aranan şartlar :</strong></blockquote><ul><li>Alışveriş tutarı en az 1000 TL olan müşteriler <strong>MinimumPurchaseAmountSpecification</strong></li><li>VE (<strong>AndSpecification)</strong></li><li>Kayıt süresi en az 3 yıl olan <strong>RegistrationDurationSpecification</strong></li></ul><pre>/// &lt;summary&gt;<br>///  Kampanya 1: Sadık Müşteri Kampanyası<br>///        * Kayıt süresi en az 3 yıl olan, VE<br>///        * Alışveriş tutarı en az 1000 TL olan müşteriler.<br>/// &lt;/summary&gt;<br>public class LoyalCustomerCampaignCheck : ICampaignCheck&lt;Customer&gt;<br>{<br>  <br>  public string? CheckEligibility(Customer customer)<br>   {<br>     var loyalCustomerCampaignSpecification=new AndSpecification&lt;Customer&gt;(<br>            new RegistrationDurationSpecification(3),<br>            new MinimumPurchaseAmountSpecification(1000)<br>        );<br>        <br>        var checkResponse = loyalCustomerCampaignSpecification<br>                             .IsSatisfiedBy(customer);<br>        <br>        return checkResponse<br>            ? &quot;- Sadık Müşteri Kampanyasına uygun!&quot; <br>            : null;<br>    }<br>}</pre><blockquote><strong>Yeni Müşteri ve Büyük Şehir İndirimi</strong></blockquote><p>Burada iç içe geçmiş 2 adet <strong>VE</strong> koşulu var. Birbirine zincirleme bağlı <strong>AndSpecification</strong> kullanarak tasarlıyoruz.</p><p>İlk <strong>VE</strong> koşulu <br>Şehir: İstanbul, Ankara veya İzmir olan <strong>CitySpecification</strong><br>VE ( <strong>AndSpecification )</strong><br>Alışveriş tutarı en az 500 TL olan <strong>MinimumPurchaseAmountSpecification</strong></p><p>İkinci <strong>VE</strong> koşulu ilk <strong>VE</strong> koşulunun sonucuna <strong>RegistrationDurationSpecification </strong>koşuluna<strong> AndSpecification </strong>ile tekrar kontrol ediyoruz.</p><pre>/// &lt;summary&gt;<br>///  Kampanya 2: Yeni Müşteri ve Büyük Şehir İndirimi<br>///      *  Kayıt süresi 1 yıldan az olan, VE<br>///      *  Şehir: İstanbul, Ankara veya İzmir olan, VE<br>///      *  Alışveriş tutarı en az 500 TL olan müşteriler.<br>/// &lt;/summary&gt;<br>public class NewCustomerCityCampaignCheck : ICampaignCheck&lt;Customer&gt;<br>{<br>  <br> public string? CheckEligibility(Customer customer)<br>  {<br>   var newCustomerCityCampaignSpecification=new AndSpecification&lt;Customer&gt;(<br>            new RegistrationDurationSpecification(0),<br>            new AndSpecification&lt;Customer&gt;(<br>                new CitySpecification(&quot;İstanbul&quot;, &quot;Ankara&quot;, &quot;İzmir&quot;),<br>                new MinimumPurchaseAmountSpecification(500)<br>            )<br>        );<br><br>     var checkResponse = newCustomerCityCampaignSpecification<br>                            .IsSatisfiedBy(customer);<br><br>     return checkResponse<br>            ? &quot;- Yeni Müşteri ve Büyük Şehir İndirimi Kampanyasına uygun!&quot;<br>            : null;<br>    }<br>}</pre><blockquote><strong>Üyelik Düzeyi Teklifi</strong></blockquote><p>3 ayrı Mantıksal Specification <strong>VEYA</strong>-<strong>VE</strong>-<strong>VE</strong> birleştirmesi yapacağız. <strong>AndSpecification — OrSpecification.</strong></p><pre>/// &lt;summary&gt;<br>/// Kampanya 3: Üyelik Düzeyi Özel Teklifi<br>///    * Premium üye VEYA Gold üye olup en az 2000 TL alışveriş yapan,VE<br>///    * Kayıt süresi en az 2 yıl olan müşteriler<br>/// &lt;/summary&gt;<br><br>public class SpecialMembershipOffersCampaignCheck :ICampaignCheck&lt;Customer&gt;<br>{<br>  public string? CheckEligibility(Customer customer)<br>   {<br>      var premiumOrGoldCampaignSpecification=new OrSpecification&lt;Customer&gt;(<br>            new MembershipLevelSpecification(MembershipLevel.Premium),<br>            new AndSpecification&lt;Customer&gt;(<br>                new MembershipLevelSpecification(MembershipLevel.Gold),<br>                new MinimumPurchaseAmountSpecification(2000)<br>            )<br>        );<br><br>        var membershipOfferSpecification = new AndSpecification&lt;Customer&gt;(<br>            premiumOrGoldCampaignSpecification,<br>            new RegistrationDurationSpecification(2)<br>        );<br>        <br>        var checkResponse= membershipOfferSpecification<br>                          .IsSatisfiedBy(customer);<br>        <br>        return checkResponse <br>            ? &quot;- Üyelik Düzeyi Özel Teklif Kampanyasına uygun!&quot; <br>            : null;<br>    }<br>}</pre><p><strong>Senaryo-2 </strong>de Kullanıcıların tamamı için <strong>Altın Çark</strong> kampanyasına uyup uymadığı sorgulaması yapılacaktır. Bu işlem database-veritabanı sorgusu olarak hazırlanacaktır. Senaryomuzu ve kampanyamızı tekrar hatırlayalım.</p><p>Database operasyonları için ortak bir interface olarak tanımlayalım.</p><pre>public interface ISpecificationExpressionCheck&lt;T&gt;<br>{<br>    Expression&lt;Func&lt;T, bool&gt;&gt; GetExpression();<br>}</pre><pre><br>/// &lt;summary&gt;<br>///     Altın Çark Kampanya kosulları<br>///        En az 500 TL alışveriş yapmış (TotalPurchaseAmountSpecification)<br>///        Gold seviyesinde üyeliğe sahip (MembershipLevelSpecification),<br>///        25-45 yaş aralığında (AgeRangeSpecification).<br>/// &lt;/summary&gt;<br>public class SurpriseWheelCampaignExpression<br>              :ISpecificationExpressionCheck&lt;Customer&gt;<br>{<br><br>public Expression&lt;Func&lt;Customer, bool&gt;&gt; GetExpression()<br>{<br>   var purchaseSpecification = new MinimumPurchaseAmountSpecification(500);<br>   <br>   var membershipSpecification = new MembershipLevelSpecification(<br>                                       MembershipLevel.Gold);<br>  <br>   var ageSpecification = new AgeRangeSpecification(24, 45);<br>        <br>   var combinedSpecification = new AndSpecification&lt;Customer&gt;(<br>                           purchaseSpecification, membershipSpecification);<br>        <br>   combinedSpecification = new AndSpecification&lt;Customer&gt;(<br>                          combinedSpecification, ageSpecification);<br><br>   return combinedSpecification.ConvertToExpression();<br> }<br><br>}</pre><p>Hazırlıklarımız tamam şimdi api controller hazırlayıp 2 endpoint ile bu akışları kontrol edelim.</p><p>İlk endpoint <strong>iş kuralı</strong> çerçevesinde çalışacak,<br>İkinci endpoint ise <strong>karmaşık sorgulama</strong> amacı ile çalışacak.</p><pre>[ApiController]<br>[Route(&quot;api/campaign&quot;)]<br>public class CampaignController(IMediator mediator) : ControllerBase<br>{<br>    <br>    [HttpGet(&quot;customers/{customerId:Guid}/eligibility&quot;)]<br>    public async Task&lt;IActionResult&gt; CheckCampaignEligibility(<br>                                               [FromRoute] Guid customerId)<br>    {<br>        var result = await mediator.Send(<br>                       new EligibilityCheckByCustomerQuery(customerId));<br>        return Ok(result);<br>    }<br>    <br>    [HttpGet(&quot;campaigns/surprise-wheel/customers&quot;)]<br>    public async Task&lt;IActionResult&gt; CheckCampaignEligibilityByCustomer()<br>    {<br>        var result = await mediator.Send(<br>                              new CampaignEligibilityCustomersQuery());<br>        return Ok(result);<br>    }<br>}</pre><p>Senaryo-1</p><pre>public class CampaignEligibilityService<br>(<br>  IEnumerable&lt;ICampaignCheck&gt; campaignChecks<br>):ICampaignEligibilityService<br><br>{<br>    public EligibilityCheckByCustomerResult SemesterHolidayCampaignCheck(Customer customer)<br>    {<br>        var eligibleCampaigns = campaignChecks<br>                                .Select(check =&gt; check.CheckEligibility(customer))<br>                                .Where(result =&gt; result != null)<br>                                .ToList();<br>    <br>     return new EligibilityCheckByCustomerResult<br>        {<br>            Message = $&quot;Değerli Hepsiburada kullanıcımız {customer.Name}, size uygun kampanyalarımız var, Kuponlar bitmeden gel!!!&quot;,<br>            EligibleCampaigns = eligibleCampaigns,<br>            CustomerId = customer.GetId()<br>        };<br>    }<br>}</pre><p>Dikkat edilmesi gereken bir konu var. Daha önce tanımladığımız <strong>ICampaignCheck&lt;in T&gt; </strong>nesnesini referans alan ne kadar Specification varsa otomatik olarak<strong> campaignChecks</strong> içerisinde görüntülenmektedir. Burada Senaryo-1&#39;e yeni bir kampanya koşulu eklersek buradaki sorgu alanı değişmeyecektir. Dinamik olarak <strong>ICampaignCheck </strong>interface’i referans alan tüm Spesifikasyonlar eklenmiş ve sorgulanmış olacaktır.</p><p>Senaryo-1 için bu 4 kampanyayı <strong><em>ICampaignCheck&lt;in T&gt;</em></strong> ile imzalamıştık.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/506/1*ri_EdbC1-WIZ83_NZL4x0A.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*Bxl003-JtKsjxBie6iSE9g.png" /><figcaption>Varolan entegrasyon ile</figcaption></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*sr35DW632ZzewFjhqfJ3xg.png" /><figcaption><strong>NewCustomerSpecification</strong> nesnesinin imzasını kaldıralım</figcaption></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*kgwiMM4C70GW0kj1SIgeYQ.png" /><figcaption><strong>YeniEklenenSpecification</strong> adında <strong>ICampaignCheck&lt;in T&gt; </strong>referans alan bir specification daha ekleyelim.</figcaption></figure><h3>Senaryo-2</h3><pre>public class SurpriseWheelCustomersQuery <br>               : IRequest&lt;CampaignEligibilityResponse&gt;<br>{}</pre><pre>public class SurpriseWheelCustomersQueryHandler(<br>    ICustomerRepository customerRepository,<br>    ISpecificationExpressionCheck&lt;Customer&gt; specificationExpressionCheck)<br>    : IRequestHandler&lt;SurpriseWheelCustomersQuery, CampaignEligibilityResponse&gt;<br>{<br>    public async Task&lt;CampaignEligibilityResponse&gt; Handle(SurpriseWheelCustomersQuery request, CancellationToken cancellationToken)<br>    {<br>        var response = new CampaignEligibilityResponse { Campaign = &quot;Sürpriz Çarkı!&quot; };<br>        var expressionQuery = specificationExpressionCheck.GetExpression();<br><br>        var customers = await customerRepository<br>                              .GetAllAsync(expressionQuery.Compile(), cancellationToken);<br><br>        foreach (var customer in customers)<br>        {<br>            response.EligibleCustomers.Add(new EligibleCustomer()<br>            {<br>                CustomerId = customer.Id,<br>                Name = customer.Name<br>            });<br>        }<br><br>        return response;<br>    }<br>}</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*XbLTsUFdU0VjTLc6JORQvw.png" /></figure><p>Farklı bir yazıda görüşmek üzere.</p><p><a href="https://github.com/ademolguner/SpecificationPattern">GitHub - ademolguner/SpecificationPattern: Specification Pattern</a></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=415835115cc0" width="1" height="1" alt=""><hr><p><a href="https://medium.com/devopsturkiye/specification-design-pattern-karma%C5%9F%C4%B1kl%C4%B1%C4%9F%C4%B1-basitlikle-y%C3%B6netmenin-sanat%C4%B1-415835115cc0">Specification Design Pattern: Karmaşıklığı Basitlikle Yönetmenin Sanatı</a> was originally published in <a href="https://medium.com/devopsturkiye">Devops &amp; AI Türkiye☁️ 🐧 🐳 ☸️</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Asp.Net Core Polly ile Resiliency Patterns ( Esneklik-Dayanıklılık) Retry Pattern İncelemesi]]></title>
            <link>https://medium.com/devopsturkiye/asp-net-core-polly-ile-resiliency-patterns-esneklik-dayan%C4%B1kl%C4%B1l%C4%B1k-retry-pattern-i%CC%87ncelemesi-dedf1c019fd1?source=rss-a068d8b0ac3------2</link>
            <guid isPermaLink="false">https://medium.com/p/dedf1c019fd1</guid>
            <category><![CDATA[resilience]]></category>
            <category><![CDATA[retry-pattern]]></category>
            <category><![CDATA[polly]]></category>
            <category><![CDATA[microservices]]></category>
            <category><![CDATA[design-patterns]]></category>
            <dc:creator><![CDATA[Adem Olguner]]></dc:creator>
            <pubDate>Thu, 07 Mar 2024 22:29:06 GMT</pubDate>
            <atom:updated>2024-03-16T18:20:23.934Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/774/1*_-UsynsvqKZeHkvzhvuNOQ.png" /></figure><p>Eğer bu satırları okuyorsanız, muhtemelen Microservices dünyasına adım atmışsınız demektir. Bu süreçte bir dizi zorlukla karşılaşmış olabilir ve bu sorunlara çözüm arayışına girmiş olmalısınız. Microservices kavramı, ilk duyulduğunda oldukça heyecan verici gelebilir ancak bu yolculuğa adım attıkça, zaman zaman karmaşık ve sınırsız gibi görünen sorunlarla karşılaşmanın kaçınılmaz olduğunu fark etmiş olabilirsiniz.</p><blockquote>Hizmetler arası iletişim,ağ hataları, gecikmeler, bağlantı sorunları, hata yönetimi, veritabanları yönetimi, veri bütünlüğü, tutarlılık ve güvenilirlik, veri paylaşımı, veri güncelleme, veri senkronizasyonu, yetkilendirme, kimlik doğrulama, loglama ve izleme mekanizması, versiyon yönetimi vb… bu liste daha çok uzar gider. Teknik terimlere boğmadan kuşbakışı bu ve daha fazlası ile uğraşmak.</blockquote><h3>Resiliency Patterns (Esneklik-Dayanıklılık)</h3><p>Resiliency işlemlerinin asıl amacı, uygulamalarımızın dayanıklılığını arttırmayı hedefler. Dayanıklılıktan kasıt sistem veya sistemlerde meydana gelebilecek hatalar ile başa çıkmak, hizmet kesintilerine karşı uygulamalarımızın down olmamasını, çalışabilirliğini sağlamak, devamlılığını sürdürmek.</p><p>Gelin bu tanımlamayı bir hikaye üzerinden giderek daha akılda kalıcı olmasını sağlayalım</p><p>Bir zamanlar <strong>Güzelyalı</strong> adında huzurlu bir kasaba vardı. Kasaba sakinleri, günlük işlerini gerçekleştiren ve birbirleriyle etkileşimde bulunan bir topluluktu. Ancak, Güzelyalı’da sıklıkla karşılaşılan bir sorun vardı: doğanın tuhaf olaylarına bağlı olarak ortaya çıkan <strong><em>beklenmeyen kesintiler</em></strong>.</p><p>Kasaba lideri, bu durumu çözmek ve Güzelyalı sakinlerine sürekli bir hizmet sunmak için bir çözüm bulmak istedi. Bu noktada, bir bilge kasaba sakini olan Uncle Adem, <strong>Resiliency Patterns</strong> adında bir <em>büyü kitabını</em> hatırladı.</p><p>Uncle Adem, kasaba liderine bu sihirli desenlerin kasabanın dayanıklılığını artırabileceğini ve beklenmeyen durumlarla başa çıkma yeteneğini güçlendirebileceğini anlattı. Kasaba lideri, Uncle Adem’nın önerilerini dikkate alarak Güzelyalı’yı daha dayanıklı hale getirmeye karar verdi.</p><p>İlk olarak, <strong>Retry Pattern</strong> kullanılarak, kasabada ortaya çıkan küçük kesintilerin otomatik olarak düzeltilebileceği bir sistem kuruldu. Bir hizmette hata oluştuğunda, sistem otomatik olarak <strong><em>belirli aralıklarla tekrar deneme stratejisini</em></strong> uygulayarak normal duruma dönme çabasına girdi.</p><p>Ardından, <strong>Circuit Breaker Pattern</strong> ile kasabadaki bazı hizmetler izole edildi. Bir hizmette ciddi bir hata oluştuğunda, bu <strong><em>hizmet geçici olarak devre dışı</em></strong> bırakılarak diğer hizmetlerin etkilenmesi önlendi.</p><p>Uncle Adem, kasabanın her tarafına <strong>Bulkhead Pattern</strong> uygulayarak, gelen talepleri kontrollü bir şekilde yönetmeyi önerdi. Bu, beklenmedik bir <strong><em>yük artışı durumunda sistemde aşırı yüklenmeyi önlemek</em></strong> amacını taşıyordu.</p><p>Böylece, <strong>Resiliency Patterns</strong> sayesinde Güzelyalı, doğanın ve beklenmedik olayların yol açtığı sorunlara karşı daha dayanıklı hale geldi. Kasaba sakinleri, günlük yaşamlarını daha az kesintiyle sürdürmeyi başardılar ve Güzelyalı, bu sihirli desenlerle daha güçlü ve dirençli bir kasaba haline geldi.</p><p><strong>Resiliency Patternler</strong> türleri sadece bunlar değil tabiki. Hikayeleştirme yaparak daha hatırlanabilir bir anlatım ortaya çıkarmaya çalıştım. Bu yazı serisi ile Resiliency Patternleri tek tek inceleyeceğiz.</p><p><strong>Resiliency Pattern Policy Tipleri</strong>;</p><blockquote>Retry<br>Circuit Breaker<br>Fallback<br>Timeout<br>Cache<br>Bulkhead</blockquote><h3>Retry Pattern</h3><p><strong>Retry Pattern</strong>, hata durumlarında bir operasyonu <strong><em>tekrar deneyerek başarılı bir sonuç</em></strong> elde etme stratejisidir. Bu desen, iç ve dış servis çağrıları veya ağ bağlantıları gibi durumlarda kullanışlıdır. Tekrar deneme, kaç kere ve hangi sıklıkta gibi soruların cevabını kodlarımız yazarken inceleyeceğiz.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/967/1*9pYzAdu3j6hXEqmI0wUYKw.png" /><figcaption><a href="https://learn.microsoft.com/en-us/dotnet/architecture/cloud-native/application-resiliency-patterns">https://learn.microsoft.com/en-us/dotnet/architecture/cloud-native/application-resiliency-patterns</a></figcaption></figure><p><strong>Neden Retry Pattern Kullanmalıyım?</strong></p><p>Retry pattern bize ne sağlıyor, uygulamamız yaşam döngüsü içerisinde farklı bir api ye (internal veya external) istekte bulunduğumuzda, bu isteği karşılayan tarafta farklı durumlardan dolayı hata (exception) ile karşılaşıldı ve bu durumda api isteğimiz burada kesilecektir, bu pek karşılaşmak istediğimiz bir durum değildir. Peki burada hata durumlarının-çeşitlerinin bir önemi var mı? sorusu akla geliyor.</p><p><strong>Hata durumlarının-çeşitlerinin bir önemi var mı?</strong></p><p>Belkide en önemli soru diyebiliriz. Tekrar deneme tasarımı ile ne tür hata durumlarında denemeliyiz? <strong>BadRequest(400), Unauthorized(401) </strong>yada<strong> Forbidden(403) </strong>aldığımız, bir hata durumunda tekrar denemek çözüm olmayacaktır aksine network trafiği oluşturacağız. Bu durumda doğru hata (exception) tipleri için Retry Pattern uygulamalıyız. Genel olarak network kaynaklı hatalarda erişememe, zaman aşımı (timeout) gibi hata (exception) türleri için kullanmak daha sağlıklı olacaktır.</p><pre>private static readonly HttpStatusCode[] HttpStatusCodesWorthRetrying =<br>    [<br>        HttpStatusCode.RequestTimeout, // 408<br>        HttpStatusCode.InternalServerError, // 500<br>        HttpStatusCode.BadGateway, // 502<br>        HttpStatusCode.ServiceUnavailable, // 503<br>        HttpStatusCode.GatewayTimeout // 504<br>    ];</pre><blockquote>Not: Bu durumların dışında Custom Exception’lar içinde yapılabilir. Kodumuzu yazarken bu noktalara değineceğiz.</blockquote><p>Retry pattern ile tekrar deneme işlemi yaparken bazı hususlarda (<strong>Idempotency</strong>) kontrol etmek gerekecektir<strong>. Idempotency</strong> nedir ne değildir bu konuya girmeyeceğim bu konuda takım arkadaşım <a href="https://medium.com/u/fbafbccfd746">Serdar Usta (Hepsiburada/Bilgi Teknolojileri)</a>’nın detaylıca kaleme aldığı <a href="https://medium.com/@serdar_usta/s%C3%B6ylemesi-haval%C4%B1-bir-o-kadar-sinir-bozucu-idempotency-in-event-driven-architecture-f885f19184e2"><strong>Idempotency</strong></a><strong> </strong>yazısını okuyabilirsiniz<strong>.</strong></p><p>Kısaca değinmek gerekirse; ödeme işlemi için farklı bir takımın kontrolünde olan bir servise ait istek yaptığımızı düşünelim. Yaptığımızı istekte kullanıcı bakiyesinden para kesildiğini düşünelim. Kullanıcı hesabından para kesiliyor ancak işlem devam ederken timeout aldık ve Retry Pattern ile tekrar denedik ve yine kullanıcı hesabından para kesildi. Kullanıcı mağduriyeti yaratıldı. Burada hizmet aldığınız takımdan bu işlem ile alakalı <strong>idempotent</strong> yapının olup olmadığını bilmek ve dikkat etmek gerekiyor.</p><h3>Let’s code</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/800/1*nVhB4OckFv4FmuTym3OmKw.gif" /></figure><h3>Polly.NET</h3><p>Açık kaynak olarak geliştirilen ve içinde hazır Resiliency Pattern’ler (Retry, Circuit Breaker, BulkHead Isolation, Timeout ve Fallback) barındıran bir .NET kütüphanesidir. NuGet üzerinden kurulum sağlayabiliriz.</p><pre>&lt;PackageReference Include=&quot;Polly&quot; Version=&quot;8.3.0&quot; /&gt;<br>&lt;PackageReference Include=&quot;Polly.Extensions.Http&quot; Version=&quot;3.0.0&quot; /&gt;<br>&lt;PackageReference Include=&quot;Microsoft.Extensions.Http.Polly&quot; Version=&quot;8.0.2&quot; /&gt;</pre><h3>Web Api Projesi Oluşturalım</h3><p>Uygulamamız bir oyun uygulaması için gerekli olan entegrasyonların olduğu bir Api uygulaması olacaktır. Bu uygulama kendi içerisindeki iş kuralları ile beraber internal-external servislerden de beslenen bir uygulama olacaktır. Oyunun kendi işlem akışları devam ederken external bir servis olan Wallet servisine istek atacağız ve kullanıcı güncel bakiyesini öğreneceğiz, bu bakiye ile oyun oynamaya devam edecektir.</p><p>Uygulama API’nin adı: <strong>SpinningWheels-Api</strong> olsun<br>Bakiye bilgisi için kullanacağımız API’nin adı <strong>Wallet-Api </strong>olsun<strong>.</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*Pb2Ag5flTORx-FUvo9JfAA.png" /><figcaption>Oyun arayüzümüz</figcaption></figure><h3>Uygulama Katmanı ve Proje</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*8H4UTlPC1774rX1u9ElE6Q.png" /></figure><p>Retry Pattern kullanmadan önce client isteğinin request ve response durumu bu şekilde olacaktır.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*zCBjADFcmKx7_MAx8TH4Pw.png" /><figcaption>Retry Pattern — Uygulamadan önce</figcaption></figure><p>Uygulamalar arası client entegrasyonunu ekleyelim. <strong>AddHttpClient</strong>() eklendikten sonra şu an için sadece wallet-client olduğu için sadece bu clientı ekliyoruz. Tüm clint eklenme olayını ayrı ayrı metotlar ile yapmak kod karmaşası açısından ve her bir client için farklı farklı ihtiyaç duyulabilen entegrasyonlar eklenebilir düşüncesi ile ayro metot olarak tasarlanmıştır.</p><pre>private static IServiceCollection AddClientDependencies(this IServiceCollection services, <br>                                                        IConfiguration configuration)<br>    {<br>        var httpClients = services.AddHttpClient();<br>        httpClients.RegisterWalletClient(configuration);<br>        return services;<br>    }<br><br>    private static void RegisterWalletClient(this IServiceCollection services, <br>                                                  IConfiguration configuration)<br>    {<br>       services<br>           .AddWalletClient(configuration)<br>           .AddTransientHttpErrorPolicy(_=&gt;ResiliencyStrategies.GetRetryPolicy());<br>    }</pre><p><strong>.AddWalletClient(configuration)</strong> ile wallet için yaptığımız client entegrasyonunu ekliyoruz ve ardından Retry Pattern entegrasyonunu ekliyoruz.</p><blockquote><strong>.AddTransientHttpErrorPolicy(_=&gt;</strong>ResiliencyStrategies.GetRetryPolicy()<strong>);</strong></blockquote><pre>public static class ResiliencyStrategies<br>{<br>  private static readonly HttpStatusCode[] HttpStatusCodesWorthRetrying =<br>    [<br>        HttpStatusCode.RequestTimeout, // 408<br>        HttpStatusCode.InternalServerError, // 500<br>        HttpStatusCode.BadGateway, // 502<br>        HttpStatusCode.ServiceUnavailable, // 503<br>        HttpStatusCode.GatewayTimeout // 504<br>    ];<br><br>  public static IAsyncPolicy&lt;HttpResponseMessage&gt; GetRetryPolicy()<br>    {<br>        return HttpPolicyExtensions<br>            .HandleTransientHttpError()<br>            .OrResult(r =&gt; HttpStatusCodesWorthRetrying.Contains(r.StatusCode))<br>            .WaitAndRetryAsync(<br>                retryCount : 6, <br>                sleepDurationProvider: retryAttempt =&gt; <br>                                       TimeSpan.FromSeconds(Math.Pow(3, retryAttempt)), //TimeSpan.FromSeconds(10)<br>                onRetryAsync: (exception, timespan, retryAttempt, context) =&gt;<br>                {<br>                    Console.WriteLine($&quot;Retry #{retryAttempt} due to {exception.Exception.Message}. &quot; +<br>                                      $&quot;Waiting for {timespan.TotalSeconds} seconds.&quot;);<br>                    return Task.CompletedTask;<br>                });<br>    }<br>}</pre><p><strong>HandleTransientHttpError : </strong>Geçici olarak gerçekleşen (transient) HTTP hatalarını handle eder. InternalServiceError (5xx) veya RequestTimeout [408] durumlarında ele alınır. Bu hata türklerine ek olarak farklı hata tiplerini de ekleyebiliriz.</p><p><strong>OrResult : </strong>Bu metot ile ekstra koşullar eklenilir. Ben örnek olarak sadece statusCode ekledim ancak farklı koşullar eklenebilir.</p><p><strong>WaitAndRetryAsync : <em>D</em></strong><em>eneme sayısı</em> ve <em>bekleme süresi</em> alınarak, istek otomatik olarak tekrar gerçekleştirilir. Burada tekrar süresi (delay) sabit bir değer olabileceği gibi farklı delay tanımlamaları yapılabilir. biz burada örnek olarak 6 tekrar ve 3&#39;ün katları (3–9–27–81…) olacak şekilde ayarladık.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*ytoE3EHV-nG_be3RG_kx1Q.png" /><figcaption>Retry Pattern — Uygulandıktan sonra</figcaption></figure><blockquote><strong>Not</strong>: Retry Pattern genel olarak kısa süreli oluşabilecek ağ problemi ve network kaynaklı timeout işlemleri için kullanılabilir. Client isteği için genelde bir timeout süresi olacaktır bu api katmanında 10 sn desek gateway katmanında max 60 sn olarak tanımlansa da burada client isteği retry sürecinde max 60 sn içerisinde cevap verebilir olmalı aksi durumda <strong>TimeoutException</strong> hatası alınır ve uygulamamız exception verir, uygulama dayanıklılık ve esnekliği tam olarak sağlanmamış olur. Burada TimeoutException hatasının oluşma ihtimalini göz önünde bulundurup handle edebilmemiz gerekiyor. Buna çözüm olarak daha sonraki yazımızda değineceğimiz <strong>TimeoutException Pattern</strong> ile çözüm geliştirmiş olacağız.</blockquote><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*G0_HsNgXRiHvhbicJP6jdQ.png" /><figcaption><strong>TimeoutException handle edemediğimizde uygulama hata alıcaktır</strong></figcaption></figure><p>SpinningWheels-Api çalıştırıp 2. ci retry denemesini yaparken Wallet-Api’yi ayağa kaldırdığımızda erişim sağlamaya başlayacak ve request işlemi kaldığı yerden kesintisiz sağlamış olucaktır.</p><iframe src="https://cdn.embedly.com/widgets/media.html?src=https%3A%2F%2Fwww.youtube.com%2Fembed%2Flz_3QEHn2so%3Ffeature%3Doembed&amp;display_name=YouTube&amp;url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3Dlz_3QEHn2so&amp;image=https%3A%2F%2Fi.ytimg.com%2Fvi%2Flz_3QEHn2so%2Fhqdefault.jpg&amp;type=text%2Fhtml&amp;schema=youtube" width="640" height="480" frameborder="0" scrolling="no"><a href="https://medium.com/media/207e483dd8c9ddd04669763968038af2/href">https://medium.com/media/207e483dd8c9ddd04669763968038af2/href</a></iframe><p>Polly kütüphanesi ile Resiliency Pattern’leri incelemeye çalıştık. İlk olarak Retry Pattern ile düzenlemeye ve konfigüre etmeye çalıştık. Bir sonraki yazımızda Circuit Pattern ile devam edeceğiz. Kısa zaman sonra görüşmek üzere.</p><p>Kod örneklerine <a href="https://github.com/ademolguner/ResiliencyPatterns.git">buradan</a> ulaşabilirsiniz.</p><p>Saygı ve sevgilerimle<br>Adem OLGUNER.</p><p><a href="https://github.com/ademolguner/ResiliencyPatterns.git">GitHub - ademolguner/ResiliencyPatterns: Resiliency Patterns</a></p><p>Kaynaklar:<br>. <a href="https://learn.microsoft.com/en-us/dotnet/architecture/cloud-native/application-resiliency-patterns">https://learn.microsoft.com/en-us/dotnet/architecture/cloud-native/application-resiliency-patterns</a><br>. <a href="https://github.com/App-vNext/Polly">https://github.com/App-vNext/Polly</a></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=dedf1c019fd1" width="1" height="1" alt=""><hr><p><a href="https://medium.com/devopsturkiye/asp-net-core-polly-ile-resiliency-patterns-esneklik-dayan%C4%B1kl%C4%B1l%C4%B1k-retry-pattern-i%CC%87ncelemesi-dedf1c019fd1">Asp.Net Core Polly ile Resiliency Patterns ( Esneklik-Dayanıklılık) Retry Pattern İncelemesi</a> was originally published in <a href="https://medium.com/devopsturkiye">Devops &amp; AI Türkiye☁️ 🐧 🐳 ☸️</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Asp.Net Core Web Api Versiyonlama ve Swagger Entegrasyonu]]></title>
            <link>https://medium.com/devopsturkiye/asp-net-core-web-api-versiyonlama-ve-swagger-entegrasyonu-ba3581e96d1e?source=rss-a068d8b0ac3------2</link>
            <guid isPermaLink="false">https://medium.com/p/ba3581e96d1e</guid>
            <category><![CDATA[versioning]]></category>
            <category><![CDATA[aspnetcore]]></category>
            <category><![CDATA[api-versioning]]></category>
            <category><![CDATA[technology]]></category>
            <category><![CDATA[swagger]]></category>
            <dc:creator><![CDATA[Adem Olguner]]></dc:creator>
            <pubDate>Sun, 25 Feb 2024 20:33:37 GMT</pubDate>
            <atom:updated>2024-02-26T10:35:10.470Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*YhShoZq5tUiis5omMy4GDA.png" /></figure><p>Teknolojik gelişmeler genellikle bir ihtiyacı karşılamak amacıyla ortaya çıkar. Geliştiriciler olarak, bu teknolojileri sıklıkla kullanırız; ancak, çoğu zaman neden ortaya çıktığı, hangi ihtiyaca hizmet ettiği, neyi kolaylaştırdığı veya hangi sorunu çözdüğü gibi temel soruları sormaya odaklanmayız. Her çıkan yeniliği projenin gereksinimlerine uygun mu diye sormak ve kullanılmasının artı ve eksilerini değerlendirmek zorundayız. Bu soruları sormadan yapılan her entegrasyon veya geliştirme, genellikle beklentilerin altında kalır ve uzun vadede olumsuz sonuçlar doğurabilir. Bu nedenle, her teknolojiyi kullanmadan önce bu sorgulama sürecini geçirmek, projelerin başarıya ulaşması için kritik bir öneme sahiptir. Tecrübe ile sabittir!</p><p>Gelelim sorularımıza ve bu sorulara verebileceğimiz cevaplara.</p><ul><li>Versiyonlama nedir ?</li><li>Neden versiyonlama kullanmalıyız?</li><li>Versiyonlama için hangi stratejileri yada yöntemleri bulunmaktadır?</li><li>Sorularımız bu şekilde uzayıp gider.</li></ul><h3>Versiyonlama Nedir?</h3><p>Versiyonlamaya geçmeden önce biraz web api’lerden konuşalım kısaca.</p><p><strong>Web Api nedir? Neden kullanılır?</strong></p><p>API, Uygulama Programlama Arayüzü’nün kısaltmasıdır. Basit bir ifadeyle, API, birbirinden ayrı iki farklı yazılım bileşeninin belirli tanımlar ve protokoller aracılığıyla iletişim kurmasını sağlayan bir arayüzdür. Bu iki farklı yazılım birimi arasındaki etkileşimi kolaylaştırır.</p><p>Ancak, bir API’nin hizmet verdiği uygulamalar sadece iki bileşenle sınırlı olmayabilir. Hizmet veren API’nin N adet tüketicisi olabilir. Bu durumda, belirli standartlarda hizmet vermek ve yapılan herhangi bir değişiklikten etkilenmeksizin hizmetin devamlılığını sağlamak önemlidir.</p><p>Bu noktada, API versiyonlaması devreye girer. Versiyonlama, tüketicilere hizmet sunma sürecini yönetmenin ve yeni güncellemeleri sorunsuz bir şekilde uygulamanın bir yoludur. En basit haliyle, versiyonlama, değişiklikleri uygulayarak ve yeni özellikleri tanıtarak hizmeti güncel tutma yöntemidir. Bu, hizmet verenin sunduğu hizmetin sürekli geliştirilmesini ve aynı zamanda mevcut tüketicilerin hizmetten etkilenmemesini sağlar. Versiyonlama, API’lerin neden ve nasıl geliştirildiği konusunda önemli bir anahtardır.</p><blockquote>Versiyonlama apilerin farklı sürüm veya versiyonlarının yönetilmesidir.</blockquote><h3>Neden versiyonlama kullanmalıyız</h3><p>Yazılım yaşam döngüsü içinde öngörülerin de bir sınırlılığı vardır. Başlangıçta API tasarlanırken, mümkün olan her senaryoyu düşünmeye çalışabiliriz. Ancak süreç içinde ihtiyaçlar, çıktılar, hata kodları ve iş kuralları gibi varsayımlardan kaynaklanan değişiklikler, farklı bir versiyona geçme ihtiyacını doğurabilir. Yazılım dünyası, değişim kavramının sürekli var olduğu bir ortamdır. SOLID prensipleri içinde yer alan “Open-Closed” prensibi, başlangıçta tasarlanan mimarinin değişikliklere uygun olarak yazılmasını önerir. Ancak, bu derin konuya girmeyeceğim ve Solid prensipleri hakkında daha fazla bilgi almak isteyenler için,<a href="https://medium.com/u/1b0b90211784">Batuhan güngör</a> kaleminden okuyabileceğiniz <a href="https://medium.com/@batgungor/solid-prensipleri-part-1-0cf5ea03aa14">solid-part-1</a> ve <a href="https://medium.com/@batgungor/solid-prensipleri-part-2-fa251515d22b">solid-part-2</a> yazılarını önerebilirim.</p><ol><li><strong>Gelişen İş İhtiyaçları</strong>: Bir web API başlangıçta belirli bir iş ihtiyacını karşılamak üzere tasarlanabilir, ancak iş ihtiyaçları zaman içinde değişebilir. API versiyonlamak, yeni gereksinimlere uyum sağlamak ve iş mantığındaki değişikliklere adapte olmak için esneklik sağlar.</li><li><strong>Müşteri Talepleri ve Geriye Dönük Uyumluluk</strong>: Müşterilerin veya uygulama kullanıcılarının ihtiyaçları da zamanla değişebilir. Web API versiyonlaması, mevcut müşteri tabanının taleplerini karşılamak ve geriye dönük uyumluluk sağlamak amacıyla kullanılır.</li><li><strong>API’yi Kullanan İstemcilerin Çeşitliliği</strong>: Farklı uygulamalar, cihazlar veya istemci türleri, API’yi kullanırken farklı özelliklere veya veri yapılarına ihtiyaç duyabilir. Versiyonlamak, farklı istemcilere uygun API sürümlerini desteklemek için kullanılır.</li><li><strong>Hata Düzeltmeleri ve Güvenlik Güncellemeleri</strong>: API’lerdeki hata düzeltmeleri ve güvenlik güncellemeleri zamanla gerekebilir. Bu tür değişiklikler, mevcut kullanıcılar ve uygulamalar üzerinde olumsuz etkilere yol açabilir. Versiyonlama, bu güncellemeleri uygulamak ve güncellenmiş API’yi kullanmak isteyenlere esneklik sağlar.</li><li><strong>API’nin Genişlemesi ve Yeniden Tasarımı</strong>: API’nin başlangıçta küçük bir hedefle oluşturulması ve zaman içinde genişlemesi durumunda versiyonlama gerekebilir. Ayrıca, API’nin temel tasarımında veya mimarisinde yapılan önemli değişiklikler için versiyonlamaya ihtiyaç duyulabilir.</li><li><strong>Test ve Geliştirme Süreçleri</strong>: Yeni özellikleri test etmek ve geliştirmek isteyen geliştiriciler, mevcut API sürümüne zarar vermeden yeni özellikleri eklemek isteyebilir. Bu durumda versiyonlama, geliştirme süreçlerini daha güvenli ve etkili hale getirir.</li></ol><p>Versiyonlama, API’lerin uzun vadeli sürdürülebilirliği, uyumluluk ve güncelleme ihtiyaçlarına uyum sağlamak için önemli bir stratejidir. Ayrıca, bu yaklaşım, hem API sağlayıcıları hem de kullanıcıları için daha iyi bir deneyim sunar.</p><h3>Versiyonlama için hangi yöntemleri bulunmaktadır?</h3><p>Burada neden ve niçin sorularının ardından versiyonlamayı kullanırken hangi standart ve strateji ile kullanabiliriz bunu inceleyelim.</p><p>Web Api versiyonlama işlemleri için kullanılan stratejiler:</p><ul><li>URL</li><li>Query String</li><li>Header/Media Type</li></ul><p>Versiyonlama stratejilerine geçmeden önce, küçük bir soru ile devam etmek istiyorum. API versiyonlaması yaparken kullanılacak numaralandırma konusunda varsayılan bir versiyon var mıdır? Ayrıca, versiyonlama sürecinde yapılan güncellemeleri hizmet verdiğimiz istemcilere nasıl bildirebiliriz? Bu sorular, kodlarımızı yazarken bu konuları nasıl ele alacağımızı incelememiz için önemlidir.</p><p>Kısa örnekler ile belirtip uygulama üzerinde her tanım parametresini inceleyerek devam edeceğiz. Neyi neden kullanıyoruz sorgulayıcı bakış açısını sürdüreceğiz :)</p><p>Bu stratejilerin her biri için artı ve eksi tarafları bulunmaktadır. Değerlendirilip yerine göre kullanabiliriz.</p><p>Bu yöntemlere ek olarak action seviyesinde de versiyon belirleyebiliriz. Bu işlemi <strong>MapToApiVersion</strong> attribute ile yapılandıracağız.</p><h3><strong>Let’s code</strong></h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/800/0*_zn2bRM8WYOqeZKV.gif" /></figure><h3>Web Api projesi oluşturalım.</h3><p>Uygulamaya Nuget Paket eklentisi yada terminalden bu 2 paketi yükleyelim.</p><pre>dotnet add package Microsoft.AspNetCore.Mvc.Versioning<br>dotnet add package Microsoft.AspNetCore.Mvc.Versioning.ApiExplorer</pre><p><strong>Program.cs</strong> dosyasında <strong>AddApiVersioning</strong> ekleyelim. Bu işlem neticesinde artık uygulamamıza versiyonlama servisi yüklenmiştir.</p><pre>builder.Services.AddApiVersioning();</pre><p>Api uygulamasını ayağa kaldırmaya çalıştırdığımızda bir şeyler ters gitti <strong>“An API version is required, but was not specified”</strong> default version belirtilmediği hatası aldık.</p><pre>{<br>  &quot;error&quot;: {<br>    &quot;code&quot;: &quot;ApiVersionUnspecified&quot;,<br>    &quot;message&quot;: &quot;An API version is required, but was not specified.&quot;,<br>    &quot;innerError&quot;: null<br>  }<br>}</pre><h3>Default Api VersiyonTanımlamları</h3><p><strong>Program.cs</strong> dosyası üzerinde <strong><em>builder.Services</em></strong> ile başlayıp devam eden noktada kod karmaşasını önlemek adına versiyon işlemleri için ayrı bir class ve ayrı bir metot(<strong>AddVersionConfigure</strong>) üzerinden devam edeceğim.</p><pre>public static IServiceCollection AddVersionConfigure(this IServiceCollection services)<br>{<br>  services.AddApiVersioning(opt =&gt;<br>  {<br>      opt.DefaultApiVersion = new ApiVersion(1, 0);<br>      opt.AssumeDefaultVersionWhenUnspecified = true;<br>  });<br>        <br> return services;<br>}</pre><p>Varsayılan api versiyonunu belirliyoruz. <strong>DefaultApiVersion</strong> tanımını yapıp <strong>AssumeDefaultVersionWhenUnspecified</strong> tanımlamasını yapmadan veya <strong><em>false</em></strong> olarak ayarladığımızda yine aynı hata ile karşılaşacağız. Bu durumda true olarak ayarlamanız gerekmektedir. Herhangi bir versiyon belirtilmediği durumda versiyonu 1.0 olarak belirlemiş oluyoruz.</p><pre>AssumeDefaultVersionWhenUnspecified = true;</pre><h3><strong>Desteklenen Sürümlerden Haberdar Etme</strong></h3><p>Peki uygulamızın hangi versiyonda veya versiyonlarda çalıştığını bilgisini istemcilere nasıl haber vereceğiz?</p><pre>ReportApiVersions = true</pre><p><strong>ReportApiVersions </strong>parametresini true olarak belirtiyoruz<strong>. </strong>Controllerda herhangi bir versiyon eklemeden uygulama ayarlarında bu bilginin setlenmesi ile api hangi versiyon veya versiyonlara destek verdiğini eklemiş oluyoruz.</p><pre>public static IServiceCollection AddVersionConfigure(this IServiceCollection services)<br>{<br> services.AddApiVersioning(opt =&gt;<br>  {<br>      opt.DefaultApiVersion = new ApiVersion(1, 0);<br>      opt.AssumeDefaultVersionWhenUnspecified = true;<br>      opt.ReportApiVersions = true;<br>  });<br><br>        <br> return services;<br>}</pre><p>Controller nesnesinde herhangi bir ek versiyon belirtmeden default olarak ayarladığımız versiyon bilgisi Header içerisinde iletmiş oluyoruz.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/702/1*qikMgTZRZTANimjuaQCgbw.png" /><figcaption>ReportApiVersions : Api-Supported-Versions</figcaption></figure><p>Birden fazla versiyon ekleyerek buradaki bilginin nasıl görüntülendiğine bakalım. Article controller <strong>ApiVersion</strong> attribute ile versiyonlari ekleyelim.</p><pre>[ApiController]<br>[Route(&quot;api/[controller]&quot;)]<br>[ApiVersion(&quot;1.0&quot;)]<br>[ApiVersion(&quot;1.1&quot;)]<br>[ApiVersion(&quot;1.2&quot;)]<br>[ApiVersion(&quot;1.3&quot;)]<br>public class ArticleController : ControllerBase<br>{<br>    <br>    [HttpGet]<br>    [Route(&quot;id/{id}&quot;)]<br>    public Task&lt;IResult&gt; GetAsync(string id)<br>    {<br>        var allProducts = MockArticle<br>                         .GetDatabaseExampleModels();<br>        <br>        var response = allProducts<br>                       .FirstOrDefault(c =&gt; c.Id == id);<br><br>        return Task.FromResult(Results.Ok(response));<br>    }<br>    <br>    [HttpGet]<br>    [Route(&quot;list&quot;)]<br>    public Task&lt;IResult&gt; GetListAsync()<br>    {<br>        var allProducts = MockArticle<br>                          .GetDatabaseExampleModels()<br>                          .OrderBy(d=&gt;d.OrderValue);<br><br>        return Task.FromResult(Results.Ok(allProducts));<br>    }<br>}</pre><p><strong>Api-Supported-Versions</strong> ile eklediğimiz ve hizmet verdiğimiz versiyon bilgilerini iletmiş olduk.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/693/1*fR9PFErxhJxx5Z8qGKe6Yw.png" /><figcaption>ReportApiVersions</figcaption></figure><h3>Versiyonlama Stratejileri</h3><p>Api versiyonunu client tarafının okuyabilmesi için farklı yöntemler bulunmaktadır. Bu yöntemleri <strong>ApiVersionReader </strong>özelliği ile belirtiyoruz<strong>. </strong>Bir veya birden fazla yöntemle kullanabileceğimizi söyleyebiliriz konfigürasyonu buna göre yapılandırabiliriz.</p><pre>public static IServiceCollection AddVersionConfigure(this IServiceCollection services)<br>{<br>  services.AddApiVersioning(opt =&gt;<br>  {<br>      opt.DefaultApiVersion = new ApiVersion(1, 0);<br>      opt.AssumeDefaultVersionWhenUnspecified = true;<br>      opt.ReportApiVersions = true;<br>      opt.ApiVersionReader = ApiVersionReader<br>                             .Combine(<br>                               new UrlSegmentApiVersionReader(),<br>                               new QueryStringApiVersionReader(), <br>                               new HeaderApiVersionReader(&quot;x-api-version&quot;),<br>                               new MediaTypeApiVersionReader(&quot;x-api-version&quot;)<br>                                     );<br>  });<br><br>        <br> return services;<br>}</pre><p><strong>1- URL ile versiyon belirleme — UrlSegmentApiVersionReader</strong></p><p>Apinin versiyonu url üzerinde belirtilir. Controller route işlemi ile belirtebiliriz. Bu yöntemde url ile versiyon bilgisi bir bütün şeklindedir. Yeni versiyon hizmete girdiğinde client istek attığı url bilgisini güncellemesi gerekecektir. Bu yöntem kendi içerisinde aslında bir ihlal olarak görülebilir. Versiyon güncellemesinde tüketicinin endpoint bilgisinide değişmesini gerektireceğini unutmamalıyız.<br> <br><strong>[Route(“api/v{version:apiVersion}/[controller]”)]</strong></p><pre>https://webapi.practice.com/api/v1/articles<br>https://webapi.practice.com/api/v2/articles</pre><p><strong>2- Query String ile versiyon belirleme — QueryStringApiVersionReader</strong></p><p>Query parametresi ile versiyon bilgisi iletilir. Url de <strong>api-version=1.0 </strong>şeklinde ayarlanarak istek atıldığında hangi versiyona yönleneceğini anlayabiliriz.</p><pre>https://webapi.practice.com/api/articles?api-version=1.0<br>https://webapi.practice.com/api/articles?api-version=2.0</pre><p><strong>QueryStringApiVersionReader()</strong> default olarak “api-version” parametre ismi ile gelmektedir. Bunu istediğimiz zaman özelleştirebiliriz.</p><blockquote>QueryStringApiVersionReader(“my-api-version-key”)</blockquote><p>QueryString versiyonlama Url versiyonlama işlemine nazaran daha esnek görünmektedir. Url olarak tek bir url bilgisi kullanmaktadır.</p><p><strong>3- Header/Media Type ile versiyon belirleme — HeaderApiVersionReader</strong></p><p>Header da gönderilen parametre ile versiyon belirtilir. Burada da yine aynı şekilde kendi belirleyeceğimiz key değeri ile api versiyon bilgisini alabiliriz. Bu yöntem ile url bilgisinin v1,v2 versiyonlama url değişimi ve query string karışıklığınında önüne geçmektedir.</p><pre>GET /articles HTTP/1.1<br>Host: webapi.practice.com<br>Accept: application/json<br>Api-Version: 1.0</pre><pre>GET /articles HTTP/1.1<br>Host: webapi.practice.com<br>Accept: application/json<br>Api-Version: 2.0</pre><p>Yine aynı şekilde konfigürasyon ile bu <strong>api-version</strong> anahtarı yerine geçecek farklı bir anahtar ile de versiyon bilgisini kullanabiliriz.</p><blockquote>new HeaderApiVersionReader(“my-api-version-key”),<br> new MediaTypeApiVersionReader(“my-api-version-key”))</blockquote><p><strong><em>MediaTypeApiVersionReader </em></strong>kısmı ise yine header da gönderilen <em>Content-Type</em> veya <em>Accept</em> parametresinin içerisinde de <strong>x-api-version</strong> değerini gönderilerek versiyon bilgisine ulaşılabilir uygulama istenilen versiyonda çalışacaktır</p><pre>      URL -&gt; https://webapi.practice.com/api/v1/metod<br>   Header -&gt; x-api-version:1.0<br>MediaType -&gt; Accept/Content-Type: application/json; x-api-version=1.0</pre><p>Bu stratejilerin her biri için artı ve eksi tarafları bulunmaktadır. Değerlendirilip yerine göre kullanabiliriz.</p><h3>Swagger ile Asp.Net Core Api Versiyon Konfigürasyonu</h3><p>Swagger entegrasyonu için ufak dokunuşlar yapacağız. <strong>AddVersionedApiExplorer</strong> metodunu konfigürasyonunu yapalım.</p><pre>services.AddVersionedApiExplorer(setup =&gt;<br>{<br>    setup.GroupNameFormat = &quot;&#39;v&#39;VVV&quot;;<br>    setup.SubstituteApiVersionInUrl = true;<br>});</pre><p>GroupNameFormat: Versiyonlama için apilerin grup isim formatını belirtir. &#39;v&#39;VVV formatı kullanılarak grup isimleri &quot;v&quot; öneki ile versiyon numarasını içerecek şekilde oluşturulur.</p><blockquote>Burada ‘v’VVV olarak tanımlayıp proje içerisinde farklı isimlendirme ile klasör oluşturduğumuzda ve çalıştırmak istediğimizde hata alıyor olacağız.</blockquote><p>Ek olarak buradaki grup isim tanımını biraz özelleştirebiliriz.<br>setup.GroupNameFormat = “‘v’VVV” =&gt;&gt; “‘adem-api-version-v’VVV”</p><p>Url route değişmeyecektir sadece swagger UI tarafında bu şekilde görüntülenecektir.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/747/1*Iz_n-Yl_72641cFXFt4nCA.png" /></figure><p>SubstituteApiVersionInUrl: API versiyonunu URL&#39;de otomatik olarak yerine koyacak şekilde ayarlanır. Örneğin, /api/v1/article gibi bir URL oluşturulmasını sağlar.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/967/1*h6Lqs-26gHpd27_-pBafQA.png" /></figure><p>Bu makalede dikkati çekmek istediğim nokta versiyon işlemi, swagger ile daha fazla yazıyı uzatmak istemediğim için detay giremiyorum. Swagger entegrasyon detayları için projeyi <a href="https://github.com/ademolguner/ApiVersioning.git">buradan</a> indirip inceleyebilirsiniz.</p><p>Bu yazınında sonuna geldik, asıl amaç sorgulama ve cevap bulmaya çalışmak bu alışkanlığı önce kendimde sonra siz değerli okuyuculara pratik etmeye çalışıyorum. Umarım faydalı olmuştur.</p><p>Farklı bir yazıda görüşmek dileği ile.</p><p>Saygı ve sevgilerimle <br>Adem OLGUNER</p><p><a href="https://github.com/ademolguner/ApiVersioning.git">GitHub - ademolguner/ApiVersioning</a></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=ba3581e96d1e" width="1" height="1" alt=""><hr><p><a href="https://medium.com/devopsturkiye/asp-net-core-web-api-versiyonlama-ve-swagger-entegrasyonu-ba3581e96d1e">Asp.Net Core Web Api Versiyonlama ve Swagger Entegrasyonu</a> was originally published in <a href="https://medium.com/devopsturkiye">Devops &amp; AI Türkiye☁️ 🐧 🐳 ☸️</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Hata Yönetimini Result Pattern ile Yönetmek]]></title>
            <link>https://medium.com/devopsturkiye/hata-y%C3%B6netimini-result-pattern-ile-y%C3%B6netmek-c1dc3918c513?source=rss-a068d8b0ac3------2</link>
            <guid isPermaLink="false">https://medium.com/p/c1dc3918c513</guid>
            <category><![CDATA[result-pattern]]></category>
            <category><![CDATA[middleware]]></category>
            <category><![CDATA[net-core]]></category>
            <category><![CDATA[exception-handling]]></category>
            <category><![CDATA[error-handling]]></category>
            <dc:creator><![CDATA[Adem Olguner]]></dc:creator>
            <pubDate>Mon, 08 Jan 2024 20:42:29 GMT</pubDate>
            <atom:updated>2024-01-09T07:08:36.839Z</atom:updated>
            <content:encoded><![CDATA[<p><strong>Gel Ne Olursan Ol Yine Gel</strong>, ister <em>NotFoundException</em>, ister <em>AlreadyException</em> isterse <em>InvalidOperationException</em> bizim yolumuz <strong>Result Pattern </strong>:)</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/316/1*42tFsfiyceo6Tpz2ZXQxGQ.png" /></figure><p>Mizahın en güçlü yanı güçsüz olmamasıdır :)</p><p>Kendi adıma öğrenme stratejisi olarak öğrendiklerimi daha hatırlanabilir kılmak için kullanıyor olabilirim bilmiyorum <strong>Result</strong>’ta göreceğiz…</p><p>Geliştirdiğimiz veya tasarladığımız tüm projelerde yada çözümlemeye çalıştığımız iş kuralları değişkenlik gösterse de alışılagelmiş hata yönetim metotlarını kullanıyoruz. Çoğu zaman projelerdeki hataları nasıl ele alırız sorusunu sormuyor ezbere olanı kullanıyoruz.</p><blockquote><strong><em>Kodumuzda ki hataları nasıl ele alıyoruz?</em></strong></blockquote><p>Bu sorunun tabiki tek bir çözümü veya tek bir cevabı yok, farklı yöntemler kullanabiliyoruz. Kod blokları içerisinde hata ile karşılaşır karşılaşmaz bir istisna (exception) fırlatıyoruz. Peki bu oluşturduğumuz veya fırlatılan istisnalar tahmin edilebilir mi? , edilemez mi? sorusunu soruyor muyuz? Gelin bu soruyu sorarak devam edelim.</p><p>İstisnaları 2 kategoriye ayırabiliriz. <br>- <em>Tahmin edilebilir</em> istisnalar (exception)<br>- <em>Tahmin edilemeyen</em> istisnalar (exception)</p><p>Bu durumda tahmin edebildiğimiz istisnalar için anlamlı, anlaşılabilir ve daha okunabilir şekilde ifade edebiliriz. Bu tarz durumlar için <strong>Result Pattern’i</strong> işlevsel bir şekilde kullanabiliriz. Bu pattern içinde negatif yanlarının bulunduğunu söyleyebilir. <strong>İşlemin başarısız olup olmadığını sorgulaması gerekmektedir</strong>. Yani iş kuralı işletildiğinde bir istisna olsa da olmasa da response kontrol eden tarafın result modelin sorgulanması gerekmektedir.</p><h3>Result Pattern</h3><p>Response modelimizi oluşturalım. Ben buna <strong>GenericResult</strong> olarak tanımlayacağım (keyfe keder bir tanımlama) siz istediğiniz bir isimlendirme ile tanımlayabilirsiniz.</p><p><strong>GenericResult&lt;T&gt;</strong> generic modelin belirlenmesi.</p><pre>using System.Net;<br>using System.Text.Json.Serialization;<br>using Microsoft.AspNetCore.Mvc;<br><br>namespace ExceptionHandlingWithResultPattern.Framework.ResultPattern;<br><br>public class GenericResult&lt;T&gt; where T: class, new()<br>{<br>    private GenericResult() : this(true)<br>    { }<br><br>    private GenericResult(bool isSuccess)<br>    { IsSuccess = isSuccess; if (!isSuccess) {Data = null;} }<br><br>    <br>    [JsonPropertyName(&quot;IsSuccess&quot;)] <br>    public bool IsSuccess { get; init; }<br>    <br>    [JsonPropertyName(&quot;Data&quot;)] <br>    public T Data { get; private init; } = new();<br>    <br>    [JsonPropertyName(&quot;ProblemDetails&quot;)] <br>    public ProblemDetails ProblemDetails { get; private init; } = new();<br>  <br>    <br>    public static GenericResult&lt;T&gt; Success(T data)<br>    {<br>        return new GenericResult&lt;T&gt;(true)<br>        {<br>            Data = data<br>        };<br>    }<br><br>    public static GenericResult&lt;T&gt; Fail(string message)<br>    {<br>        return new GenericResult&lt;T&gt;(false)<br>        {<br>            ProblemDetails = new ProblemDetails<br>            {<br>                Status = (int) HttpStatusCode.BadRequest,<br>                Title = &quot;Operation Error&quot;,<br>                Detail = message<br>            }<br>        };<br>    }<br>    <br>    public static GenericResult&lt;T&gt; Exception(ProblemDetails problemDetails)<br>    {<br>        return new GenericResult&lt;T&gt;(false)<br>        {<br>            ProblemDetails = problemDetails<br>        };<br>    }<br>}</pre><p>GenericResult model aslında bir <strong><em>isSuccess</em></strong>, <strong><em>T</em></strong> tipinde <em>generic model</em> ve exceptional durum için <strong><em>ProblemDetails</em></strong> parametreleri olacaktır.</p><p>GenericResult <strong>Success</strong> ve <strong>Exception</strong> adında 2 adet metot barındırmaktadır.</p><p><strong>* Success</strong> olan metot herhangi bir istisna olmadığı durumda geri dönecek objenin modeline göre dinamik parametreleri bulunacaktır.</p><p><strong>* Exception</strong> metodunu ise kod içerisinde değil <em>ExceptionHandling — OnException</em> durumunda biz handle edeceğiz.</p><h3><strong>Tahmin edilebilir istisnaların tanımlanması</strong></h3><p><strong>System.Exception</strong> sınıfından türeyen özel istisna sınıflarının tanımlamalarını yapacağız ve her istisna türü kendine ait bir mesaj ile son kullanıcıya anlamlı geri dönüş sağlayacaktır.</p><p><strong>CustomBaseException</strong> adında bir istisna sınıfı oluşturup belli başlı parametrelerin tanımlamasını yapalım.</p><pre>public abstract class CustomBaseException : Exception<br>{<br>  public virtual string MessageFormat { get;}<br>  public virtual string Title  { get; }<br>  public virtual HttpStatusCode StatusCode  { get; }<br>  public virtual Dictionary&lt;string, string&gt; MessageProps {get; set;}=new();<br>}</pre><p><strong>CustomBaseException </strong>sınıfından türeyen<strong> t</strong>ahmin edilebilir istisnalar için özel istisna sınıfları oluşturalım.</p><p><strong><em>AlreadyExistException</em></strong></p><pre>public sealed class AlreadyExistException : CustomBaseException<br>{<br>    public override string MessageFormat =&gt;  &quot;{propName} : &#39;{propValue}&#39; ile bir {objectName} kaydı mevcut.&quot;;<br>    public override string Title =&gt; &quot;Already Exist Error&quot;;<br>    public override HttpStatusCode StatusCode =&gt; HttpStatusCode.BadRequest;<br><br>   <br>    public AlreadyExistException(string propName, string propValue, string objectName): base()<br>    {<br>        MessageProps.Add(&quot;{propName}&quot;, propName);<br>        MessageProps.Add(&quot;{propValue}&quot;, propValue);<br>        MessageProps.Add(&quot;{objectName}&quot;, objectName);<br>    }<br>}</pre><p><strong><em>ClientSideException</em></strong></p><pre>public sealed class ClientSideException : CustomBaseException<br>{<br>    public override string MessageFormat =&gt; &quot;Client : {clientName} - {processName} işlemi sırasında bir hata oluştu.&quot;;<br>    public override string Title =&gt; &quot;Client Side Error&quot;;<br>    public override HttpStatusCode StatusCode =&gt; HttpStatusCode.InternalServerError;<br><br>    public ClientSideException(string clientName, string processName) : base()<br>    {<br>        MessageProps.Add(&quot;{clientName}&quot;, clientName);<br>        MessageProps.Add(&quot;{processName}&quot;, processName);<br>    }<br>}</pre><p><strong><em>InvalidParameterException</em></strong></p><pre>public sealed class InvalidParameterException : CustomBaseException<br>{<br>    public override string MessageFormat =&gt; &quot;Geçersiz parametre. {fieldName} : {fieldValue}&quot;;<br>    public override string Title =&gt; &quot;Invalid Parameter Error&quot;;<br>    public override HttpStatusCode StatusCode =&gt; HttpStatusCode.BadRequest;<br><br>    public InvalidParameterException(string fieldName, string fieldValue) : base()<br>    {<br>        MessageProps.Add(&quot;{fieldName}&quot;, fieldName);<br>        MessageProps.Add(&quot;{fieldValue}&quot;, fieldValue);<br>    }<br>}</pre><p><strong><em>NotFoundException</em></strong></p><pre>public sealed class NotFoundException : CustomBaseException<br>{<br>    public override string MessageFormat =&gt; &quot;{objectName} Kayıt bulunamadı. {propertyName}: &#39;{propertyValue}&#39;&quot;;<br>    public override string Title =&gt; &quot;Not Found Error&quot;;<br>    public override HttpStatusCode StatusCode =&gt; HttpStatusCode.BadRequest;<br><br>    public NotFoundException(string objectName, string propertyName, string propertyValue) : base()<br>    {<br>        MessageProps.Add(&quot;{objectName}&quot;, objectName);<br>        MessageProps.Add(&quot;{propertyName}&quot;, propertyName);<br>        MessageProps.Add(&quot;{propertyValue}&quot;, propertyValue);<br>    }<br>}</pre><p>…</p><p>Tahmin edilebilir istisna sınıflarını bu şekilde özel <strong>StatusCode</strong>, <strong>Title</strong> ve <strong>MessageFormat</strong> parametreleri ile tanımlama yapabiliriz. Bu standartta farklı Tahmin edilebilir istisnalar tanımlayabiliriz.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/386/1*UwfG8P3bU0XcMGqjz2RTbw.png" /></figure><h3><strong>Error Handling</strong></h3><p>Şimdi sıra geldi hata yönetimini Result Pattern ile tamamlamak adımına. Kendi <strong>middleware’imizi</strong> (<em>ExceptionHandlingMiddleware</em>) yazmaya başlayalım. Burada yöntem olarak ister middleware yazarak isterse <strong>filter attribute (exception filter) </strong>yazabilir veya farklı bir yöntemde kullanılabilir<strong>.</strong></p><pre>using System.Net;<br>using System.Text.Json;<br>using ExceptionHandlingWithResultPattern.Framework.Exceptions.Base;<br>using ExceptionHandlingWithResultPattern.Framework.Exceptions.Validation;<br>using ExceptionHandlingWithResultPattern.Framework.ResultPattern;<br>using Microsoft.AspNetCore.Http;<br>using Microsoft.AspNetCore.Mvc;<br>using Microsoft.Extensions.Logging;<br><br>namespace ExceptionHandlingWithResultPattern.Framework;<br><br>public class ExceptionHandlingMiddleware(RequestDelegate next, ILogger&lt;ExceptionHandlingMiddleware&gt; logger)<br>{<br>    private const string UnexpectedErrorMessage = &quot;Beklenmeyen bir hata ile karşılaşıldı.&quot;;<br>    <br>    public async Task InvokeAsync(HttpContext context)<br>    {<br>        context.Response.ContentType = &quot;application/json&quot;;<br>        <br>        try<br>        {<br>            await next(context);<br>        }<br>        catch (Exception exception)<br>        {<br>            var messages = new List&lt;string&gt;();<br>            var statusCode = (int)HttpStatusCode.InternalServerError;<br>            var title = &quot;Server error&quot;;<br>            <br>            switch (exception)<br>            {<br>                case ArgumentValidationException validationExp:<br>                 {   <br>                    statusCode = (int)ArgumentValidationException.StatusCode;<br>                    title = &quot;Validation Error&quot;;<br>                    messages.AddRange(validationExp.MessageProps);<br>                    break;<br>                 }<br>              case CustomBaseException customBaseException:<br>                {<br>                    statusCode = (int)customBaseException.StatusCode;<br>                    title = customBaseException.Title;<br>                <br>                    var responseExMessage = customBaseException.MessageFormat;<br>                    foreach (var (key, value) in customBaseException.MessageProps)<br>                        responseExMessage = responseExMessage.Replace(key, value);<br>                <br>                    messages.Add(responseExMessage);<br>                    break;<br>                }<br>                default:<br>                    messages.Add(UnexpectedErrorMessage);<br>                    break;<br>            }<br><br>            var problemDetails = new ProblemDetails<br>            { <br>                Status = statusCode,<br>                Title = title,<br>                Detail = string.Join(Environment.NewLine,messages.ToArray())<br>            };<br>            <br>            logger.LogError(&quot;Exception Detail {@Exception-Status} - {@Exception-Title} - {@Exception-Detail} - {@Context-Path}&quot;,<br>                problemDetails.Status,<br>                problemDetails.Title,<br>                problemDetails.Detail,<br>                context.Request.Path.Value);<br>            <br>            var responseResult = JsonSerializer.Serialize(GenericResult&lt;GenericResponse&gt;.Exception(problemDetails));<br>            await context.Response.WriteAsync(responseResult);<br>        }<br>    }<br>}<br>            </pre><p>Burada middleware hata almadığı sürece <strong>await next(context);</strong> ile hayatını sürdürecektir. Hat alma durumunda catch’e (catch (Exception exception)) düştüğünde oluşan exception eğer bizim tanımladığımız istisnalardan biri ise burada istisnayı yakalayıp response model için işlemleri yapıyoruz.</p><blockquote>-case <strong>ArgumentValidationException</strong> validationExp:<br>-case <strong>CustomBaseException</strong> customBaseException:<br>-case <strong>default</strong> tahmin edilemeyen exception types</blockquote><pre>switch (exception)<br>   {<br>     case ArgumentValidationException validationExp:<br>           ......<br>           break;<br>      case CustomBaseException customBaseException:<br>            ......<br>            break;<br>      default:<br>            ......<br>            break;<br>   }</pre><h3>Custom Exception Kullanımı</h3><p>Bir Web Api projesi oluşturup endpoint ekleyelim.</p><blockquote>Ben burada minimal api olarak tasarladım normal bir Controller olarakta tasarlayıp devam edebilirsiniz</blockquote><pre>var app = builder.Build();<br>app.RegistrationEndpoints();</pre><pre> public static IEndpointRouteBuilder RegistrationEndpoints(this IEndpointRouteBuilder app)<br>    {<br>        app.MapControllers();<br>        app.MapExceptionEndpoints();<br>        return app;<br>    }</pre><pre>public static class ErrorHandlingController<br>{<br>    public static void MapExceptionEndpoints(this IEndpointRouteBuilder app)<br>    {<br>        var appGroup = app.MapGroup(&quot;api/exception-handling-with-result-pattern&quot;);<br>        appGroup.MapPost(&quot;/already-exception&quot;, AlreadyAsync).WithName(nameof(AlreadyAsync));<br>        appGroup.MapPost(&quot;/invalid-parameter-exception&quot;, InvalidParameterAsync).WithName(nameof(InvalidParameterAsync));<br>        appGroup.MapPost(&quot;/create-operation-exception&quot;, CreateOperationAsync).WithName(nameof(CreateOperationAsync));<br>        appGroup.MapPost(&quot;/not-found-exception&quot;, NotFoundAsync).WithName(nameof(NotFoundAsync));<br>        appGroup.MapPost(&quot;/update-operation-exception&quot;, UpdateOperationAsync).WithName(nameof(UpdateOperationAsync));<br>        appGroup.MapPost(&quot;/fail&quot;, FailAsync).WithName(nameof(FailAsync));<br>        appGroup.MapPost(&quot;/success&quot;, SuccessAsync).WithName(nameof(SuccessAsync));<br>    }<br>    <br>    [HttpPost(&quot;error/already-exception&quot;)]<br>    private static async Task&lt;IResult&gt; AlreadyAsync([FromBody] AlreadyRequest request,IMediator sender)<br>    {<br>        var response = await sender.Send(new AlreadyResponseCommand(request.UserId,request.Name));<br>        return Results.Ok(response);<br>    }<br>    <br>    [HttpPost(&quot;error/invalid-parameter-exception&quot;)]<br>    private static async  Task&lt;IResult&gt; InvalidParameterAsync([FromBody] InvalidRequest request,IMediator sender)<br>    {<br>        var response = await sender.Send(new InvalidParameterResponseCommand(request.UserId,request.Name));<br>        return Results.Ok(response);<br>    }<br>   <br>    ...<br>}</pre><h3>Örnek istisna fırlatma:</h3><pre><br>using ExceptionHandlingWithResultPattern.Api.Data;<br>using ExceptionHandlingWithResultPattern.Api.Models.Responses;<br>using ExceptionHandlingWithResultPattern.Framework.Exceptions;<br>using ExceptionHandlingWithResultPattern.Framework.ResultPattern;<br>using MediatR;<br><br>namespace ExceptionHandlingWithResultPattern.Api.Features.ResultPatterns.Already;<br><br>public class AlreadyResponseCommandHandler:IRequestHandler&lt;AlreadyResponseCommand,GenericResult&lt;ResponseModelDto&gt;&gt;<br>{<br>    public async Task&lt;GenericResult&lt;ResponseModelDto&gt;&gt; Handle(AlreadyResponseCommand command, CancellationToken cancellationToken)<br>    {<br>       var mockDataModels = MockDataModel.GetDatabaseExampleModels();<br>       if (mockDataModels.Any(c =&gt; c.Name == command.Name))<br>           throw new AlreadyExistException(nameof(AlreadyResponseCommand.Name),<br>                                           command.Name, <br>                                           nameof(MockDataModel));<br><br>      return ...<br>    }<br>}</pre><p>Bu örnekleme ile diğer exception kullanımlarını inceleyebilirsiniz.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*qBqGjCQQJ3HD9pnflkTC-w.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/995/1*TXTopI5x14ubwCWgJPTX2g.png" /><figcaption>Response</figcaption></figure><p>Hata alma durumunda response incelendiğinde <strong>GenericResult</strong> model olarak belirlediğimiz model ile response düzenlenmiş görünüyor.</p><p>Gelin şimdi de success alan bir response model inceleyelim.</p><h3>GenericResult&lt;T&gt; Kullanımı</h3><p>Bu aşamada iş kuralı sonucu dönen response modeli GenericResult tipinde ayarlayıp dönüş sağlayacağız. Burada GenericResult tipinde dönüşü ister servis tarafında ister handler isterse controller tarafında ayarlayarak dönebiliriz bu tamamen kullanıma bağlı olarak değişkenlik gösterebilir.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*IktjcBLO0IbeQDFVAzba2Q.png" /><figcaption>Request</figcaption></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*kXA4TGzVyPeqCdt9xs-XoQ.png" /><figcaption>Response</figcaption></figure><p>Handler sınıfında ayarlanan <strong>GenericResult</strong> <em>Success</em> işlemi</p><pre>public async class SuccessResponseCommandHandler:IRequestHandler&lt;SuccessResponseCommand,GenericResult&lt;ResponseModelDto&gt;&gt;<br>{<br>    public async Task&lt;GenericResult&lt;ResponseModelDto&gt;&gt; Handle(SuccessResponseCommand command, CancellationToken cancellationToken)<br>    {<br>        return GenericResult&lt;ResponseModelDto&gt;.Success(new ResponseModelDto(command.UserId,command.Name));<br>    }<br>}</pre><p><strong>GenericResult </strong>içerisinde <strong>Success</strong>, <strong>Exception</strong> ve <strong>Fail</strong> olarak tanımladığımız 3 metot bulunmaktadır. Exception almayan durumlar için Success kullandık. ExceptionHandlingMiddleware tarafında Exception metodunu kullandık peki bu <strong>Fail</strong> metodunu nerede kullanacağız.</p><p>Burası aslında biraz yoruma açık bir durum, ben örneklendirme olarak ekledim ancak bu durumda bir Exception olarak tasarlanabilir veya farklı bir şekilde düşünülebilir. Fail işlemi aslında bir info-warning gibi kullanmayı düşünerek oluşturdum.. İş kuralları içerisinde exceptiona denk gelmeyen, success olmayan, validation exception (fluent validation) olmadığı durumların dışında responsu anlamlı bir hale dönüştürmek için kullanılabilir. (Olmasada olur)</p><pre>public class FailResponseQueryHandler:IRequestHandler&lt;FailResponseQuery,GenericResult&lt;ResponseModelDto&gt;&gt;<br>{<br>    public async Task&lt;GenericResult&lt;ResponseModelDto&gt;&gt; Handle(FailResponseQuery request, CancellationToken cancellationToken)<br>    {<br>        var mockDataModels = MockDataModel.GetDatabaseExampleModels();<br><br>        var mockItem = mockDataModels.FirstOrDefault(c =&gt; c.UserId.Equals(request.UserId));<br>        if (mockItem is null)<br>            throw new NotFoundException(nameof(MockDataModel), nameof(MockDataModel.UserId),request.UserId);<br><br>        if (mockItem.Name != request.Name)<br>            return GenericResult&lt;ResponseModelDto&gt;.Fail($&quot;Girdiğiniz Name : {request.Name} alanı ile modele ait Name : {mockItem.Name} alanı eşleşmiyor.&quot;);<br>          <br>        return GenericResult&lt;ResponseModelDto&gt;.Success(new ResponseModelDto{UserId = request.UserId, Name = request.Name});<br>    }<br>}</pre><p>ExceptionHandlingMiddleware içinde <strong>validationException</strong> tipinde tahmin edilebilir bir istisna olarak görebileceğimiz <strong>ArgumentValidationException</strong> olarak tanımlanan başka bir istisna tipi bulunmaktadır. Bunu kullanmak için FluentValidation ile request-command işlemlerinde validator kullanarak yapabiliriz.</p><p><strong>ValidationBehavior</strong> tanımlayalım.</p><pre>public class ValidationBehavior&lt;TRequest, TResponse&gt;(IEnumerable&lt;IValidator&lt;TRequest&gt;&gt; validators) <br>             : IPipelineBehavior&lt;TRequest, TResponse&gt;<br>    where TRequest : IRequest&lt;TResponse&gt;<br>{<br>    public Task&lt;TResponse&gt; Handle(TRequest request, <br>                                  RequestHandlerDelegate&lt;TResponse&gt; next, <br>                                  CancellationToken cancellationToken)<br>    {<br>        var context = new ValidationContext&lt;TRequest&gt;(request);<br>        var failures = validators<br>            .Select(x =&gt; x.Validate(context))<br>            .SelectMany(x =&gt; x.Errors)<br>            .Where(x =&gt; x != null)<br>            .ToList();<br><br>        if (failures.Count == 0)<br>            return next();<br><br>        throw new ArgumentValidationException(<br>                   failures.Select(failure =&gt; failure.ErrorMessage)<br>                           .ToList());<br>    }<br>}</pre><p>Farklı bir endpoint yazalım ve validator sınıfını oluşturalım. UserId guid tipinde olduğu bir adet type ve bir adet te null check validasyonu ekleyelim.</p><pre>public class ValidateErrorResponseCommandValidator: AbstractValidator&lt;ValidateErrorResponseCommand&gt;<br>{<br>    public ValidateErrorResponseCommandValidator()<br>    {<br>        var nullOrEmptyMsg = ValidationConsts.NullOrEmpty_Validation;<br>        var guidRegexMsg = ValidationConsts.GuidRegex_Validation;<br><br>        <br>        RuleFor(x =&gt; x.UserId)<br>            .Cascade(CascadeMode.Stop)<br>            .NotEmpty()<br>            .WithMessage(nullOrEmptyMsg.Replace(ValidationConsts.FieldName, nameof(ValidateErrorResponseCommand.UserId)));<br>        <br>        RuleFor(x =&gt; x.UserId)<br>            .Cascade(CascadeMode.Stop)<br>            .Matches(ValidationConsts.GuidRegex)<br>            .WithMessage(guidRegexMsg.Replace(ValidationConsts.FieldName, nameof(ValidateErrorResponseCommand.UserId)));<br>        <br>        RuleFor(x =&gt; x.Name)<br>            .Cascade(CascadeMode.Stop)<br>            .NotEmpty()<br>            .WithMessage(nullOrEmptyMsg.Replace(ValidationConsts.FieldName, nameof(ValidateErrorResponseCommand.Name)));<br><br>    }<br>}</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*JiY0aA-lqVVz8BwH4lbMiw.png" /><figcaption>Request</figcaption></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*YtDvuHIZbjvkqRsWWPo_Tw.png" /><figcaption>Response</figcaption></figure><p>Kısaca bir bakış açısı olması için karalamış olduğum bu yazı ile alakalı kodlarını <a href="https://github.com/ademolguner/ExceptionHandlingWithResultPattern">buradan</a> erişebilirsiniz.</p><p>Farklı bir konu ile görüşmek dileğiyle. Umarım faydalı olmuştur.</p><p><a href="https://github.com/ademolguner/ExceptionHandlingWithResultPattern">GitHub - ademolguner/ExceptionHandlingWithResultPattern</a></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=c1dc3918c513" width="1" height="1" alt=""><hr><p><a href="https://medium.com/devopsturkiye/hata-y%C3%B6netimini-result-pattern-ile-y%C3%B6netmek-c1dc3918c513">Hata Yönetimini Result Pattern ile Yönetmek</a> was originally published in <a href="https://medium.com/devopsturkiye">Devops &amp; AI Türkiye☁️ 🐧 🐳 ☸️</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[.Net Core’da Serilog İle ElasticSearch Sink ve Kibana Field Özelleştirmesi-3]]></title>
            <link>https://medium.com/devopsturkiye/net-coreda-serilog-i%CC%87le-elasticsearch-sink-ve-kibana-field-%C3%B6zelle%C5%9Ftirmesi-3-40399c904b5d?source=rss-a068d8b0ac3------2</link>
            <guid isPermaLink="false">https://medium.com/p/40399c904b5d</guid>
            <category><![CDATA[logging]]></category>
            <category><![CDATA[serilog]]></category>
            <category><![CDATA[net-core]]></category>
            <category><![CDATA[kibana]]></category>
            <category><![CDATA[elasticsearch]]></category>
            <dc:creator><![CDATA[Adem Olguner]]></dc:creator>
            <pubDate>Fri, 09 Dec 2022 14:30:04 GMT</pubDate>
            <atom:updated>2022-12-11T08:25:41.897Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*2hQwNtSs1y6wiqH1-ucGDQ.png" /></figure><p>Bu makale serinin 4.cü yazısıdır. Seriye ait diğer yazıları okumak için altta bulunan linklerden diğer yazılara erişim sağlayabilirsiniz.</p><p>1- <a href="https://medium.com/@ademolguner/net-coreda-serilog-i%CC%87le-elasticsearch-sink-ve-kibana-field-%C3%B6zelle%C5%9Ftirmesi-1-e13020d54475">Docker Ortamlarının ayarlanması</a><br><strong>2- </strong><a href="https://medium.com/@ademolguner/net-coreda-serilog-i%CC%87le-elasticsearch-sink-%C3%B6zelle%C5%9Ftirmesi-2-368a49957a6e">Serilog Entegrasyonu ve Konfigürasyonu</a><br>3- <a href="https://medium.com/devopsturkiye/net-core-3-0-elasticsearch-kurulum-konfig%C3%BCrasyon-ve-sorgulama-3dc81e4fcc72">ElasticSearch Detaylı Kullanım</a><br>4-<strong> Kibana ve Loglama için Custom Field oluşturma ve Kibana ortamlarında sorgulama</strong></p><h3>Kibana</h3><p>ELK yığını nasıl çalışır? <strong>Logstash</strong>, verileri alır, dönüştürür ve doğru hedefe gönderir. <strong>Elasticsearch</strong>, alınan verileri dizinler, analiz eder ve bunlarda arama yapar. <strong>Kibana</strong>, analizin sonuçlarını görselleştirir.</p><p><em>Kibana</em> toplanıp anlamlı hale gelen verinin, analizini yaptıktan sonra ki görselleştirme işlemini yapar.</p><p>Kibana özelleştirmesi yapılmadan önce:</p><p>1- Management =&gt; Stack Management menüsüne gelelim.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*c00uzQw0j76rg8-QJcmEgQ.png" /></figure><p>2- Kibana altinda Index Pattern alanına tıklayalım</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*YpBvKGdXdwyJgepPHXxSjQ.png" /></figure><p>Herhangi bir log olmadığı için ELK tarafında bir index oluşmadı. Projeyi çalıştırıp herhangi bir endpointi çağırdığımızda logları Elasticsearch’e yazmış olacağız.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*SBpsE2QnBwQ4-LnkMbcbeA.png" /></figure><p>Sistemde artık loglarımızın olduğunu anlıyoruz. Şimdi bir index pattern oluşturalım.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*2onB67vJvq5SuyTA6kzbNg.png" /></figure><p>Logların Elasticseach’e akmasından sonra bir <strong>index pattern</strong> belirleyebiliriz. Aslında kod tarafında bu patterni oluşturduk ancak farklı patternler ile de bu logların ayrıştırılmasını istersek parklı patternler uygulayabiliriz.</p><pre>IndexFormat = $&quot;{applicationName.ToLower()}-{DateTime.UtcNow:yyyy-MM}&quot;,</pre><p>Ben de bu pattern’deki bir index’i ekleyip sonraki adıma geçiyorum.</p><p>Solution içerisinde sadece bir api projemiz mevcut. Örneğin bir background job projesi daha ekledik bu durumda:</p><p>var olan api projesi index<br><strong> serilogelastickibana.api-yyyy-MM</strong><br>yeni eklenen backgroundjob<br> <strong>serilogelastickibana.backgroundjob-yyyy-MM</strong></p><p>bu şekilde birbirinden farklı indexler oluşturmak için pattern oluşturarak bu ayrımı yapabiliriz.</p><p><strong>serilogelastickibana.-*</strong> bu şekilde index pattern name verildiğinde farklı projelerdeki farklı loglar farklı indexlerde toplanmış olacaktır.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*TW9QIyLBajIJ20FsDgexLQ.png" /></figure><p>Burada timestamp de ekledikten ve Create index pattern dedikten sonra index’imiz hazır:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*H9hHMMcH1pkc-I_nrD84mw.png" /></figure><p>Son olarak bu index için yazdığımız loglara bir bakalım:</p><iframe src="https://cdn.embedly.com/widgets/media.html?src=https%3A%2F%2Fwww.youtube.com%2Fembed%2FA7YcozYyhSk&amp;display_name=YouTube&amp;url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DA7YcozYyhSk&amp;image=http%3A%2F%2Fi.ytimg.com%2Fvi%2FA7YcozYyhSk%2Fhqdefault.jpg&amp;key=a19fcc184b9711e1b4764040d3dc5c07&amp;type=text%2Fhtml&amp;schema=youtube" width="854" height="480" frameborder="0" scrolling="no"><a href="https://medium.com/media/b33e79c4d41819bfd0d3bf346843b082/href">https://medium.com/media/b33e79c4d41819bfd0d3bf346843b082/href</a></iframe><p><strong>SerilogExtension</strong> static clasıı içerisinde <strong><em>UseSerilog</em></strong> adında bir metot oluşturalım ve <strong>Program.cs</strong> içerisinden çağıralım.</p><p><strong>Program.cs</strong></p><pre>var app = builder.Build();<br>app.UseSerilog();</pre><p><strong>SerilogExtension.cs</strong></p><pre><br>public static WebApplication UseSerilog(this WebApplication app)<br>{<br>   app.UseMiddleware&lt;ErrorHandlingMiddleware&gt;();<br>   app.UseSerilogRequestLogging(opts =&gt; { opts.EnrichDiagnosticContext = EnrichFromRequest; });<br>   return app;<br>}<br><br>private static void EnrichFromRequest(IDiagnosticContext diagnosticContext, HttpContext httpContext)<br>{<br>  diagnosticContext.Set(&quot;CustomField.UserName&quot;, httpContext?.User.Identity?.Name);<br>  diagnosticContext.Set(&quot;CustomField.ClientIP&quot;, httpContext?.Connection.RemoteIpAddress?.ToString());<br>  diagnosticContext.Set(&quot;CustomField.UserAgent&quot;, httpContext?.Request.Headers[&quot;User-Agent&quot;].FirstOrDefault());<br>  diagnosticContext.Set(&quot;CustomField.Developer&quot;, httpContext?.Request.Headers[&quot;developer&quot;].FirstOrDefault());<br>  diagnosticContext.Set(&quot;CustomField.Resource&quot;, httpContext?.GetMetricsCurrentResourceName());<br>  diagnosticContext.Set(&quot;CustomField.MethodType&quot;, httpContext?.Request.Method);<br>  diagnosticContext.Set(&quot;CustomField.StatusCode&quot;, httpContext?.Response.StatusCode);<br>}<br><br>private static string GetMetricsCurrentResourceName(this HttpContext httpContext)<br>{<br>   if (httpContext == null)<br>       throw new ArgumentNullException(nameof(httpContext));<br><br>   var endpoint = httpContext.Features.Get&lt;IEndpointFeature&gt;()?.Endpoint;<br>   return endpoint?.Metadata.GetMetadata&lt;EndpointNameMetadata&gt;()?.EndpointName;<br>}</pre><p>Şimdi tekrar loglarımızı inceleyelim.</p><p>Youtube:</p><iframe src="https://cdn.embedly.com/widgets/media.html?src=https%3A%2F%2Fwww.youtube.com%2Fembed%2Fm2zpvLvJ1Pc&amp;display_name=YouTube&amp;url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3Dm2zpvLvJ1Pc&amp;image=http%3A%2F%2Fi.ytimg.com%2Fvi%2Fm2zpvLvJ1Pc%2Fhqdefault.jpg&amp;key=a19fcc184b9711e1b4764040d3dc5c07&amp;type=text%2Fhtml&amp;schema=youtube" width="854" height="480" frameborder="0" scrolling="no"><a href="https://medium.com/media/4c9136819a0af03cf61639ec60cc2bb5/href">https://medium.com/media/4c9136819a0af03cf61639ec60cc2bb5/href</a></iframe><p>Evet Log işlemleri için şimdilik anlatacaklarım bu kadar, umarım faydalı olmuştur. Başka bir makalede görüşmek üzere.</p><p>Kaynak Kodlar</p><p><a href="https://github.com/ademolguner/SerilogElk.git">GitHub - ademolguner/SerilogElk</a></p><p>Kaynakalar:</p><ul><li><a href="https://serilog.net/">Serilog - simple .NET logging with fully-structured events</a></li><li><a href="https://github.com/serilog">Serilog</a></li><li><a href="https://github.com/serilog/serilog/wiki/Provided-Sinks">Provided Sinks</a></li></ul><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=40399c904b5d" width="1" height="1" alt=""><hr><p><a href="https://medium.com/devopsturkiye/net-coreda-serilog-i%CC%87le-elasticsearch-sink-ve-kibana-field-%C3%B6zelle%C5%9Ftirmesi-3-40399c904b5d">.Net Core’da Serilog İle ElasticSearch Sink ve Kibana Field Özelleştirmesi-3</a> was originally published in <a href="https://medium.com/devopsturkiye">Devops &amp; AI Türkiye☁️ 🐧 🐳 ☸️</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Net Core’da Serilog İle ElasticSearch Sink Özelleştirmesi-2]]></title>
            <link>https://medium.com/devopsturkiye/net-coreda-serilog-i%CC%87le-elasticsearch-sink-%C3%B6zelle%C5%9Ftirmesi-2-368a49957a6e?source=rss-a068d8b0ac3------2</link>
            <guid isPermaLink="false">https://medium.com/p/368a49957a6e</guid>
            <category><![CDATA[elasticsearch]]></category>
            <category><![CDATA[kibana]]></category>
            <category><![CDATA[logging]]></category>
            <category><![CDATA[net-core]]></category>
            <category><![CDATA[serilog]]></category>
            <dc:creator><![CDATA[Adem Olguner]]></dc:creator>
            <pubDate>Fri, 09 Dec 2022 14:28:47 GMT</pubDate>
            <atom:updated>2022-12-11T08:25:27.400Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*2hQwNtSs1y6wiqH1-ucGDQ.png" /></figure><p>Bu makale serinin 2.ci yazısıdır. Seriye ait diğer yazıları okumak için altta bulunan linklerden diğer yazılara erişim sağlayabilirsiniz.</p><p>1- <a href="https://medium.com/@ademolguner/net-coreda-serilog-i%CC%87le-elasticsearch-sink-ve-kibana-field-%C3%B6zelle%C5%9Ftirmesi-1-e13020d54475">Docker Ortamlarının ayarlanması</a><br><strong>2- Serilog Entegrasyonu ve Konfigürasyonu</strong><br>3- <a href="https://medium.com/devopsturkiye/net-core-3-0-elasticsearch-kurulum-konfig%C3%BCrasyon-ve-sorgulama-3dc81e4fcc72">ElasticSearch Detaylı Kullanım</a><br>4- Kibana ve Loglama için Custom Field oluşturma ve Kibana ortamlarında sorgulama</p><p>Development süreci boyunca karşılaştığımız hatalarda request-respons incelemeleri için bir çok olasılık ile farklı çözüm yöntemleri geliştiriyoruz. Bunların en çok kullanımı ‘<strong><em>curl gönderirmisin? debug edeyim</em></strong>’ söylemi oluyor. Bu yönteminde doğru bir yöntem olduğunu ama daha maliyetli (zaman) bir yöntem olduğunu tecrübe ederek öğreniyoruz. Merkezi log yöntemi ile aslında sorunlara çözüm üretme development tarafında asıl sorunun çözülme ve çözüm önerisi için daha net ve daha az efor ile çözüldüğünü öğreniyoruz. Anahtar kelimemiz <strong>Merkezi Loglama</strong>.</p><p>Merkezi loglama hemen her proje de olmazsa olmazımız haline geldi. Bir sorunumuz varsa gerek response durumu (HttpStatus Code), response model, response time, custom exceptionların detayları neden kaynaklandığı gibi farklı sorulara daha net cevaplar üretebiliriz.</p><blockquote>Merkezi Loglama altyapı olarak çok farklı entegrasyonları ile farklı yoğurt yeme şekilleri vardır. Burada örnek olarak sadece bir yapı kullanacağız.</blockquote><p>Biz loglama için <strong>Serilog</strong> kullancağız. Loglama ile request response ve diğer detayları ElasticSearch’e yazacağız (kurduğumuz Docker Container yardımı ile) ve ilerleyen yazımızda bahsedeceğim custom field oluşturup kibana da bu logları görüntüleme ve search etme işlemlerini yapacağız.</p><blockquote>Özel parametreler oluşturmadan da log atılıyor olacak, burada belirttiğim özel durumlarda özel parametreleri log parametresi olarak ekleyip, kibana tarafında search işleminde bu parametreler ile filtreleme yapabiliyor olmamızdır.</blockquote><h3>Serilog</h3><p>Serilog çeşitli platformlarında çalışan loglamayı basite indirgeyen bir kütüphanedir. Serilog kayıt gerçekleştirdiği ortamı ‘Sink’ ismi ile nitelendirmektedir. Sink çeşit olarak oldukça zengindir. İster dosya sink’ine ister bir veritabanı sink’ine, isterse de Elasticsearch sink’ine loglarımızı yazabiliyoruz. Serilog’un tüm sink’lerine <a href="https://github.com/serilog/serilog/wiki/Provided-Sinks"><strong>buradan</strong></a> erişebilirsiniz. Yazılım geliştiricilere <strong>structured logging</strong> imkanı da sağladığı için logları okurken anlamlandırabilmek için oldukça faydalıdır.</p><blockquote>Structured logging, bir veriyi nesne yapısında loglamak ve bu yapısal veriyi kolayca sorgulamaktır diyebiliriz.</blockquote><pre>Log.Debug(“O sene {busene}”, busene);</pre><p>Bu şekilde loglanan data içerisinde ‘O sene’ olarak search (like) etmemiz gerekiyor.</p><pre>var busene = new { Name = &quot;Baba Hakkı Spor&quot;, Age = 1903 };<br>Log.Information(&quot;O sene {@busene}&quot;, busene);</pre><p>Yukarıda gördüğümüz gibi b<strong>usene</strong> parametremiz artık bir obje. İlk kullanımdan farklı olarak burada string içerisindeki süslü parantez ifadesini <strong>’@busene’</strong> şeklinde yazdık. Loglanan veriyi, hem de log sorgusu sonrasında <strong>Name=”Baba Hakkı Spor”</strong> olan bilgiye ulaştığımızı görebilirsiniz. Objeyi oluşturan property bazında sorgulama yapma kolaylığı sağlar.</p><h3>PROJE</h3><p>Daha önce oluşturduğumuz <strong>SerilogElasticKibana.Api</strong> projesine gerekli nuget paketlerini ekleyelim.</p><pre>dotnet add package Serilog.AspNetCore --version 6.0.1<br>dotnet add package Serilog.Enrichers.CorrelationId --version 3.0.1<br>dotnet add package Serilog.Exceptions --version 8.4.0<br>dotnet add package Serilog.Sinks.Async --version 1.5.0<br>dotnet add package Serilog.Sinks.Elasticsearch --version 8.4.1<br>dotnet add package Elastic.CommonSchema.Serilog --version 1.5.3<br>dotnet add package Serilog.Settings.Configuration --version 3.3.0</pre><p>Burada eklediğim nuget paketleri sadece serilog için değil ek olarak API UI tarafında endpoint leri daha hızlı hareket etmek adına Swagger entegrasyonunu da ekledi. <strong>Swagger</strong> hakkında bilgi almak için <a href="https://medium.com/devopsturkiye/core-3-0-ile-swagger-kullan%C4%B1m%C4%B1-b80196fd8787?source=your_stories_page-------------------------------------"><strong>bu yazımı</strong></a> okuyabilirsiniz.</p><h4>Konfigürasyon İşlemleri</h4><p>Burada Serilog entegrasyon işlemlerini kod ile yapacağım, ancak bu entegrasyonu appsetting dosyasından okunur şekilde de düzenleyip ekleyeceğim.</p><p><strong>Program.cs</strong> dosyası içerisinde altta bulunan satır kodlarını ekliyoruz.</p><pre>var builder = WebApplication.CreateBuilder(args);<br>SerilogRegistration.ConfigureLogging();<br>builder.Host.UseSerilog();</pre><blockquote>Burada Serilog ile alakalı konfigürasyonu farklı bir .cs dosyasında yazacağız. <br><strong>SerilogRegistration.ConfigureLogging()</strong></blockquote><h3>Serilog ile neler yapabiliriz?</h3><p>Serilog ile mesaj şablonları(message template) oluşturabilmekte ve loglama esnasında bu şablonları parametre ismi olarak kullanabilmekteyiz. Haliyle oluşturulan bu şablonlar bizlere filtreleme, sıralama, serialize etme vb. gibi işlemlerde inanılmaz yardımcı olmakta ve efektif bir loglama süreci geçirmemizi sağlamaktadır.</p><p>Static <strong>SerilogRegistration</strong> class içerisinde <strong>void</strong> geri dönüş tipinde <strong>ConfigureLogging</strong> metodu oluşturalım. Gerekli kod bloklarını yazalım.</p><h3>SerilogExtension — AddSerilog</h3><pre>using System.Reflection;<br>using System.Runtime.Serialization;<br>using Elastic.CommonSchema.Serilog;<br>using Microsoft.AspNetCore.Http.Features;<br>using Serilog;<br>using Serilog.Events;<br>using Serilog.Exceptions;<br>using Serilog.Filters;<br>using Serilog.Formatting.Elasticsearch;<br>using Serilog.Formatting.Json;<br>using Serilog.Sinks.Elasticsearch;<br>using Serilog.Sinks.SystemConsole.Themes;<br>using SerilogElasticKibana.Api.Middlewares;<br><br>namespace SerilogElasticKibana.Api.StartupConfiguration;<br><br>public static class SerilogExtension<br>{<br><br>  public static WebApplicationBuilder AddSerilog(this WebApplicationBuilder builder)<br>   {<br>        var environment = Environment.GetEnvironmentVariable(&quot;ASPNETCORE_ENVIRONMENT&quot;);<br>        var configuration = new ConfigurationBuilder()<br>            .AddJsonFile(&quot;appsettings.json&quot;, optional: false, reloadOnChange: true)<br>            .AddJsonFile($&quot;appsettings.{environment}.json&quot;, optional: true)<br>            .Build();<br><br>        if (environment == null)<br>            return null;<br>       <br>        var applicationName = Assembly.GetExecutingAssembly().GetName().Name;<br>        if (applicationName == null)<br>            return null;<br><br>        Log.Logger = new LoggerConfiguration()<br>            .ReadFrom.Configuration(configuration)<br>            .MinimumLevel.Override(&quot;Microsoft&quot;, LogEventLevel.Information)<br>            .MinimumLevel.Override(&quot;System&quot;, LogEventLevel.Information)<br>            .Enrich.FromLogContext()<br>            .Enrich.WithProperty(&quot;ApplicationName&quot;, $&quot;{applicationName} - {environment}&quot;)<br>            .Enrich.WithProperty(&quot;Coder&quot;, &quot;Adem Olguner&quot;)<br>            .Enrich.WithCorrelationId()<br>            .Enrich.WithExceptionDetails()<br>            .Filter.ByExcluding(Matching.FromSource(&quot;Microsoft.AspNetCore.StaticFiles&quot;))<br>            .WriteTo.Async(writeTo =&gt; writeTo.Console(new JsonFormatter()))<br>            .WriteTo.Async(writeTo=&gt;  writeTo.Debug(new RenderedCompactJsonFormatter()))<br>            .WriteTo.Async(writeTo=&gt;  writeTo.File(&quot;log.txt&quot;,rollingInterval: RollingInterval.Day))<br>            .WriteTo.Async(writeTo =&gt; writeTo.Elasticsearch(new ElasticsearchSinkOptions(new Uri(configuration[&quot;ElasticConfiguration:uri&quot;]))<br>                                    {<br>                                        TypeName = null,<br>                                        AutoRegisterTemplate = true,<br>                                        IndexFormat = $&quot;{applicationName.ToLower()}-{DateTime.UtcNow:yyyy-MM}&quot;,<br>                                        BatchAction = ElasticOpType.Create,<br>                                        CustomFormatter = new ElasticsearchJsonFormatter(),<br>                                        OverwriteTemplate = true,<br>                                        DetectElasticsearchVersion = true,<br>                                        AutoRegisterTemplateVersion = AutoRegisterTemplateVersion.ESv7,<br>                                        NumberOfReplicas = 1,<br>                                        NumberOfShards = 2,<br>                                        FailureCallback = e =&gt; Console.WriteLine(&quot;Unable to submit event &quot; + e.MessageTemplate),<br>                                        EmitEventFailure = EmitEventFailureHandling.WriteToSelfLog |<br>                                                           EmitEventFailureHandling.WriteToFailureSink |<br>                                                           EmitEventFailureHandling.RaiseCallback |<br>                                                           EmitEventFailureHandling.ThrowException<br>                                    }))<br>           .CreateLogger();<br><br>        builder.Logging.ClearProviders();<br>        builder.Host.UseSerilog(Log.Logger, true);<br><br>        return builder;<br>}</pre><p>Şimdi burada konfigürasyonunu yaptığımız alanları anlamaya çalışalım.</p><h4>Sink Belirleme</h4><p>Sink belirleyebilmek için aşağıdaki gibi ‘<strong>WriteTo</strong>…’ komutunun kullanılması yeterlidir.</p><p>Yukarıdaki örnek kod bloğunda birçok desteklenen Sink örneklendirdik.</p><ul><li><strong><em>Console</em></strong><br>Console platformunda log çıktılarını verir. Kullanabilmek için <a href="https://www.nuget.org/packages/serilog.sinks.console/">Serilog.Sinks.Console</a> kütüphanesinin yüklü olması gerekmektedir.</li><li><strong><em>Debug</em></strong><br>Visual Studio ‘Output’ penceresin de log çıktılarını verir. <a href="https://www.nuget.org/packages/serilog.sinks.debug/">Serilog.Sinks.Debug</a> kütüphanesini gerektirir.</li><li><strong><em>File</em></strong><br>Bir metin dosyasına log çıktılarını verir. <a href="https://www.nuget.org/packages/Serilog.Sinks.File/">Serilog.Sinks.File</a> kütüphanesini gerektirir.</li></ul><blockquote>‘<strong>rollingInterval</strong>’ parametresi ile log dosyasının yuvarlama aralığı belirtilebilir. Örneğin; ‘<strong>RollingInterval.Day</strong>’ değeri verildiğinde <strong><em>her gün için bir dosya</em></strong> üretecek ve o dosyaya loglama işlemini gerçekleştirecektir.</blockquote><ul><li><strong>ElasticSearch</strong><br>Log çıktılarını ElasticSearch platformunda verir. Kullanabilmek için <a href="https://www.nuget.org/packages/serilog.sinks.elasticsearch/">Serilog.Sinks.Elasticsearch</a> kütüphanesinin yüklü olması gerekmektedir</li><li><strong><em>Seq</em></strong><br>Log çıktılarını Seq platformunda verir. <a href="https://www.nuget.org/packages/Serilog.Sinks.Seq/">Serilog.Sinks.Seq</a> kütüphanesini gerektirir.</li></ul><blockquote>Burada Seq nedir diyip bir kaç cümle yazmakta fayda var. Seq Serilog içerisinde kullanılabilen farklı bir Sink yöntemidir. Loglanan verileri Seq ortamına kaydedilecek şekilde ayarlayabilir ve oluşan logların monitör edilmesi için kullanılabilir bir arayüzdür.</blockquote><blockquote>Ben burada logları Kibana kullanarak görüntüleyip monitör edeceğim için Seq kullanımı hakkında detaylı bilgiye giremiyorum, ama raştırmak öğrenmek isteyenler içinde not düşmek istedim.</blockquote><p><a href="https://www.nuget.org/packages/Serilog.Sinks.Seq/">Serilog.Sinks.Seq</a></p><pre>.WriteTo.Async(writeTo=&gt; writeTo.Seq(<br>                                      serverUrl:&quot;seq_server-url&quot;,<br>                                      apiKey:&quot;seq-api-keu&quot;<br>                                    )<br>               )</pre><h3>Loglama Parametreleri ve Kullanımları</h3><ul><li><strong>Filter</strong>: Serilog’a uygulanacak filtreleri tanımlamaktadır. Loglama yapılırken hangi namespace’den gelen logları include veya exclude edeceğimizi belirleyebiliriz.</li></ul><pre>.Filter.ByExcluding(Matching.FromSource(&quot;System&quot;))<br>.Filter.ByIncludingOnly(Matching.FromSource(&quot;Microsoft.AspNetCore.Hosting&quot;))</pre><ul><li><strong>MinimumLevel</strong>: Log etkinlik seviyelerinden birini minimum seviye. <br>olarak uygulamamızı sağlar.</li></ul><pre>.MinimumLevel.Information()<br>.MinimumLevel.Override(&quot;Microsoft.AspNetCore&quot;, LogEventLevel.Warning)<br>.MinimumLevel.Override(&quot;SerilogElasticCustomField.Behaviors.LoggingBehavior&quot;, LogEventLevel.Warning)</pre><ul><li><strong>Enrich</strong>: Atılacak log’a dair ekstradan propertyler aşağıdaki gibi tanımlanabilmektedir.</li></ul><pre>.Enrich.WithProperty(&quot;AppName&quot;, name)<br>.Enrich.WithProperty(&quot;Environment&quot;, environment)<br>.Enrich.WithProperty(&quot;Coder&quot;, &quot;AdemOlguner&quot;)</pre><p>Yazının bir sonraki adımında <strong>Elastic Search Özelleştirmesi ve Sorgulama </strong>işlemlerini yapacağız. Bir sonraki yazıya <a href="https://medium.com/devopsturkiye/net-core-3-0-elasticsearch-kurulum-konfig%C3%BCrasyon-ve-sorgulama-3dc81e4fcc72"><strong>buradan</strong></a> ulaşabilirsiniz.</p><p>ElasticSearch tarafını ayrı olarak değerlendirebiliriz. İsterseniz bir sonraki yazı olan <strong>Kibana Özelleştirmesi ve Görüntüleme</strong> yazısına <a href="https://medium.com/@ademolguner/net-coreda-serilog-i%CC%87le-elasticsearch-sink-ve-kibana-field-%C3%B6zelle%C5%9Ftirmesi-3-40399c904b5d"><strong>buradan</strong></a> geçebilirsiniz.</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=368a49957a6e" width="1" height="1" alt=""><hr><p><a href="https://medium.com/devopsturkiye/net-coreda-serilog-i%CC%87le-elasticsearch-sink-%C3%B6zelle%C5%9Ftirmesi-2-368a49957a6e">Net Core’da Serilog İle ElasticSearch Sink Özelleştirmesi-2</a> was originally published in <a href="https://medium.com/devopsturkiye">Devops &amp; AI Türkiye☁️ 🐧 🐳 ☸️</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
    </channel>
</rss>