GolangRPC客户端与服务器完整示例

Golang的net/rpc包提供高效、强类型的RPC通信机制,适用于高性能微服务内部通信。通过定义共享接口(如Arith服务的Multiply方法),在服务器端注册服务并监听连接,客户端通过Dial建立连接后可同步或异步调用远程方法。相比RESTful API,RPC使用二进制编码(如gob),性能更高、延迟更低,适合对性能敏感的内部服务通信;而REST因基于HTTP、易于调试和跨语言兼容,更适合公共API。实现时需遵循方法导出、两个参数(请求和指针响应)、返回error等规则,并通过rpc.Register注册服务。生产环境中需结合context实现超时控制,合理处理错误(如自定义错误类型),复用rpc.Client实例以减少连接开销,并设计重连机制应对网络不稳,确保系统健壮性。

golangrpc客户端与服务器完整示例

Golang的

net/rpc

包提供了一种非常直观且高效的方式来构建远程过程调用(RPC)系统,它让不同进程甚至不同机器上的程序能够像调用本地函数一样互相通信。这种内置的机制,在我看来,是Go语言在并发和网络编程领域强大能力的又一体现,特别适合构建高性能的微服务内部通信。

解决方案

要搭建一个Golang RPC客户端与服务器的完整示例,我们需要三个核心部分:一个共享的接口定义(通常是结构体及其方法),一个服务器端实现,以及一个客户端调用。

首先,我们定义一个共享的服务接口。为了简单起见,我们创建一个

Arith

服务,它有一个

Multiply

方法。这个定义在客户端和服务器端都需要。

shared/arith.go

(共享定义)

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

package shared// Args 定义了乘法运算的两个操作数type Args struct {    A, B int}// Quotient 定义了除法运算的结果(如果我们要扩展的话)type Quotient struct {    Quo, Rem int}// Arith 是我们的RPC服务接口type Arith int // 只是一个占位符,实际方法会绑定到这个类型上

接着,我们实现服务器端。服务器会注册

Arith

服务,并监听一个端口,等待客户端连接。

server/main.go

(服务器端)

package mainimport (    "log"    "net"    "net/rpc"    "time"    "your_module_path/shared" // 替换为你的模块路径)// Arith 是服务的实际实现type Arith int// Multiply 方法接收Args结构体作为参数,将结果写入reply,并返回errorfunc (t *Arith) Multiply(args *shared.Args, reply *int) error {    log.Printf("Server received Multiply request: %d * %d", args.A, args.B)    *reply = args.A * args.B    time.Sleep(100 * time.Millisecond) // 模拟一些工作负载    return nil}func main() {    arith := new(Arith)    rpc.Register(arith) // 注册服务实例    tcpAddr, err := net.ResolveTCPAddr("tcp", ":1234")    if err != nil {        log.Fatalf("Error resolving TCP address: %v", err)    }    listener, err := net.ListenTCP("tcp", tcpAddr)    if err != nil {        log.Fatalf("Error listening on port: %v", err)    }    log.Println("RPC Server started on port 1234")    for {        conn, err := listener.Accept()        if err != nil {            log.Printf("Accept error: %v", err)            continue        }        // 为每个新连接启动一个goroutine来处理RPC请求        go rpc.ServeConn(conn)    }}

最后,我们构建客户端,它会连接到服务器,并调用

Multiply

方法。

client/main.go

(客户端)

package mainimport (    "context"    "log"    "net/rpc"    "time"    "your_module_path/shared" // 替换为你的模块路径)func main() {    client, err := rpc.Dial("tcp", "localhost:1234")    if err != nil {        log.Fatalf("Error dialing RPC server: %v", err)    }    defer client.Close()    args := shared.Args{A: 7, B: 8}    var reply int    // 创建一个带超时的上下文    ctx, cancel := context.WithTimeout(context.Background(), 2*time.Second)    defer cancel()    // 异步调用RPC,并在select中处理结果或超时    call := client.Go("Arith.Multiply", args, &reply, nil)    select {    case <-call.Done:        if call.Error != nil {            log.Fatalf("RPC call error: %v", call.Error)        }        log.Printf("Arith: %d * %d = %d", args.A, args.B, reply)    case <-ctx.Done():        log.Printf("RPC call timed out: %v", ctx.Err())    }    // 再次调用,这次使用同步方式    var reply2 int    args2 := shared.Args{A: 10, B: 5}    err = client.Call("Arith.Multiply", args2, &reply2)    if err != nil {        log.Fatalf("Synchronous RPC call error: %v", err)    }    log.Printf("Arith: %d * %d = %d", args2.A, args2.B, reply2)}

要运行这个示例,你需要将

your_module_path

替换为你的Go模块路径(例如

github.com/yourusername/yourproject

),并在项目根目录运行

go mod init your_module_path

。然后先启动服务器,再启动客户端。你会看到服务器打印接收到的请求,客户端打印计算结果。

Golang RPC与RESTful API,我该如何选择?

这确实是一个老生常谈的问题,但每次我启动新项目,尤其涉及内部服务通信时,都会在脑海里过一遍。对我来说,选择Golang RPC还是RESTful API,很大程度上取决于服务的“受众”和“性能敏感度”。

RESTful API,以其无状态、易于理解和调试的特性,以及广泛的工具支持,无疑是构建公共API或与前端(Web/移动)交互的首选。它基于HTTP协议,请求和响应通常是JSON或XML,人类可读性极强。如果你需要一个对外开放、兼容性好的接口,或者你的服务需要被各种异构系统消费,那么REST几乎是你的不二之选。它的松耦合特性也意味着服务之间可以独立演进,不会因为接口变更而频繁牵连。

然而,当谈到微服务之间的内部通信,特别是对性能、延迟有较高要求,或者服务间数据传输量大时,Golang RPC的优势就显现出来了。

net/rpc

通常使用Go的

gob

编码,这是一种二进制协议,相比于JSON/HTTP,它的序列化和反序列化效率更高,数据包也更小。这意味着更低的网络开销和更快的处理速度。此外,RPC通常是强类型的,服务接口在编译时就能确定,减少了运行时因类型不匹配导致的错误,这对于大型、复杂的微服务系统来说,能带来更好的开发体验和维护性。我个人在构建一些后端计算密集型服务时,就更倾向于RPC,因为它能榨取出更多的性能潜力。当然,这种紧密的类型绑定也意味着服务间的耦合度相对较高,接口变更可能需要同步更新客户端,这需要团队在设计时就考虑清楚。

Golang RPC服务接口定义与注册的那些事儿

在Golang中定义RPC服务接口,其实比很多人想象的要简单,但也有一些约定俗成的规则需要遵守,否则你的方法就无法被RPC系统识别。我刚开始接触时,也踩过一些小坑,比如忘记将方法首字母大写,或者参数类型不对。

核心规则是:

方法必须是导出(Exported)的: 也就是说,方法名首字母必须大写。方法必须有两个参数: 第一个参数是请求(request)类型,第二个参数是响应(response)类型。第二个参数必须是指针类型: 这是因为RPC系统需要将结果写入这个参数。方法必须返回一个

error

类型: 如果方法执行成功,返回

nil

;如果失败,返回具体的错误信息。

举个例子,我们上面的

Multiply

方法:

func (t *Arith) Multiply(args *shared.Args, reply *int) error

这里

t *Arith

是接收者,

args *shared.Args

是请求参数,

reply *int

是响应参数(指针),

error

是返回类型。

服务注册则是通过

rpc.Register(serviceInstance)

rpc.RegisterName(name, serviceInstance)

完成的。

rpc.Register

会使用服务实例的类型名(比如

Arith

)作为RPC服务的名称。而

rpc.RegisterName

允许你自定义服务的名称,这在某些情况下非常有用,比如当你需要注册多个相同类型的服务,或者想给服务一个更具描述性的名字时。注册之后,客户端就可以通过这个名称来调用服务的方法了,例如

client.Call("Arith.Multiply", ...)

理解这些规则和注册机制,是构建健壮Golang RPC服务的基石。它们确保了RPC框架能够正确地反射出你的方法,并进行参数的序列化与反序列化。

应对Golang RPC中的错误、超时与连接管理

在实际生产环境中,网络通信总是充满了不确定性。错误、超时和连接断开是常态,而不是异常。因此,在Golang RPC中,妥善处理这些问题至关重要,它直接关系到服务的健壮性和用户体验。

错误处理Golang RPC方法的返回类型是

error

,这意味着每次RPC调用后,我们都应该检查这个错误。服务器端返回的任何非

nil

错误,都会在客户端的

client.Call

call.Error

中体现。这允许我们构建自定义的错误类型,以便客户端可以根据错误类型进行不同的处理。比如,定义一个

InvalidArgumentError

,当客户端传入无效参数时返回,客户端收到后就知道是参数问题,而不是网络问题

// 服务器端func (t *Arith) Divide(args *shared.Args, reply *shared.Quotient) error {    if args.B == 0 {        return errors.New("divide by zero") // 返回自定义错误    }    // ...    return nil}// 客户端var quo shared.Quotienterr := client.Call("Arith.Divide", args, &quo)if err != nil {    if err.Error() == "divide by zero" {        log.Println("Error: Cannot divide by zero!")    } else {        log.Printf("RPC call failed: %v", err)    }}

超时机制超时是防止服务雪崩的关键。如果一个RPC调用长时间没有响应,它可能会阻塞客户端,并耗尽资源。在Golang RPC客户端中,我们可以利用

context

包来优雅地实现超时。通过

context.WithTimeout

创建一个带有超时的上下文,然后在异步RPC调用(

client.Go

)后,通过

select

语句监听

call.Done

通道和

ctx.Done

通道。哪个先触发,我们就处理哪个。

// 客户端示例(已在解决方案中给出)ctx, cancel := context.WithTimeout(context.Background(), 2*time.Second)defer cancel()call := client.Go("Arith.Multiply", args, &reply, nil)select {case <-call.Done:    // RPC调用完成,处理结果case <-ctx.Done():    // RPC调用超时    log.Printf("RPC call timed out: %v", ctx.Err())}

这种模式非常强大,它允许你在不阻塞主goroutine的情况下,同时管理RPC调用的完成和超时。

连接管理RPC客户端与服务器的连接管理也需要细心。

rpc.Dial

会建立一个TCP连接,并将其封装成

rpc.Client

。在客户端,通常建议复用这个

rpc.Client

实例,而不是每次调用都重新建立连接,因为连接的建立是有开销的。如果连接断开(例如服务器重启),

client.Call

会返回错误。在生产系统中,我们通常会实现一个连接池或重连机制,当检测到连接断开时,尝试重新建立连接,或者从连接池中获取一个新的可用连接。这部分通常会涉及到一些更高级的设计模式,比如使用

sync.Pool

来管理

rpc.Client

实例,或者实现一个带有指数退避策略的重连器。服务器端则需要考虑优雅停机,确保在关闭前处理完所有正在进行的请求,避免客户端接收到意外的连接关闭错误。

以上就是GolangRPC客户端与服务器完整示例的详细内容,更多请关注创想鸟其它相关文章!

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 chuangxiangniao@163.com 举报,一经查实,本站将立刻删除。
发布者:程序猿,转转请注明出处:https://www.chuangxiangniao.com/p/1403046.html

(0)
打赏 微信扫一扫 微信扫一扫 支付宝扫一扫 支付宝扫一扫
Golang微服务分布式事务处理方法
上一篇 2025年12月15日 19:14:34
go语言和java哪个更有前途
下一篇 2025年12月15日 19:14:59

相关推荐

  • composer require-dev和require有什么不同_Composer Require与Require-Dev区别解析

    require用于声明项目运行必需的依赖,如框架、数据库组件和第三方SDK,这些包会随项目部署到生产环境;2. require-dev用于声明仅在开发和测试阶段需要的工具,如PHPUnit、PHPStan、Faker等,不会默认部署到生产环境;3. 安装时composer install根据环境决定…

    2026年5月10日
    1000
  • 修复Django电商项目中AJAX过滤产品列表图片不显示问题

    在Django电商项目中,当使用AJAX动态加载过滤后的产品列表时,常遇到图片无法正常显示的问题。这通常是由于前端模板中图片加载方式(如data-setbg属性结合JavaScript库)与AJAX动态内容更新机制不兼容所致。解决方案是直接在AJAX返回的HTML中使用标准的标签来渲染图片,确保浏览…

    2026年5月10日
    000
  • 开源免费PHP工具 PHP开发效率提升利器

    推荐开源免费PHP开发工具以提升效率:VS Code、Sublime Text轻量高效,PhpStorm专业强大;调试用Xdebug、Kint、Ray;依赖管理选Composer;代码质量工具包括PHPStan、Psalm、PHP_CodeSniffer;数据库管理可用%ignore_a_1%MyA…

    2026年5月10日
    000
  • Matplotlib 地图中多类型图例的创建与优化

    Matplotlib 地图中多类型图例的创建与优化Matplotlib 地图中多类型图例的创建与优化Matplotlib 地图中多类型图例的创建与优化Matplotlib 地图中多类型图例的创建与优化

    本教程旨在解决matplotlib地图可视化中,如何在一个图例中同时展示颜色块(如区域分类)和自定义标记(如特定兴趣点)的问题。文章详细介绍了当传统`patch`对象无法正确显示标记时,如何利用`matplotlib.lines.line2d`创建标记图例句柄,并将其与颜色块图例句柄合并,从而生成一…

    2026年5月10日 用户投稿
    100
  • Golang JSON序列化:控制敏感字段暴露的最佳实践

    本教程探讨golang中如何高效控制结构体字段在json序列化时的可见性。当需要将包含敏感信息的结构体数组转换为json响应时,通过利用`encoding/json`包提供的结构体标签,特别是`json:”-“`,可以轻松实现对特定字段的忽略,从而避免敏感数据泄露,确保api…

    2026年5月10日
    000
  • 利用海象运算符简化条件赋值:Python教程与最佳实践

    本文旨在探讨Python中海象运算符(:=)在条件赋值场景下的应用。通过对比传统if/else语句与海象运算符,以及条件表达式,分析海象运算符在简化代码、提高可读性方面的优势与局限性。并通过具体示例,展示如何在列表推导式等场景下合理使用海象运算符,同时强调其潜在的复杂性及替代方案,帮助开发者更好地掌…

    2026年5月10日
    100
  • Debian syslog性能优化技巧有哪些

    提升Debian系统syslog (通常基于rsyslog)性能,关键在于精简配置和高效处理日志。以下策略能有效优化日志管理,提升系统整体性能: 精简配置,高效加载: 在rsyslog配置文件中,仅加载必要的输入、输出和解析模块。 使用全局指令设置日志级别和格式,避免不必要的处理。 自定义模板: 创…

    2026年5月10日
    000
  • 比特币新手教程 比特币交易平台有哪些

    比特币是一种去中心化的数字货币,基于区块链技术实现点对点交易,具有匿名性、有限发行和不可篡改等特点;新手可通过交易所购买,P2P交易获得比特币,常用平台包括Binance、OKX和Huobi;交易流程包括注册账户、实名认证、绑定支付方式、充值法币并下单购买,可选择市价单或限价单;比特币存储方式有交易…

    2026年5月10日
    000
  • c++中的SFINAE技术是什么_c++模板编程中的SFINAE原理与应用

    SFINAE 是“替换失败不是错误”的原则,指模板实例化时若参数替换导致错误,只要存在其他合法候选,编译器不报错而是继续重载决议。它用于条件启用模板、类型检测等场景,如通过 decltype 或 enable_if 控制函数重载,实现类型特征判断。尽管 C++20 引入 Concepts 简化了部分…

    2026年5月10日
    000
  • Golang gRPC流式请求异常处理

    在Golang的gRPC流式通信中,必须通过context.Context处理异常。应监听上下文取消或超时,及时释放资源,设置合理超时,避免连接长时间挂起,并在goroutine中通过context控制生命周期。 在使用 Golang 和 gRPC 实现流式通信时,异常处理是确保服务健壮性的关键部分…

    2026年5月10日
    000
  • Go语言mgo查询构建:深入理解bson.M与日期范围查询的正确实践

    本文旨在解决go语言mgo库中构建复杂查询时,特别是涉及嵌套`bson.m`和日期范围筛选的常见错误。我们将深入剖析`bson.m`的类型特性,解释为何直接索引`interface{}`会导致“invalid operation”错误,并提供一种推荐的、结构清晰的代码重构方案,以确保查询条件能够正确…

    2026年5月10日
    100
  • vscode上怎么运行html_vscode上运行html步骤【指南】

    首先保存文件为.html格式,再通过浏览器或Live Server插件打开预览;推荐安装Live Server实现本地服务器运行与实时刷新,提升开发体验。 在 VS Code 上运行 HTML 文件并不需要复杂的配置,只需几个简单步骤即可预览页面效果。VS Code 本身是一个代码编辑器,不直接运行…

    2026年5月10日
    100
  • Golang goroutine与channel调试技巧

    使用go run -race检测数据竞争,结合runtime.NumGoroutine监控协程数量,通过pprof分析阻塞调用栈,利用select超时避免永久阻塞,有效排查goroutine泄漏、死锁和数据竞争问题。 Go语言的goroutine和channel是并发编程的核心,但它们也带来了调试上…

    2026年5月10日
    000
  • 使用 Jupyter Notebook 进行探索性数据分析

    Jupyter Notebook通过单元格实现代码与Markdown结合,支持数据导入(pandas)、清洗(fillna)、探索(matplotlib/seaborn可视化)、统计分析(describe/corr)和特征工程,便于记录与分享分析过程。 Jupyter Notebook 是进行探索性…

    2026年5月10日
    000
  • 《魔兽世界》将于6月11日开启国服回归技术测试

    《魔兽世界》将于6月11日开启国服回归技术测试《魔兽世界》将于6月11日开启国服回归技术测试《魔兽世界》将于6月11日开启国服回归技术测试《魔兽世界》将于6月11日开启国服回归技术测试

    《%ign%ignore_a_1%re_a_1%》官方宣布,将于6月11日开启国服回归技术测试,时间为7天,并称可以在6月内正式开服,玩家们可以访问官网下载战网客户端并预下载“巫妖王之怒”客户端,技术测试详情见下图。 WordAi WordAI是一个AI驱动的内容重写平台 53 查看详情 以上就是《…

    2026年5月10日 用户投稿
    200
  • 如何在HTML中插入表单元素_HTML表单控件与输入类型使用指南

    HTML表单通过标签构建,包含action和method属性定义数据提交目标与方式,常用input类型如text、password、email等适配不同输入需求,配合label、required、placeholder提升可用性,结合textarea、select、button等控件实现完整交互,是…

    2026年5月10日
    100
  • 前端缓存策略与JavaScript存储管理

    根据数据特性选择合适的存储方式并制定清晰的读写与清理逻辑,能显著提升前端性能;合理运用Cookie、localStorage、sessionStorage、IndexedDB及Cache API,结合缓存策略与定期清理机制,可在保证用户体验的同时避免安全与性能隐患。 前端缓存和JavaScript存…

    2026年5月10日
    200
  • 网站标题关键词更新后,搜索引擎为何仍显示旧标题?

    网站标题更新后,搜索引擎为何显示旧标题? 网站SEO优化中,站长常修改网站标题关键词,期望搜索结果显示自定义标题。然而,即使更新标签、meta keywords、meta description和结构化数据中的name属性后,搜索结果仍显示旧标题,这令人费解。本文将对此进行解释。 问题:站长修改了网…

    2026年5月10日
    100
  • HTML5网页如何实现手势操作 HTML5网页移动端交互的处理技巧

    首先利用原生touch事件实现滑动判断,再通过preventDefault解决滚动冲突,接着引入Hammer.js处理复杂手势,最后通过优化点击区域、避免事件冲突和增加视觉反馈提升体验。 在移动端浏览器中,HTML5网页可以通过触摸事件实现手势操作,提升用户体验。虽然原生JavaScript提供了基…

    2026年5月10日
    000
  • 深入理解 Express.js 中 next() 参数的作用与中间件机制

    本文深入探讨 express.js 中间件函数中的 `next()` 参数。它负责将控制权传递给请求-响应周期中的下一个中间件或路由处理程序。文章将详细解释 `next()` 的工作原理、中间件的注册与执行顺序,以及不正确使用 `next()` 可能导致请求挂起的风险,并通过代码示例和实际应用场景,…

    2026年5月10日
    000

发表回复

登录后才能评论
关注微信