pemasangan grpc golang

gRPC (Panggilan Prosedur Jauh Google) ialah rangka kerja panggilan prosedur jauh merentas bahasa berprestasi tinggi yang mentakrifkan antara muka perkhidmatan melalui Penampan Protokol (ProtoBuf) dan menyokong banyak bahasa pengaturcaraan. gRPC digunakan secara meluas dalam pembangunan sistem teragih Mekanisme pensirilan dan penyahseriannya yang cekap, kawalan aliran berasaskan HTTP/2 dan penghantaran chunked dan ciri-ciri lain memberikan kelebihan yang jelas dalam penghantaran rangkaian.

Artikel ini terutamanya memperkenalkan cara memasang gRPC di Golang dan menulis kod sampel klien dan pelayan yang mudah.

1. Pasang gRPC

Sebelum memasang gRPC, anda perlu memasang Protocol Buffers 3. Penampan Protokol ialah alat yang diperlukan untuk gRPC menjana kod secara automatik, dan ia juga merupakan alat untuk mensiri data.

Mula-mula, muat turun pakej pemasangan Protocol Buffers 3, mengambil Mac OS sebagai contoh:

$ curl -OL https://github.com/google/protobuf/releases/download/v3.9.1/protobuf-all-3.9.1.zip
$ unzip protobuf-all-3.9.1.zip
$ cd protobuf-3.9.1

Laksanakan konfigurasi, buat, buat pemasangan untuk memasang Protocol Buffers:

$ ./configure
$ make
$ sudo make install

Pasang Selepas melengkapkan Penampan Protokol, gunakan arahan berikut untuk memasang gRPC Go dan alatan berkaitan:

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

2 Tulis fail ProtoBuf

Fail ProtoBuf digunakan untuk mentakrif antara muka perkhidmatan dan struktur data, dan. secara automatik melalui alat gRPC Jana kod yang sepadan (termasuk kod klien dan pelayan).

Kami menulis contoh mudah di sini untuk mentakrifkan antara muka perkhidmatan kalkulator yang menyokong operasi penambahan:

syntax = "proto3";

package calculator;

service Calculator {
  rpc Add(AddRequest) returns (AddResponse) {}
}

message AddRequest {
  int32 left = 1;
  int32 right = 2;
}

message AddResponse {
  int32 sum = 1;
}

Dalam contoh ini, tentukan antara muka perkhidmatan bernama Kalkulator, termasuk Kaedah Tambah yang menerima parameter AddRequest dan mengembalikan parameter AddResponse.

AddRequest dan AddResponse ialah kedua-dua struktur mesej, setiap satu mengandungi dua medan jenis int32, mewakili dua operan dan hasil penambahan.

3. Jana kod

Selepas menulis fail ProtoBuf, gunakan arahan berikut untuk menjana kod klien dan pelayan:

$ protoc --go_out=plugins=grpc:. calculator.proto

Arahan ini menjana fail bernama calculator.pb. Go file for go, yang mentakrifkan kod klien dan pelayan untuk perkhidmatan kalkulator.

4. Tulis kod klien dan pelayan

Selepas menjana kod klien dan pelayan, anda boleh mula menulis klien dan pelayan sebenar.

Pertama ialah kod pelayan Kami mencipta fail bernama server.go untuk melaksanakan antara muka Kalkulator:

package main

import (
    "context"
    "log"
    "net"

    pb "calculator/calculator"

    "google.golang.org/grpc"
)

type server struct{}

func (s *server) Add(ctx context.Context, in *pb.AddRequest) (*pb.AddResponse, error) {
    sum := in.Left + in.Right
    return &pb.AddResponse{Sum: sum}, nil
}

const (
    port = ":50051"
)

func main() {
    lis, err := net.Listen("tcp", port)
    if err != nil {
        log.Fatalf("failed to listen: %v", err)
    }
    s := grpc.NewServer()
    pb.RegisterCalculatorServer(s, &server{})
    if err := s.Serve(lis); err != nil {
        log.Fatalf("failed to serve: %v", err)
    }
}

Dalam contoh ini, kami mentakrifkan struktur bernama pelayan, Melaksanakan kaedah Tambah dalam Antara muka kalkulator. Kaedah Tambah menerima parameter AddRequest, mengira jumlah dua operan dan mengembalikan parameter AddResponse.

Akhir sekali, daftarkan perkhidmatan ke dalam pelayan gRPC melalui kaedah RegisterCalculatorServer yang disediakan oleh rangka kerja gRPC dan mulakan pelayan gRPC.

Seterusnya untuk menulis kod klien, kami mencipta fail bernama client.go untuk melaksanakan contoh mudah operasi penambahan melalui perkhidmatan kalkulator:

package main

import (
    "context"
    "log"
    "os"
    "strconv"

    pb "calculator/calculator"

    "google.golang.org/grpc"
)

const (
    address     = "localhost:50051"
    defaultName = "world"
)

func main() {
    // Set up a connection to the server.
    conn, err := grpc.Dial(address, grpc.WithInsecure())
    if err != nil {
        log.Fatalf("did not connect: %v", err)
    }
    defer conn.Close()
    c := pb.NewCalculatorClient(conn)

    // Contact the server and print out its response.
    left, err := strconv.Atoi(os.Args[1])
    if err != nil {
        log.Fatalf("could not parse left operand: %v", err)
    }
    right, err := strconv.Atoi(os.Args[2])
    if err != nil {
        log.Fatalf("could not parse right operand: %v", err)
    }
    r, err := c.Add(context.Background(), &pb.AddRequest{Left: int32(left), Right: int32(right)})
    if err != nil {
        log.Fatalf("could not add: %v", err)
    }
    log.Printf("Sum: %d", r.Sum)
}

Dalam contoh ini, Kami mencipta objek klien menamakan klien dan menyambung ke pelayan melalui kaedah grpc.Dial. Kemudian, kami menghuraikan dua operan penambahan daripada parameter baris arahan, dan memanggil kaedah Tambah untuk menghantar permintaan, mendapatkan hasil yang dikembalikan oleh pelayan dan mengeluarkannya.

5 Jalankan contoh

Selepas kedua-dua fail ditulis, susun dan jalankan kedua-dua program menggunakan arahan berikut:

$ go build server.go
$ go build client.go
$ ./server

Kemudian laksanakan yang berikut dalam Perintah terminal lain untuk dijalankan program klien:

$ ./client 1 2

Hasil berjalan akan mengeluarkan hasil pengiraan 3.

Di atas adalah pemasangan dan penggunaan gRPC di Golang Menulis sistem teragih yang cekap melalui gRPC akan menjadi sangat mudah.

Atas ialah kandungan terperinci pemasangan grpc golang. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!