gRPC简单应用——Hello World 超详细版本

最新推荐文章于 2024-06-20 10:18:26 发布

ask ask ask

最新推荐文章于 2024-06-20 10:18:26 发布

阅读量1k

点赞数 24

文章标签： rpc 开发语言后端 golang

本文链接：https://blog.csdn.net/weixin_45894608/article/details/139142893

版权

1、关于RPC

RPC（Remote Procedure Call 中文名：远程过程调用）用于不同系统或网络中的计算机之间通信的协议。gRPC是 Google 开发的一个高性能、开源的 RPC 框架，基于 HTTP/2 协议，并使用 Protocol Buffers（protobuf）作为接口描述语言和数据序列化格式。

它的优点如下：

多语言支持：支持多种编程语言，如 C++, Java, Python, Go 等。
流式处理：支持双向流式通信，可以更高效地处理数据流。
强类型：使用 Protocol Buffers 定义接口和消息格式，提供强类型检查和序列化功能。
负载均衡和命名解析：内置支持负载均衡和命名解析机制。

2、Protobuf的安装

protobuf下载链接

1、找到所需版本号；2、打开对应的Assets；3、找到对应的系统版本

把对应的压缩包下载到本地，并解压；

配置环境变量：

把解压之后的bin目录配置到：环境变量--系统变量--path路径下。

比如：我解压之后的路径是：D:\software\protobuf\protoc-26.0-rc-1-win64\bin

环境变量如图：

安装结果测试：

proctoc //命令行执行

出现如下输出，说明安装成功

3、项目创建

创建一个空白项目
下载grpc；终端执行：

go get google.golang.org/grpc

得到以下输出

依次执行以下命令

go install google.golang.org/protobuf/cmd/protoc-gen-go@latest

go install google.golang.org/grpc/cmd/protoc-gen-grpc@latest

4、编写protoc文件

文件结构如下图所示：

在客户端和服务器端的proto文件夹下新建hello.proto文件

两个hello.proto文件内容是一样的，因此可以直接复制过去

hello.proto文件的具体内容如下

//这是在说明我们使用的是proto3语法
syntax="proto3";
//这部分的内容是关于最后生成的go文件是处在哪个目录哪个包中,.代表在当前目录生成，service代表生成的go文件的包名是service。
option go_package =".;service";

//然后我们需要定义一个服务，在这个服务中需要有一个方法，这个方法可以接受客户端的参数，再返回服务端的响应。
//其实很容易可以看出，我们定义了一个service，称为SayHello，这个服务中有一个rpc方法，名为SayHello。
//这个方法会发送一个HelloReguest，然后返回一个HelloResponse。

service SayHello{
  rpc SayHello(HelloRequest)returns(HelloResponse){}
}
  //message关键字，其实你可以理解为Golang中的结构体。
  //这里比较特别的是变最后面的“赋值"。注意，这里并不是赋值，而是在定义这个变最在这个message中的位置。
message HelloRequest{
  string requestName = 1;
  //int64 age =2;
}
message HelloResponse {
  string responseMsg = 1;
}

编写完hello.proto文件之后，需要在终端（切换到具体的地址proto下）执行以下命令

protoc --go_out=. hello.proto

protoc --go-grpc_out=. hello.proto

执行完命令就会生成hello.pb.go和hello_grpc.pb.go文件

hello.pb.go文件中，可以看到我们定义的message

hello_grpc.pb.go文件中，可以看到定义的方法

5、服务端方法实现

package main

import (
	"context"
	"fmt"
	"google.golang.org/grpc"
	pb "grpc/hello_server/proto"
	"net"
)

type server struct {
	//UnimplementedSayHelloServer取自hello_grpc.pb.go文件。注意pb包的引用

	pb.UnimplementedSayHelloServer
}

// SayHello 对hello_grpc.pb.go文件中的SayHello方法进行改写，修改成自己定义的结构体
func (s *server) SayHello(ctx context.Context, req *pb.HelloRequest) (*pb.HelloResponse, error) {
	return &pb.HelloResponse{ResponseMsg: "hello " + req.RequestName}, nil
}

func main() {
	//开启端口
	listen, _ := net.Listen("tcp", "127.0.0.1:9090")
	//创建grpc服务
	grpcServer := grpc.NewServer()
	//服务注册
	pb.RegisterSayHelloServer(grpcServer, &server{})

	//启动服务
	err := grpcServer.Serve(listen)
	if err != nil {
		fmt.Println("服务启动失败！")
		return
	}
}

6、客户端方法实现

package main

import (
	"context"
	"fmt"
	"google.golang.org/grpc"
	"google.golang.org/grpc/credentials/insecure"
	pb "grpc/hello_server/proto"
	"log"
)

func main() {
	//连接到server端，此处没有使用加密和验证
	conn, err := grpc.Dial("127.0.0.1:9090", grpc.WithTransportCredentials(insecure.NewCredentials()))

	if err != nil {
		log.Fatal("error", err)
	}
	defer func(conn *grpc.ClientConn) {
		err := conn.Close()
		if err != nil {

		}
	}(conn)

	//建立连接
	client := pb.NewSayHelloClient(conn)

	//执行rpc调用（这个方法在服务器端实现并返回结果）
	resp, err := client.SayHello(context.Background(), &pb.HelloRequest{RequestName: "world"})
	if err != nil {
		fmt.Println("rpc调用失败", err)
	}
	fmt.Println(resp.GetResponseMsg())
}