gRPC,爆赞

原文链接: gRPC,爆赞

gRPC 这项技术真是太棒了,接口约束严格,性能还高,在 k8s 和很多微服务框架中都有应用。

作为一名程序员,学就对了。

之前用 Python 写过一些 gRPC 服务,现在准备用 Go 来感受一下原汁原味的 gRPC 程序开发。

本文的特点是直接用代码说话,通过开箱即用的完整代码,来介绍 gRPC 的各种使用方法。

代码已经上传到 GitHub,下面正式开始。

介绍

gRPC 是 Google 公司基于 Protobuf 开发的跨语言的开源 RPC 框架。gRPC 基于 HTTP/2 协议设计,可以基于一个 HTTP/2 链接提供多个服务,对于移动设备更加友好。

入门

首先来看一个最简单的 gRPC 服务,第一步是定义 proto 文件,因为 gRPC 也是 C/S 架构,这一步相当于明确接口规范。

proto

syntax = "proto3";

package proto;

// The greeting service definition.
service Greeter {
    // Sends a greeting
    rpc SayHello (HelloRequest) returns (HelloReply) {}
}

// The request message containing the user's name.
message HelloRequest {
    string name = 1;
}

// The response message containing the greetings
message HelloReply {
    string message = 1;
}

使用 protoc-gen-go 内置的 gRPC 插件生成 gRPC 代码:

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

执行完这个命令之后,会在当前目录生成一个 helloworld.pb.go 文件,文件中分别定义了服务端和客户端的接口:

// For semantics around ctx use and closing/ending streaming RPCs, please refer to https://godoc.org/google.golang.org/grpc#ClientConn.NewStream.
type GreeterClient interface {
   
   
	// Sends a greeting
	SayHello(ctx context.Context, in *HelloRequest, opts ...grpc.CallOption) (*HelloReply, error)
}

// GreeterServer is the server API for Greeter service.
type GreeterServer interface {
   
   
	// Sends a greeting
	SayHello(context.Context, *HelloRequest) (*HelloReply, error)
}

接下来就是写服务端和客户端的代码,分别实现对应的接口。

server

package main

import (
	"context"
	"fmt"
	"grpc-server/proto"
	"log"
	"net"

	"google.golang.org/grpc"
	"google.golang.org/grpc/reflection"
)

type greeter struct {
   
   
}

func (*greeter) SayHello(ctx context.Context, req *proto.HelloRequest) (*proto.HelloReply, error) {
   
   
	fmt.Println(req)
	reply := &proto.HelloReply{
   
   Message: "hello"}
	return reply, nil
}

func main() {
   
   
	lis, err := net.Listen("tcp", ":50051")
	if err != nil {
   
   
		log.Fatalf("failed to listen: %v", err)
	}

	server := grpc.NewServer()
	// 注册 grpcurl 所需的 reflection 服务
	reflection.Register(server)
	// 注册业务服务
	proto.RegisterGreeterServer(server, &greeter{
   
   })

	fmt.Println("grpc server start ...")
	if err := server.Serve(lis); err != nil {
   
   
		log.Fatalf("failed to serve: %v", err)
	}
}

client

package main

import (
	"context"
	"fmt"
	"grpc-client/proto"
	"log"

	"google.golang.org/grpc"
)

func main() {
   
   
	conn, err := grpc.Dial("localhost:50051", grpc.WithInsecure())
	if err != nil {
   
   
		log.Fatal(err)
	}
	defer conn.Close()

	client := proto.NewGreeterClient(conn)
	reply, err := client.SayHello(context.Background(
### gRPC 介绍与使用指南 gRPC 是一种高性能、开源和通用的 RPC 框架,基于 HTTP/2 协议进行通信,并采用 Protocol Buffers(简称 Protobuf)作为接口定义语言(IDL)。它支持多种编程语言,包括但不限于 Go、Java、Python、C++ 等,广泛应用于微服务架构中[^1]。 #### gRPC 的核心概念 - **Service 定义**:通过 `.proto` 文件定义服务接口,例如 `service Greeter { rpc SayHello (HelloRequest) returns (HelloReply) {} }`。`service` 关键字用于声明服务名称,`rpc` 关键字定义方法,指定输入参数和返回值类型[^4]。 - **Protobuf 消息格式**:消息结构以 `.proto` 文件的形式定义,例如: ```protobuf message HelloRequest { string name = 1; } message HelloReply { string message = 1; } ``` 上述代码中,`name` 和 `message` 分别是请求和响应中的字段,数字表示字段编号[^4]。 - **四种 RPC 类型**: - **Simple RPC**:客户端发送单个请求,服务器返回单个响应。 - **Server-side streaming RPC**:客户端发送请求后,服务器连续返回多个响应。 - **Client-side streaming RPC**:客户端连续发送多个请求,服务器返回单个响应。 - **Bidirectional streaming RPC**:客户端和服务器可以同发送和接收流式数据[^3]。 #### gRPC 的环境搭建 在开始开发之前,需要安装必要的工具和依赖项。例如,在 Go 语言中,可以通过以下命令安装 `protoc-gen-go` 插件: ```bash go install google.golang.org/protobuf/cmd/protoc-gen-go@latest go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@latest ``` 如果遇到错误 `$ protoc-gen-go: program not found or is not executable`,可能是由于插件未正确安装或环境变量未配置。确保将 `$GOPATH/bin` 添加到系统路径中[^5]。 #### gRPC 的使用步骤 1. **定义 `.proto` 文件**:描述服务接口和消息结构。 2. **生成代码**:使用 `protoc` 工具生成客户端和服务端代码。例如: ```bash protoc --go_out=. --go-grpc_out=. greeter.proto ``` 3. **实现服务端逻辑**:编写服务端代码以处理 RPC 请求。例如: ```go package main import ( "context" "log" "net" "google.golang.org/grpc" pb "path/to/generated/greeter" ) 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{}) log.Printf("server listening at %v", lis.Addr()) if err := s.Serve(lis); err != nil { log.Fatalf("failed to serve: %v", err) } } ``` 4. **创建客户端**:编写客户端代码调用远程服务。例如: ```go package main import ( "context" "log" "time" "google.golang.org/grpc" pb "path/to/generated/greeter" ) func main() { conn, err := grpc.Dial("localhost:50051", grpc.WithInsecure(), grpc.WithBlock()) 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.Message) } ``` #### gRPC 的生态系统 gRPC 可与其他工具结合使用,增强其功能: - **Envoy**:作为边缘代理,提供高级负载均衡和监控能力[^1]。 - **Jaeger**:用于全链路追踪,简化 gRPC 调用及 HTTP 请求的跟踪。 - **OpenTelemetry**:监控和指标收集框架,适用于现代微服务架构[^1]。 - **Cloud Endpoints**:Google Cloud 提供的服务网关,便于云部署和管理[^1]。
评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值