gRPC入门学习之旅(二)
2.3、创建自定义服务
除上面的模板中自带的一个gRPC服务之后,我们再创建一个自己的服务,我将创建一个用户信息gRPC服务,主要功能有三个,登录、获取用户信息、修改用户信息。
- 创建UserInfo.proto协议文件
- 在“解决方案资源管理器”中,使用鼠标左键选中“Protos”文件夹,然后在菜单栏上,依次选择“添加-->新建项”。如下图。
- 在“添加新项”对话框中,选择“ASP.NET Core-->常规”节点,然后选择“协议缓冲区文件”项。
- 在“名称”文本框中,输入 UserInfo.proto,然后选择“添加”按钮。如下图。
4.Visual Studio 2022会在Protos目录中添加一个UserInfo.proto协议文件。如下图。
5.这个UserInfo.proto文件中的代码如下:
syntax = "proto3"; option csharp_namespace = "Demo.GrpcService.Protos"; //包名 package user; //服务名称 service UserInfo{ //方法名称 rpc GetUserInfo (UserInfoRequest) returns (UserInfoResult); rpc Login(UserInfoRequest) returns(UserInfoResult); rpc Save(UserInfoRequest) returns (UserInfoResult); } //请求的参数对象 message UserInfoRequest{ string UserName = 1; string Password=2; } //请求响应的对象 message UserInfoResult{ string UserName = 1; string Password=2; int32 Age = 3; string Tel=4; string Name=5; int32 Sex=6; string City=7; bool IsLogin=8; }
- 添加userinfo.proto协议文件的关联配置
6.在“解决方案资源管理器”中,使用鼠标左键选中项目名称“Demo.GrpcService”,然后使用鼠标双击这个名称,Visual Studio 2022将在文本编辑器中打开项目文件。 如下图。
7. 在文本编辑器中找到ItemGroup节点,在ItemGroup
节点中增加如下配置:如下图。
<ItemGroup> <Protobuf Include="Protos\greet.proto" GrpcServices="Server" /> <Protobuf Include="Protos\UserInfo.proto" GrpcServices="Server" /> </ItemGroup>
8.在“解决方案资源管理器”中,使用鼠标左键选中项目名称“Demo.GrpcService”,然后单击鼠标右键,在弹出的快捷菜单中选择“重新生成”菜单项。如下图。
9.我们打开“文件资源管理器”,进入到Demo.Grpc.Service\obj\Debug\net7.0\Protos
目录,发现此时目录下比刚才多了2个.cs文件,就是我们自己定义的UserInfo.proto协议文件对应的类文件,如下图所示: