core

type BusinessError interface {
	// WithError setting error message
	WithStack(err error) BusinessError

	// BusinessCode get business code
	BusinessCode() string

	// HTTPCode get the HTTP status code
	HTTPCode() int

	// Message get the error description
	Message() string

	// StackError get the error message with stack
	StackError() error

	Error() string
}

type Context interface {
	ShouldBind(obj interface{}) error

	// ShouldBindQuery deserialization querystring
	// tag: `form:"xxx"`(note: do not write query)
	ShouldBindQuery(obj interface{}) error

	// ShouldBindPostForm deserialization postform (querystring will be ignored)
	// tag: `form:"xxx"`
	ShouldBindPostForm(obj interface{}) error

	// ShouldBindJSON deserialization postjson
	// tag: `json:"xxx"`
	ShouldBindJSON(obj interface{}) error

	// ShouldBindURI the deserialization path parameter (if the routing path is/user/:name)
	// tag: `uri:"xxx"`
	ShouldBindURI(obj interface{}) error

	Param(key string) string

	// Payload returned correctly
	GetMethodPath() (method string, path string)

	// Payload 正确返回
	Payload(payload interface{})

	// AbortWithError error return
	AbortWithPermissionError(err error, expectCode string, emptyResp any)

	// c.AbortWithError(
	// 			http.StatusBadRequest,
	// 			code.ParamBindError,
	// 			err,
	// 		)
	// AbortWithError(err BusinessError)
	// If err is BusinessError, param businessCode will be ignored
	AbortWithError(statusCode int, businessCode string, err error)

	// Header Gets the Header object
	Header() http.Header
	// Get the header GetHeader
	GetHeader(key string) string
	// Set the header SetHeader
	SetHeader(key, value string)

	GetContext() go_context.Context
	// Set Sets key-value pairs in context
	Set(key string, value interface{})
	// Get Gets the value of the key in context.
	Get(key string) (any, bool)

	Next()
	Request() *http.Request

	ClientIP() string

	LANG() string
	UserID() int64

	ErrMessage(errCode string) string

	Clone() Context

	Done() <-chan struct{}
	Err() error
	Value(key any) any
	Deadline() (deadline time.Time, ok bool)
	// contains filtered or unexported methods
}

type HandlerFunc func(c Context)

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

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