<\/div>\n

Merhaba,<\/p>\n

Bu i\u00e7eri\u011fimizde gRPC<\/a> teknolojisini REST API olarak kullanmam\u0131z\u0131 sa\u011flayacak olan .NET 7 ile gelen JSON Transcoding<\/em> \u00f6zelli\u011fini t\u00fcm teferruatlar\u0131yla birlikte de\u011ferlendiriyor olaca\u011f\u0131z.<\/p>\n

gRPC, bilindi\u011fi \u00fczere y\u00fcksek performansl\u0131(high-performance) ve ger\u00e7ek zamanl\u0131(real-time) servisler \u00fcretmemizi sa\u011flayan, bir\u00e7ok avantaj\u0131n yan\u0131nda belli ba\u015fl\u0131 s\u0131n\u0131rl\u0131l\u0131klar bar\u0131nd\u0131ran Remote Procedure Call(RPC)<\/em> framework’\u00fcd\u00fcr. gRPC’nin en b\u00fcy\u00fck s\u0131n\u0131rl\u0131l\u0131klar\u0131ndan biri her platforma uygun bir modele sahip olmamas\u0131d\u0131r. \u00d6zellikle web browser’lar\u0131n binary protokolleri yorumlayamamas\u0131 ve HTTP\/2 protokol\u00fcn\u00fc tam olarak desteklememesinden dolay\u0131 gRPC’nin getirdi\u011fi avantajlardan ziyade modern web uygulamalar\u0131nda hala REST API’lar ve JSON format\u0131ndaki veriler yerlerini korumaktad\u0131rlar.<\/p>\n

.NET 7 ile gelen JSON Transcoding<\/em> \u00f6zelli\u011fi sayesinde art\u0131k gRPC servisleri i\u00e7in RESTful JSON API’lar\u0131 olu\u015fturabilir ve bildi\u011finiz HTTP konseptleri e\u015fli\u011finde gRPC’yi kullanabilirsiniz. B\u00f6ylece deneysel olarak gRPC JSON Transcoding<\/em> ile HTTP API’lar\u0131n\u0131n yerini alacak alternatif bir \u00e7\u00f6z\u00fcm yolu \u00fcretebilirsiniz.<\/p>\n

gRPC JSON Transcoding, deneysel olarak HTTP API’lar\u0131n yerini alabilecek alternatif bir \u00e7\u00f6z\u00fcm olabilir…<\/em><\/p><\/blockquote>\n

Nas\u0131l Kullan\u0131l\u0131r?<\/h4>\ngRPC JSON Transcoding \u00f6zelli\u011fini kullanabilmek i\u00e7in \u00f6ncelikle gRPC Server uygulamas\u0131na Microsoft.AspNetCore.Grpc.JsonTranscoding<\/a> k\u00fct\u00fcphanesinin y\u00fcklenmesi ve ard\u0131ndan ‘Program.cs’ dosyas\u0131nda a\u015fa\u011f\u0131daki gibi AddJsonTranscoding<\/code> servisi \u00e7a\u011fr\u0131larak uygulaman\u0131n yap\u0131land\u0131r\u0131lmas\u0131 gerekmektedir.<\/p>\n
\n\r\nusing gRPC_Server.Services;\r\n\r\nvar builder = WebApplication.CreateBuilder(args);\r\nbuilder.Services.AddCors(options => options.AddDefaultPolicy(policy => policy.AllowAnyMethod()\r\n .AllowAnyHeader()\r\n .AllowAnyOrigin()));\r\n\r\nbuilder.Services.AddGrpc()\r\n .AddJsonTranscoding();\r\n\r\nvar app = builder.Build();\r\napp.UseCors();\r\n\r\napp.MapGrpcService<MessageService>();\r\napp.MapGet("\/", () => "");\r\n\r\napp.Run();\r\n\r\n<\/pre>\n<\/div>\nBu konfig\u00fcrasyonlardan sonra projenin root dizininde ‘google\/api’ path’i alt\u0131na http.proto<\/a> ve annotations.proto<\/a> dosyalar\u0131n\u0131 ekleyiniz.<\/a>Son olarak .proto dosyan\u0131z\u0131 a\u015fa\u011f\u0131daki gibi HTTP konseptine uygun bir \u015fekilde g\u00fcncelleyiniz.<\/p>\n \n\r\nsyntax = "proto3";\r\n\r\noption csharp_namespace = "gRPC_Server";\r\n\r\nimport "google\/api\/annotations.proto";\r\n\r\npackage message;\r\n\r\nservice Message {\r\n rpc SendMessage (MessageRequest) returns (stream MessageReply){\r\n option (google.api.http) = {\r\n get: "\/message\/{text}"\r\n };\r\n };\r\n}\r\n\r\nmessage MessageRequest {\r\n string text = 1;\r\n}\r\n\r\nmessage MessageReply {\r\n string text = 1;\r\n}\r\n<\/pre>\n<\/div>\nBurada 5.<\/strong> sat\u0131ra bakarsan\u0131z google\/api\/annotations.proto<\/code> path’indeki dosya import edilmekte ve 11<\/strong> ile 13.<\/strong> sat\u0131r aral\u0131\u011f\u0131nda ‘SendMessage’ fonksiyonunun HTTP protokol\u00fc \u00fczerinden \/message\/{text}<\/span><\/code> endpoint’i e\u015fli\u011finde ‘GET’ t\u00fcr\u00fcnden tetiklenebilece\u011fi bildirilmektedir. Buradaki {text}<\/span> parametresi ise, tetikleme s\u00fcrecinde ilgili fonksiyonun ald\u0131\u011f\u0131 ‘MessageRequest’ nesnesinin ‘text’ field’\u0131na kar\u015f\u0131l\u0131k gelmektedir.<\/p>\nB\u00f6ylece ‘SendMessage’ metodu art\u0131k hem gRPC hem de JSON Web API olarak \u00e7a\u011fr\u0131labilecek \u015fekilde tasarlanm\u0131\u015ft\u0131r. Misal olarak taray\u0131c\u0131 \u00fczerinden ilgili endpoint’e bir istek g\u00f6nderdi\u011fimizde cevap olarak a\u015fa\u011f\u0131daki ekran g\u00f6r\u00fcnt\u00fcs\u00fcndeki de\u011feri elde ediyor olaca\u011f\u0131z.<\/a><\/p>\n gRPC JSON Transcoding’i GET isteklerinin d\u0131\u015f\u0131nda a\u015fa\u011f\u0131daki HTTP metotlar\u0131n\u0131n hepsiyle de kullanabilmekteyiz.<\/p>\n \nGET<\/li>\n POST<\/li>\n PUT<\/li>\n DELETE<\/li>\nPATCH<\/li>\n<\/ul>\n\u00d6rne\u011fin, POST iste\u011fini kar\u015f\u0131layabilecek bir metodu a\u015fa\u011f\u0131daki gibi tasarlayabiliriz.<\/p>\n\n\r\nsyntax = "proto3";\r\n\r\noption csharp_namespace = "gRPC_Server";\r\n\r\nimport "google\/api\/annotations.proto";\r\n\r\npackage person;\r\n\r\nservice Person {\r\n rpc CreatePerson (PersonRequest) returns (PersonResponse){\r\n option (google.api.http) = {\r\n post: "\/persons",\r\n body : "*"\r\n };\r\n };\r\n}\r\nmessage PersonRequest {\r\n string name = 1;\r\n string surname = 2;\r\n}\r\n\r\nmessage PersonResponse {\r\n string message = 1;\r\n}\r\n<\/pre>\n<\/div>\ngRPC JSON Transcoding | Swagger<\/h4>\nAyr\u0131ca yap\u0131lan t\u00fcm bu konfig\u00fcrasyonlar\u0131 Swashbuckle ile entegre ederek gRPC’yi Swagger aray\u00fcz\u00fc \u00fczerinden de test edebiliriz. Bunun i\u00e7in server uygulamas\u0131na Microsoft.AspNetCore.Grpc.Swagger<\/a> k\u00fct\u00fcphanesini y\u00fckleyiniz ve ‘Program.cs’ dosyas\u0131nda a\u015fa\u011f\u0131daki yap\u0131land\u0131rmay\u0131 ger\u00e7ekle\u015ftiriniz.<\/p>\n \n\r\nusing gRPC_Server.Services;\r\nusing Microsoft.OpenApi.Models;\r\n\r\nvar builder = WebApplication.CreateBuilder(args);\r\nbuilder.Services.AddCors(options => options.AddDefaultPolicy(policy => policy.AllowAnyMethod()\r\n .AllowAnyHeader()\r\n .AllowAnyOrigin()));\r\n\r\nbuilder.Services.AddGrpc()\r\n .AddJsonTranscoding();\r\n\r\nbuilder.Services.AddGrpcSwagger();\r\nbuilder.Services.AddSwaggerGen(options =>\r\n options.SwaggerDoc("v1", new OpenApiInfo\r\n {\r\n Title = "gRPC Transcoding",\r\n Version = "v1"\r\n }));\r\n\r\nvar app = builder.Build();\r\napp.UseCors();\r\n\r\napp.UseSwagger();\r\napp.UseSwaggerUI(options => options.SwaggerEndpoint("\/swagger\/v1\/swagger.json", "My API V1"));\r\n\r\napp.MapGrpcService<MessageService>();\r\napp.MapGrpcService<PersonService>();\r\napp.MapGet("\/", () => "");\r\n\r\napp.Run();\r\n\r\n<\/pre>\n<\/div>\nYukar\u0131daki kod blo\u011funu incelerseniz e\u011fer Swagger i\u00e7in 12<\/strong> ile 13.<\/strong> sat\u0131rlardaki gibi uygulamaya gerekli servislerin eklenmesi ve devam\u0131nda ise 23<\/strong> ile 24.<\/strong> sat\u0131rlardaki gibi middleware’lerin \u00e7a\u011fr\u0131lmas\u0131 yeterli olacakt\u0131r.<\/p>\n Bunun d\u0131\u015f\u0131nda .proto dosyas\u0131nda a\u015fa\u011f\u0131daki gibi yorum sat\u0131rlar\u0131ndan da a\u00e7\u0131klama sat\u0131rlar\u0131 olu\u015fturulabilir.<\/p>\n\n\r\n.\r\n.\r\n.\r\n\/\/Person service\r\nservice Person {\r\n \/\/Person creater service\r\n rpc CreatePerson (PersonRequest) returns (PersonResponse){\r\n option (google.api.http) = {\r\n post: "\/persons",\r\n body : "*"\r\n };\r\n };\r\n}\r\n.\r\n.\r\n.\r\n<\/pre>\n<\/div>\nTabi yorum sat\u0131rlar\u0131n\u0131 a\u00e7\u0131klama sat\u0131r\u0131 olarak okuyabilmek i\u00e7in server uygulamas\u0131n\u0131n .csproj<\/code> dosyas\u0131nda <GenerateDocumentationFile>true<\/span><\/GenerateDocumentationFile><\/code> komutu ile gerekli etkinle\u015ftirmenin yap\u0131lmas\u0131 ve ard\u0131ndan yine ‘Program.cs’ dosyas\u0131nda AddSwaggerGen<\/code> metodunda a\u015fa\u011f\u0131daki gibi yap\u0131land\u0131rman\u0131n in\u015fas\u0131 gerekmektedir.<\/p>\n\n\r\n.\r\n.\r\n.\r\nbuilder.Services.AddSwaggerGen(options =>\r\n{\r\n options.SwaggerDoc("v1", new OpenApiInfo\r\n {\r\n Title = "gRPC Transcoding",\r\n Version = "v1"\r\n });\r\n\r\n var filePath = Path.Combine(System.AppContext.BaseDirectory, "gRPC_Server.xml");\r\n options.IncludeXmlComments(filePath);\r\n options.IncludeGrpcXmlComments(filePath, includeControllerXmlComments: true);\r\n});\r\n.\r\n.\r\n.\r\n<\/pre>\n<\/div>\nNihai olarak ilgili servisi aya\u011fa kald\u0131rd\u0131\u011f\u0131m\u0131zda Swagger aray\u00fcz\u00fcn\u00fc a\u015fa\u011f\u0131daki gibi g\u00f6rebiliriz.<\/a><\/p>\n \u0130lgilenenlerin faydalanmas\u0131 dile\u011fiyle… \nSonraki yaz\u0131lar\u0131mda g\u00f6r\u00fc\u015fmek \u00fczere… \n\u0130yi \u00e7al\u0131\u015fmalar…<\/p>\n Not : \u00d6rnek uygulamay\u0131 a\u015fa\u011f\u0131daki github adresinden inceleyebilirsiniz. \nhttps:\/\/github.com\/gncyyldz\/gRPC_Json_Transcoding_Example<\/a><\/p>\n","protected":false},"excerpt":{"rendered":" Merhaba, Bu i\u00e7eri\u011fimizde gRPC teknolojisini REST API olarak kullanmam\u0131z\u0131 sa\u011flayacak olan .NET 7 ile gelen JSON Transcoding \u00f6zelli\u011fini t\u00fcm teferruatlar\u0131yla birlikte de\u011ferlendiriyor olaca\u011f\u0131z. gRPC, bilindi\u011fi \u00fczere y\u00fcksek performansl\u0131(high-performance) ve ger\u00e7ek zamanl\u0131(real-time) servisler \u00fcretmemizi sa\u011flayan,...<\/p>\n","protected":false},"author":1,"featured_media":20414,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[4754,4032],"tags":[4327,4751,4065,4750,4753,4749,4752,3765,3764],"class_list":["post-26041","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-net-7","category-grpc","tag-asp-net-core-grpc","tag-asp-net-core-grpc-json-transcoding","tag-grpc","tag-grpc-json-transcoding","tag-grpc-swashbuckle","tag-json-transcoding","tag-microsoft-aspnetcore-grpc-jsontranscoding","tag-remote-procedure-call","tag-rpc"],"amp_enabled":true,"_links":{"self":[{"href":"https:\/\/www.gencayyildiz.com\/blog\/wp-json\/wp\/v2\/posts\/26041","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=26041"}],"version-history":[{"count":14,"href":"https:\/\/www.gencayyildiz.com\/blog\/wp-json\/wp\/v2\/posts\/26041\/revisions"}],"predecessor-version":[{"id":26061,"href":"https:\/\/www.gencayyildiz.com\/blog\/wp-json\/wp\/v2\/posts\/26041\/revisions\/26061"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.gencayyildiz.com\/blog\/wp-json\/wp\/v2\/media\/20414"}],"wp:attachment":[{"href":"https:\/\/www.gencayyildiz.com\/blog\/wp-json\/wp\/v2\/media?parent=26041"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.gencayyildiz.com\/blog\/wp-json\/wp\/v2\/categories?post=26041"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.gencayyildiz.com\/blog\/wp-json\/wp\/v2\/tags?post=26041"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}