context

type HttpContext struct {
	WebsocketConn    *websocket.Conn                                // websocket
	Request          *HttpRequest                                   // Request
	Response         *HttpResponse                                  // Response
	Header           collections.ReadonlyDictionary[string, string] // 头部信息
	Cookie           *HttpCookies                                   // Cookies信息
	Session          IHttpSession                                   // Session信息
	Route            *HttpRoute                                     // 路由信息
	URI              *HttpURL                                       // URL信息
	Data             *HttpData                                      // 用于传递值
	Method           string                                         // 客户端提交时的Method
	ContentLength    int64                                          // 客户端提交时的内容长度
	ContentType      string                                         // 客户端提交时的内容类型
	Exception        error                                          // 是否发生异常
	Jwt              *HttpJwt                                       // jwt验证
	Close            bool
	TransferEncoding []string
}

type HttpCookies struct {
	// contains filtered or unexported fields
}

type HttpData struct {
	// contains filtered or unexported fields
}

type HttpJwt struct {
	// contains filtered or unexported fields
}

type HttpRequest struct {
	Body       io.ReadCloser
	BodyString string
	BodyBytes  []byte
	Form       map[string]any
	Query      map[string]any
	Params     []reflect.Value // 转换成Handle函数需要的参数
	R          *http.Request
}

type HttpResponse struct {
	W         http.ResponseWriter
	Body      []any  // Action执行的结果（Action返回值）
	BodyBytes []byte // 自定义输出结果
	// contains filtered or unexported fields
}

type HttpRoute struct {
	RouteUrl                string                         // 路由地址
	Controller              reflect.Type                   // 控制器类型
	ControllerName          string                         // 控制器名称
	Action                  any                            // action类型
	ActionName              string                         // action名称
	RequestParamType        collections.List[reflect.Type] // 入参
	ResponseBodyType        collections.List[reflect.Type] // 出参
	Method                  collections.List[string]       // method
	ParamNames              collections.List[string]       // 入参变量名称（显示指定）
	RequestParamIsImplCheck bool                           // 入参DTO是否实现了Check接口
	RequestParamIsModel     bool                           // 入参是否为DTO结构
	ResponseBodyIsModel     bool                           // 出参是否为DTO结构
	AutoBindHeaderName      string                         // 自动绑定header的字段名称
	IsImplActionFilter      bool                           // 是否实现了IActionFilter
	IsGoBasicType           bool                           // 返回值只有一个时，是否为基础类型
	HttpMiddleware          IMiddleware                    // 中间件入口（每个路由的管道都不一样）
	HandleMiddleware        IMiddleware                    // handle中间件
	RouteRegexp             *routeRegexp                   // 正则路由
	Handler                 http.Handler                   // api处理函数
	Filters                 []IFilter                      // 过滤器（对单个路由的执行单元）
	Schema                  string                         // http or ws
}

type HttpURL struct {
	Url             string // 请求地址 http(s)://xxx.xxx.xxx/xxx
	Path            string // 请求地址
	RemoteAddr      string // 客户端IP端口
	X_Forwarded_For string // 客户端IP端口
	X_Real_Ip       string // 客户端IP端口
	Host            string // 请求的Host主机头
	Proto           string // http协议
	RequestURI      string
	QueryString     string
	Query           map[string]any
	R               *http.Request
}

type IFilter interface {
	// OnActionExecuting 页面执行前执行
	OnActionExecuting(httpContext *HttpContext)
	// OnActionExecuted 页面执行后执行
	OnActionExecuted(httpContext *HttpContext)
}

type IHttpSession interface {
	// GetValue 获取Session
	GetValue(name string) any
	// SetValue 设置Session
	SetValue(name string, val any)
	// Remove 删除Session
	Remove(name string)
	// Clear 清空Session
	Clear()
}

type IMiddleware interface {
	Invoke(httpContext *HttpContext)
}

type RegexpType int

type RouteRegexpOptions struct {
	StrictSlash    bool
	UseEncodedPath bool
}