ToB企服应用市场:ToB评测及商务社交产业平台

标题: Go Zero 与复杂.proto文件：构建强大的游戏服务架构 [打印本页]
作者: 盛世宏图    时间: 2024-9-25 19:13
标题: Go Zero 与复杂.proto文件：构建强大的游戏服务架构



一、引言


在游戏开辟中，高效且可扩展的后端服务架构至关紧张。Go Zero 框架凭借其强大的功能，特殊是基于.proto文件的自动代码生成，为我们提供了一种高效的开辟方式。本文将深入探讨一个更复杂的.proto文件示例，并展示如何利用它在 Go Zero 中构建游戏服务架构。

二、.proto文件概述


我们的.proto文件界说了多个服务，涵盖了游戏中的关键功能模块。以下是其主要内容：

1. 用户服务（UserService）




2. 物品服务（ItemService）




3. 任务服务（QuestService）



  1. syntax = "proto3";
  3. package mygame;
  5. // 用户服务
  6. service UserService {
  7.     rpc GetUser(GetUserRequest) returns (GetUserResponse);
  8.     rpc UpdateUser(UpdateUserRequest) returns (UpdateUserResponse);
  9. }
  11. // 用户请求和响应消息
  12. message GetUserRequest {
  13.     string user_id = 1;
  14. }
  16. message GetUserResponse {
  17.     string user_id = 1;
  18.     string username = 2;
  19.     string email = 3;
  20. }
  22. message UpdateUserRequest {
  23.     string user_id = 1;
  24.     string username = 2;
  25.     string email = 3;
  26. }
  28. message UpdateUserResponse {
  29.     bool success = 1;
  30. }
  32. // 物品服务
  33. service ItemService {
  34.     rpc GetItem(GetItemRequest) returns (GetItemResponse);
  35.     rpc CreateItem(CreateItemRequest) returns (CreateItemResponse);
  36. }
  38. // 物品请求和响应消息
  39. message GetItemRequest {
  40.     string item_id = 1;
  41. }
  43. message GetItemResponse {
  44.     string item_id = 1;
  45.     string name = 2;
  46.     int32 quantity = 3;
  47. }
  49. message CreateItemRequest {
  50.     string name = 1;
  51.     int32 quantity = 2;
  52. }
  54. message CreateItemResponse {
  55.     string item_id = 1;
  56.     bool success = 2;
  57. }
  59. // 任务服务
  60. service QuestService {
  61.     rpc GetQuest(GetQuestRequest) returns (GetQuestResponse);
  62.     rpc CompleteQuest(CompleteQuestRequest) returns (CompleteQuestResponse);
  63. }
  65. // 任务请求和响应消息
  66. message GetQuestRequest {
  67.     string quest_id = 1;
  68. }
  70. message GetQuestResponse {
  71.     string quest_id = 1;
  72.     string name = 2;
  73.     string description = 3;
  74. }
  76. message CompleteQuestRequest {
  77.     string quest_id = 1;
  78. }
  80. message CompleteQuestResponse {
  81.     bool success = 1;
  82.     string reward = 2;
  83. }
复制代码

三、使用 Go Zero 工具生成代码


1. 安装goctl


可以通过以下下令安装goctl：

  1. go install github.com/zeromicro/go-zero/tools/goctl@latest
复制代码

2. 生成代码


假设上面的.proto文件名为game.proto，位于当前目次下。可以使用以下下令生成服务端代码：

  1. goctl rpc protoc game.proto --go_out=. --go-grpc_out=. --zrpc_out=.
复制代码

这将生成多个文件，主要按照服务进行区分：




  1. // user_service.go
  2. type UserService struct{}
  4. func (s *UserService) GetUser(ctx context.Context, in *GetUserRequest) (*GetUserResponse, error) {
  5.     // 实现获取用户逻辑
  6.     return &GetUserResponse{UserID: in.UserID, Username: "example_username", Email: "example@example.com"}, nil
  7. }
  9. func (s *UserService) UpdateUser(ctx context.Context, in *UpdateUserRequest) (*UpdateUserResponse, error) {
  10.     // 实现更新用户逻辑
  11.     return &UpdateUserResponse{Success: true}, nil
  12. }
复制代码

  1. // item_service.go
  2. type ItemService struct{}
  4. func (s *ItemService) GetItem(ctx context.Context, in *GetItemRequest) (*GetItemResponse, error) {
  5.     // 实现获取物品逻辑
  6.     return &GetItemResponse{ItemID: in.ItemID, Name: "example_item", Quantity: 10}, nil
  7. }
  9. func (s *ItemService) CreateItem(ctx context.Context, in *CreateItemRequest) (*CreateItemResponse, error) {
  10.     // 实现创建物品逻辑
  11.     return &CreateItemResponse{ItemID: "new_item_id", Success: true}, nil
  12. }
复制代码

  1. // quest_service.go
  2. type QuestService struct{}
  4. func (s *QuestService) GetQuest(ctx context.Context, in *GetQuestRequest) (*GetQuestResponse, error) {
  5.     // 实现获取任务逻辑
  6.     return &GetQuestResponse{QuestID: in.QuestID, Name: "example_quest", Description: "example_description"}, nil
  7. }
  9. func (s *QuestService) CompleteQuest(ctx context.Context, in *CompleteQuestRequest) (*CompleteQuestResponse, error) {
  10.     // 实现完成任务逻辑
  11.     return &CompleteQuestResponse{Success: true, Reward: "example_reward"}, nil
  12. }
复制代码



  1. func main() {
  2.     s := engine.NewServer(
  3.         rpc.NewServer(
  4.             mygame.RegisterUserServiceServer(&UserService{}),
  5.             mygame.RegisterItemServiceServer(&ItemService{}),
  6.             mygame.RegisterQuestServiceServer(&QuestService{}),
  7.         ),
  8.     )
  9.     s.Start()
  10. }
复制代码

对于客户端代码，可以使用以下下令：

  1. goctl rpc client game.proto --zrpc
复制代码

这将生成客户端代码，用于调用长途服务。客户端代码也会按照服务进行区分，方便调用差别的服务方法。

四、总结


通过这个复杂的.proto文件示例，我们展示了如安在 Go Zero 中构建一个功能丰富的游戏服务架构。利用.proto文件界说清晰的服务接口，再结合goctl工具自动生成代码，大大提高了开辟效率和代码的可维护性。无论是在游戏开辟还是其他领域的微服务架构中，这种方式都具有很大的代价。

希望这篇博客文章能够帮助你更好地明白和运用 Go Zero 与.proto文件，为你的项目开辟带来更多的便利和强大的功能。

第一个题目，带rpc和不带rpc有什么区别 第二个题目.api文件和.proto文件可以交换吗

一、带 rpc 和不带 rpc 的区别

在 Protobuf 界说中，使用 “rpc” 关键字界说的是长途过程调用（Remote Procedure Call）方法。


二、.api 文件和.proto 文件可以交换吗

.api文件和.proto文件一样平常不能直接交换。


综上所述，带 “rpc” 和不带 “rpc” 在 Protobuf 中有明白的功能区分，而.api文件和.proto文件通常不能交换使用。


免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。



欢迎光临 ToB企服应用市场:ToB评测及商务社交产业平台 (https://dis.qidao123.com/) Powered by Discuz! X3.4