<\/div>\n
Merhaba,<\/p>\n
OData protokol\u00fcne dair \u00f6nceden kaleme alm\u0131\u015f oldu\u011fumuz makaleler<\/a>imizden g\u00f6r\u00fcld\u00fc\u011f\u00fc \u00fczere, OData; controllerlar\u0131n y\u00f6netimini ele almakta ve belirli varsay\u0131lan standartlar \u00fczerine yap\u0131lanmay\u0131 in\u015fa etmektedir. \u0130\u015fte bu i\u00e7eri\u011fimizde OData’n\u0131n varsay\u0131msal standartlar\u0131n\u0131 inceleyecek ve bir nebze \u00f6zelle\u015ftirme dokunu\u015flar\u0131nda bulunaca\u011f\u0131z.<\/p>\n
OData Controller Yap\u0131lanmas\u0131<\/h3>\n
OData protokol\u00fc \u00fczerinden sorgulama yap\u0131labilecek bir controller modeli i\u00e7in a\u015fa\u011f\u0131daki \u00f6rne\u011fi ele al\u0131rsak e\u011fer;<\/p>\n
\r\n    public class PersonelController : ODataController\r\n    {\r\n        NorthwindContext _northwindContext;\r\n        public PersonelController(NorthwindContext northwindContext)\r\n        {\r\n            _northwindContext = northwindContext;\r\n        }\r\n        [EnableQuery]\r\n        public IActionResult Get()\r\n        {\r\n            return Ok(_northwindContext.Personeller);\r\n        }\r\n    }\r\n<\/pre>\ng\u00f6r\u00fcld\u00fc\u011f\u00fc \u00fczere, ilgili controller s\u0131n\u0131f\u0131m\u0131z standart API yap\u0131lanmas\u0131ndaki gibi ne ‘ApiController’ veya ‘Route’ attributelar\u0131 taraf\u0131ndan i\u015faretlenmekte ne de ‘ControllerBase’ s\u0131n\u0131f\u0131nda t\u00fcremektedir. Tabi burada ele almasakta uygulamaya entegre edilen protokol yap\u0131lanmas\u0131n\u0131n konfig\u00fcrasyonlar\u0131nda bu controller ‘ODataConventionModelBuilder’ nesnesine ‘EntitySet’ olarak tan\u0131mlanmakta ve Edm(Entity Data Model) olarak ilgili controller’\u0131n t\u00fcm y\u00f6netimi OData protokol\u00fcne devredilmektedir. implemantasyon i\u00e7in gerekli konfig\u00fcrasyon temellerini ele ald\u0131\u011f\u0131m\u0131z Asp.NET Core Web API Uygulamas\u0131na OData Implementasyonu<\/a> ba\u015fl\u0131kl\u0131 makaleyi inceleyebilirsiniz.<\/span><\/p>\n
\u0130\u015fte bu devir neticesinde art\u0131k OData ilgili controller’da ki tan\u0131mlamalar\u0131 belirli bir standart \u00e7er\u00e7evesindeki varsay\u0131mlarla de\u011ferlendirmekte ve davran\u0131\u015f\u0131n\u0131 bu varsay\u0131mlara g\u00f6re g\u00f6stermektedir.<\/p>\n
Nedir bu varsay\u0131mlar?<\/strong>
\nURL \u00fczerinden yap\u0131lan sorgulamada bir ‘GET’ iste\u011fi g\u00f6nderilecekse e\u011fer bu iste\u011fi kar\u015f\u0131layacak metot isminin ya ‘Get’ ya da ‘Get{controller_name}’ format\u0131nda olmas\u0131 gerekmektedir. Aksi taktirde iste\u011fi kar\u015f\u0131layacak farkl\u0131 isimde tan\u0131mlanm\u0131\u015f bir metot i\u015flevsellik g\u00f6stermeyecektir.<\/p>\n
Benzer \u015fekilde ‘id’ bazl\u0131 sorgulamalar\u0131n yap\u0131laca\u011f\u0131 durumlarda ilgili ‘Get’ metodunun a\u015fa\u011f\u0131daki gibi isimlendirilmi\u015f olmas\u0131 gerekmektedir.<\/p>\n
\r\n        [EnableQuery]\r\n        public IActionResult Get([FromODataUri]int key)\r\n        {\r\n            return Ok(_northwindContext.Personeller.Where(p => p.PersonelId == key));\r\n        }\r\n<\/pre>\nya da<\/p>\n\r\n        [EnableQuery]\r\n        public IActionResult GetPersonel([FromODataUri]int key)\r\n        {\r\n            return Ok(_northwindContext.Personeller.Where(p => p.PersonelId == key));\r\n        }\r\n<\/pre>\nG\u00f6r\u00fcld\u00fc\u011f\u00fc \u00fczere ‘id’ de\u011ferini kar\u015f\u0131layacak olan parametre birebir ‘int key’ \u015feklinde tan\u0131mlanmal\u0131 ve ‘FromODataUri’ attribute’u ile i\u015faretlenmelidir. ‘int key’ parametresi ‘int id’ \u015feklinde tan\u0131mland\u0131\u011f\u0131nda bile ilgili metot hi\u00e7bir sorgulamada yine i\u015flevsellik g\u00f6stermeyecektir.<\/p>\n
Yukar\u0131daki gibi ‘id’ bazl\u0131 sorgulama fonksiyonlar\u0131na istek g\u00f6nderebilmek i\u00e7in a\u015fa\u011f\u0131daki gibi url olu\u015fturulmas\u0131 yeterlidir.<\/p>\n
1 id de\u011ferine sahip olan personeli getirir.
\nhttps:\/\/localhost:5001\/odata\/personel(1)<\/span><\/strong><\/code><\/p>\n
9 id de\u011ferine sahip olan personelin ad\u0131n\u0131, soyad\u0131n\u0131 ve yapt\u0131\u011f\u0131 t\u00fcm sat\u0131\u015flar\u0131n; sat\u0131\u015f id, sat\u0131\u015f tarihi ve adedini getirir.
\nhttps:\/\/localhost:5001\/odata\/personel(9)?$select=adi, soyadi&$expand=satislar($select=satisid, satistarihi;$count=true)<\/span><\/strong><\/code><\/p>\nODataRoute Attribute’u<\/h3>\nPeki bu varsay\u0131mlar\u0131 nas\u0131l \u00f6zelle\u015ftirebiliyoruz?<\/strong>
\nMetot yahut parametre isimlerini \u00f6zelle\u015ftirebilmek i\u00e7in ‘ODataRoute’ attribute’u kullan\u0131l\u0131r. \u015e\u00f6yle ki;<\/p>\n\r\n        [ODataRoute("personel")]\r\n        [EnableQuery]\r\n        public IActionResult GetTumPersoneller()\r\n        {\r\n            return Ok(_northwindContext.Personeller);\r\n        }\r\n<\/pre>\nya da<\/p>\n\r\n        [EnableQuery]\r\n        [ODataRoute("personel({id})")]\r\n        public IActionResult GetIdyeGorePersonel([FromODataUri] int id)\r\n        {\r\n            return Ok(_northwindContext.Personeller.Where(p => p.PersonelId == id));\r\n        }\r\n<\/pre>\n\u015feklinde kullan\u0131labilmektedir. Burada ‘ODataRoute’ attribute’unda belirtilen ‘personel’ de\u011ferinin birebir controller ismiyle ayn\u0131 oldu\u011funa ve ‘({id})’ de\u011ferininde parametredekiyle isim olarak e\u015fle\u015fti\u011fine dikkatinizi \u00e7ekerim. Tabi burada bir hususa daha de\u011finmek istiyorum. O da bu metotlar\u0131n isimlerinin ‘Get…’ ile ba\u015flama gereksinimidir. E\u011fer ki ‘Get…’ \u00f6n ekiyle ba\u015flamazlarsa sorgulama neticesinde bu metotlar i\u015flevsellik g\u00f6stermeyeceklerdir.<\/p>\nODataRoutePrefix Attribute’u<\/h3>\nCustom isimlendirilmi\u015f action metotlar\u0131 ‘ODataRoute’ attribute’u ile bildirirken daima controller ismini bildirmemiz gerekmektedir. Haliyle bu durum t\u00fcm actionlarda ger\u00e7ekle\u015fince a\u015fa\u011f\u0131daki gibi tekrar eden bir yap\u0131lanma kar\u015f\u0131m\u0131za \u00e7\u0131kacakt\u0131r.<\/p>\n\r\n    public class PersonelController : ODataController\r\n    {\r\n        NorthwindContext _northwindContext;\r\n        .\r\n        .\r\n        .\r\n        [ODataRoute("personel")]\r\n        [EnableQuery]\r\n        public IActionResult GetTumPersoneller()\r\n        {\r\n            return Ok(_northwindContext.Personeller);\r\n        }\r\n\r\n        [EnableQuery]\r\n        [ODataRoute("personel({id})")]\r\n        public IActionResult GetIdyeGorePersonel([FromODataUri] int id)\r\n        {\r\n            return Ok(_northwindContext.Personeller.Where(p => p.PersonelId == id));\r\n        }\r\n    }\r\n<\/pre>\n\u0130\u015fte bu tekrar\u0131 engellemek i\u00e7in controller seviyesinde ‘ODataRoutePrefix’ attribute’unu kullanabilir ve t\u00fcm ‘ODataRoute’ attribute’lar\u0131nda tekrar tekrar controller ismini yazmaktan kurtulunabilir.<\/p>\n\r\n    [ODataRoutePrefix("personel")]\r\n    public class PersonelController : ODataController\r\n    {\r\n        NorthwindContext _northwindContext;\r\n        .\r\n        .\r\n        .\r\n        [ODataRoute()]\r\n        [EnableQuery]\r\n        public IActionResult GetTumPersoneller()\r\n        {\r\n            return Ok(_northwindContext.Personeller);\r\n        }\r\n\r\n        [EnableQuery]\r\n        [ODataRoute("({id})")]\r\n        public IActionResult GetIdyeGorePersonel([FromODataUri] int id)\r\n        {\r\n            return Ok(_northwindContext.Personeller.Where(p => p.PersonelId == id));\r\n        }\r\n    }\r\n<\/pre>\nOData Pagination<\/h3>\nOData her ne kadar url \u00fczerinden sorgulama yapmam\u0131z\u0131 sa\u011flayarak API’lar\u0131m\u0131z\u0131n yeteneklerini artt\u0131r\u0131p biz developerlar\u0131n i\u015flerini kolayla\u015ft\u0131rsada, bu kolayl\u0131\u011f\u0131 g\u00f6lgede b\u0131rakacak ba\u015fka bir \u00f6zelli\u011fide b\u00fcnyesinde bar\u0131nd\u0131rmaktad\u0131r. Sayfalama… Bunun i\u00e7in action metotlar\u0131 i\u015faretledi\u011fimiz ‘EnableQuery’ attribute’unun ‘PageSize’ parametresine ne kadar veri gelmesi isteniyorsa belirtilmesi yeterlidir. \u015e\u00f6yle ki;<\/p>\n
\r\n    public class SatisController : ODataController\r\n    {\r\n        NorthwindContext _northwindContext;\r\n        public SatisController(NorthwindContext northwindContext)\r\n        {\r\n            _northwindContext = northwindContext;\r\n        }\r\n        [EnableQuery(PageSize = 5)]\r\n        public IActionResult Get()\r\n        {\r\n            return Ok(_northwindContext.Satislar.ToList());\r\n        }\r\n    }\r\n<\/pre>\nBu API’ya a\u015fa\u011f\u0131daki gibi istek g\u00f6nderildi\u011finde i\u00e7erisinde bir sonraki sayfan\u0131n linkinide bar\u0131nd\u0131ran sonu\u00e7 d\u00f6nd\u00fcr\u00fclecektir.
\nhttps:\/\/localhost:5001\/odata\/satis?$select=satisid,musteriid<\/span><\/strong><\/code>
\n<\/a><\/p>\n
\u0130\u015fte g\u00f6r\u00fcld\u00fc\u011f\u00fc gibi, bu kadar basit… \ud83d\ude0e<\/p>\n
\u0130lgilenenlerin faydalanmas\u0131 dile\u011fiyle…
\nSonraki yaz\u0131lar\u0131mda g\u00f6r\u00fc\u015fmek \u00fczere…
\n\u0130yi \u00e7al\u0131\u015fmalar…<\/p>\n","protected":false},"excerpt":{"rendered":"
Merhaba, OData protokol\u00fcne dair \u00f6nceden kaleme alm\u0131\u015f oldu\u011fumuz makalelerimizden g\u00f6r\u00fcld\u00fc\u011f\u00fc \u00fczere, OData; controllerlar\u0131n y\u00f6netimini ele almakta ve belirli varsay\u0131lan standartlar \u00fczerine yap\u0131lanmay\u0131 in\u015fa etmektedir. \u0130\u015fte bu i\u00e7eri\u011fimizde OData’n\u0131n varsay\u0131msal standartlar\u0131n\u0131 inceleyecek ve bir nebze...<\/p>\n","protected":false},"author":1,"featured_media":15889,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[3516],"tags":[3529,3530,3526,3528,3527],"class_list":["post-15992","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-odata","tag-odata-attributes","tag-odata-davranisi","tag-odata-pagination","tag-odataroute","tag-odatarouteprefix"],"amp_enabled":true,"_links":{"self":[{"href":"https:\/\/www.gencayyildiz.com\/blog\/wp-json\/wp\/v2\/posts\/15992","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=15992"}],"version-history":[{"count":30,"href":"https:\/\/www.gencayyildiz.com\/blog\/wp-json\/wp\/v2\/posts\/15992\/revisions"}],"predecessor-version":[{"id":16023,"href":"https:\/\/www.gencayyildiz.com\/blog\/wp-json\/wp\/v2\/posts\/15992\/revisions\/16023"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.gencayyildiz.com\/blog\/wp-json\/wp\/v2\/media\/15889"}],"wp:attachment":[{"href":"https:\/\/www.gencayyildiz.com\/blog\/wp-json\/wp\/v2\/media?parent=15992"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.gencayyildiz.com\/blog\/wp-json\/wp\/v2\/categories?post=15992"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.gencayyildiz.com\/blog\/wp-json\/wp\/v2\/tags?post=15992"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}