简介：

gRPC是一个高性能、开源和通用的 RPC 框架，面向移动和 HTTP/2 设计。

环境：

WIN环境下：
GO 版本1.15
其他包的信息为：
    github.com/golang/protobuf v1.4.2
    golang.org/x/net v0.0.0-20200904194848-62affa334b73 // indirect
    golang.org/x/sys v0.0.0-20200915050820-6d893a6b696e // indirect
    golang.org/x/text v0.3.3 // indirect
    google.golang.org/genproto v0.0.0-20200914193844-75d14daec038 // indirect
    google.golang.org/grpc v1.32.0
    google.golang.org/protobuf v1.25.0

实践步骤：

1：下载protocbuf编译器

下载地址：https://github.com/google/protobuf/releases
然后选择对应的版本进行下载。

image.png

2：解压protocbuf并配置到环境变量

image.png

然后配置：D:\code\go\protoc-3.13.0\bin
到 电脑环境变量中。

3：打开cmd，运行protoc --version

成功打印当前版本信息证明安装成功了

4：安装GO下的相关包

新建项目

image.png

修改自己模块名称

image.png

4.1安装 golang 的proto工具包

go get -u github.com/golang/protobuf/proto

image.png

4.2安装 goalng 的proto编译支持

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

image.png

4.3 安装 gRPC 包

go get -u google.golang.org/grpc

image.png

查看安装的依赖包：

image.png

5：编写proto文件（中间件文件）并编译

5.1 1.新建proto文件夹，在里面新建Prod.proto文件

syntax = "proto3";// 协议为proto3

package servies; //生成的文件包的存放包名称

// 定义发送请求信息
message ProdRequest{
  // 定义发送的参数
  // 参数类型 参数名 标识号(不可重复) 1  表示确定顺序
  int32 prod_id = 1;
}

// 定义响应信息返回信息
message ProdResponse{
  // 定义接收的参数
  // 参数类型 参数名 标识号(不可重复)
  int32 prod_stock = 1;
}


// 定义我们的服务（可定义多个服务,每个服务可定义多个接口）
service ProdService{
  rpc Route (ProdRequest) returns (ProdResponse){};
}

安装显示proto格式文件的插件

image.png

对应的项目目录：

image.png

5.1 2. 编译Prod.proto文件

D:\code\go\learngrpc>cd pdfiles

D:\code\go\learngrpc\pdfiles>protoc --go_out=plugins=grpc:../servies ./Prod.proto

提示不是

image.png

奇葩了，明明已经配置了还是不行！！！但是CMD可以，这样的话，那只能试一试把protoc.exe复制到GO安装目录bin下：

image.png

再进行执行命令OK：

D:\code\go\learngrpc\pdfiles>protoc --go_out=plugins=grpc:../servies ./Prod.proto

image.png

最终在package servies有对于的GO文件生成，此文件里面有对于的接口是生产，我们后续的服务就基于此接口的来实现对于的服务：

内容是：

// Code generated by protoc-gen-go. DO NOT EDIT.
// versions:
//  protoc-gen-go v1.25.0
//  protoc        v3.13.0
// source: Prod.proto

package servies

import (
    context "context"
    proto "github.com/golang/protobuf/proto"
    grpc "google.golang.org/grpc"
    codes "google.golang.org/grpc/codes"
    status "google.golang.org/grpc/status"
    protoreflect "google.golang.org/protobuf/reflect/protoreflect"
    protoimpl "google.golang.org/protobuf/runtime/protoimpl"
    reflect "reflect"
    sync "sync"
)

const (
    // Verify that this generated code is sufficiently up-to-date.
    _ = protoimpl.EnforceVersion(20 - protoimpl.MinVersion)
    // Verify that runtime/protoimpl is sufficiently up-to-date.
    _ = protoimpl.EnforceVersion(protoimpl.MaxVersion - 20)
)

// This is a compile-time assertion that a sufficiently up-to-date version
// of the legacy proto package is being used.
const _ = proto.ProtoPackageIsVersion4

// 定义发送请求信息
type ProdRequest struct {
    state         protoimpl.MessageState
    sizeCache     protoimpl.SizeCache
    unknownFields protoimpl.UnknownFields

    // 定义发送的参数
    // 参数类型 参数名 标识号(不可重复) 1  表示确定顺序
    ProdId int32 `protobuf:"varint,1,opt,name=prod_id,json=prodId,proto3" json:"prod_id,omitempty"`
}

func (x *ProdRequest) Reset() {
    *x = ProdRequest{}
    if protoimpl.UnsafeEnabled {
        mi := &file_Prod_proto_msgTypes[0]
        ms := protoimpl.X.MessageStateOf(protoimpl.Pointer(x))
        ms.StoreMessageInfo(mi)
    }
}

func (x *ProdRequest) String() string {
    return protoimpl.X.MessageStringOf(x)
}

func (*ProdRequest) ProtoMessage() {}

func (x *ProdRequest) ProtoReflect() protoreflect.Message {
    mi := &file_Prod_proto_msgTypes[0]
    if protoimpl.UnsafeEnabled && x != nil {
        ms := protoimpl.X.MessageStateOf(protoimpl.Pointer(x))
        if ms.LoadMessageInfo() == nil {
            ms.StoreMessageInfo(mi)
        }
        return ms
    }
    return mi.MessageOf(x)
}

// Deprecated: Use ProdRequest.ProtoReflect.Descriptor instead.
func (*ProdRequest) Descriptor() ([]byte, []int) {
    return file_Prod_proto_rawDescGZIP(), []int{0}
}

func (x *ProdRequest) GetProdId() int32 {
    if x != nil {
        return x.ProdId
    }
    return 0
}

// 定义响应信息返回信息
type ProdResponse struct {
    state         protoimpl.MessageState
    sizeCache     protoimpl.SizeCache
    unknownFields protoimpl.UnknownFields

    // 定义接收的参数
    // 参数类型 参数名 标识号(不可重复)
    ProdStock int32 `protobuf:"varint,1,opt,name=prod_stock,json=prodStock,proto3" json:"prod_stock,omitempty"`
}

func (x *ProdResponse) Reset() {
    *x = ProdResponse{}
    if protoimpl.UnsafeEnabled {
        mi := &file_Prod_proto_msgTypes[1]
        ms := protoimpl.X.MessageStateOf(protoimpl.Pointer(x))
        ms.StoreMessageInfo(mi)
    }
}

func (x *ProdResponse) String() string {
    return protoimpl.X.MessageStringOf(x)
}

func (*ProdResponse) ProtoMessage() {}

func (x *ProdResponse) ProtoReflect() protoreflect.Message {
    mi := &file_Prod_proto_msgTypes[1]
    if protoimpl.UnsafeEnabled && x != nil {
        ms := protoimpl.X.MessageStateOf(protoimpl.Pointer(x))
        if ms.LoadMessageInfo() == nil {
            ms.StoreMessageInfo(mi)
        }
        return ms
    }
    return mi.MessageOf(x)
}

// Deprecated: Use ProdResponse.ProtoReflect.Descriptor instead.
func (*ProdResponse) Descriptor() ([]byte, []int) {
    return file_Prod_proto_rawDescGZIP(), []int{1}
}

func (x *ProdResponse) GetProdStock() int32 {
    if x != nil {
        return x.ProdStock
    }
    return 0
}

var File_Prod_proto protoreflect.FileDescriptor

var file_Prod_proto_rawDesc = []byte{
    0x0a, 0x0a, 0x50, 0x72, 0x6f, 0x64, 0x2e, 0x70, 0x72, 0x6f, 0x74, 0x6f, 0x12, 0x07, 0x73, 0x65,
    0x72, 0x76, 0x69, 0x65, 0x73, 0x22, 0x26, 0x0a, 0x0b, 0x50, 0x72, 0x6f, 0x64, 0x52, 0x65, 0x71,
    0x75, 0x65, 0x73, 0x74, 0x12, 0x17, 0x0a, 0x07, 0x70, 0x72, 0x6f, 0x64, 0x5f, 0x69, 0x64, 0x18,
    0x01, 0x20, 0x01, 0x28, 0x05, 0x52, 0x06, 0x70, 0x72, 0x6f, 0x64, 0x49, 0x64, 0x22, 0x2d, 0x0a,
    0x0c, 0x50, 0x72, 0x6f, 0x64, 0x52, 0x65, 0x73, 0x70, 0x6f, 0x6e, 0x73, 0x65, 0x12, 0x1d, 0x0a,
    0x0a, 0x70, 0x72, 0x6f, 0x64, 0x5f, 0x73, 0x74, 0x6f, 0x63, 0x6b, 0x18, 0x01, 0x20, 0x01, 0x28,
    0x05, 0x52, 0x09, 0x70, 0x72, 0x6f, 0x64, 0x53, 0x74, 0x6f, 0x63, 0x6b, 0x32, 0x45, 0x0a, 0x0b,
    0x50, 0x72, 0x6f, 0x64, 0x53, 0x65, 0x72, 0x76, 0x69, 0x63, 0x65, 0x12, 0x36, 0x0a, 0x05, 0x52,
    0x6f, 0x75, 0x74, 0x65, 0x12, 0x14, 0x2e, 0x73, 0x65, 0x72, 0x76, 0x69, 0x65, 0x73, 0x2e, 0x50,
    0x72, 0x6f, 0x64, 0x52, 0x65, 0x71, 0x75, 0x65, 0x73, 0x74, 0x1a, 0x15, 0x2e, 0x73, 0x65, 0x72,
    0x76, 0x69, 0x65, 0x73, 0x2e, 0x50, 0x72, 0x6f, 0x64, 0x52, 0x65, 0x73, 0x70, 0x6f, 0x6e, 0x73,
    0x65, 0x22, 0x00, 0x62, 0x06, 0x70, 0x72, 0x6f, 0x74, 0x6f, 0x33,
}

var (
    file_Prod_proto_rawDescOnce sync.Once
    file_Prod_proto_rawDescData = file_Prod_proto_rawDesc
)

func file_Prod_proto_rawDescGZIP() []byte {
    file_Prod_proto_rawDescOnce.Do(func() {
        file_Prod_proto_rawDescData = protoimpl.X.CompressGZIP(file_Prod_proto_rawDescData)
    })
    return file_Prod_proto_rawDescData
}

var file_Prod_proto_msgTypes = make([]protoimpl.MessageInfo, 2)
var file_Prod_proto_goTypes = []interface{}{
    (*ProdRequest)(nil),  // 0: servies.ProdRequest
    (*ProdResponse)(nil), // 1: servies.ProdResponse
}
var file_Prod_proto_depIdxs = []int32{
    0, // 0: servies.ProdService.Route:input_type -> servies.ProdRequest
    1, // 1: servies.ProdService.Route:output_type -> servies.ProdResponse
    1, // [1:2] is the sub-list for method output_type
    0, // [0:1] is the sub-list for method input_type
    0, // [0:0] is the sub-list for extension type_name
    0, // [0:0] is the sub-list for extension extendee
    0, // [0:0] is the sub-list for field type_name
}

func init() { file_Prod_proto_init() }
func file_Prod_proto_init() {
    if File_Prod_proto != nil {
        return
    }
    if !protoimpl.UnsafeEnabled {
        file_Prod_proto_msgTypes[0].Exporter = func(v interface{}, i int) interface{} {
            switch v := v.(*ProdRequest); i {
            case 0:
                return &v.state
            case 1:
                return &v.sizeCache
            case 2:
                return &v.unknownFields
            default:
                return nil
            }
        }
        file_Prod_proto_msgTypes[1].Exporter = func(v interface{}, i int) interface{} {
            switch v := v.(*ProdResponse); i {
            case 0:
                return &v.state
            case 1:
                return &v.sizeCache
            case 2:
                return &v.unknownFields
            default:
                return nil
            }
        }
    }
    type x struct{}
    out := protoimpl.TypeBuilder{
        File: protoimpl.DescBuilder{
            GoPackagePath: reflect.TypeOf(x{}).PkgPath(),
            RawDescriptor: file_Prod_proto_rawDesc,
            NumEnums:      0,
            NumMessages:   2,
            NumExtensions: 0,
            NumServices:   1,
        },
        GoTypes:           file_Prod_proto_goTypes,
        DependencyIndexes: file_Prod_proto_depIdxs,
        MessageInfos:      file_Prod_proto_msgTypes,
    }.Build()
    File_Prod_proto = out.File
    file_Prod_proto_rawDesc = nil
    file_Prod_proto_goTypes = nil
    file_Prod_proto_depIdxs = nil
}

// Reference imports to suppress errors if they are not otherwise used.
var _ context.Context
var _ grpc.ClientConnInterface

// This is a compile-time assertion to ensure that this generated file
// is compatible with the grpc package it is being compiled against.
const _ = grpc.SupportPackageIsVersion6

// ProdServiceClient is the client API for ProdService service.
//
// For semantics around ctx use and closing/ending streaming RPCs, please refer to https://godoc.org/google.golang.org/grpc#ClientConn.NewStream.
type ProdServiceClient interface {
    Route(ctx context.Context, in *ProdRequest, opts ...grpc.CallOption) (*ProdResponse, error)
}

type prodServiceClient struct {
    cc grpc.ClientConnInterface
}

func NewProdServiceClient(cc grpc.ClientConnInterface) ProdServiceClient {
    return &prodServiceClient{cc}
}

func (c *prodServiceClient) Route(ctx context.Context, in *ProdRequest, opts ...grpc.CallOption) (*ProdResponse, error) {
    out := new(ProdResponse)
    err := c.cc.Invoke(ctx, "/servies.ProdService/Route", in, out, opts...)
    if err != nil {
        return nil, err
    }
    return out, nil
}

// ProdServiceServer is the server API for ProdService service.
type ProdServiceServer interface {
    Route(context.Context, *ProdRequest) (*ProdResponse, error)
}

// UnimplementedProdServiceServer can be embedded to have forward compatible implementations.
type UnimplementedProdServiceServer struct {
}

func (*UnimplementedProdServiceServer) Route(context.Context, *ProdRequest) (*ProdResponse, error) {
    return nil, status.Errorf(codes.Unimplemented, "method Route not implemented")
}

func RegisterProdServiceServer(s *grpc.Server, srv ProdServiceServer) {
    s.RegisterService(&_ProdService_serviceDesc, srv)
}

func _ProdService_Route_Handler(srv interface{}, ctx context.Context, dec func(interface{}) error, interceptor grpc.UnaryServerInterceptor) (interface{}, error) {
    in := new(ProdRequest)
    if err := dec(in); err != nil {
        return nil, err
    }
    if interceptor == nil {
        return srv.(ProdServiceServer).Route(ctx, in)
    }
    info := &grpc.UnaryServerInfo{
        Server:     srv,
        FullMethod: "/servies.ProdService/Route",
    }
    handler := func(ctx context.Context, req interface{}) (interface{}, error) {
        return srv.(ProdServiceServer).Route(ctx, req.(*ProdRequest))
    }
    return interceptor(ctx, in, info, handler)
}

var _ProdService_serviceDesc = grpc.ServiceDesc{
    ServiceName: "servies.ProdService",
    HandlerType: (*ProdServiceServer)(nil),
    Methods: []grpc.MethodDesc{
        {
            MethodName: "Route",
            Handler:    _ProdService_Route_Handler,
        },
    },
    Streams:  []grpc.StreamDesc{},
    Metadata: "Prod.proto",
}

6：生成对应的服务实现相关生成的接口的文件信息

实现ProdServiceClient接口的方法：

type ProdServiceClient interface {
    Route(ctx context.Context, in *ProdRequest, opts ...grpc.CallOption) (*ProdResponse, error)
}

实现内容：

返回的是一个指针类型的

package servies

import (
    "context"
)
// 定义我们的服务
type ProdServies struct{}

//func (this *ProdServies)GetProdStock(ctx context.Context, request *ProdRequest, opts ...grpc.CallOption) (*ProdResponse, error)  {
//  return &ProdResponse{ProdStock: 20},nil
//}
// Route 实现Route方法
func (s *ProdServies) Route(ctx context.Context, req *ProdRequest) (*ProdResponse, error) {
    res := ProdResponse{ProdStock:req.ProdId}
    return &res, nil
}

image.png

7：创建服务端-新建一个server.go

注册的服务是基于上次生产的GO文件里面的

func RegisterProdServiceServer(s *grpc.Server, srv ProdServiceServer) {
    s.RegisterService(&_ProdService_serviceDesc, srv)
}

正式的内容信息为：

package main

import (
    "google.golang.org/grpc"
    "log"
    "net"
    "xiaozhong/servies"

)


func main() {
    // 监听本地端口// Address 监听地址// Network 网络通信协议
    listener, err := net.Listen("tcp", ":8000")
    if err != nil {
        log.Fatalf("net.Listen err: %v", err)
    }
    log.Println(" net.Listing...8000")
    // 新建gRPC服务器实例
    grpcServer := grpc.NewServer()
    // 在gRPC服务器注册我们的服务
    servies.RegisterProdServiceServer(grpcServer, &servies.ProdServies{})

    //用服务器 Serve() 方法以及我们的端口信息区实现阻塞等待，直到进程被杀死或者 Stop() 被调用
    err = grpcServer.Serve(listener)
    if err != nil {
        log.Fatalf("grpcServer.Serve err: %v", err)
    }
}

启动服务端：
看到启动信息为：

image.png

8：创建客户端client.go，访问服务端调用接口 获取信息-

package main

import (
    "context"
    "google.golang.org/grpc"
    "log"
    "xiaozhong/servies"
)

const (
    // Address 连接地址
    Address string = ":8000"
)

func main() {
    // 连接服务器
    conn, err := grpc.Dial(Address, grpc.WithInsecure())
    if err != nil {
        log.Fatalf("net.Connect err: %v", err)
    }
    defer conn.Close()

    // 建立gRPC连接
    grpcClient := servies.NewProdServiceClient(conn)
    // 创建发送结构体
    req := servies.ProdRequest{
        ProdId: 15555,
    }
    // 调用我们的服务(Route方法)
    // 同时传入了一个 context.Context ，在有需要时可以让我们改变RPC的行为，比如超时/取消一个正在运行的RPC
    res, err := grpcClient.Route(context.Background(), &req)
    if err != nil {
        log.Fatalf("Call Route err: %v", err)
    }
    // 打印返回值
    log.Println(res)
}

运行的我们客户端：

image.png

PS：成功调用服务端的Server端的Route方法并获取返回我们自己传输的数据参数值。

最终的项目目录结构是：

image.png