如何基于gRPC沟通微服务框架(gin框架微服务)
ccwgpt 2024-10-03 18:17 33 浏览 0 评论
本文我们来讲解一下如何使用 gRPC构建微服务,gRPC是一个开源框架,可用于构建可扩展且高性能的微服务并创建服务之间的通信。
背景
随着企业越来越多地转向微服务,对构建这些微服务的低延迟和可扩展框架的需求也在增加。为了满足这一需求,各种工具和框架提供商正加快满足微服务需求。同时从构建大型微服务应用程序的经验中学习,技术专业人士分享他们对可重用组件的知识,以便其他人可以构建具有相同规模和性能的架构。
什么是 gRPC
gRPC 是一个开源框架(由 Google 创建),是一个通用的 RPC 框架,用于大规模构建具有高性能的网络应用程序。实现有多种语言版本,并且支持跨平台通信。
使用场景
gRPC 非常适合服务与服务之间的 RPC 通信。在这里,我们将使用 Java 来实现微服务和相关框架,让它的功能更齐全。为了让其他服务可以访问它,我们将创建一个包装 REST 服务,这个服务将使用 gRPC 客户端与 gRPC 服务进行通信。
准备工作
我们需要设置一个基础环境来构建和运行示例。基本要求是安装 Java 和 Maven。gRPC 工具和服务器运行时库等其他依赖项,将在构建过程中自动下载。有关构建应用程序所需的核心依赖项,请参阅下面的代码。
<dependency>
<groupId>io.github.lognet</groupId>
<artifactId>grpc-spring-boot-starter</artifactId>
<version>4.5.0</version>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-log4j2</artifactId>
</dependency>
<dependency>
<groupId>org.mapstruct</groupId>
<artifactId>mapstruct</artifactId>
<version>${mapstruct.version}</version>
</dependency>
核心功能
gRPC 基本上是一种与平台和编码无关的协议。这意味着,您可以使用任何类型的编码,如二进制、JSON、XML 等,但推荐的方法是使用“protobuf”,它使用专门的序列化/反序列化机制支持二进制编码。可插拔设计允许用户对其进行扩展以支持所需的平台和堆栈。
protobuf 的核心构造是 proto IDL(接口定义语言),定义了消息类型和服务定义。它还提供了为所需平台生成模型类和服务接口的工具。
消息类型
我们可以从在.proto文件中定义消息类型的 proto 定义开始。看下面的例子。
message AccountProto {
int32 accId = 1;
string accName = 2;
string accBalance = 3;
bool status = 4;
...
}
有关数据类型和关键字的完整参考,请参阅proto3文档。
Protobuf 提供了一种工具,可以根据适用于您的平台/编程语言的消息定义为模型类生成代码。以下命令将根据给定的消息定义在 Java 中生成account类。
$ > protoc -I=proto-demo --java_out=proto-demo account.proto
服务定义
gRPC 服务定义是一组需要对定义的消息类型执行的操作。这些操作可以采用以下四种通信形式之一:
- 单通道 RPC — 它是最简单的通信形式。它本质上是同步的,允许用户以阻塞模式发送请求并等待响应,直到服务器完成处理。
- 流式 RPC — 在这种形式中,客户端一次性发送数据,但服务器以流的形式返回响应。
- 客户端流式 RPC — 与服务器流式传输不同,在这种形式中,客户端以流的形式发送请求的数据,服务器将数据作为一个整体返回。
- 双向流式 RPC — 在这种形式中,服务器和客户端都支持根据请求和响应流式传输数据。
具有标准 CRUD 操作的消息类型的示例服务定义将采用以下输入:
service AccountService {
rpc GetAccount (google.protobuf.Int32Value) returns (AccountProto);
rpc GetAllAccounts (google.protobuf.Empty) returns (stream AccountProto);
rpc CreateAccount (AccountProto) returns (AccountProto);
rpc UpdateAccount (AccountProto) returns (AccountProto);
rpc DeleteAccount (google.protobuf.Int32Value) returns (google.protobuf.Empty);
}
gRPC-Java 实现提供的扩展工具有助于根据域逻辑和服务器存根生成用户需要实现的服务接口,客户端将使用这些存根调用已部署的服务。
$ > protoc -I=grpc-demo\src\main\proto --java_out=grpc-demo\src\main\proto account.proto
标准服务器和客户端
gRPC-Java 库提供了一个响应式服务器实现(基于 Netty)来部署您的服务和一个阻塞/非阻塞客户端实现来连接您的服务和其他服务。
您需要注册您的服务实现并以编程方式启动服务器。
server = ServerBuilder.forPort(port), .addService(new GreeterImpl()).build().start();
在此处找到 GitHub 参考。
要连接到部署在基于 Netty 的 gRPC 服务器上的服务,您需要创建一个消息通道并将其与生成的服务器存根连接以进行调用。
ManagedChannel channel = ManagedChannelBuilder.forTarget(target).usePlaintext().build();
blockingStub = GreeterGrpc.newBlockingStub(channel);
HelloRequest request = HelloRequest.newBuilder().setName(name).build();
HelloReply response = blockingStub.sayHello(request);
在此处找到 GitHub 参考。
网络客户端
还有一个 gRPC Web 模块,允许 Web 客户端无缝访问您的 gRPC 服务。他们的早期版本支持通过反向代理连接 Web 客户端,但现在可以在没有中间代理的情况下进行。
另一种方法是使用 REST/GraphQL 协议将包装服务层暴露给面向外部的世界,并通过 gRPC 客户端连接。
数据映射和持久性
我们可能需要在其之上添加另一层,以使用 Hibernate 等数据访问库创建功能齐全的域服务。与 Hibernate 或任何数据库一样,需要以某种方式修饰所需的实体,而这对于 protobuf 模型生成的模型可能不可行。因此,我们可能需要一些映射逻辑来将模型类转换为实体类。一个这样好的库是 MapStruct,它基于 bean 约定进行自动映射。我们只需要提供映射接口:
@Mapper
public interface AccountProtoMapper {
Account map(AccountProto accountProto);
AccountProto map(Account account);
}
第三方支持
为了进一步简化整个构建和运行环境,有一些流行的第三方 Maven 插件和库也有帮助。
1. 运行与 Build 集成的 Proto Tool
协议缓冲区 Maven 插件(由 Xolstice 提供)运行 proto 工具及其扩展,以及从*.proto文件构建和生成源代码。它还附加了 .proto*文件作为项目的资源。请参阅示例配置以生成 Java 代码。
<configuration>
<protocArtifact>com.google.protobuf:protoc:${protoc.version}:exe:${os.detected.classifier}</protocArtifact>
<pluginId>grpc-java</pluginId>
<pluginArtifact>io.grpc:protoc-gen-grpc-java:${grpc.version}:exe:${os.detected.classifier}</pluginArtifact>
</configuration>
参考可以在这里找到。
2. 生成映射器类
MapStruct 库支持生成消息类型的映射器类,这些映射器类可以将消息从/到类的实体。它提供了一个注解处理器,通过在构建时分析指定的注解来生成一个映射器类。Maven编译插件参考下面的配置。
<configuration>
<annotationProcessorPaths>
<path>
<groupId>org.mapstruct</groupId>
<artifactId>mapstruct-processor</artifactId>
<version>${mapstruct.version}</version>
</path>
</annotationProcessorPaths>
</configuration>
3.自动启动gRPC服务器并注册服务实现
默认情况下,gRPC 服务器不会与 web 服务器(在本例中为 Netty)一起启动。此外,它需要在服务器启动之前注册所有 gRPC 服务。LogNet 的 gRPC Spring Boot 会自动扫描所有带有@GRpcService注解的类,并向服务器构建器注册服务定义。构建服务器后,它会在 Spring 应用程序属性中配置的端口上自动启动 gRPC 服务器。
除了注册服务和启动服务器外,它还支持自动配置的安全、健康检查和服务发现。有关详细信息,请参阅此处。
GitHub 上提供了上述方法的完整示例实现。
差异化
- 谷歌构建 gRPC 是出于从零开始构建大规模微服务的学习需求。大多数流行的微服务框架仍然缺乏对性能和跨平台支持的要求,因为没有大型系统可以在单个堆栈和单个编码中构建。
- 最受欢迎的是对 HTTP/2 的支持,它仍然是许多提供商的路线图。它为在单个 TCP 连接上使用多路复用非阻塞数据流的二进制线路传输提供了优势。进一步支持标头压缩,它提供了额外的性能优势。
- 除了支持 protobuf 作为主要编码机制外,它还增加了对基于 JSON 的服务的支持,这些服务可以很容易地被低端客户端使用。虽然 protobuf 是实施 gRPC 的推荐方式,但 Google 增加了对 FlatBuffers 的支持,并增加了内部和整个行业的采用率。
- 初始版本支持通过反向代理(如基于 Envoy 和 Ngnix 的系统)公开 gRPC 服务。gRPC Web 的最新发展弥补了这一差距,并通过跨 JavaScript 库采用 HTTP/2 增加了对向 Web 客户端公开 gRCP 服务的支持。进一步的开发正在进行中,以增加对 Angular 和 React 等流行 Web 框架的支持。
- 借助功能齐全的开发堆栈,它还为单元测试助手(如InProcessServer和InProcessChannelBuilder.
采用
- Google 在其内部工具和平台上使用它,例如 Bigtable、Pub/Sub、Speech 和 TensorFlow。
- CoreOS 是 gRPC 的早期采用者,并在其服务发现工具和容器引擎中增加了支持。
- Microsoft 是 gRPC 的高级采用者,并增加了对其 Web API 和构建工具的支持,以简化开发人员无缝构建服务的工作。
- 现在,越来越多的项目在整个行业中使用它,例如 Docker、Square、Netflix 和 Cisco 等开源开发人员。
替代方法
除了构建 gRPC 之外,Google 的应用程序还提供了文章中提到的工具/库和 Spring Boot 启动框架。一些专门的微服务框架为 gRPC 服务实现提供了开箱即用的支持。
- Quarkus gRPC
- Asp.NET gRPC
- Akka gRPC
- Salesforce gRPC
相关推荐
- 一个基于.Net Core遵循Clean Architecture原则开源架构
-
今天给大家推荐一个遵循CleanArchitecture原则开源架构。项目简介这是基于Asp.netCore6开发的,遵循CleanArchitecture原则,可以高效、快速地构建基于Ra...
- AI写代码翻车无数次,我发现只要提前做好这3步,bug立减80%
-
写十万行全是bug之后终于找到方法了开发"提示词管理助手"新版本那会儿,我差点被bug整崩溃。刚开始两周,全靠AI改代码架构,结果十万行程序漏洞百出。本来以为AI说没问题就稳了,结果...
- OneCode低代码平台的事件驱动设计:架构解析与实践
-
引言:低代码平台的事件驱动范式在现代软件开发中,事件驱动架构(EDA)已成为构建灵活、松耦合系统的核心范式。OneCode低代码平台通过创新性的注解驱动设计,将事件驱动理念深度融入平台架构,实现了业务...
- 国内大厂AI插件评测:根据UI图生成Vue前端代码
-
在IDEA中安装大厂的AI插件,打开ruoyi增强项目:yudao-ui-admin-vue31.CodeBuddy插件登录腾讯的CodeBuddy后,大模型选择deepseek-v3,输入提示语:...
- AI+低代码技术揭秘(二):核心架构
-
本文档介绍了为VTJ低代码平台提供支持的基本架构组件,包括Engine编排层、Provider服务系统、数据模型和代码生成管道。有关UI组件库和widget系统的信息,请参阅UI...
- GitDiagram用AI把代码库变成可视化架构图
-
这是一个名为gitdiagram的开源工具,可将GitHub仓库实时转换为交互式架构图,帮助开发者快速理解代码结构。核心功能一键可视化:替换GitHubURL中的"hub...
- 30天自制操作系统:第六天:代码架构整理与中断处理
-
1.拆开bootpack.c文件。根据设计模式将对应的功能封装成独立的文件。2.初始化pic:pic(可编程中断控制器):在设计上,cpu单独只能处理一个中断。而pic是将8个中断信号集合成一个中断...
- AI写代码越帮越忙?2025年研究揭露惊人真相
-
近年来,AI工具如雨后春笋般涌现,许多人开始幻想程序员的未来就是“对着AI说几句话”,就能轻松写出完美的代码。然而,2025年的一项最新研究却颠覆了这一期待,揭示了一个令人意外的结果。研究邀请了16位...
- 一键理解开源项目:两个自动生成GitHub代码架构图与说明书工具
-
一、GitDiagram可以一键生成github代码仓库的架构图如果想要可视化github开源项目:https://github.com/luler/reflex_ai_fast,也可以直接把域名替换...
- 5分钟掌握 c# 网络通讯架构及代码示例
-
以下是C#网络通讯架构的核心要点及代码示例,按协议类型分类整理:一、TCP协议(可靠连接)1.同步通信//服务器端usingSystem.Net.Sockets;usingTcpListene...
- 从复杂到优雅:用建造者和责任链重塑代码架构
-
引用设计模式是软件开发中的重要工具,它为解决常见问题提供了标准化的解决方案,提高了代码的可维护性和可扩展性,提升了开发效率,促进了团队协作,提高了软件质量,并帮助开发者更好地适应需求变化。通过学习和应...
- 低代码开发当道,我还需要学习LangChain这些框架吗?| IT杂谈
-
专注LLM深度应用,关注我不迷路前两天有位兄弟问了个问题:当然我很能理解这位朋友的担忧:期望效率最大化,时间用在刀刃上,“不要重新发明轮子”嘛。铺天盖地的AI信息轰炸与概念炒作,很容易让人浮躁与迷茫。...
- 框架设计并不是简单粗暴地写代码,而是要先弄清逻辑
-
3.框架设计3.框架设计本节我们要开发一个UI框架,底层以白鹭引擎为例。框架设计的第一步并不是直接撸代码,而是先想清楚设计思想,抽象。一个一个的UI窗口是独立的吗?不是的,...
- 大佬用 Avalonia 框架开发的 C# 代码 IDE
-
AvalonStudioAvalonStudio是一个开源的跨平台的开发编辑器(IDE),AvalonStudio的目标是成为一个功能齐全,并且可以让开发者快速使用的IDE,提高开发的生产力。A...
- 轻量级框架Lagent 仅需20行代码即可构建自己的智能代理
-
站长之家(ChinaZ.com)8月30日消息:Lagent是一个专注于基于LLM模型的代理开发的轻量级框架。它的设计旨在简化和提高这种模型下代理的开发效率。LLM模型是一种强大的工具,可以...
你 发表评论:
欢迎- 一周热门
- 最近发表
- 标签列表
-
- 框架图 (58)
- flask框架 (53)
- quartz框架 (51)
- abp框架 (47)
- springmvc框架 (49)
- 分布式事务框架 (65)
- scrapy框架 (56)
- shiro框架 (61)
- 定时任务框架 (56)
- java日志框架 (61)
- mfc框架 (52)
- abb框架断路器 (48)
- beego框架 (52)
- java框架spring (58)
- grpc框架 (65)
- tornado框架 (48)
- 前端框架bootstrap (54)
- orm框架有哪些 (51)
- 知识框架图 (52)
- ppt框架 (55)
- 框架图模板 (59)
- 内联框架 (52)
- cad怎么画框架 (58)
- ssm框架实现登录注册 (49)
- oracle字符串长度 (48)