<\/div>\n

Merhaba,<\/p>\n

Bu i\u00e7eri\u011fimizde, uygulamalar\u0131m\u0131zda HttpClient yerine basit interface tan\u0131mlamalar\u0131 sayesinde Rest API’lar ile kolay ve h\u0131zl\u0131 bir \u015fekilde i\u015flemler yapmam\u0131z\u0131 sa\u011flayan olduk\u00e7a g\u00fc\u00e7l\u00fc Refit k\u00fct\u00fcphanesi \u00fczerine konu\u015fuyor olaca\u011f\u0131z. Makalemizde i\u00e7eriksel ak\u0131\u015f olarak Console Application \u00fczerinde temellendirmeler yap\u0131lmas\u0131n\u0131n ard\u0131ndan Asp.NET Core uygulamas\u0131 \u00fczerinde de entegrasyonun nas\u0131l ger\u00e7ekle\u015ftirildi\u011fini inceleyece\u011fiz. O halde hi\u00e7 vakit kaybetmeden Refit tan\u0131m\u0131yla ba\u015flayal\u0131m…<\/p>\n

\u0130\u00e7indekiler;<\/p>\n

Refit K\u00fct\u00fcphanesi Nedir?<\/a><\/li>\n
Nas\u0131l Kullan\u0131l\u0131r?<\/a><\/li>\n
API Attributes<\/a><\/li>\n
Dynamic Querystring Parameters<\/a><\/li>\n
Collections as Querystring parameters<\/a><\/li>\n
Unescape Querystring Parameters<\/a><\/li>\n
Headers Ekleme<\/a><\/li>\n
Dynamic Headers Ekleme<\/a><\/li>\n
Authorization (Dynamic Headers Redux)<\/a><\/li>\n
Header\u2019lar\u0131n Yeniden Tan\u0131mlanmas\u0131<\/a><\/li>\n
Header\u2019lar\u0131n Silinmesi<\/a><\/li>\n
Asp.NET Core Uygulamalar\u0131nda Refit Kullan\u0131m\u0131<\/a><\/li>\n<\/ul>\n
Refit K\u00fct\u00fcphanesi Nedir?<\/h3>\n
Temel anlamda Rest API’lar\u0131 uygulamada bir aray\u00fcze d\u00f6n\u00fc\u015ft\u00fcrerek ileti\u015fim kurulacak ba\u011f\u0131ml\u0131l\u0131klar\u0131 daha kolay bir \u015fekilde y\u00f6netmemizi sa\u011flayan ve Android taraf\u0131nda geli\u015ftirilmi\u015f olan Retrofit isimli k\u00fct\u00fcphaneden esinlenerek olu\u015fturulmu\u015f olan .NET tabanl\u0131 bir k\u00fct\u00fcphanedir.<\/p>\n
Refit k\u00fct\u00fcphanesinin i\u015flevsel a\u00e7\u0131dan bir\u00e7ok avantaj\u0131 mevcuttur;<\/p>\n
\n
GET, POST, PUT ve DELETE gibi her t\u00fcrl\u00fc HTTP fonksiyonuna kar\u015f\u0131l\u0131k gelen metotlar olu\u015fturulabilmektedir,<\/li>\n
QueryString, Dynamic URL Parameter vs. gibi bir\u00e7ok farkl\u0131 \u015fekilde parametreler bar\u0131nd\u0131ran istekler olu\u015fturulabilmektedir,<\/li>\n
Datalar birden fazla serialization y\u00f6ntemi ile harmanlanarak POST edilebilmektedir,<\/li>\n
Multipart Upload’lar ile byte dizisi, string, Stream yahut FileInfo t\u00fcrlerinde dosya transferleri ger\u00e7ekle\u015ftirilebilmektedir,<\/li>\n
Yap\u0131lacak isteklere static yahut dynamic olmak \u00fczere kolayca headerlar eklenebilmektedir.<\/li>\n<\/ul>\n
Nas\u0131l Kullan\u0131l\u0131r?<\/h3>\n
Temel kullan\u0131m \u00f6rneklendirmesi Console Application \u00fczerinden anlat\u0131lmaktad\u0131r.<\/em><\/p><\/blockquote>\n
Refit<\/a> k\u00fct\u00fcphanesini kullanabilmek i\u00e7in \u00f6ncelikle a\u015fa\u011f\u0131daki kod ile projeye y\u00fcklenmesi gerekmektedir.
\ndotnet add package refit<\/strong><\/code><\/p>\n
Ard\u0131ndan hedef API’lar\u0131n bir interface \u00fczerinden modellenmesi gerekmektedir. Bizler burada \u00f6rneklendirme i\u00e7in http:\/\/jsonplaceholder.typicode.com\/todos<\/a> adresini hedef API olarak kullanacak ve t\u00fcm sistemi buradaki datalara g\u00f6re in\u015fa edece\u011fiz.<\/p>\n
Tabi \u00f6ncelikle ilgili adresteki dataya uygun bir entity olu\u015fturarak i\u015fe ba\u015flayal\u0131m. \n
<\/a>Makalenin kaleme al\u0131nd\u0131\u011f\u0131 tarihte http:\/\/jsonplaceholder.typicode.com\/todos adresindeki \u00f6rnek data modeli…<\/p><\/div><\/p>\n\r\n public class Todo\r\n {\r\n public int userId { get; set; }\r\n public int id { get; set; }\r\n public string title { get; set; }\r\n public bool completed { get; set; }\r\n }\r\n<\/pre>\nArd\u0131ndan ilgili API’a a\u015fa\u011f\u0131daki aray\u00fcz\u00fc tasarlayal\u0131m.<\/p>\n\r\n public interface ITodoAPI\r\n {\r\n [Get("\/todos")]\r\n Task<List<Todo>> GetTodos();\r\n }\r\n<\/pre>\nBuradaki interface’e odaklan\u0131rsak e\u011fer kendisi hedef API’\u0131n base url’ine(http:\/\/jsonplaceholder.typicode.com)<\/span> kar\u015f\u0131l\u0131k gelmektedir. \u0130\u00e7erisinde tan\u0131mlanan imzalar ise ilgili base url’lerin tetiklenece\u011fi metotlar\u0131n\u0131 temsil etmektedir. \u00d6rne\u011fin; ‘Get’ attribute’u ile i\u015faretlenmi\u015f ‘GetTodos’ imzas\u0131 base url’in devam\u0131ndaki metodu\/yolu(\/todos)<\/span> temsil etmektedir. <\/p>\n \u015eimdi bu aray\u00fcz \u00fczerinden hedef API’a bir istek g\u00f6nderelim;<\/p>\n\r\n static async Task Main(string[] args)\r\n {\r\n ITodoAPI todoAPI = RestService.For<ITodoAPI>("http:\/\/jsonplaceholder.typicode.com");\r\n List<Todo> todos = await todoAPI.GetTodos();\r\n foreach (var todo in todos)\r\n Console.WriteLine(todo.title);\r\n }\r\n<\/pre>\nYukar\u0131daki kod blo\u011funu incelersek e\u011fer ‘RestService.For’ komutu arac\u0131l\u0131\u011f\u0131yla base url’imizi belirlemekte ve d\u00f6n\u00fclen nesne \u00fczerinden interface’de tan\u0131mlanan imzalar vas\u0131tas\u0131yla ilgili metotlara istekler yapmaktay\u0131z. \n<\/a>\u00c7\u0131kt\u0131<\/p><\/div><\/p>\nAPI Attributes<\/h3>\nRefit \u00fczerinden attribute’lar ile birbirinden farkl\u0131 bir\u00e7ok annotations tan\u0131mlamas\u0131 yap\u0131labilmektedir. Bu tan\u0131mlamalar\u0131 incelersek e\u011fer;<\/p>\n\n[Get(“\/todos”)]<\/strong> \n\u015euana kadar yapt\u0131\u011f\u0131m\u0131z \u00f6rneklendirmelerde kulland\u0131\u011f\u0131m\u0131z t\u00fcrd\u00fcr.\n<\/li>\n[Get(“\/todos\/{id}”)]<\/strong> \nUrl’de parametreler belirtilebilmektedir. \nTan\u0131mlanma;<\/p>\n\r\n public interface ITodoAPI\r\n {\r\n [Get("\/todos\/{id}")]\r\n Task<Todo> GetTodo(int id);\r\n }\r\n<\/pre>\nKullan\u0131m;<\/p>\n\r\n ITodoAPI todoAPI = RestService.For<ITodoAPI>("http:\/\/jsonplaceholder.typicode.com");\r\n Todo todo = await todoAPI.GetTodo(5);\r\n Console.WriteLine(todo.title);\r\n<\/pre>\nAyr\u0131ca parametre ad\u0131n\u0131n url’dekiyle e\u015fle\u015fmedi\u011fi durumlarda a\u015fa\u011f\u0131daki gibi ‘AliasAs’<\/span> attribute’u kullan\u0131labilir.<\/p>\n\r\n public interface ITodoAPI\r\n {\r\n [Get("\/todos\/{id}")]\r\n Task<Todo> GetTodo([AliasAs("id")]int todoid);\r\n }\r\n<\/pre>\n<\/li>\n[Get(“\/todos?id={id}”)]<\/strong> \nBu \u015fekilde QueryString olacak \u015fekilde sorgu parametreleri de verilebilmektedir. \nTan\u0131mlanma;<\/p>\n\r\n public interface ITodoAPI\r\n {\r\n [Get("\/todos?id={id}")]\r\n Task<List<Todo>> GetTodosId(int id);\r\n }\r\n<\/pre>\nKullan\u0131m;<\/p>\n \r\n ITodoAPI todoAPI = RestService.For<ITodoAPI>("http:\/\/jsonplaceholder.typicode.com");\r\n List<Todo> todos = await todoAPI.GetTodosId(5);\r\n foreach (var todo in todos)\r\n Console.WriteLine(todo.title);\r\n<\/pre>\n<\/li>\n[Get(“\/todos?id={request.Id}&UserId={request.UserId}”)]<\/strong> \nURL parametreleri \u00f6zel bir nesneye ba\u011flanarak bu \u015fekilde kullan\u0131labilmektedirler. \nCustom Object;<\/p>\n\r\n public class TodoRequest\r\n {\r\n public int Id { get; set; }\r\n public int UserId { get; set; }\r\n }\r\n<\/pre>\nTan\u0131mlama;<\/p>\n \r\n public interface ITodoAPI\r\n {\r\n [Get("\/todos?id={request.Id}&UserId={request.UserId}")]\r\n Task<List<Todo>> GetByIdAndUserId(TodoRequest request);\r\n }\r\n<\/pre>\nKullan\u0131m;<\/p>\n \r\n ITodoAPI todoAPI = RestService.For<ITodoAPI>("http:\/\/jsonplaceholder.typicode.com");\r\n List<Todo> todos = await todoAPI.GetByIdAndUserId(new TodoRequest { Id = 1, UserId = 1 });\r\n foreach (var todo in todos)\r\n Console.WriteLine(todo.title);\r\n<\/pre>\n<\/li>\nTan\u0131mlanmayan Parametreler<\/strong> \nA\u015fa\u011f\u0131daki gibi tan\u0131mlanmayan parametreler QueryString parametresi olarak kullan\u0131lmaktad\u0131r.<\/p>\n\r\n public interface ITodoAPI\r\n {\r\n [Get("\/todos")]\r\n Task<List<Todo>> GetTodo(int id);\r\n }\r\n<\/pre>\n\/todos?id=…\n<\/li>\n {**name} Parametresi<\/strong> \n{**name} parametresi ile tan\u0131mlanan ifadeler b\u00fct\u00fcnsel olarak kendisinden sonraki t\u00fcm tan\u0131mlamalar\u0131 kapsayabilmektedirler. \nTan\u0131mlama;<\/p>\n\r\n public interface ITodoAPI\r\n {\r\n [Get("\/{**page}")]\r\n Task<Todo> Get(string page);\r\n }\r\n<\/pre>\nKullan\u0131m;<\/p>\n \r\n ITodoAPI todoAPI = RestService.For<ITodoAPI>("http:\/\/jsonplaceholder.typicode.com");\r\n Todo todo = await todoAPI.Get("todos\/5");\r\n Console.WriteLine(todo.title);\r\n<\/pre>\n<\/li>\n<\/ul>\nDynamic Querystring Parameters<\/h3>\nBir nesne a\u015fa\u011f\u0131daki gibi dinamik olarak sorgu parametresi \u015feklinde belirtilebilmektedir.<\/p>\n \r\n public class TodoQueryParam\r\n {\r\n [AliasAs("order")]\r\n public string SortOrder { get; set; }\r\n public int Limit { get; set; }\r\n }\r\n<\/pre>\n\r\n public interface ITodoAPI\r\n {\r\n [Get("\/todos")]\r\n Task<List<Todo>> GetTodos(TodoQueryParam todoQueryParam);\r\n }\r\n<\/pre>\nE\u011fer ki, API \u00fczerinde bir \u00f6nek tan\u0131mlanmas\u0131 gerekiyorsa Query attribute’unun kullan\u0131lmas\u0131 yeterli olacakt\u0131r.<\/p>\n \r\n public interface ITodoAPI\r\n {\r\n [Get("\/todos")]\r\n Task<List<Todo>> GetTodosQuery([Query("search")]TodoQueryParam todoQueryParam);\r\n }\r\n<\/pre>\nB\u00f6ylece ilgili aray\u00fcz \u00fczerinden imzalar\u0131 kullan\u0131rken a\u015fa\u011f\u0131daki gibi API’lara istekler g\u00f6nderilmi\u015f olacakt\u0131r.<\/p>\n \r\n ITodoAPI todoAPI = RestService.For<ITodoAPI>("http:\/\/jsonplaceholder.typicode.com");\r\n await todoAPI.GetTodos(new TodoQueryParam { Limit = 5, SortOrder = "desc" });\r\n await todoAPI.GetTodosQuery(new TodoQueryParam { Limit = 5, SortOrder = "desc" });\r\n<\/pre>\n“\/todos\/?order=desc&Limit=5” \n“\/todos\/?search.order=desc&search.Limit=10”<\/p>\n Collections as Querystring parameters<\/h3>\nA\u015fa\u011f\u0131daki gibi interface i\u00e7erisindeki imzada tan\u0131mlanan koleksiyonel de\u011ferler direkt olarak query string de\u011ferleri olarak kullan\u0131lacakt\u0131r.<\/p>\n \r\n public interface ITodoAPI\r\n {\r\n [Get("\/todos")]\r\n Task<List<Todo>> GetTodosMulti([Query(CollectionFormat.Multi)] int[] ids);\r\n [Get("\/todos")]\r\n Task<List<Todo>> GetTodosCsv([Query(CollectionFormat.Csv)] int[] ids);\r\n }\r\n<\/pre>\nHer iki imza aras\u0131ndaki kullan\u0131m fark\u0131;<\/p>\n \r\n ITodoAPI todoAPI = RestService.For<ITodoAPI>("http:\/\/jsonplaceholder.typicode.com");\r\n await todoAPI.GetTodosMulti(new[] { 3, 5, 7 });\r\n await todoAPI.GetTodosCsv(new[] { 3, 5, 7 });\r\n<\/pre>\n\/todos?ids=3&ids=5&ids=7 \n\/todos?ids=3%2C5%2C7<\/p>\n \u015feklinde olacakt\u0131r.<\/p>\n Ayr\u0131ca a\u015fa\u011f\u0131daki gibi koleksiyonel parametrelerin ‘Query’ attribute’u ile i\u015faretlenmeksizin ‘CollectionFormat’ tan\u0131mlamas\u0131 yap\u0131lmad\u0131\u011f\u0131 durumlar olabilir.<\/p>\n \r\n public interface ITodoAPI\r\n {\r\n [Get("\/todos")]\r\n Task<List<Todo>> GetTodosMulti(int[] ids);\r\n [Get("\/todos")]\r\n Task<List<Todo>> GetTodosCsv(int[] ids);\r\n }\r\n<\/pre>\n\u0130\u015fte b\u00f6yle bir durumda ‘RestService’ \u00fczerinden bir ‘RefitSettings’ nesnesiyle genel konfig\u00fcrasyon sa\u011flanabilir.<\/p>\n \r\n ITodoAPI todoAPI = RestService.For<ITodoAPI>("http:\/\/jsonplaceholder.typicode.com", new RefitSettings { CollectionFormat = CollectionFormat.Csv });\r\n await todoAPI.GetTodosMulti(new[] { 3, 5, 7 });\r\n await todoAPI.GetTodosCsv(new[] { 3, 5, 7 });\r\n<\/pre>\nUnescape Querystring Parameters<\/h3>\n\u0130mza parametrelerine verilen de\u011ferler URL yap\u0131s\u0131na uygun olmayan karakterleri bar\u0131nd\u0131r\u0131yorsa e\u011fer taray\u0131c\u0131lar taraf\u0131ndan otomatik escape karakterlerine d\u00f6n\u00fc\u015ft\u00fcr\u00fcl\u00fcrler. \u00d6rne\u011fin;<\/p>\n \r\n public interface ITodoAPI\r\n {\r\n [Get("\/todos")]\r\n Task<List<Todo>> GetTodos(string q);\r\n }\r\n<\/pre>\nbu aray\u00fcze uygun \u015f\u00f6yle bir istek g\u00f6nderilirse e\u011fer<\/p>\n \r\n ITodoAPI todoAPI = RestService.For<ITodoAPI>("http:\/\/jsonplaceholder.typicode.com");\r\n await todoAPI.GetTodos("sebepsiz+bo\u015f+yere.ayr\u0131lacaksan!");\r\n<\/pre>\n\/todos?q=sebepsiz%2Bbo%C5%9F%2Byere.ayr%C4%B1lacaksan%21 \n\u015feklinde query string de\u011feri olu\u015fturulacakt\u0131r.<\/p>\n Lakin bu \u015fekilde \u00f6zel karakterlerin query string de\u011ferine oldu\u011fu gibi eklenmesini istiyorsak e\u011fer ilgili imzay\u0131 a\u015fa\u011f\u0131daki gibi ‘QueryUriFormat’ attribute’u ile i\u015faretleyerek ‘UriFormat.Unescaped’ de\u011ferinin verilmesi yeterli olacakt\u0131r.<\/p>\n \r\n public interface ITodoAPI\r\n {\r\n [Get("\/todos")]\r\n [QueryUriFormat(UriFormat.Unescaped)]\r\n Task<List<Todo>> GetTodos(string q);\r\n }\r\n<\/pre>\n\/todos?q=sebepsiz+bo%C5%9F+yere.ayr%C4%B1lacaksan!<\/p>\n Headers Ekleme<\/h3>\nYap\u0131lacak isteklere metot seviyesinde ve interface seviyesinde olmak \u00fczere iki t\u00fcrl\u00fc header eklenebilmektedir.<\/p>\n Metot seviyesinde header ekleme;<\/em><\/p>\n \r\n public interface ITodoAPI\r\n {\r\n [Headers("name:gencay yildiz")]\r\n [Get("\/todos")]\r\n Task<List<Todo>> GetTodos();\r\n }\r\n<\/pre>\nInterface seviyesinde header ekleme;<\/em><\/p>\n \r\n [Headers("name:gencay yildiz")]\r\n public interface ITodoAPI\r\n {\r\n [Get("\/todos")]\r\n Task<List<Todo>> GetTodos();\r\n }\r\n<\/pre>\nDynamic Headers Ekleme<\/h3>\nA\u015fa\u011f\u0131daki gibi dinamik bir \u015fekilde header eklenebilmektedir.<\/p>\n \r\n public interface ITodoAPI\r\n {\r\n [Get("\/todos")]\r\n Task<Todo> GetTodos([Header("authorization")] string authorization);\r\n }\r\n<\/pre>\nAuthorization (Dynamic Headers Redux)<\/h3>\nGenellikle header authorization i\u015flemlerinde token ta\u015f\u0131mak amac\u0131yla kullan\u0131lan bir yap\u0131d\u0131r. Dolay\u0131s\u0131yla bu yap\u0131ya dinamik bir s\u00fcre\u00e7 neticesinde a\u015fa\u011f\u0131daki gibi token de\u011feri set edilebilir ve talep \u00f6ylece g\u00f6nderilebilir.<\/p>\n Tabi bu dinamik s\u00fcreci in\u015fa edebilmek i\u00e7in a\u015fa\u011f\u0131daki ad\u0131mlar\u0131n s\u0131ras\u0131yla uygulanmas\u0131 gerekmektedir;<\/p>\n \nAd\u0131m 1<\/strong> \n\u00d6ncelikle ‘HttpClientHandler’<\/em> s\u0131n\u0131f\u0131ndan t\u00fcreyen ve ‘SendAsync’ metodunu override eden a\u015fa\u011f\u0131daki nesne olu\u015fturulur.<\/p>\n\r\n class AuthenticatedHttpClientHandler : HttpClientHandler\r\n {\r\n private readonly Func<Task<string>> getToken;\r\n public AuthenticatedHttpClientHandler(Func<Task<string>> getToken)\r\n {\r\n if (getToken == null) throw new ArgumentNullException(nameof(getToken));\r\n this.getToken = getToken;\r\n }\r\n\r\n async protected override Task<HttpResponseMessage> SendAsync(HttpRequestMessage request, CancellationToken cancellationToken)\r\n {\r\n var auth = request.Headers.Authorization;\r\n if (auth != null)\r\n {\r\n var token = await getToken().ConfigureAwait(false);\r\n request.Headers.Authorization = new AuthenticationHeaderValue(auth.Scheme, token);\r\n }\r\n return await base.SendAsync(request, cancellationToken);\r\n }\r\n }\r\n<\/pre>\nYukar\u0131daki ‘AuthenticatedHttpClientHandler<\/em>‘ s\u0131n\u0131f\u0131na g\u00f6z atarsak e\u011fer biraz \u00f6nce bahsedildi\u011fi gibi ‘HttpClientHandler’ s\u0131n\u0131f\u0131ndan t\u00fcremekte ve ‘SendAsync’ metodunu override etmektedir. Constructor’\u0131na bakarsan\u0131z e\u011fer ‘Func<Task<string>>’ t\u00fcr\u00fcnden ‘getToken’ isimli bir delegate almaktad\u0131r. Bu Func yap\u0131lanmas\u0131, ilgili s\u0131n\u0131ftan nesne \u00fcretilirken kendisine verilen metot i\u00e7erisinde server’dan token’\u0131 talep edecek ve geriye d\u00f6nd\u00fcrecektir. 15.<\/strong><\/em> sat\u0131rda ilgili Func referans\u0131na verilen metot \u00e7a\u011fr\u0131larak token elde edilmekte ve 16.<\/strong><\/em> sat\u0131rda request’in headerlar\u0131ndan Authorization’a yerle\u015ftirilmekte ve b\u00f6ylece request yenilenmi\u015f olmaktad\u0131r. Ard\u0131ndan ilgili request base class’ta ki ‘SendAsync’ metoduna g\u00f6nderilmektedir.\n<\/li>\n Ad\u0131m 2<\/strong> \nRefit’in istekleri g\u00f6rselle\u015ftirebilmesi i\u00e7in aray\u00fcz tasarlanmal\u0131d\u0131r.<\/p>\n\r\n public interface ITodoAPI\r\n {\r\n [Get("\/todos\/login")]\r\n [Headers("Authorization: Bearer")]\r\n Task<string> Login();\r\n }\r\n<\/pre>\n<\/li>\nAd\u0131m 3<\/strong> \nArd\u0131ndan istek a\u015fa\u011f\u0131daki gibi tasarlan\u0131p, g\u00f6nderilmelidir.<\/p>\n\r\n var api = RestService.For<ITodoAPI>(new HttpClient(new AuthenticatedHttpClientHandler(() =>\r\n {\r\n \/\/Sunucudan token talep edilebilir...\r\n return Task.FromResult("elde edilen token degeri");\r\n }))\r\n {\r\n BaseAddress = new Uri("https:\/\/localhost:5001")\r\n });\r\n await api.Login();\r\n<\/pre>\nG\u00f6r\u00fcld\u00fc\u011f\u00fc \u00fczere ‘RestService.For’ komutuyla iste\u011fin g\u00f6nderilebilmesi i\u00e7in bir ‘HttpClient’ nesnesi kullan\u0131lmakta ve i\u00e7erisine olu\u015fturdu\u011fumuz ‘AuthenticatedHttpClientHandler’ nesnesi verilmektedir. Bu nesnenin tasar\u0131m\u0131 icab\u0131 constructor’\u0131ndan istedi\u011fi Func de\u011ferine kar\u015f\u0131l\u0131k tan\u0131mlanan lambda fonksiyonu i\u00e7erisinde token talep edilmekte ve elde edildi\u011fi taktirde geriye d\u00f6nd\u00fcr\u00fclmektedir. Ayr\u0131ca ‘HttpClient’ nesnesinin initializer’\u0131nda ‘BaseAddress’ propertysine base url verilmektedir.\n<\/li>\n<\/ul>\n Header’lar\u0131n Yeniden Tan\u0131mlanmas\u0131<\/h3>\nA\u015fa\u011f\u0131daki \u00f6ncelik s\u0131ras\u0131na g\u00f6re header’lar yeniden tan\u0131mlan\u0131rlar.<\/p>\n \nInterfaceler’de ki header tan\u0131mlamas\u0131(en d\u00fc\u015f\u00fck \u00f6ncelik),<\/em><\/li>\n Metotlarda ki header tan\u0131mlamas\u0131,<\/em><\/li>\n Parametrelerde ki header tan\u0131mlamas\u0131(en y\u00fcksek \u00f6ncelik)<\/em><\/li>\n<\/ul>\n\u00d6rne\u011fin;<\/p>\n \r\n [Headers("position:interface")]\r\n public interface ITodoAPI\r\n {\r\n [Get("\/todos")]\r\n Task<List<Todo>> GetTodos();\r\n [Get("\/todos")]\r\n [Headers("position:metot")]\r\n Task<List<Todo>> GetTodos(int id);\r\n [Get("\/todos")]\r\n [Headers("position:metot")]\r\n Task<List<Todo>> GetTodos(int id, int userId, [Header("position")] string headerparam);\r\n }\r\n<\/pre>\naray\u00fcz\u00fcn\u00fc ele al\u0131rsak e\u011fer a\u015fa\u011f\u0131daki gibi yap\u0131lan isteklerde s\u0131ras\u0131yla<\/p>\n \r\n ITodoAPI todoAPI = RestService.For<ITodoAPI>("http:\/\/jsonplaceholder.typicode.com");\r\n await todoAPI.GetTodos();\r\n await todoAPI.GetTodos(5);\r\n await todoAPI.GetTodos(5, 2, "parametre");\r\n<\/pre>\n{[position, {interface}]} \n{[position, {metot}]} \n{[position, {parametre}]} \nheaderlar\u0131n\u0131 alacakt\u0131r.<\/p>\n Header’lar\u0131n yeniden tan\u0131mlanma davran\u0131\u015f\u0131 sadece ayn\u0131 isimdeki headerlar i\u00e7in ge\u00e7erlidir.<\/p><\/blockquote>\n Header’lar\u0131n Silinmesi<\/h3>\nTan\u0131mlanm\u0131\u015f herhangi bir header, bo\u015f de\u011fere sahip olacak \u015fekilde tekrardan tan\u0131mlanarak ezilebilir ve b\u00f6ylece temizlenebilir.<\/p>\n \r\n [Headers("position:interface")]\r\n public interface ITodoAPI\r\n {\r\n [Get("\/todos")]\r\n [Headers("position")]\r\n Task<List<Todo>> GetTodos();\r\n }\r\n<\/pre>\nAyr\u0131ca a\u015fa\u011f\u0131daki gibi bir tan\u0131mlama yap\u0131larak da header’a silinmeksizin empty de\u011fer at\u0131l\u0131r.<\/p>\n \r\n [Headers("position:interface")]\r\n public interface ITodoAPI\r\n {\r\n [Get("\/todos")]\r\n [Headers("position:")]\r\n Task<List<Todo>> GetTodos();\r\n }\r\n<\/pre>\nAsp.NET Core Uygulamalar\u0131nda Refit Kullan\u0131m\u0131<\/h3>\nBir Asp.NET Core uygulamas\u0131nda Refit’i kullanabilmek i\u00e7in \u00f6ncelikle projeye Refit<\/a> k\u00fct\u00fcphanesiyle birlikte Refit.HttpClientFactory<\/a> k\u00fct\u00fcphanesinin y\u00fcklenmesi gerekmektedir.<\/p>\n Ard\u0131ndan ‘Startup.cs’ dosyas\u0131ndaki ‘ConfigureServices’ metodu i\u00e7erisinde a\u015fa\u011f\u0131daki gibi ‘AddRefitClient’ servisinin eklenmesi gerekmektedir.<\/p>\n \r\n public interface ITodoAPI\r\n {\r\n [Get("\/todos")]\r\n public Task<List<Todo>> GetTodos();\r\n }\r\n<\/pre>\n\r\n public void ConfigureServices(IServiceCollection services)\r\n {\r\n services.AddRefitClient<ITodoAPI>()\r\n .ConfigureHttpClient(c => c.BaseAddress = new Uri("http:\/\/jsonplaceholder.typicode.com"));\r\n services.AddControllers();\r\n }\r\n<\/pre>\nTabi istek do\u011frultusunda bir ‘RefitSettings’ objeside eklenebilmektedir.<\/p>\n \r\n public void ConfigureServices(IServiceCollection services)\r\n {\r\n services.AddRefitClient<ITodoAPI>(new RefitSettings { CollectionFormat = CollectionFormat.Csv })\r\n .ConfigureHttpClient(c => c.BaseAddress = new Uri("http:\/\/jsonplaceholder.typicode.com"));\r\n services.AddControllers();\r\n }\r\n<\/pre>\nT\u00fcm bu d\u00fczenlemeler neticesinde tasarlanan Refit aray\u00fcz\u00fc a\u015fa\u011f\u0131daki gibi dependency injection’dan talep edilerek, kullan\u0131labilir.<\/p>\n \r\n [Route("api\/[controller]")]\r\n [ApiController]\r\n public class TodosController : ControllerBase\r\n {\r\n readonly ITodoAPI _todoAPI;\r\n public TodosController(ITodoAPI todoAPI)\r\n {\r\n _todoAPI = todoAPI;\r\n }\r\n\r\n public async Task<IActionResult> GetTodos()\r\n {\r\n return Ok(await _todoAPI.GetTodos());\r\n }\r\n }\r\n<\/pre>\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, Bu i\u00e7eri\u011fimizde, uygulamalar\u0131m\u0131zda HttpClient yerine basit interface tan\u0131mlamalar\u0131 sayesinde Rest API’lar ile kolay ve h\u0131zl\u0131 bir \u015fekilde i\u015flemler yapmam\u0131z\u0131 sa\u011flayan olduk\u00e7a g\u00fc\u00e7l\u00fc Refit k\u00fct\u00fcphanesi \u00fczerine konu\u015fuyor olaca\u011f\u0131z. Makalemizde i\u00e7eriksel ak\u0131\u015f olarak Console Application...<\/p>\n","protected":false},"author":1,"featured_media":16681,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[2739,3102,12,3573],"tags":[3601,3603,3602,3599,3600,3598],"class_list":["post-16618","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-net-core","category-asp-net-core","category-c-sharp-c","category-microservices","tag-net-core-refit","tag-asp-net-core-refit","tag-httpclienthandler","tag-refit","tag-refit-framework","tag-refit-kutuphanesi"],"amp_enabled":true,"_links":{"self":[{"href":"https:\/\/www.gencayyildiz.com\/blog\/wp-json\/wp\/v2\/posts\/16618","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=16618"}],"version-history":[{"count":69,"href":"https:\/\/www.gencayyildiz.com\/blog\/wp-json\/wp\/v2\/posts\/16618\/revisions"}],"predecessor-version":[{"id":16694,"href":"https:\/\/www.gencayyildiz.com\/blog\/wp-json\/wp\/v2\/posts\/16618\/revisions\/16694"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.gencayyildiz.com\/blog\/wp-json\/wp\/v2\/media\/16681"}],"wp:attachment":[{"href":"https:\/\/www.gencayyildiz.com\/blog\/wp-json\/wp\/v2\/media?parent=16618"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.gencayyildiz.com\/blog\/wp-json\/wp\/v2\/categories?post=16618"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.gencayyildiz.com\/blog\/wp-json\/wp\/v2\/tags?post=16618"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}

API Attributes<\/h3>\nRefit \u00fczerinden attribute’lar ile birbirinden farkl\u0131 bir\u00e7ok annotations tan\u0131mlamas\u0131 yap\u0131labilmektedir. Bu tan\u0131mlamalar\u0131 incelersek e\u011fer;<\/p>\n