{"id":26060579,"url":"https://github.com/redmooner/go-grpc-demo","last_synced_at":"2026-04-22T04:35:25.066Z","repository":{"id":280770102,"uuid":"943105530","full_name":"RedMooner/go-grpc-demo","owner":"RedMooner","description":null,"archived":false,"fork":false,"pushed_at":"2025-03-05T07:18:12.000Z","size":10,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-12-25T16:16:14.543Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/RedMooner.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-03-05T07:13:21.000Z","updated_at":"2025-03-05T07:18:15.000Z","dependencies_parsed_at":"2025-03-05T08:26:35.372Z","dependency_job_id":null,"html_url":"https://github.com/RedMooner/go-grpc-demo","commit_stats":null,"previous_names":["redmooner/go-grpc-demo"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/RedMooner/go-grpc-demo","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RedMooner%2Fgo-grpc-demo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RedMooner%2Fgo-grpc-demo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RedMooner%2Fgo-grpc-demo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RedMooner%2Fgo-grpc-demo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/RedMooner","download_url":"https://codeload.github.com/RedMooner/go-grpc-demo/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RedMooner%2Fgo-grpc-demo/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32121177,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-22T00:31:26.853Z","status":"online","status_checked_at":"2026-04-22T02:00:05.693Z","response_time":58,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-03-08T14:08:45.554Z","updated_at":"2026-04-22T04:35:25.052Z","avatar_url":"https://github.com/RedMooner.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Объяснение работы gRPC-приложения на Go\n\nВ этом документе мы подробно разберем, как работает простое gRPC-приложение на Go, состоящее из клиента и сервера. Мы рассмотрим каждый файл и объясним, как они взаимодействуют между собой.\n\n## 1. Архитектура приложения\n\nПриложение состоит из следующих компонентов:\n\n- **Клиент (`client.go`)**: Отправляет запросы на сервер и получает ответы.\n- **Сервер (`server.go`)**: Обрабатывает запросы от клиента и возвращает ответы.\n- **Protobuf-файл (`greet.proto`)**: Определяет структуру данных и сервис, который будет использоваться для взаимодействия между клиентом и сервером.\n- **Сгенерированные файлы (`greet.pb.go` и `greet_grpc.pb.go`)**: Автоматически сгенерированные файлы на основе `greet.proto`, содержащие код для работы с gRPC.\n- **Файл зависимостей (`go.mod`)**: Определяет зависимости проекта.\n\n## 2. Protobuf-файл (`greet.proto`)\n\nФайл `greet.proto` определяет структуру данных и сервис, который будет использоваться для взаимодействия между клиентом и сервером.\n\n```proto\nsyntax = \"proto3\";\n\npackage greet;\n\noption go_package = \"src/go/greet\";\n\nservice Greeter {\n    rpc SayHello (HelloRequest) returns (HelloReply) {}\n}\n\nmessage HelloRequest {\n    string name = 1;\n}\n\nmessage HelloReply {\n    string message = 1;\n}\n```\n\n### 2.1. Сервис `Greeter`\n\n- **`SayHello`**: Это RPC-метод, который принимает сообщение типа `HelloRequest` и возвращает сообщение типа `HelloReply`.\n\n### 2.2. Сообщения\n\n- **`HelloRequest`**: Сообщение, которое клиент отправляет серверу. Оно содержит одно поле `name` типа `string`.\n- **`HelloReply`**: Сообщение, которое сервер возвращает клиенту. Оно содержит одно поле `message` типа `string`.\n\n## 3. Сгенерированные файлы\n\nНа основе `greet.proto` сгенерированы два файла:\n\n- **`greet.pb.go`**: Содержит структуры данных для `HelloRequest` и `HelloReply`, а также методы для работы с этими структурами.\n- **`greet_grpc.pb.go`**: Содержит интерфейсы и методы для реализации gRPC-сервиса `Greeter`.\n\n### 3.1. `greet.pb.go`\n\nЭтот файл содержит Go-структуры, соответствующие сообщениям `HelloRequest` и `HelloReply`, а также методы для работы с ними.\n\n```go\ntype HelloRequest struct {\n    Name string `protobuf:\"bytes,1,opt,name=name,proto3\" json:\"name,omitempty\"`\n}\n\ntype HelloReply struct {\n    Message string `protobuf:\"bytes,1,opt,name=message,proto3\" json:\"message,omitempty\"`\n}\n```\n\n### 3.2. `greet_grpc.pb.go`\n\nЭтот файл содержит интерфейсы и методы для реализации gRPC-сервиса `Greeter`.\n\n- **`GreeterClient`**: Интерфейс для клиента, который позволяет вызывать метод `SayHello`.\n- **`GreeterServer`**: Интерфейс для сервера, который должен реализовать метод `SayHello`.\n\n```go\ntype GreeterClient interface {\n    SayHello(ctx context.Context, in *HelloRequest, opts ...grpc.CallOption) (*HelloReply, error)\n}\n\ntype GreeterServer interface {\n    SayHello(context.Context, *HelloRequest) (*HelloReply, error)\n}\n```\n\n## 4. Сервер (`server.go`)\n\nСервер реализует интерфейс `GreeterServer` и обрабатывает запросы от клиента.\n\n```go\ntype server struct {\n    pb.UnimplementedGreeterServer\n}\n\nfunc (s *server) SayHello(ctx context.Context, in *pb.HelloRequest) (*pb.HelloReply, error) {\n    log.Printf(\"Received: %v\", in.GetName())\n    return \u0026pb.HelloReply{Message: \"Hello \" + in.GetName()}, nil\n}\n\nfunc main() {\n    lis, err := net.Listen(\"tcp\", \":50051\")\n    if err != nil {\n        log.Fatalf(\"failed to listen: %v\", err)\n    }\n    s := grpc.NewServer()\n    pb.RegisterGreeterServer(s, \u0026server{})\n    log.Printf(\"server listening at %v\", lis.Addr())\n    if err := s.Serve(lis); err != nil {\n        log.Fatalf(\"failed to serve: %v\", err)\n    }\n}\n```\n\n### 4.1. Реализация метода `SayHello`\n\nМетод `SayHello` принимает запрос `HelloRequest`, логирует имя, переданное в запросе, и возвращает ответ `HelloReply` с сообщением, содержащим это имя.\n\n### 4.2. Запуск сервера\n\nСервер запускается на порту `50051` и начинает слушать входящие соединения. Когда клиент подключается, сервер обрабатывает запросы с помощью метода `SayHello`.\n\n## 5. Клиент (`client.go`)\n\nКлиент подключается к серверу и вызывает метод `SayHello`.\n\n```go\nfunc main() {\n    conn, err := grpc.Dial(\"localhost:50051\", grpc.WithInsecure(), grpc.WithBlock())\n    if err != nil {\n        log.Fatalf(\"did not connect: %v\", err)\n    }\n    defer conn.Close()\n    c := pb.NewGreeterClient(conn)\n\n    ctx, cancel := context.WithTimeout(context.Background(), time.Second)\n    defer cancel()\n    r, err := c.SayHello(ctx, \u0026pb.HelloRequest{Name: \"World\"})\n    if err != nil {\n        log.Fatalf(\"could not greet: %v\", err)\n    }\n    log.Printf(\"Greeting: %s\", r.GetMessage())\n}\n```\n\n### 5.1. Подключение к серверу\n\nКлиент подключается к серверу по адресу `localhost:50051` с использованием небезопасного соединения (`grpc.WithInsecure()`).\n\n### 5.2. Вызов метода `SayHello`\n\nКлиент создает запрос `HelloRequest` с именем `\"World\"` и вызывает метод `SayHello`. Ответ от сервера логируется.\n\n## 6. Зависимости (`go.mod`)\n\nФайл `go.mod` определяет зависимости проекта, включая версии библиотек `grpc` и `protobuf`.\n\n```go\nmodule go-grpc-demo\n\ngo 1.24.0\n\nrequire (\n    google.golang.org/grpc v1.71.0\n    google.golang.org/protobuf v1.36.5\n)\n```\n\n## 7. Взаимодействие клиента и сервера\n\n1. **Клиент** подключается к серверу по адресу `localhost:50051`.\n2. **Клиент** отправляет запрос `HelloRequest` с именем `\"World\"`.\n3. **Сервер** получает запрос, логирует имя и возвращает ответ `HelloReply` с сообщением `\"Hello World\"`.\n4. **Клиент** получает ответ и логирует его.\n\n## 8. Заключение\n\nЭто простое gRPC-приложение демонстрирует базовую структуру взаимодействия между клиентом и сервером. Protobuf используется для определения структуры данных и сервисов, а gRPC обеспечивает эффективную коммуникацию между клиентом и сервером.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fredmooner%2Fgo-grpc-demo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fredmooner%2Fgo-grpc-demo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fredmooner%2Fgo-grpc-demo/lists"}