<\/div>\n

Merhaba,<\/p>\n

Bu i\u00e7eri\u011fimizde .NET 8’de C# 12 ile birlikte gelen Interceptor \u00f6zelli\u011fini inceliyor olaca\u011f\u0131z.<\/p>\n

Interceptor Nedir? Neden Bu Yap\u0131lanmaya \u0130htiyac\u0131m\u0131z Vard\u0131r?<\/h3>\n
Interceptor, uygulamadaki herhangi bir metoda yap\u0131lan \u00e7a\u011fr\u0131y\u0131 alternatif ba\u015fka bir metotla de\u011fi\u015ftirmemize ya da ilgili metodun i\u015flevini engellememize yarayan, yaz\u0131l\u0131msal yakla\u015f\u0131mlar a\u00e7\u0131s\u0131ndan a\u015fina oldu\u011fumuz lakin programlama dili a\u00e7\u0131s\u0131ndan ise C# 12 ile hayat\u0131m\u0131za giren ilgin\u00e7 ve yeni bir deneysel \u00f6zelliktir.<\/p>\n
Interceptor’lar, \u00f6nceki .NET 8 \u2013 Minimal API Ahead of Time(AOT) Compilation Template<\/a> ba\u015fl\u0131kl\u0131 makalemizde inceledi\u011fimiz AOT i\u00e7in olmasa da esas\u0131nda AOT merkezli d\u00fc\u015f\u00fcnce neticesinde tasarlanm\u0131\u015f yap\u0131lard\u0131r diyebiliriz. \u00c7\u00fcnk\u00fc interceptor’lar\u0131 kullanarak, daha \u00f6nce AOT dostu olmayan kodu alabilir ve onu source generator taraf\u0131ndan olu\u015fturulan bir s\u00fcr\u00fcmle de\u011fi\u015ftirebilme \u015fans\u0131n\u0131 elde edebiliriz.<\/p>\n
\u015eimdi interceptor’lar\u0131 daha iyi bir \u015fekilde anlayabilmek i\u00e7in basit bir \u00f6rnek \u00fczerinden yap\u0131y\u0131 g\u00f6zlemleyelim.<\/p>\n

Basit Bir \u00d6rnek \u00dczerinden Interceptor Kullan\u0131m\u0131<\/h3>\n

Interceptor’lar her ne kadar source generator’lar i\u00e7in tasarlanm\u0131\u015f olsa da burada basitlik ad\u0131na ham bir interceptor olu\u015fturmaya odaklanacak ve olay\u0131 \u00f6zetlemi\u015f olaca\u011f\u0131z.<\/p>\n

Her \u015feyden \u00f6nce .NET 8 Preview framework’\u00fcn de herhangi bir proje olu\u015fturman\u0131z gerekmektedir. \u015eahsen ben deniz s\u0131radan bir Console Application \u00fczerinden \u00f6rneklendirme yap\u0131yor olaca\u011f\u0131m.<\/p>\n

\u0130lk olarak olu\u015fturdu\u011funuz projede interceptor’lar\u0131 kullan\u0131labilir hale getirmek i\u00e7in uygulaman\u0131n .csproj dosyas\u0131nda <Features>InterceptorsPreview<\/Features><\/code> \u00f6\u011fesinin ayarlanmas\u0131 gerekmektedir.<\/p>\n

\n

\r\n<Project Sdk="Microsoft.NET.Sdk">\r\n\r\n\t<PropertyGroup>\r\n\t\t<OutputType>Exe<\/OutputType>\r\n\t\t<TargetFramework>net8.0<\/TargetFramework>\r\n\t\t<ImplicitUsings>enable<\/ImplicitUsings>\r\n\t\t<Nullable>enable<\/Nullable>\r\n\t\t<Features>InterceptorsPreview<\/Features>\r\n\t<\/PropertyGroup>\r\n\r\n<\/Project>\r\n<\/pre>\n<\/div>\nArd\u0131ndan uygulamada System.Runtime.CompilerServices<\/code> namespace’i i\u00e7erisinde a\u015fa\u011f\u0131daki attribute’un tan\u0131mlanmas\u0131 gerekmektedir. Bu attribute, interceptor’\u0131n davran\u0131\u015f\u0131n\u0131 farkl\u0131 bir metoda y\u00f6nlendirmemizi sa\u011flayacak olan yap\u0131lanman\u0131n ta kendisidir. Ancak hen\u00fcz hi\u00e7bir yerde herhangi bir base class library’sine(BCL) dahil edilmedi\u011finden dolay\u0131 bu attribute’u kendinizin tan\u0131mlamas\u0131 gerekmektedir.<\/p>\n\n\r\nnamespace System.Runtime.CompilerServices\r\n{\r\n    [AttributeUsage(AttributeTargets.Method, AllowMultiple = true)]\r\n    sealed class InterceptsLocationAttribute(string filePath, int line, int column) : Attribute\r\n    {\r\n\r\n    }\r\n}\r\n<\/pre>\n<\/div>\nAttribute’u incelerseniz e\u011fer interceptor’\u0131n hangi dosyadaki(filePath<\/code>), ka\u00e7\u0131nc\u0131 sat\u0131r(line<\/code>) ve kolondaki(column<\/code>) komutlar i\u00e7in devreye girece\u011fini ifade edecek alanlar tan\u0131mlanm\u0131\u015f vaziyettedir.<\/p>\n
Bu tan\u0131mlamadan sonra art\u0131k interceptor’\u0131 olu\u015fturabilirsiniz. Bunun i\u00e7in misal olarak a\u015fa\u011f\u0131daki i\u00e7eri\u011fe sahip olan ‘Program.cs’ dosyas\u0131n\u0131 referans al\u0131rsak e\u011fer;<\/p>\n\n\r\nX();\r\n\r\nvoid X()\r\n{\r\n    Console.WriteLine("Laylaylom galiba sana g\u00f6re sevmeler...");\r\n}\r\n<\/pre>\n<\/div>\nX metoduna bir interceptor \u00f6rneklendirmesi ger\u00e7ekle\u015ftirebiliriz. Bunun i\u00e7in yap\u0131lmas\u0131 gereken \u00e7al\u0131\u015fma a\u015fa\u011f\u0131daki gibidir;<\/p>\n\n\r\n    static public class CodeGenerator\r\n    {\r\n        [InterceptsLocation(@"C:\\Users\\Gencay\\Desktop\\Interceptor.Example\\Interceptor.Example\\Program.cs", line: 1, column: 1)]\r\n        static public void XInterceptor()\r\n        {\r\n            Console.WriteLine("Doldur be meyhaneci, bo\u015f kalmas\u0131n kadehim...");\r\n        }\r\n    }\r\n<\/pre>\n<\/div>\nYukar\u0131daki kod blo\u011funa g\u00f6z atarsan\u0131z e\u011fer static bir s\u0131n\u0131f olu\u015fturulmakta ve i\u00e7erisinde interceptor’la y\u00f6nlendirmede bulunacak hedef metotla ayn\u0131 imzaya sahip bir metot tan\u0131m\u0131 ger\u00e7ekle\u015ftirilmektedir. \u0130\u015fte bu metot, uygulamada X metodu tetiklendi\u011fi taktirde, bu tetiklenmeyi kesecek ve araya girecek olan metottur.<\/p>\n
Tabi burada dikkat edilmesi gereken bir husus vard\u0131r ki, o da; InterceptsLocation<\/code> attribute’unu kullan\u0131rken line<\/code> ve column<\/code> \u00f6zelliklerine verilen de\u011ferlerin kesinlikle bir metot \u00e7a\u011fr\u0131s\u0131na kar\u015f\u0131l\u0131k gelmesi gereklili\u011fidir. Aksi taktirde verilen de\u011ferler a\u015fa\u011f\u0131daki g\u00f6rseldeki gibi alakas\u0131z bir noktaya\/yap\u0131ya denk geliyorsa ilgili attribute hata verecektir.<\/a>G\u00f6rselde, ‘Program.cs’ dosyas\u0131 i\u00e7erisinde belirtilen 3. sat\u0131r 1. kolonun nereye denk geldi\u011fi g\u00f6sterilmektedir. Haliyle bu durumda a\u015fa\u011f\u0131dakine benzer bir hata verilecektir.<\/p>\n
The provided line and character number does not refer to an interceptable method name, but rather to token ‘void’.<\/em><\/p><\/blockquote>\n
Ayr\u0131ca a\u015fa\u011f\u0131daki gibi birden fazla metodu ayn\u0131 interceptor’a y\u00f6nlendirebilirsiniz.<\/p>\n
\n\r\nX();\r\nY();\r\n\r\nvoid X()\r\n{\r\n    Console.WriteLine("Laylaylom galiba sana g\u00f6re sevmeler...");\r\n}\r\n\r\nvoid Y()\r\n{\r\n    Console.WriteLine("Sende ba\u015f\u0131n\u0131 al\u0131p gitme ne olur, ne olur tut ellerimi...");\r\n}\r\n<\/pre>\n<\/div>\n\n\r\n    static public class CodeGenerator\r\n    {\r\n        [InterceptsLocation(@"C:\\Users\\Gencay\\Desktop\\Interceptor.Example\\Interceptor.Example\\Program.cs", line: 1, column: 1)]\r\n        [InterceptsLocation(@"C:\\Users\\Gencay\\Desktop\\Interceptor.Example\\Interceptor.Example\\Program.cs", line: 2, column: 1)]\r\n        static public void XInterceptor()\r\n        {\r\n            Console.WriteLine("Doldur be meyhaneci, bo\u015f kalmas\u0131n kadehim...");\r\n        }\r\n    }\r\n<\/pre>\n<\/div>\nYakalanan parametreli metodun, parametre de\u011ferleri interceptor metoduna da aktar\u0131lacakt\u0131r. Buna dair \u00f6rne\u011fi yaz\u0131n\u0131n sonunda payla\u015ft\u0131\u011f\u0131m github reposundaki \u00f6rnek \u00e7al\u0131\u015fmada g\u00f6zlemleyebilirsiniz.<\/em><\/p><\/blockquote>\n
Evet, g\u00f6r\u00fcld\u00fc\u011f\u00fc \u00fczere interceptor’lar bu \u015fekilde kullan\u0131lmaktad\u0131rlar. Burada konuya dair bilinmesi gereken s\u0131n\u0131rl\u0131l\u0131klardan biri, interceptor’lar\u0131n yaln\u0131zca metotlar\u0131n m\u00fcdahalesine odaklanmas\u0131yken bir di\u011feri ise interceptor’\u0131n metot imzas\u0131yla tam olarak e\u015fle\u015fmesi gereklili\u011fidir. Ba\u015fka bir s\u0131n\u0131rl\u0131l\u0131k ise interceptor’lar derleme s\u00fcrecinin bir par\u00e7as\u0131 olarak \u00e7al\u0131\u015ft\u0131klar\u0131 i\u00e7in NuGet \u00fczerinden y\u00fcklenmi\u015f olan harici k\u00fct\u00fcphanelerden gelen metotlara kar\u015f\u0131n yap\u0131lan \u00e7a\u011fr\u0131lar\u0131 y\u00f6nlendirememektedirler. \u00c7\u00fcnk\u00fc haz\u0131r k\u00fct\u00fcphanelerde gelen yap\u0131lar zaten derlendi\u011fi i\u00e7in bu i\u015flem ge\u00e7erli olmayacakt\u0131r. Ve sonuncu olarak da dosya yollar\u0131n\u0131n tam bir path olarak belirtilme ihtiyac\u0131 Linux, macOS veya Windows ortamlar\u0131nda istemsiz olsa da kesinlikle sorunlara neden olabilecektir.<\/p>\nInterceptor’lar tam bir AOP \u00e7\u00f6z\u00fcm\u00fc de\u011fildirler.<\/em><\/p><\/blockquote>\n
T\u00fcm bunlar\u0131n d\u0131\u015f\u0131nda InterceptsLocation<\/code> attribute’u ile bildirilen metot \u00e7a\u011fr\u0131lar\u0131n\u0131n sat\u0131r ve kolon bilgilerinin de\u011fi\u015fmesi ihtimali kodun olas\u0131 hatalara her daim gebe oldu\u011funu g\u00f6stermektedir.<\/p>\n
Nihai olarak,
\nInterceptor’lar sayesinde beklenen o ki, \u00e7o\u011fu programc\u0131 a\u00e7\u0131s\u0131ndan interceptor’lar do\u011frudan kullan\u0131lmayacak ancak uygulamalar\u0131n daha h\u0131zl\u0131 \u00e7al\u0131\u015fmas\u0131 ve kolayl\u0131kla konu\u015fland\u0131r\u0131lmas\u0131 a\u00e7\u0131s\u0131ndan \u00f6nemli rol oynayacakt\u0131r kanaatindeyiz.<\/p>\n
\u0130lgilenenlerin faydalanmas\u0131 dile\u011fiyle…
\nSonraki yaz\u0131lar\u0131mda g\u00f6r\u00fc\u015fmek \u00fczere…
\n\u0130yi \u00e7al\u0131\u015fmalar…<\/p>\nNot : \u00d6rnek \u00e7al\u0131\u015fmay\u0131 a\u015fa\u011f\u0131daki github adresinden indirebilirsiniz.
\nhttps:\/\/github.com\/gncyyldz\/CSharp12.Interceptor.Example<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"
Merhaba, Bu i\u00e7eri\u011fimizde .NET 8’de C# 12 ile birlikte gelen Interceptor \u00f6zelli\u011fini inceliyor olaca\u011f\u0131z. Interceptor Nedir? Neden Bu Yap\u0131lanmaya \u0130htiyac\u0131m\u0131z Vard\u0131r? Interceptor, uygulamadaki herhangi bir metoda yap\u0131lan \u00e7a\u011fr\u0131y\u0131 alternatif ba\u015fka bir metotla de\u011fi\u015ftirmemize ya...<\/p>\n","protected":false},"author":1,"featured_media":26539,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[4912,4939],"tags":[4915,4937,4938,4933,4936,4935,4934],"class_list":["post-26603","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-net-8","category-c-12","tag-net-8","tag-net-8-interceptor","tag-aot-interceptors","tag-c-12","tag-c-12-interceptors","tag-c-interceptors","tag-interceptors"],"amp_enabled":true,"_links":{"self":[{"href":"https:\/\/www.gencayyildiz.com\/blog\/wp-json\/wp\/v2\/posts\/26603","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.gencayyildiz.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.gencayyildiz.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.gencayyildiz.com\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.gencayyildiz.com\/blog\/wp-json\/wp\/v2\/comments?post=26603"}],"version-history":[{"count":8,"href":"https:\/\/www.gencayyildiz.com\/blog\/wp-json\/wp\/v2\/posts\/26603\/revisions"}],"predecessor-version":[{"id":26616,"href":"https:\/\/www.gencayyildiz.com\/blog\/wp-json\/wp\/v2\/posts\/26603\/revisions\/26616"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.gencayyildiz.com\/blog\/wp-json\/wp\/v2\/media\/26539"}],"wp:attachment":[{"href":"https:\/\/www.gencayyildiz.com\/blog\/wp-json\/wp\/v2\/media?parent=26603"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.gencayyildiz.com\/blog\/wp-json\/wp\/v2\/categories?post=26603"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.gencayyildiz.com\/blog\/wp-json\/wp\/v2\/tags?post=26603"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}