概述

开始 gRPC 了,这篇文章学习使用 gRPC,输出一个 Hello World。

  • 用 Go 实现 gRPC 的服务端。
  • 用 Go 实现 gRPC 的客户端。

gRPC 支持 4 类服务方法,咱们这次实现 单项 RPC 和 服务端流式 RPC。

四类服务方法

单项 RPC

服务端发送一个请求给服务端,从服务端获取一个应答,就像一次普通的函数调用。

  1. rpc SayHello(HelloRequest) returns (HelloResponse){}

服务端流式 RPC

客户端发送一个请求给服务端,可获取一个数据流用来读取一系列消息。客户端从返回的数据流里一直读取直到没有更多消息为止。

  1. rpc LotsOfReplies(HelloRequest) returns (stream HelloResponse){}

客户端流式 RPC

客户端用提供的一个数据流写入并发送一系列消息给服务端。一旦客户端完成消息写入,就等待服务端读取这些消息并返回应答。

  1. rpc LotsOfGreetings(stream HelloRequest) returns (HelloResponse) {}

双向流式 RPC

两边都可以分别通过一个读写数据流来发送一系列消息。这两个数据流操作是相互独立的,所以客户端和服务端能按其希望的任意顺序读写,例如:服务端可以在写应答前等待所有的客户端消息,或者它可以先读一个消息再写一个消息,或者是读写相结合的其他方式。每个数据流里消息的顺序会被保持。

  1. rpc BidiHello(stream HelloRequest) returns (stream HelloResponse){}

安装

安装 protobuf 编译器

  1. brew install protobuf

验证:

  1. protoc --version
  2. //输出:libprotoc 3.7.1

安装 Go protobuf 插件

  1. go get -u github.com/golang/protobuf/proto
  2. go get -u github.com/golang/protobuf/protoc-gen-go

安装 grpc-go

  1. go get -u google.golang.org/grpc

写个 Hello World 服务

  • 编写服务端 .proto 文件
  • 生成服务端 .pb.go 文件并同步给客户端
  • 编写服务端提供接口的代码
  • 编写客户端调用接口的代码

目录结构

  1. ├─ hello -- 代码根目录
  2. ├─ go_client
  3. ├── main.go
  4. ├── proto
  5. ├── hello
  6. ├── hello.pb.go
  7. ├─ go_server
  8. ├── main.go
  9. ├── controller
  10. ├── hello_controller
  11. ├── hello_server.go
  12. ├── proto
  13. ├── hello
  14. ├── hello.pb.go
  15. ├── hello.proto

这样创建目录是为了 go_client 和 go_server 后期可以拆成两个项目。

编写服务端 hello.proto 文件

  1. syntax = "proto3"; // 指定 proto 版本
  2. package hello; // 指定包名
  3. // 定义 Hello 服务
  4. service Hello {
  5. // 定义 SayHello 方法
  6. rpc SayHello(HelloRequest) returns (HelloResponse) {}
  7. // 定义 LotsOfReplies 方法
  8. rpc LotsOfReplies(HelloRequest) returns (stream HelloResponse){}
  9. }
  10. // HelloRequest 请求结构
  11. message HelloRequest {
  12. string name = 1;
  13. }
  14. // HelloResponse 响应结构
  15. message HelloResponse {
  16. string message = 1;
  17. }

了解更多 Protobuf 语法,请查看:

https://developers.google.com/protocol-buffers/

生成服务端 .pb.go

  1. protoc -I . --go_out=plugins=grpc:. ./hello.proto

同时将生成的 hello.pb.go 复制到客户端一份。

查看更多命令参数,执行 protoc,查看 OPTION 。

编写服务端提供接口的代码

  1. // hello_server.go
  2. package hello_controller
  3. import (
  4. "fmt"
  5. "golang.org/x/net/context"
  6. "hello/go_server/proto/hello"
  7. )
  8. type HelloController struct{}
  9. func (h *HelloController) SayHello(ctx context.Context, in *hello.HelloRequest) (*hello.HelloResponse, error) {
  10. return &hello.HelloResponse{Message : fmt.Sprintf("%s", in.Name)}, nil
  11. }
  12. func (h *HelloController) LotsOfReplies(in *hello.HelloRequest, stream hello.Hello_LotsOfRepliesServer) error {
  13. for i := 0; i < 10; i++ {
  14. stream.Send(&hello.HelloResponse{Message : fmt.Sprintf("%s %s %d", in.Name, "Reply", i)})
  15. }
  16. return nil
  17. }
  1. // main.go
  2. package main
  3. import (
  4. "log"
  5. "net"
  6. "hello/go_server/proto/hello"
  7. "hello/go_server/controller/hello_controller"
  8. "google.golang.org/grpc"
  9. )
  10. const (
  11. Address = "0.0.0.0:9090"
  12. )
  13. func main() {
  14. listen, err := net.Listen("tcp", Address)
  15. if err != nil {
  16. log.Fatalf("Failed to listen: %v", err)
  17. }
  18. s := grpc.NewServer()
  19. // 服务注册
  20. hello.RegisterHelloServer(s, &hello_controller.HelloController{})
  21. log.Println("Listen on " + Address)
  22. if err := s.Serve(listen); err != nil {
  23. log.Fatalf("Failed to serve: %v", err)
  24. }
  25. }

运行:

  1. go run main.go
  2. 2019/07/28 17:51:20 Listen on 0.0.0.0:9090

编写客户端请求接口的代码

  1. package main
  2. import (
  3. "hello/go_client/proto/hello"
  4. "io"
  5. "log"
  6. "golang.org/x/net/context"
  7. "google.golang.org/grpc"
  8. )
  9. const (
  10. // gRPC 服务地址
  11. Address = "0.0.0.0:9090"
  12. )
  13. func main() {
  14. conn, err := grpc.Dial(Address, grpc.WithInsecure())
  15. if err != nil {
  16. log.Fatalln(err)
  17. }
  18. defer conn.Close()
  19. // 初始化客户端
  20. c := hello.NewHelloClient(conn)
  21. // 调用 SayHello 方法
  22. res, err := c.SayHello(context.Background(), &hello.HelloRequest{Name: "Hello World"})
  23. if err != nil {
  24. log.Fatalln(err)
  25. }
  26. log.Println(res.Message)
  27. // 调用 LotsOfReplies 方法
  28. stream, err := c.LotsOfReplies(context.Background(),&hello.HelloRequest{Name: "Hello World"})
  29. if err != nil {
  30. log.Fatalln(err)
  31. }
  32. for {
  33. res, err := stream.Recv()
  34. if err == io.EOF {
  35. break
  36. }
  37. if err != nil {
  38. log.Printf("stream.Recv: %v", err)
  39. }
  40. log.Printf("%s", res.Message)
  41. }
  42. }

运行:

  1. go run main.go
  2. 2019/07/28 17:58:13 Hello World
  3. 2019/07/28 17:58:13 Hello World Reply 0
  4. 2019/07/28 17:58:13 Hello World Reply 1
  5. 2019/07/28 17:58:13 Hello World Reply 2
  6. 2019/07/28 17:58:13 Hello World Reply 3
  7. 2019/07/28 17:58:13 Hello World Reply 4
  8. 2019/07/28 17:58:13 Hello World Reply 5
  9. 2019/07/28 17:58:13 Hello World Reply 6
  10. 2019/07/28 17:58:13 Hello World Reply 7
  11. 2019/07/28 17:58:13 Hello World Reply 8
  12. 2019/07/28 17:58:13 Hello World Reply 9

查看源码:https://github.com/xinliangnote/Go

推荐阅读

gRPC

Gin 框架

基础篇

本文欢迎转发,转发请注明作者和出处,谢谢!

[系列] Go gRPC Hello World的更多相关文章

  1. 跟我一起学 Go 系列:gRPC 拦截器

    Go gRPC 学习系列: 跟我一起学Go系列:gRPC 入门必备 第一篇内容我们已经基本了解到 gRPC 如何使用 .对应的三种流模式.现在已经可以让服务端和客户端互相发送消息.本篇仍然讲解功能性的 ...

  2. [系列] Go gRPC 调试工具

    目录 概述 写一个 gRPC API grpcui 使用 go-gin-api 系列文章 概述 最近这段时间工作挺忙的,发现已经 3 周没更文了... 感谢你们还在,今天给大家分享一款 gRPC 的调 ...

  3. btcWallet系列之一-grpc模块

    btcwallet对外服务 btcwallet除了像btcd对外提供rpc服务以外,还提供了grpc服务,同时grpc采用的是protobuf来实现. 这方便与不同语言进行交互,降低客户端代码编写量. ...

  4. go微服务系列(四) - gRPC入门

    1. 前言 2. gRPC与Protobuf简介 3. 安装 4. 中间文件演示 4.1 编写中间文件 4.2 运行protoc命令编译成go中间文件 5. 创建gRPC服务端 5.1 新建Produ ...

  5. 跟我一起学Go系列:gRPC 入门必备

    RPC 的定义这里就不再说,看文章的同学都是成熟的开发.gRPC 是 Google 开源的高性能跨语言的 RPC 方案,该框架的作者 Louis Ryan 阐述了设计这款框架的动机,有兴趣的同学可以看 ...

  6. 跟我一起学Go系列:gRPC 全局数据传输和超时处理

    gRPC 在多个 GoRoutine 之间传递数据使用的是 Go SDK 提供的 Context 包.关于 Context 的使用可以看我之前的一篇文章:Context 使用. 但是 Context ...

  7. go语言gRPC系列(二) - 为gRPC添加证书

    1. 前言 2. 生成自签证书 2.1 MAC生成自签证书的教程链接: 2.2 Windows生成自签证书的教程 3. 改造服务端使用自签证书 3.1 复制证书至代码下 3.2 改造代码添加证书认证 ...

  8. 跟我一起学Go系列:Go gRPC 安全认证机制-SSL/TLS认证

    Go gRPC 系列: 跟我一起学Go系列:gRPC 拦截器使用 跟我一起学Go系列:gRPC 入门必备 第一篇入门说过 gRPC 底层是基于 HTTP/2 协议的,HTTP 本身不带任何加密传输功能 ...

  9. 跟我一起学Go系列:Go gRPC 安全认证方式-Token和自定义认证

    Go gRPC 系列: 跟我一起学Go系列:gRPC安全认证机制-SSL/TLS认证 跟我一起学 Go 系列:gRPC 拦截器使用 跟我一起学 Go 系列:gRPC 入门必备 接上一篇继续讲 gRPC ...

随机推荐

  1. 13 CSS样式权重问题

    <!-- 权重问题整体说明: 1.权重的意义:判定CSS属性的优先级高低,也就是说判定那个CSS的属性优先显示,将其他的低优先级的CSS样式覆盖掉. 2.如何判断权重:数选择器的数量,按照Id选 ...

  2. 高并发 Nginx+Lua OpenResty系列(5)——Lua开发库Redis

    Redis客户端 lua-resty-redis是为基于cosocket API的ngx_lua提供的Lua redis客户端,通过它可以完成Redis的操作.默认安装OpenResty时已经自带了该 ...

  3. mysql group_concat的长度问题

    mysql group_concat的长度问题 show variables like 'group_concat_max_len';+----------------------+-------+| ...

  4. SHELL 中条件语句的运用 if for 条件测试语句

    if条件测试语句可以让脚本根据实际情况自动执行相应的命令.从技术角度来讲,if语句分为单分支结构.双分支结构.多分支结构:其复杂度随着灵活度一起逐级上升. if条件语句的单分支结构由if.then.f ...

  5. putty秘钥转换成xhell支持的格式

    使用XShell导入KEY的时候报“Failed to import the user key!”错误 这个错误表明导入的private key文件不是XShell所支持的,有三种可能: 将Publi ...

  6. Appium+python自动化(十五)- Android 这些基础知识,你知多少???(超详解)

    简介 前边具体操作和实战已经讲解和分享了很多了,但是一些android的一些基础知识,你又知道多少了,你都掌握了吗?这篇就由宏哥给小伙伴们既是一个分享,又是对前边的一次总结.为什么要对这些做一个简单的 ...

  7. java 中的一些运算符问题

    逻辑运算符 && 与 &: 在这二个与运算符中,一般用于if的判断中,A&&B,假设A的条件不满足时 则不会去判断后面的B, 如果A满足条件时就会接下来去做B条 ...

  8. JavaScript 基础知识 表达式和运算符

    表达式的概念:将同类型的数据(如常量.变量.函数等),用运算符号按一定的规则连起来的.有意义的式子称为表达式 一.原始表达式 最简单的表达式,是表达式的最小单位.JavaScript中的原始表达式包含 ...

  9. element-ui中轮播图自适应图片高度

    哈哈,久违了各位.我又回来了,最近在做毕设,所以难免会遇到很多问题,需要解决很多问题,在万能的博友帮助下,终于解决了Element-ui中轮播图的图片高度问题,话不多说上代码. 那个axios的使用不 ...

  10. 嵊州D1T1 总统先生,一路走好!

    嵊州D1T1 总统先生,一路走好! 在总统先生的所有财产就是 n 杯黑咖啡,咖啡店可以用 m 个空杯子换一杯黑咖啡. 因为总统的特殊身份,心地善良而心生怜悯的咖啡店店长决定先借给总统一杯黑咖啡,只要他 ...