0

0

Golang如何使用Protobuf定义RPC接口

P粉602998670

P粉602998670

发布时间:2025-10-12 10:58:01

|

286人浏览过

|

来源于php中文网

原创

在Go中使用Protobuf定义RPC需先编写.proto文件,用service声明服务及方法;2. 通过protoc生成Go代码,包括消息结构体和服务接口;3. 实现服务端结构体并注册gRPC服务;4. 客户端通过Stub调用远程方法,完成通信。该流程支持跨语言、高效率的微服务交互。

golang如何使用protobuf定义rpc接口

在Go语言中使用Protobuf定义RPC接口,核心是通过.proto文件描述服务方法,然后借助代码生成工具生成Go代码。整个流程清晰、高效,广泛应用于gRPC等系统中。

1. 定义.proto文件中的service

你需要编写一个.proto文件,在其中定义RPC服务和方法。使用service关键字声明服务,每个方法指定输入和输出类型,这些类型必须是已定义的message

示例:

rpc_service.proto

syntax = "proto3";

package example;

// 定义请求和响应消息
message HelloRequest {
    string name = 1;
}

message HelloResponse {
    string message = 1;
}

// 定义RPC服务
service Greeter {
    rpc SayHello (HelloRequest) returns (HelloResponse);
}

这个文件定义了一个名为Greeter的服务,包含一个SayHello方法,接收HelloRequest,返回HelloResponse

立即学习go语言免费学习笔记(深入)”;

2. 生成Go代码

需要安装protoc编译器以及Go插件来生成代码。

安装工具:

  • 下载protoc:从 GitHub releases 获取对应平台版本
  • 安装Go插件:
go install google.golang.org/protobuf/cmd/protoc-gen-go@latest
go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@latest

生成代码命令:

DeepL
DeepL

DeepL是一款强大的在线AI翻译工具,可以翻译31种不同语言的文本,并可以处理PDF、Word、PowerPoint等文档文件

下载
protoc --go_out=. --go-grpc_out=. rpc_service.proto

执行后会生成两个文件:

  • rpc_service.pb.go:包含消息类型的Go结构体和序列化方法
  • rpc_service_grpc.pb.go:包含客户端和服务端接口定义

3. 实现服务端逻辑

在Go中实现服务接口,只需定义一个结构体并实现.proto中声明的方法。

服务实现示例:

package main

import (
    "context"
    "log"
    "net"

    "google.golang.org/grpc"
    pb "your-module-path/example" // 替换为你的模块路径
)

type server struct {
    pb.UnimplementedGreeterServer
}

func (s *server) SayHello(ctx context.Context, req *pb.HelloRequest) (*pb.HelloResponse, error) {
    return &pb.HelloResponse{
        Message: "Hello, " + req.Name,
    }, nil
}

func main() {
    lis, err := net.Listen("tcp", ":50051")
    if err != nil {
        log.Fatalf("failed to listen: %v", err)
    }
    s := grpc.NewServer()
    pb.RegisterGreeterServer(s, &server{})
    log.Println("gRPC server running on :50051")
    s.Serve(lis)
}

4. 编写客户端调用

客户端通过gRPC连接服务端,调用生成的Stub方法。

客户端示例:

package main

import (
    "context"
    "log"

    "google.golang.org/grpc"
    "google.golang.org/grpc/credentials/insecure"
    pb "your-module-path/example"
)

func main() {
    conn, err := grpc.Dial("localhost:50051", grpc.WithTransportCredentials(insecure.NewCredentials()))
    if err != nil {
        log.Fatalf("did not connect: %v", err)
    }
    defer conn.Close()

    client := pb.NewGreeterClient(conn)
    resp, err := client.SayHello(context.Background(), &pb.HelloRequest{Name: "Alice"})
    if err != nil {
        log.Fatalf("call failed: %v", err)
    }

    log.Printf("Response: %s", resp.Message)
}

基本上就这些。通过.proto定义接口,工具生成代码,再分别实现服务端和客户端,就能完成一个完整的gRPC通信流程。这种方式保证了跨语言兼容性和接口一致性,适合微服务架构。

相关专题

更多
golang如何定义变量
golang如何定义变量

golang定义变量的方法:1、声明变量并赋予初始值“var age int =值”;2、声明变量但不赋初始值“var age int”;3、使用短变量声明“age :=值”等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

178

2024.02.23

golang有哪些数据转换方法
golang有哪些数据转换方法

golang数据转换方法:1、类型转换操作符;2、类型断言;3、字符串和数字之间的转换;4、JSON序列化和反序列化;5、使用标准库进行数据转换;6、使用第三方库进行数据转换;7、自定义数据转换函数。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

226

2024.02.23

golang常用库有哪些
golang常用库有哪些

golang常用库有:1、标准库;2、字符串处理库;3、网络库;4、加密库;5、压缩库;6、xml和json解析库;7、日期和时间库;8、数据库操作库;9、文件操作库;10、图像处理库。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

337

2024.02.23

golang和python的区别是什么
golang和python的区别是什么

golang和python的区别是:1、golang是一种编译型语言,而python是一种解释型语言;2、golang天生支持并发编程,而python对并发与并行的支持相对较弱等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

208

2024.03.05

golang是免费的吗
golang是免费的吗

golang是免费的。golang是google开发的一种静态强类型、编译型、并发型,并具有垃圾回收功能的开源编程语言,采用bsd开源协议。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

389

2024.05.21

golang结构体相关大全
golang结构体相关大全

本专题整合了golang结构体相关大全,想了解更多内容,请阅读专题下面的文章。

195

2025.06.09

golang相关判断方法
golang相关判断方法

本专题整合了golang相关判断方法,想了解更详细的相关内容,请阅读下面的文章。

191

2025.06.10

golang数组使用方法
golang数组使用方法

本专题整合了golang数组用法,想了解更多的相关内容,请阅读专题下面的文章。

192

2025.06.17

Golang gRPC 服务开发与Protobuf实战
Golang gRPC 服务开发与Protobuf实战

本专题系统讲解 Golang 在 gRPC 服务开发中的完整实践,涵盖 Protobuf 定义与代码生成、gRPC 服务端与客户端实现、流式 RPC(Unary/Server/Client/Bidirectional)、错误处理、拦截器、中间件以及与 HTTP/REST 的对接方案。通过实际案例,帮助学习者掌握 使用 Go 构建高性能、强类型、可扩展的 RPC 服务体系,适用于微服务与内部系统通信场景。

4

2026.01.15

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Git 教程
Git 教程

共21课时 | 2.7万人学习

Git版本控制工具
Git版本控制工具

共8课时 | 1.5万人学习

Git中文开发手册
Git中文开发手册

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号