what
53169264da
HTTPService.Invoke 新增 caller req.User 参数,指定时内部转发请求认证成该身份,配合 req-v2 新增的 Router.CallWithUser。 HttpController.AuthDB()、Orm.Model.SetAuthDB()、OrmController.AuthDB() 的返回值/参数类型从 req.ResAuthDB 同步改成 req.ResScope,跟 req-v2 那边的重命名保持一致。
67 lines
2.1 KiB
Go
67 lines
2.1 KiB
Go
package contracts
|
|
|
|
import (
|
|
"io"
|
|
"net/http"
|
|
|
|
"git.fsdpf.net/go/req"
|
|
)
|
|
|
|
type HTTPService interface {
|
|
// Start 启动 HTTP 服务。
|
|
Start() error
|
|
|
|
// Shutdown 停止 HTTP 服务,等待当前请求处理完成后退出。
|
|
Shutdown() error
|
|
|
|
// Restart 重启 HTTP 服务,先停止再重新加载路由并启动。
|
|
Restart() error
|
|
|
|
// Invoke 在进程内直接调用 HTTP 路由处理器,不通过网络。
|
|
//
|
|
// 参数:
|
|
// - method: HTTP 方法,如 "GET"、"POST" 等。
|
|
// - path: 请求路径,如 "/api/user/list"。
|
|
// - body: 请求体,无请求体时传 nil。
|
|
// - headers: 附加请求头键值对,无需额外请求头时传 nil。
|
|
// - caller: 指定认证中间件应认证成的调用者身份,为 nil 时按 headers 里的
|
|
// Authorization/token 正常解析(等同于外部请求)。只有进程内部
|
|
// 发起调用时才可能传非 nil 值,不受外部请求影响。
|
|
//
|
|
// 返回:
|
|
// - *http.Response: 包含状态码、响应头及响应体的结果。
|
|
// - error: 构造请求失败时返回错误。
|
|
Invoke(method, path string, body io.Reader, header http.Header, caller req.User) (*http.Response, error)
|
|
}
|
|
|
|
type HttpController interface {
|
|
Controller
|
|
|
|
// User 返回当前请求的认证用户信息。
|
|
User() req.User
|
|
|
|
// Request 返回当前 HTTP 请求对象。
|
|
Request() *http.Request
|
|
|
|
// Execute 处理请求并返回响应数据。
|
|
Execute(req.GlobalParams) any
|
|
|
|
// Route 返回当前请求匹配到的路由信息。
|
|
Route() req.Route
|
|
|
|
// Call 在进程内以路由 code 发起内部调用,等同于向自身发送 HTTP 请求。
|
|
//
|
|
// 参数:
|
|
// - code: 路由标识码。
|
|
// - params: 附加请求参数。
|
|
// - category: 可选的路由匹配选项。
|
|
//
|
|
// 返回:
|
|
// - req.HttpResponse: 内部调用的响应结果。
|
|
// - error: 调用失败时返回错误。
|
|
Call(code string, params map[string]any, category ...req.RouteMatchOption) (req.HttpResponse, error)
|
|
|
|
// AuthDB 返回当前控制器的数据库权限模式。
|
|
AuthDB() req.ResScope
|
|
}
|