|
在使用gRpc之前，需要先了解一点基础知识。
1. Protocol Buffers 具体参考https://protobuf.dev/ :
简答来说就是Google开发的一种数据描述的格式。和具体的开发语言无关，根据这个东西，你能定义你方法的参数，返回值类型。
首先 创建一个 xxx.proto 文件 .例如 sayHello.proto
syntax = "proto3"; //必须是第一行 制定使用哪个版本的协议，可以选择 proto2/proto3
//定义一个 消息 ，相当于C#里面的一个类 至于这个类怎么用，一会说
message SearchRequest {
string query = 1;
int32 page_number = 2;
int32 results_per_page = 3;
}
SearchRequest 相当于C#类名字。string ,int32 ,int32 是proto里面的数据类型。query ，page_number ,results_per_page 是类的属性名，后面又给了数字，这个是proto的语法要求。在给字段编号时遵循以下规则
- 你必须给你的字段一个1-536,870,911的编号
- 每个字段的编号必须唯一
- 19,000 to 19,999是 Protocol Buffers 预留的，你要是用了 编译器就报警。(最好别用免得有麻烦)
- 不能使用保留字段名字和保留字段编号
举例子：
message SearchRequest {
reserved 15, 9 to 11;
reserved "foo", "bar";
string query = 1;
int32 page_number = 2;
int32 results_per_page = 3;
string foo =4;
string bar=10;
}
//在这个消息里面 定义了2个保留字段 分别是 foo 和 bar 以及15 ，9,10,11这四个保留的编号，如果你在消息中用了6个中的一个，就会报错。
文档中有一段写了 字段可以是单数或者复数。
单数就用optional修饰和C#中普通的字段没区别 如： string query = 1和optional string query = 1
复数就用repeated修饰，C#对于repeated修饰的字段会生成一个RepeatedField的泛型字段，相当于是list集合 如： repeated string emails= 4; 他最后生成C#类，就简单看成list<string>
定义枚举
在.proto文件中是可以定义枚举的 ,如：
enum Corpus {
CORPUS_UNSPECIFIED = 0;
CORPUS_UNIVERSAL = 1;
CORPUS_WEB = 2;
CORPUS_IMAGES = 3;
CORPUS_LOCAL = 4;
CORPUS_NEWS = 5;
CORPUS_PRODUCTS = 6;
CORPUS_VIDEO = 7;
}
message SearchRequest {
string query = 1;
int32 page_number = 2;
int32 results_per_page = 3;
Corpus corpus = 4;
}
//与C#不同，在.proto（proto3）文件中定义枚举，第一个枚举值必须是0，而且名字是必须是 枚举类型 ENUM_TYPE_NAME_UNSPECIFIED 或者ENUM_TYPE_NAME_UNKNOWN 。（举例，你的枚举叫Colors 那么第一个值就是Colors_UNSPECIFIED=0 ）
//这里我自己测试出来，如果NUM_TYPE_NAME_UNSPECIFIED 或者ENUM_TYPE_NAME_UNKNOWN不写，直接把 red=0 ,也不报错。但是如果你传值，那么默认值就是0 也就是red
package
syntax = "proto3";
option csharp_namespace = "gRPCDemo.demo";
package requestUser;//pacgage 名字
message UserItem{
string name = 1;
int32 age = 2;
string address = 3;
repeated string phones = 4 ;
}
//这个文件我保存在Protos/userPackage.proto。然后别的 地方可以引用他
syntax = "proto3";
option csharp_namespace = "gRPCDemo.demo";
import "Protos/userPackage.proto"; //导入文件路径
package greet;
// 使用的是 requestUser这个包下面的 userItem. requestUser包对应的物理文件是Protos/userPackage.proto
message HelloRequest {
requestUser.UserItem user = 1;
}
// The response message containing the greetings.
message HelloReply {
string message = 1;
}
重点来了。定义服务Defining Services
如果你想让别人调用你的服务（就是别人调用你的方法），就要定义服务
service SearchService {
rpc Search(SearchRequest) returns (SearchResponse);//这里就是我们对外暴露了一个叫做search的方法，这个方法参数是SearchRequest类型，返回值是SearchResponse类型
}
service Greeter {
rpc SayHello (HelloRequest) returns (HelloReply);// 再比如我们定义一个sayhello的方法，参数是HelloRequest返回值是HelloReply
//你要是调用无参的方法 参考这个文档：https://stackoverflow.com/questions/31768665/can-i-define-a-grpc-call-with-a-null-request-or-response/31772973
}
有这些基础后，我们下一节来测试一下。
https://www.cnblogs.com/baiyunpiaopiao/p/18628560
|