Skip to content

GRPC.md

Latest commit

 

History

History
152 lines (115 loc) · 6.1 KB

GRPC.md

File metadata and controls

152 lines (115 loc) · 6.1 KB

gRPC — это современная система удаленного вызова процедур (RPC), разработанная Google, которая использует HTTP/2 в качестве транспортного протокола и Protocol Buffers в качестве языка описания интерфейсов (IDL). Она позволяет клиентам и серверам, написанным на разных языках программирования, легко и эффективно общаться друг с другом. В Go, gRPC поддерживается официальной библиотекой, которая предоставляет все необходимые инструменты для создания и использования gRPC-сервисов.

Установка

Для начала работы с gRPC в Go, вам нужно установить пакет gRPC и инструменты Protocol Buffers. Убедитесь, что у вас установлен Go версии 1.6 или выше.

  1. Установите gRPC для Go:
go get -u google.golang.org/grpc

  1. Установите компилятор Protocol Buffers (protoc) с официального сайта или используйте менеджер пакетов вашей ОС.

  2. Установите плагин protoc для Go:

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

Убедитесь, что путь $GOPATH/bin добавлен в вашу переменную среды PATH.

Определение Сервиса

Создайте файл .proto для определения вашего сервиса и сообщений, используемых в RPC. Например, helloworld.proto:

syntax = "proto3";

package helloworld;

// 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 для генерации Go кода из вашего файла .proto:

protoc --go_out=. --go-grpc_out=. helloworld.proto

Это создаст файлы helloworld.pb.go и helloworld_grpc.pb.go, содержащие код Go для ваших сообщений и сервисов соответственно.

Реализация Сервера

Создайте gRPC сервер и реализуйте методы вашего сервиса. Например:

package main

import (
    "context"
    "log"
    "net"

    "google.golang.org/grpc"
    pb "path/to/your/protobuf/package/helloworld"
)

type server struct {
    pb.UnimplementedGreeterServer
}

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)
    }
}

Создание Клиента

Реализуйте клиента для общения с вашим gRPC сервисом:

package main

import (
    "context"
    "log"
    "os"
    "time"

    "google.golang.org/grpc"
    pb "path/to/your/protobuf/package/helloworld"
)

func main() {
    // Set up a connection to the server.
    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)

    // Contact the server and print out its response.
    name := "world"
    if len(os.Args) > 1 {
        name = os.Args[1]
    }
    ctx, cancel := context.WithTimeout(context.Background(), time.Second)
    defer cancel()
    r, err := c.SayHello(ctx, &pb.HelloRequest{Name: name})
    if err != nil {
        log.Fatalf("could not greet: %v", err)
    }
    log.Printf("Greeting: %s", r.GetMessage())
}

Этот пример клиента устанавливает соединение с gRPC-сервером, отправляет запрос SayHello с именем пользователя (или "world" по умолчанию, если имя не указано) и выводит полученный ответ.

Запуск

  1. Запустите сервер:
go run server.go
  1. В другом терминале запустите клиента, указав имя в качестве аргумента:
go run client.go your_name

Замените your_name на любое имя, которое вы хотите использовать в приветствии. Клиент отправит это имя на сервер, а сервер ответит приветствием, которое будет выведено в консоль клиента.

Заключение

gRPC предлагает мощный и удобный способ для создания распределенных приложений и микросервисов. Благодаря использованию HTTP/2 gRPC обеспечивает высокую производительность и эффективность. Protocol Buffers же позволяют строго типизировать интерфейсы и обеспечивать совместимость на уровне API. В Go, благодаря официальной поддержке и доступным инструментам, работа с gRPC становится еще проще и удобнее.