这篇文章主要讲解了“gRPC之proto及Maven插件怎么使用”,文中的讲解内容简单清晰,易于学习与理解,下面请大家跟着小编的思路慢慢深入,一起来研究和学习“gRPC之proto及Maven插件怎么使用”吧!protobuf 是 gRPC 中生成 API Service 的方式,在 Maven 编译时就可以快速生成对应的Class类。以 Maven 为例,在 gRPC 中通常使用 protobuf-maven-plugin 插件,根据一个 .proto 文件生成对应的 Java 代码。 其本身是基于 Google 的 Protocol Buffers 工具链实现的。S1 : 创建一个 .proto 文件,按照规范要求定义元数据内容S2 : 通过 protobuf-maven-plugin
插件进行 compile 操作S3 : protobuf-maven-plugin
调用 protoc
命令行工具,生成对应的 Java 代码S4 : 生成的 Java 代码会被编译,并打包成 Jar 包 , 最终生成可执行文件给项目使用.proto 文件格式通常一个 proto 文件中会包含以下主要内容package: 包名,用于区分不同模块的数据结构定义。message: 消息体,包含多个字段,每个字段都有一个名称和类型。enum: 枚举类型,定义多个枚举值。service: 定义 RPC 服务接口,包含多个方法,每个方法都有一个请求消息和一个响应消息。生成一个 .class 文件这里就可以看到,其实生成了很多文件,最重要的包括 :UserServiceGrpc ,HelloRequest 和 HelloResponse 这几个。使用文件使用文件和平时使用 Class 是一致的,引入 Maven 依赖然后直接调用就行了上面看了插件的使用,后面就来详细看看它生成的几个 Class 到底包含了什么 :以 UserServiceGrpc 为例 ,整个类包含这些核心方法 :getQueryMethod : 这个对应 proto 文件中的 query 方法MethodDescriptor 是 gRPC 中的专属对象,用于表示一个gRPC方法的描述。 其中包含了方法名,输入输出,请求流和响应流等信息。后续很多流程中都会通过该对象进行请求Client的创建,和RPC方法的注册。除了核心方法,其他比较主要的就是 stub 对象了。stub 对象用于向服务端发起 RPC 调用。使用 gRPC 时,客户端通过创建一个与服务端相同的 stub 对象来发起远程调用,封装了底层的网络通信细节。UserServiceGrpc 中有一个 newStub 方法,同时对应的还有 newBlockingStub 和 newFutureStub 。这些对象用于创建阻塞,异步回调的请求类型。这里倒没太多东西,主要是 DTO 和 DTOOrBuilder 。DTO 类 (HelloRequest)这个类比我们想的要大的多,一般我们认为 DTO 里面主要是 Getter / Setter 这些方法 ,但是 proto 生成的 DTO 要复杂得多// 容易让人迷惑的方法 :
– getUnknownFields : 获取消息中的未知字段 (解析器未知的字段)
– internalGetFieldAccessorTable : 获取特定protobuf消息类型的字段访问器表格
– isInitialized : 用于判断一个对象是否已经被完全初始化的方法 (避免字段未被初始化完全)
– getSerializedSize : 用于计算当前消息的序列化后的大小 , 用于免费云主机域名预留缓冲空间
– parseFrom : 用于将二进制数据解析成 Protobuf 消息对象
– parseFrom(byte[] data):从字节数组解析 Protobuf 消息对象
– parseFrom(byte[] data, int off, int len):从字节数组的指定位置和长度解析 Protobuf 消息对象
– parseFrom(InputStream input):从输入流解析 Protobuf 消息对象
– parseFrom(CodedInputStream input):从 CodedInputStream 对象解析 Protobuf 消息对象
– newBuilderForType : 创建当前消息类型的 Builder 对象,用于构建该类型的消息
– toBuilder :用于返回一个可以修改消息的构建器对象 , 配合 newBuilder 一起使用
– parser : 接收一个字节数组或者一个输入流作为参数,并返回一个对应的消息对象DTOOrBuilder (HelloRequestOrBuilder)在不需要修改消息属性的场景下,提供一种更轻量级的消息访问方式UserServiceOuterClassOuterClass 是 proto 文件中定义的一个特殊类,用于包含所有其他消息和服务定义,可以作为访问对应类的入口点。感谢各位的阅读,以上就是“gRPC之proto及Maven插件怎么使用”的内容了,经过本文的学习后,相信大家对gRPC之proto及Maven插件怎么使用这一问题有了更深刻的体会,具体使用情况还需要大家实践验证。这里是百云主机,小编将为大家推送更多相关知识点的文章,欢迎关注!
这篇文章主要介绍了Spring构造函数推断的原理是什么的相关知识,内容详细易懂,操作简单快捷,具有一定借鉴价值,相信大家阅读完这篇Spring构造函数推断的原理是什么文章免费云主机域名都会有所收获,下面我们一起来看看吧。Spring 提供了一组基本的功能,例如…
免责声明:本站发布的图片视频文字,以转载和分享为主,文章观点不代表本站立场,本站不承担相关法律责任;如果涉及侵权请联系邮箱:360163164@qq.com举报,并提供相关证据,经查实将立刻删除涉嫌侵权内容。