go实现grpc-快速开始

70 阅读2分钟

gRPC是一种高性能、开源和通用的RPC框架,Google开发并开源,它主要面向移动应用和HTTP/2设计,特别适合构建新的微服务。gRPC可以基于protobuf进行服务的定义,这种方式能够让我们定义一种强类型的服务接口,同时protobuf也提供了丰富的插件来生成客户端和服务端代码。

首先,你需要安装Go和gRPC。在Go的官方网站下载并安装Go。然后使用以下命令安装gRPC和protobuf:

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

然后,我们需要创建一个.proto文件来定义我们的服务。这个文件是使用protobuf语言编写的,可以定义服务和消息类型。例如,我们可以创建一个helloworld.proto文件,内容如下:

syntax = "proto3";

package helloworld;

service Greeter {
  rpc SayHello (HelloRequest) returns (HelloReply) {}
}

message HelloRequest {
  string name = 1;
}

message HelloReply {
  string message = 1;
}
​

这个文件定义了一个Greeter服务,它有一个SayHello方法,接收一个HelloRequest消息并返回一个HelloReply消息。

然后,我们需要使用protobuf的编译器protoc来生成Go代码。运行以下命令:

protoc --go_out=plugins=grpc:. helloworld.proto
​

这个命令会生成helloworld.pb.go文件,这个文件包含了我们服务的所有代码。

现在,我们可以开始编写服务端代码了。创建一个main.go文件,内容如下:

package main

import (
	"context"
	"log"
	"net"

	pb "path/to/helloworld"

	"google.golang.org/grpc"
)

type server struct{}

func (s *server) SayHello(ctx context.Context, in *pb.HelloRequest) (*pb.HelloReply, error) {
	return &pb.HelloReply{Message: "Hello " + in.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{})
	if err := s.Serve(lis); err != nil {
		log.Fatalf("failed to serve: %v", err)
	}
}
​

这段代码定义了一个server类型,实现了Greeter服务的SayHello方法。然后在main函数中,我们创建了一个gRPC服务器实例,注册了Greeter服务,并开始监听和服务。

创建客户端的代码也很简单,创建一个main.go文件,内容如下:

package main

import (
	"context"
	"log"
	"time"

	pb "path/to/helloworld"

	"google.golang.org/grpc"
)

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

	ctx, cancel := context.WithTimeout(context.Background(), time.Second)
	defer cancel()
	r, err := c.SayHello(ctx, &pb.HelloRequest{Name: "world"})
	if err != nil {
		log.Fatalf("could not greet: %v", err)
	}
	log.Printf("Greeting: %s", r.GetMessage())
}
​

这段代码创建了一个与服务器的连接,然后创建了一个Greeter服务的客户端。然后,我们调用SayHello方法,发送一个HelloRequest消息,并打印出返回的消息。