/*
 * Copyright (c) 2025 SimcuTeam. All rights reserved.
 * 遵循 MIT 许可证。
 * Interfaces/BindRequestContext：请求上下文绑定接口。
 *
 * 说明：SimApiBaseController 实现本接口，由 SimApiRequestDelegateFactory（simapi.helpers）
 * 在创建控制器后注入当前 HttpContext。放在 interfaces 包是为了避免
 * simapi.helpers → simapi.controllers 的循环依赖（controllers 依赖 helpers 的 SimApiError/SimApiAuth/SimApiUtil）。
 */

package simcu::simapi.interfaces

import soulsoft_web_http.*

/**
 * 请求上下文绑定接口：控制器实现后，框架在派发请求时把当前 HttpContext 注入。
 */
public interface BindRequestContext {
    /**
     * 绑定当前请求上下文。
     * @param context 当前请求的 HttpContext。
     */
    func bindRequestContext(context: HttpContext): Unit
}
