Какие данные хранят в контексте?

Данные, хранящиеся в контексте (context.Context)

В языке Go контекст (context.Context) является фундаментальным механизмом для передачи данных, связанных с запросом, через границы API, управления временем жизни операций и сигнализации о их завершении. Он представляет собой неизменяемый (immutable) контейнер для ключ-значение и каналов для управления временем выполнения.

Основные типы данных в контексте

Контекст хранит три категории данных:

1. Deadline или timeout - информация о максимальном времени выполнения операции.
2. Cancellation signal - механизм для сигнализации о необходимости прекращения операции.
3. Key-value данные - произвольные значения, связанные с запросом (например, идентификатор пользователя, трейсинг).

Ключ-значение (Key-Value) данные

Это основное хранилище произвольной информации. Данные добавляются в контекст с помощью context.WithValue. Ключи должны быть сравниваемыми (comparable) и обычно определяются как собственные типы, чтобы избежать конфликтов.

// Определение типа для ключа для безопасности
type userIDKey struct{}

func main() {
    // Создание контекста с значением
    ctx := context.WithValue(context.Background(), userIDKey{}, "user-123")
    
    // Получение значения из контекста
    userID := ctx.Value(userIDKey{}).(string)
    fmt.Println(userID) // Выведет: user-123
}

Важные ограничения для key-value данных:

• Контексты неизменяемы. Новый контекст создается каждый раз при добавлении данных.
• Данные хранятся в виде интерфейсов (interface{}), поэтому при получении требуется приведение типа.
• Данные имеют ограниченную область применения: они предназначены для передачи сквозной информации (например, для middleware, трейсинга, аутентификации), не для передачи основных параметров функции.

Deadline и Cancellation

Контекст также хранит информацию о времени и механизмы сигнализации.

func operationWithTimeout(ctx context.Context) error {
    // Проверка deadline
    if deadline, ok := ctx.Deadline(); ok {
        fmt.Printf("Operation must complete by: %v\n", deadline)
    }
    
    select {
    case <-time.After(2 * time.Second):
        return nil // Операция завершилась успешно
    case <-ctx.Done():
        return ctx.Err() // Контекст был завершен (timeout/cancel)
    }
}

func main() {
    // Контекст с timeout
    ctx, cancel := context.WithTimeout(context.Background(), 1*time.Second)
    defer cancel() // Освобождение ресурсов
    
    err := operationWithTimeout(ctx)
    fmt.Println(err) // Выведет: context deadline exceeded
}

Практические рекомендации по использованию

• Не используйте контекст как замену структурам или параметрам функций. Основные параметры должны передаваться явно.
• Ключи должны быть уникальными типами. Использование строк как ключей может привести к конфликтам между разными библиотеками.
• Контекст должен передаваться как первый аргумент в функциях, которые выполняют операции, зависящие от времени или требующие cancellation (например, HTTP handlers, DB queries).
• Контекст создает дерево зависимых контекстов. При cancellation родительского контекста, все его дети также получают сигнал.

Пример сквозного использования (например, в HTTP middleware)

// Middleware добавляет userID в контекст запроса
func authMiddleware(next http.Handler) http.Handler {
    return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
        userID := extractUserIDFromRequest(r)
        ctx := context.WithValue(r.Context(), userIDKey{}, userID)
        next.ServeHTTP(w, r.WithContext(ctx))
    })
}

// Handler получает userID из контекста
func userHandler(w http.ResponseWriter, r *http.Request) {
    userID := r.Context().Value(userIDKey{}).(string)
    w.Write([]byte(fmt.Sprintf("User: %s", userID)))
}

В итоге: Контекст в Go хранит Deadline/cancellation информацию и сквозные данные запроса в виде key-value. Это мощный инструмент для управления временем жизни операций и передачи мета-информации через границы API, но его следует использовать осознанно, соблюдая принципы неизменяемости и ограниченной области применения данных.