From c36f81bce2e98f4cfa9ae552061f47f80281f576 Mon Sep 17 00:00:00 2001
From: hello <stacks@outlook.com>
Date: Mon, 8 Jul 2024 21:09:31 +0800
Subject: [PATCH] =?UTF-8?q?grpc=20=E6=9C=8D=E5=8A=A1=E7=AC=94=E8=AE=B0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 notes/helloshop/basket-service-grpc.md | 62 ++++++++++++++++++++++++++
 1 file changed, 62 insertions(+)
 create mode 100644 notes/helloshop/basket-service-grpc.md

diff --git a/notes/helloshop/basket-service-grpc.md b/notes/helloshop/basket-service-grpc.md
new file mode 100644
index 0000000..8fc7ed1
--- /dev/null
+++ b/notes/helloshop/basket-service-grpc.md
@@ -0,0 +1,62 @@
+# 使用 gRPC 实现购物车服务
+
+## 什么是 gRPC 通信框架
+
+gRPC 是一个高性能、开源和通用的 RPC 框架，由 Google 开发，基于 HTTP/2 协议，支持多种语言（如 Go、Java、Python、C++、Node.js、Ruby、C#、Objective-C、PHP 和 Dart）。
+
+gRPC 使用 Protocol Buffers 作为接口定义语言（IDL），Protocol Buffers 是一种轻便高效的结构化数据序列化方法，类似于 XML 或 JSON，但更小、更快、更简单。
+
+## ASP.NET Core 中使用 gRPC 实现服务
+
+定义一个 gRPC 服务，需要创建一个 gRPC 服务定义文件（.proto 文件），然后使用 gRPC 工具生成服务端和客户端代码。
+
+
+## 带有OpenAPI 的 gRPC 服务
+
+```shell
+dotnet add package Microsoft.AspNetCore.Grpc.Swagger
+```
+
+```csharp
+var builder = WebApplication.CreateBuilder(args);
+builder.Services.AddGrpc().AddJsonTranscoding();
+builder.Services.AddGrpcSwagger();
+builder.Services.AddSwaggerGen(c =>
+{
+    c.SwaggerDoc("v1",
+        new OpenApiInfo { Title = "gRPC transcoding", Version = "v1" });
+});
+
+var app = builder.Build();
+app.UseSwagger();
+if (app.Environment.IsDevelopment())
+    app.UseSwaggerUI(c =>
+    {
+        c.SwaggerEndpoint("/swagger/v1/swagger.json", "My API V1");
+    });
+}
+app.MapGrpcService<GreeterService>();
+
+app.Run();
+```
+
+```proto
+// My amazing greeter service.
+service Greeter {
+  // Sends a greeting.
+  rpc SayHello (HelloRequest) returns (HelloReply) {
+    option (google.api.http) = {
+      get: "/v1/greeter/{name}"
+    };
+  }
+}
+
+message HelloRequest {
+  // Name to say hello to.
+  string name = 1;
+}
+message HelloReply {
+  // Hello reply message.
+  string message = 1;
+}
+```
\ No newline at end of file