<\/div>\n

Merhaba,<\/p>\n

Bir \u00f6nceki OData Nedir? GraphQL\u2019den Fark\u0131 Nedir?<\/a> ba\u015fl\u0131kl\u0131 makalemizde OData’n\u0131n ne oldu\u011fundan ve muadili olan GraphQL’le aras\u0131ndaki fark\u0131n neler oldu\u011fundan bahsetmi\u015ftik. Bu i\u00e7eri\u011fimizde ise pratiksel a\u00e7\u0131dan Asp.NET Core Web API uygulamalar\u0131na OData protokol\u00fcn\u00fcn nas\u0131l implemente edilebilece\u011fini ve b\u00f6ylece API’lara entity \u00fczerinde sorgulama yetene\u011finin kazand\u0131r\u0131labilmesi i\u00e7in neler yap\u0131lmas\u0131 gerekti\u011fini inceleyece\u011fiz.<\/p>\n

OData bir protokold\u00fcr. Protokol; iki farkl\u0131 sistemin birbiriyle nas\u0131l haberle\u015fece\u011fini belirleyen kurallar b\u00fct\u00fcn\u00fcd\u00fcr.<\/strong><\/p><\/blockquote>\n

Implementasyon<\/h3>\nOData’y\u0131 uygulaman\u0131za entegre edebilmeniz i\u00e7in Microsoft.AspNetCore.OData<\/a> k\u00fct\u00fcphanesini y\u00fcklemeniz yeterlidir.<\/p>\n
Ard\u0131ndan ‘Startup.cs’ dosyas\u0131nda a\u015fa\u011f\u0131daki konfig\u00fcrasyonlar\u0131n yap\u0131lmas\u0131 gerekmektedir.<\/p>\n
\r\n public class Startup\r\n {\r\n public void ConfigureServices(IServiceCollection services)\r\n {\r\n .\r\n .\r\n .\r\n services.AddOData();\r\n .\r\n .\r\n .\r\n }\r\n\r\n public void Configure(IApplicationBuilder app, IWebHostEnvironment env)\r\n {\r\n .\r\n .\r\n .\r\n var builder = new ODataConventionModelBuilder();\r\n builder.EntitySet<Personel>("Personel");\r\n builder.EntitySet<Kategori>("Kategori");\r\n\r\n app.UseEndpoints(endpoints =>\r\n {\r\n endpoints.MapODataRoute("odata", "odata", builder.GetEdmModel());\r\n });\r\n .\r\n .\r\n .\r\n }\r\n }\r\n<\/pre>\n
Yukar\u0131daki kod blo\u011funu incelersek e\u011fer; 8.<\/strong><\/em> sat\u0131rda ‘AddOData’ metoduyla uygulamaya OData servisi eklenmektedir. 19 – 21.<\/strong><\/em> sat\u0131rlarda ‘ODataConventionModelBuilder’ t\u00fcr\u00fcnden nesne ile entitylerin nas\u0131l sorgulanaca\u011f\u0131n\u0131 bildirece\u011fimiz bir convention tan\u0131ml\u0131yoruz ve ‘EntitySet’ metotlar\u0131yla belirtilen entitylere sorgulama yetene\u011fini kazand\u0131rmak i\u00e7in bildiride bulunuyoruz. Burada \u00f6zellikle ‘EntitySet’ metodunun parametresine kullan\u0131lacak olan controller’\u0131n ismini belirtmeye dikkat ediyoruz(\u00d6rn; ‘PersonelController’<\/span>) 25.<\/em><\/strong> sat\u0131rda ise ‘MapODataRoute’ metodu ile OData protokol\u00fcne uygun ‘www.example.com\/odata<\/span>\/{controller}’<\/span> format\u0131nda bir rota olu\u015fturuyoruz ve ‘GetEdmModel'(Edm : Entity Data Model<\/span>) ile belirtilen entityler i\u00e7erisindeki navigation propertyleri ve di\u011fer t\u00fcm \u00f6zellikleri olu\u015fturulacak rotaya dahil ediyoruz.<\/p>\n
‘Startup.cs’ dosyas\u0131nda yap\u0131lan bu konfig\u00fcrasyondan sonra istekleri kar\u015f\u0131layacak olan controller’lar\u0131 a\u015fa\u011f\u0131daki gibi tan\u0131ml\u0131yoruz.<\/p>\n
\r\n public class KategoriController : ODataController\r\n {\r\n NorthwindContext _northwindContext;\r\n public KategoriController(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.Kategoriler.ToList());\r\n }\r\n }\r\n<\/pre>\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.ToList());\r\n }\r\n }\r\n<\/pre>\n
\u00d6rnek olarak ele ald\u0131\u011f\u0131m\u0131z her iki controller’\u0131 incelerseniz e\u011fer ‘ApiController’ ve ‘Route’ attributelar\u0131 kald\u0131r\u0131lm\u0131\u015f ve ‘ControllerBase’ yerine ‘ODataController’dan t\u00fcretilmi\u015flerdir. Bu \u015fekilde tasarlanmalar\u0131n\u0131n sebebi, art\u0131k t\u00fcm kontrol\u00fcn OData \u00fczerinde olmas\u0131ndan kaynaklanmaktad\u0131r. OData var olan katman \u00fczerine yenisini ekleyerek, controller’lardaki sorumlulu\u011fu \u00fcstlenmektedir. Ayriyetten her iki controller i\u00e7erisindeki ‘Get’ fonksiyonlar\u0131na g\u00f6z atarsan\u0131z e\u011fer ‘EnableQuery’ attribute’u ile i\u015faretlenerek bu controller’lar\u0131n ‘Startup.cs’ dosyas\u0131nda tan\u0131mlanan entityleri \u00fczerinden sorgulanma yetenekleri kazand\u0131r\u0131lmaktad\u0131r.<\/p>\n
Test<\/h4>\n
Olu\u015fturulan controller’lara normal istek g\u00f6nderirsek e\u011fer;
\n $\"Asp.NET$ <\/a>
\nG\u00f6r\u00fcld\u00fc\u011f\u00fc \u00fczere i\u00e7erisinde birazdan de\u011finece\u011fimiz metadata bilgisini bar\u0131nd\u0131ran “@data.context” ile verileri bar\u0131nd\u0131ran “value” alanlar\u0131na sahip bir result olu\u015fturularak, g\u00f6nderilmektedir. Dolay\u0131s\u0131yla burada OData \u00fczerinden yap\u0131lan sorgulamalar neticesinde elde edilen verilerin ‘value’ alan\u0131ndan elde edilece\u011fine dikkatinizi \u00e7ekerim.<\/p>\n
Tabi burada sonraki makalemizde detayl\u0131ca inceleyece\u011fimiz query option’lardan ‘$select’ parametresini kullanarak belirtilen alanlar\u0131n gelip gelmedi\u011fini de denetleyerek olu\u015fturdu\u011fumuz yap\u0131lanman\u0131n \u00e7al\u0131\u015fmas\u0131n\u0131 kontrol etmemizde fayda vard\u0131r.<\/p>\n
$\"\"$ <\/a>
\nG\u00f6r\u00fcld\u00fc\u011f\u00fc \u00fczere url \u00fczerinde https:\/\/localhost:5001\/odata\/ personel?$select=adi, soyadi<\/span><\/span> \u015feklinde belirtilen bir query string ile kaynaktan gelecek olan verilerin sadece ‘adi’ ve ‘soyadi’ kolonlar\u0131n\u0131n elde edilmesini bildirmi\u015f bulunmaktay\u0131z.<\/p>\n
Yap\u0131lan istek neticesinde OData protokol\u00fcn\u00fcn \u00e7al\u0131\u015ft\u0131\u011f\u0131n\u0131 ve url \u00fczerinden sorgulaman\u0131n ba\u015far\u0131l\u0131 bir \u015fekilde ger\u00e7ekle\u015fti\u011fini g\u00f6zlemlemi\u015f bulunmaktay\u0131z.<\/p>\n
OData Metadata<\/h3>\n
Client, ‘Startup.cs’ dosyas\u0131nda OData’ya set edilen entitylerin hangi propertylere sahip oldu\u011funu g\u00f6rebilmek i\u00e7in metadata iste\u011finde bulunulabilmektedir. Bu istek neticesinde bir nevi servis d\u00f6k\u00fcmanlar\u0131 olu\u015fturulacak ve client’a g\u00f6nderilecektir. Bir url \u00fczerinden metadata bilgilerini talep edebilmek i\u00e7in $metadata<\/span> etiketinin kullan\u0131lmas\u0131 yeterli olacakt\u0131r.<\/p>\n
Uygulamada Kullan\u0131lan T\u00fcm Entityleri Sorgulamak<\/strong>
\nUygulamada OData i\u00e7in set edilen t\u00fcm entitylerin metadata bilgilerine eri\u015febilmek i\u00e7in \/odata?$metadata<\/span> url’ine istek g\u00f6nderilmesi yeterli olacakt\u0131r.
\n $\"Asp.NET$ <\/a>
\nG\u00f6r\u00fcld\u00fc\u011f\u00fc \u00fczere uygulamada ‘Personel’ ve ‘Kategori’ olmak \u00fczere iki adet entity’nin var oldu\u011fu bilgisi gelmekte ve b\u00f6ylece t\u00fcm entityler kulland\u0131\u011f\u0131 url bilgisiyle birlikte listelenmektedir. <\/p>\n
Entitylerin Propertylerini Sorgulamak<\/strong>
\nMevcut entitylerin bar\u0131nd\u0131rd\u0131\u011f\u0131 alanlar\u0131 sorgulamak i\u00e7in \/odata\/$metadata<\/span> \u015feklinde istek g\u00f6nderilmesi gerekmektedir.
\n $\"Asp.NET$ <\/a>
\nG\u00f6r\u00fcld\u00fc\u011f\u00fc \u00fczere istek neticesinde entitylerin propertyleri listelenmekte ve b\u00f6ylece client neye g\u00f6re sorgulama yapaca\u011f\u0131n\u0131 bilebilmektedir.<\/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, Bir \u00f6nceki OData Nedir? GraphQL\u2019den Fark\u0131 Nedir? ba\u015fl\u0131kl\u0131 makalemizde OData’n\u0131n ne oldu\u011fundan ve muadili olan GraphQL’le aras\u0131ndaki fark\u0131n neler oldu\u011fundan bahsetmi\u015ftik. Bu i\u00e7eri\u011fimizde ise pratiksel a\u00e7\u0131dan Asp.NET Core Web API uygulamalar\u0131na OData protokol\u00fcn\u00fcn...<\/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":[3520,3519,3514,3521],"class_list":["post-15872","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-odata","tag-api-odata","tag-asp-net-core-web-api-odata","tag-odata","tag-odata-asp-net-core-implementation"],"amp_enabled":true,"_links":{"self":[{"href":"https:\/\/www.gencayyildiz.com\/blog\/wp-json\/wp\/v2\/posts\/15872","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=15872"}],"version-history":[{"count":40,"href":"https:\/\/www.gencayyildiz.com\/blog\/wp-json\/wp\/v2\/posts\/15872\/revisions"}],"predecessor-version":[{"id":15917,"href":"https:\/\/www.gencayyildiz.com\/blog\/wp-json\/wp\/v2\/posts\/15872\/revisions\/15917"}],"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=15872"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.gencayyildiz.com\/blog\/wp-json\/wp\/v2\/categories?post=15872"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.gencayyildiz.com\/blog\/wp-json\/wp\/v2\/tags?post=15872"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}