<\/div>\n

Merhaba,<\/p>\n

Bu i\u00e7eri\u011fimizde geli\u015ftirdi\u011fimiz Azure Function uygulamalar\u0131n\u0131 di\u011fer Azure servislerine ba\u011flayarak kullanabilmemizi sa\u011flayan Binding konusu \u00fczerine detayl\u0131 izahat ve incelemede bulunaca\u011f\u0131z.<\/p>\n

Azure Function Bindings Nedir?<\/h3>\n
Azure Function Bindings, Azure Function yap\u0131lanmas\u0131n\u0131n en g\u00fc\u00e7l\u00fc \u00f6zelli\u011fidir.<\/em><\/p><\/blockquote>\n
Azure Function Bindings, Azure Functionlar’\u0131 di\u011fer Azure servislerine ba\u011flayarak kullanabilmemizi sa\u011flayan bir \u00f6zelliktir. \u0130\u015flevsel a\u00e7\u0131dan spesifik bir \u00f6rnek vermemiz gerekirse e\u011fer; Http Trigger<\/a> ile elde edilen datay\u0131 Azure Storage Table<\/a>‘a yazd\u0131rmak, gelen dosyay\u0131 Azure Storage Blog<\/a>‘a eklemek yahut asenkron i\u015flenmesi gereken bir mesaj\u0131 Azure Storage Queue<\/a>‘da kuyru\u011fa dahil etmek i\u00e7in bu servislerle function aras\u0131nda ba\u011flant\u0131y\u0131 sa\u011flayacak olan mekanizma binding yap\u0131lanmas\u0131d\u0131r.<\/p>\n
Normal \u015fartlarda bir yaz\u0131l\u0131m \u00fczerinden Azure servislerine ba\u011flant\u0131 sa\u011flayabilmek i\u00e7in yap\u0131y\u0131 in\u015fa etmemiz gerekmektedir. Bu yaz\u0131l\u0131m Azure Function oldu\u011fu zamanda s\u00fcre\u00e7 fark etmeyecek ve ayn\u0131 i\u015fi tekrar sergilememiz gerekecektir. \u0130\u015fte burada binding \u00f6zelli\u011fi sayesinde Azure Function’lar da ekstradan ba\u011flant\u0131 i\u00e7in kodlamaya gerek kalmaks\u0131z\u0131n haz\u0131r nesneler arac\u0131l\u0131\u011f\u0131yla di\u011fer servislere eri\u015fim rahat\u00e7a ger\u00e7ekle\u015ftirilebilecek ve i\u015f mant\u0131\u011f\u0131ndaki ekstra y\u00fck ay\u0131klanaca\u011f\u0131ndan dolay\u0131 kod ve i\u015f maliyeti minimize edilmi\u015f olacakt\u0131r.<\/p>\n
Binding sayesinde ekstra kod yazmaks\u0131z\u0131n Azure i\u00e7erisindeki bir\u00e7ok servise ba\u011flant\u0131 ger\u00e7ekle\u015ftirilebilmektedir.<\/em><\/p><\/blockquote>\n
Bindingler; Input Binding<\/span> ve Output Binding<\/span> olmak \u00fczere ikiye ayr\u0131l\u0131rlar.<\/p>\n
\n
Input Binding<\/strong>
\nAzure Function’\u0131n ilgili servislere ekstradan kod yazmaks\u0131z\u0131n ba\u011flanmas\u0131d\u0131r. Function’\u0131m\u0131z bu input binding \u00fczerinden verileri okuyabilir, i\u015fleyebilir. Varsay\u0131lan binding t\u00fcr\u00fcd\u00fcr.\n<\/li>\n
Output Binding<\/strong>
\nAzure Function’\u0131n ilgili servislerden data’y\u0131 d\u0131\u015far\u0131ya g\u00f6ndermesi ve i\u015fletmesidir.\n<\/li>\n<\/ul>\n
Binding Yap\u0131lanmas\u0131(function.json)<\/h3>\n
Azure Function, binding mekanizmas\u0131n\u0131 ‘function.json’ isimli dosya \u00fczerinden yap\u0131land\u0131rmaktad\u0131r. Binding, compile olabilen dillerde(Java, C#) attributes\/annotations gibi yap\u0131larla ger\u00e7ekle\u015ftirilirken, compile olmayan dillerde(Node.JS) ise direkt olarak ‘function.json’ dosyas\u0131 \u00fczerinden ger\u00e7ekle\u015ftirilmektedir. Lakin compile edilen dillerde her ne kadar attribute kullan\u0131lsada, esas\u0131nda bu bir tan\u0131mlamadan ibarettir ve \u00f6z\u00fcnde ‘function.json’ dosyas\u0131 olu\u015fturulmu\u015f olmakta ve kullan\u0131lmaktad\u0131r.<\/p>\n
\u00d6rnek olmas\u0131 hasebiyle bir ‘function.json’ dosyas\u0131n\u0131n nas\u0131l olu\u015fturuldu\u011funu ve yap\u0131sal olarak ne oldu\u011funu inceleyebilmek i\u00e7in Visual Studio’da geli\u015ftirdi\u011finiz Azure Function uygulamas\u0131n\u0131 derleyiniz ve ard\u0131ndan a\u015fa\u011f\u0131daki dizinine gidiniz;
\n...\\{app_name}\\{app_name}\\bin\\Debug\\netcoreapp3.1\\{function_name}<\/span><\/strong><\/code> \nDizini incelerseniz e\u011fer {function_name}<\/span> k\u0131sm\u0131n\u0131n uygulama i\u00e7erisinde tan\u0131mlanm\u0131\u015f her bir function’a kar\u015f\u0131l\u0131k geldi\u011fini anlayacaks\u0131n\u0131z. Misal; i\u00e7erisinde ‘Function1’ ve ‘Function2’ isimli iki adet fonksiyon bulunan bir Azure Function uygulamas\u0131 derlendikten sonra a\u015fa\u011f\u0131daki \u00e7\u0131kt\u0131y\u0131 verecektir. \n`<\/a> \nBu klas\u00f6rlerin her birinde bir ‘function.json’ dosyas\u0131 mevcuttur. \n<\/a> \n\u0130\u015fte bu dosya bizim binding yap\u0131land\u0131rmas\u0131n\u0131 bar\u0131nd\u0131ran dosyam\u0131zd\u0131r. Art\u0131k ilgili dosyan\u0131n i\u00e7eri\u011fine g\u00f6z atabiliriz;<\/p>\n`
\r\n{\r\n "generatedBy": "Microsoft.NET.Sdk.Functions-3.0.3",\r\n "configurationSource": "attributes",\r\n "bindings": [\r\n {\r\n "type": "httpTrigger",\r\n "methods": [\r\n "get",\r\n "post"\r\n ],\r\n "authLevel": "function",\r\n "name": "req"\r\n }\r\n ],\r\n "disabled": false,\r\n "scriptFile": "..\/bin\/ExampleAzureFunctions.dll",\r\n "entryPoint": "ExampleAzureFunctions.Function1.Run"\r\n}\r\n<\/pre>\n\n‘configurationSource’<\/em> \nKonfig\u00fcrasyonun davran\u0131\u015fsal olarak hangi kaynaktan oldu\u011funu ifade eder. Yukar\u0131daki tan\u0131mda ‘attributes’ de\u011ferini ta\u015f\u0131yarak, compile edilen bir dil kullan\u0131ld\u0131\u011f\u0131n\u0131 ve ilgili binding’in attribute arac\u0131l\u0131\u011f\u0131 ile yap\u0131land\u0131r\u0131ld\u0131\u011f\u0131n\u0131 ifade eder.\n<\/li>\n ‘type’<\/em> \nTrigger’\u00een t\u00fcr\u00fcn\u00fc ifade eder.\n<\/li>\n ‘methods’<\/em> \n\u0130lgili function’\u0131 hangi t\u00fcr metotlar\u0131n tetikleyebilece\u011fini ifade eder.\n<\/li>\n ‘authLevel’<\/em> \nFunction’\u0131n hangi authentication level ile tan\u0131mland\u0131\u011f\u0131n\u0131 ifade eder.\n<\/li>\n‘name’<\/em> \n\u0130lgili Function’\u0131 tetikleyecek olan trigger’\u0131 yakalayacak request nesnesinin parametrik ismini ifade eder.\n<\/li>\n<\/ul>\nBir binding i\u015flemi i\u00e7in ‘function.json’ dosyas\u0131nda en az nelerin yap\u0131land\u0131r\u0131lmas\u0131 gerekmektedir?<\/strong><\/p>\n\nY\u00f6n(direction)<\/li>\n Type(type) ve<\/li>\nName<\/li>\n<\/ol>\nbildirilmelidir. Y\u00f6n; ilgili binding’in input mu output mu oldu\u011funu ifade eder. Type; Hangi Azure servis’e(Queue, Table, Blob) binding yap\u0131laca\u011f\u0131n\u0131 bildirir. Name ise; request’i kar\u015f\u0131layan parametrik nesnenin referans\u0131n\u0131 temsil eder. Yukar\u0131daki \u00f6rnek ‘function.json’ i\u00e7eri\u011fine g\u00f6z atarsan\u0131z bu \u00fc\u00e7 asli tan\u0131m\u0131n ‘direction’ hari\u00e7 yap\u0131ld\u0131\u011f\u0131n\u0131 g\u00f6rm\u00fc\u015f olacaks\u0131n\u0131z. Neden ‘direction’ tan\u0131mlamas\u0131 yap\u0131lmam\u0131\u015ft\u0131r?<\/em> sorusuna kar\u015f\u0131l\u0131k –default olarak trigger’lar\u0131n ‘input’ kabul edilmesinden dolay\u0131<\/em>– cevab\u0131n\u0131 vermemiz yeterli olacakt\u0131r.<\/p>\nBinding, sadece Azure servisleri ile \u00e7al\u0131\u015fmaktad\u0131r. Amazon, Google vs. gibi harici servislerle \u00e7al\u0131\u015fabilmek i\u00e7in ilgili servise \u00f6zg\u00fc hususi kodlamalar\u0131n yap\u0131lmas\u0131 gerekmektedir.<\/em><\/p><\/blockquote>\nBinding \u0130\u015fleminin Uygulanmas\u0131<\/h3>\nBir Azure Function uygulamas\u0131 \u00fczerinden binding i\u015fleminin ger\u00e7ekle\u015ftirilebilmesi i\u00e7in uygulamaya ‘Microsoft.Azure.WebJobs.Extensions.Storage<\/a>‘ k\u00fct\u00fcphanesinin entegre edilmesi gerekmektedir. \n<\/a><\/p>\n Table Output Binding<\/h4>\n\u015eimdi a\u015fa\u011f\u0131da Table Output Binding’e \u00f6zel bir \u00f6rnek ele alal\u0131m;<\/p>\n\r\n public static class Function1\r\n {\r\n const string routeName = "products";\r\n [FunctionName("Post")]\r\n async public static Task<IActionResult> Post(\r\n [HttpTrigger(AuthorizationLevel.Function, "post", Route = routeName)] HttpRequest req,\r\n ILogger log, [Table(tableName: "products", Connection = "StorageConnectionString")] CloudTable cloudTable)\r\n {\r\n string body = await new StreamReader(req.Body).ReadToEndAsync();\r\n Product product = JsonConvert.DeserializeObject<Product>(body);\r\n await cloudTable.CreateIfNotExistsAsync();\r\n TableOperation operation = TableOperation.Insert(product);\r\n TableResult tableResult = await cloudTable.ExecuteAsync(operation);\r\n\r\n return new OkObjectResult(tableResult.Result);\r\n }\r\n\r\n [FunctionName("Get")]\r\n async public static Task<IActionResult> Get(\r\n [HttpTrigger(AuthorizationLevel.Function, "get", Route = routeName)] HttpRequest req,\r\n ILogger log, [Table(tableName: "products", Connection = "StorageConnectionString")] CloudTable cloudTable)\r\n {\r\n return new OkObjectResult(cloudTable.CreateQuery<Product>().AsQueryable());\r\n }\r\n }\r\n<\/pre>\nYukar\u0131daki kod blo\u011funu incelerseniz e\u011fer ‘Post’ ve ‘Get’ olmak \u00fczere iki adet function olu\u015fturulmu\u015ftur. Bu functionlar\u0131n ‘CloudTable’ isimli parametreleri ‘Table’ attribute’u arac\u0131l\u0131\u011f\u0131yla Table Storage<\/a> servisine output binding ile ba\u011flanm\u0131\u015f bulunmaktad\u0131r. Ek olarak ‘Connection’ bilgisi ‘local.storage.json<\/a>‘ dosyas\u0131ndaki ‘StorageConnectionString’ alan\u0131nda tutulmaktad\u0131r.<\/p>\n \u0130lgili functionlar\u0131 Postman \u00fczerinden test edelim…<\/p>\n\n\n\n\n\nPOST<\/th>\n GET<\/th>\n<\/tr>\n<\/thead>\n <\/a><\/td>\n <\/a><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\nQueue Output Binding<\/h4>\n\u015eimdide bir Queue Output Binding’e \u00f6rnek verelim;<\/p>\n \r\n public static class Function1\r\n {\r\n const string routeName = "message";\r\n [FunctionName("Post")]\r\n async public static Task<IActionResult> Post(\r\n [HttpTrigger(AuthorizationLevel.Function, "post", Route = routeName)] HttpRequest req,\r\n ILogger log, [Queue(queueName: "mymessage", Connection = "StorageConnectionString")] CloudQueue cloudQueue)\r\n {\r\n string body = await new StreamReader(req.Body).ReadToEndAsync();\r\n await cloudQueue.CreateIfNotExistsAsync();\r\n CloudQueueMessage cloudQueueMessage = new CloudQueueMessage(body);\r\n await cloudQueue.AddMessageAsync(cloudQueueMessage);\r\n return new OkResult();\r\n }\r\n\r\n [FunctionName("Get")]\r\n async public static Task<IActionResult> Get(\r\n [HttpTrigger(AuthorizationLevel.Function, "get", Route = routeName)] HttpRequest req,\r\n ILogger log, [Queue(queueName: "mymessage", Connection = "StorageConnectionString")] CloudQueue cloudQueue)\r\n {\r\n return new OkObjectResult((await cloudQueue.GetMessageAsync()).AsString);\r\n }\r\n }\r\n<\/pre>\n\n\n\n\n\nPOST<\/th>\n GET<\/th>\n<\/tr>\n<\/thead>\n <\/a><\/td>\n <\/a><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\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 geli\u015ftirdi\u011fimiz Azure Function uygulamalar\u0131n\u0131 di\u011fer Azure servislerine ba\u011flayarak kullanabilmemizi sa\u011flayan Binding konusu \u00fczerine detayl\u0131 izahat ve incelemede bulunaca\u011f\u0131z. Azure Function Bindings Nedir? Azure Function Bindings, Azure Function yap\u0131lanmas\u0131n\u0131n en g\u00fc\u00e7l\u00fc \u00f6zelli\u011fidir....<\/p>\n","protected":false},"author":1,"featured_media":17011,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[3121],"tags":[3734,3661,3733,3738,3737,3739,3735,3736,3741,3740],"class_list":["post-17367","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-azure","tag-azure-bindings","tag-azure-functions","tag-azure-functions-bindings","tag-azure-input-binding","tag-azure-output-binding","tag-function-json","tag-input-binding","tag-output-binding","tag-queue-output-binding","tag-table-output-binding"],"amp_enabled":true,"_links":{"self":[{"href":"https:\/\/www.gencayyildiz.com\/blog\/wp-json\/wp\/v2\/posts\/17367","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=17367"}],"version-history":[{"count":48,"href":"https:\/\/www.gencayyildiz.com\/blog\/wp-json\/wp\/v2\/posts\/17367\/revisions"}],"predecessor-version":[{"id":17424,"href":"https:\/\/www.gencayyildiz.com\/blog\/wp-json\/wp\/v2\/posts\/17367\/revisions\/17424"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.gencayyildiz.com\/blog\/wp-json\/wp\/v2\/media\/17011"}],"wp:attachment":[{"href":"https:\/\/www.gencayyildiz.com\/blog\/wp-json\/wp\/v2\/media?parent=17367"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.gencayyildiz.com\/blog\/wp-json\/wp\/v2\/categories?post=17367"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.gencayyildiz.com\/blog\/wp-json\/wp\/v2\/tags?post=17367"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}