Protobuf+gRpc Go语言微服务组件搭建

必备下载

由于protobuf设定的是定义中间文件并转为每个语言的文件,所以必须装一个protoc的编译器
https://github.com/protocolbuffers/protobuf/releases

而go则再需要一个插件
https://github.com/golang/protobuf/tree/master/protoc-gen-go

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

配置

protoc 将解压后的文件配置到path中

项目结构

image.png

Go的项目结构大概分为bin、pkg、src三个,bin是编译后可执行的文件,pkg是一些依赖包存放的地方,src就是编写的源码

此外,需要在src下新建一个go.mod文件,有点类似Java的pom.xml,做一些依赖的配置

module demo

go 1.13

require (
    github.com/gin-gonic/gin v1.6.2
    github.com/golang/protobuf v1.4.2
    google.golang.org/grpc v1.29.1
    google.golang.org/protobuf v1.23.0
)

然后在src下新建一个文件夹存放proto文件

image.png

Protobuf是一个定义通信格式的协议,不同的进程(Java,C++,Go whatever)只要遵循这个协议都可以进行序列化和反序列化,而且性能很高。

syntax = "proto3";

package proto;

message HelloRequest{
  string name = 1;
}
message HelloResponse{
  string message = 1;
}

service Hello{
  rpc Say (HelloRequest) returns (HelloResponse) {};
}

编写完成之后,程序依然无法识别这个rpc接口,它不像maven一样,做一个接口包然后共享出去,用户方通过pom文件的引入,就能看到接口定义进而调用。
它需要执行一个编译,使用go generation进行生成中间文件。
到proto的目录下,执行这个,使用grpc的插件生成中间文件,这样就能得到接口定义的go文件。

protoc hello.proto --go_out=plugins=grpc:.

服务端代码

package main

import (
    "context"
    my "demo/myproto"
    "google.golang.org/grpc"
    "google.golang.org/grpc/reflection"
    "log"
    "net"
)

type server struct{}
const (
    port = ":8081"
)

func (s *server) Say(ctx context.Context, in *my.HelloRequest) (*my.HelloResponse, error) {
    log.Printf("Received: %s", in.Name)
    return &my.HelloResponse{Message: "hello"}, nil
}

func listenAndService(){
    lis,err := net.Listen("tcp",port)
    if err != nil{
        log.Fatalf("failed to listen,%v",err)
    }
    s := grpc.NewServer()
    my.RegisterHelloServer(s, &server{})    //注册服务
    reflection.Register(s)
    log.Print("the rpc server is started up\n")
    if err := s.Serve(lis); err != nil {
        log.Fatalf("failed to serve %v",err)
    }

}

func main(){
    listenAndService()
}

首先注意的第一点,跨go文件调用,定义的方法名首字母必须大写,如果是小写则不能被外部go文件调用,类似于private。
其次就是引包路径(匪夷所思,伞兵设计),是从你GOPATH开始,demo/myproto,中间的src哪去了不知道。
还有就是,不知道为什么定义个server的结构体。

客户端代码

package main

import (
    "context"
    rpc "demo/myproto"
    "google.golang.org/grpc"
    "log"
)

const PORT = ":8081"

func main(){
    conn,err := grpc.Dial(PORT,grpc.WithInsecure())
    if err != nil {
        log.Fatalf("get an error : %v\n", err)
    }
    defer conn.Close()

    client := rpc.NewHelloClient(conn)

    resp,err := client.Say(context.Background(),&rpc.HelloRequest{
        Name: "this is client",
    })
    if err != nil {
        log.Fatalf("invoke error \n")
    }

    log.Printf("resp : %s\n",resp.GetMessage())
}

实验截图

image.png
image.png

发表评论

您的电子邮箱地址不会被公开。