/goframe-v2

gRPC - Context Usage

Description

This example demonstrates how to use context and metadata in gRPC with GoFrame. It shows how to:

• Pass metadata through gRPC context
• Handle context values and deadlines
• Manage request context
• Process context metadata

Structure

.
├── client/           # Client example
│   └── client.go     # Client implementation with context
├── controller/       # Service controllers
│   └── helloworld.go # Hello service with context handling
├── protobuf/         # Protocol buffer definitions
├── server/           # Server example
│   ├── config.yaml   # Server configuration
│   └── server.go     # Server implementation
├── go.mod            # Go module file
└── go.sum            # Go module checksums

Features

The example showcases the following features:

1. Context Management

   • Metadata handling
   • Value propagation
   • Deadline management
   • Cancellation handling

2. Client Usage

   • Context creation
   • Metadata attachment
   • Context values
   • Timeout configuration

3. Server Features

   • Context extraction
   • Metadata processing
   • Value retrieval
   • Timeout handling

Requirements

• Go 1.22 or higher
• Git
• GoFrame
• gRPC

Prerequisites

1. Protocol buffer compiler installed:

   # For macOS
   brew install protobuf
   
   # Install protoc-gen-go and protoc-gen-go-grpc
   go install google.golang.org/protobuf/cmd/protoc-gen-go@latest
   go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@latest

Usage

1. Generate protocol buffer code:

   cd protobuf
   protoc --go_out=paths=source_relative:. --go-grpc_out=paths=source_relative:. *.proto

2. Start the server:

   cd server
   go run server.go

3. Run the client:

   cd client
   go run client.go

Implementation Details

The example demonstrates:

1. Context propagation in gRPC
2. Metadata handling with GoFrame