seed

type ContextKey struct {
	Name string
}

type HandlerFunc func(ctx context.Context, req Request) Response

type MSeed interface {
	Router

	// HTTPServer 返回实例的 *http.Server
	HTTPServer() *http.Server

	// 设置默认的http server
	SetHTTPServer(srv *http.Server) MSeed

	// Run 启动HTTPServer
	//
	// 	addrs 监听的端口,非必选，但如果没有通过HTTPServer pointer修改且值不给可能导致服务启动失败
	Run(addrs ...string) error

	// Run 启动HTTPServer
	//
	// 	certFile https certFile
	// 	keyFile https keyFile
	// 	addrs 监听的端口,非必选，但如果没有通过HTTPServer pointer修改且值不给可能导致服务启动失败
	RunTLS(certFile, keyFile string, addrs ...string) error
}

type MiddleWareQueue interface {
	Next(ctx context.Context, w http.ResponseWriter, req *http.Request) bool
}

type MiddlewareFunc func(ctx context.Context, w http.ResponseWriter, req *http.Request, next MiddleWareQueue) bool

type MiddlewareFuncs []MiddlewareFunc

type Request interface {
	// HTTPRequest 返回原始 *http.Request
	HTTPRequest() *http.Request

	// Query 获取GET方式传递的参数
	Query(name string) (value string, has bool)

	// QueryDefault 获取GET方式传递的参数如果没有那么返回默认值/空值
	QueryDefault(name string, defaultValue ...string) (value string)

	// PostForm 获取POST方式传递的参数
	PostForm(name string) (value string, has bool)

	// PostFormDefault 获取POST方式传递的参数如果没有那么返回默认值/空值
	PostFormDefault(name string, defaultValue ...string) (value string)

	// Param 获取GET/POST方式传递的参数
	Param(name string) (value string, has bool)

	// ParamDefault 获取GET/POST方式传递的参数如果没有那么返回默认值/空值
	ParamDefault(name string, defaultValue ...string) (value string)

	// Header 获取Header传递的参数
	Header(name string) (value string, has bool)

	// HeaderDefault 获取Header方式传递的参数如果没有那么返回默认值/空值
	HeaderDefault(name string, defaultValue ...string) (value string)

	// Cookie 获取Cookie方式传递的参数
	Cookie(name string) (value *http.Cookie, has bool)

	// RemoteAddr 获取客户端的请求地址
	RemoteAddr() string

	// JsonUnmarshal json序列化参数到目标数据
	JsonUnmarshal(dst interface{}) error
}

type Response interface {
	WriteTo(w http.ResponseWriter) error
}

type Route interface {
	http.Handler

	Path() string
	Method() string
}

type RouteMapper interface {
	Add(route Route) error
	Find(req *http.Request) Route
}

type Router interface {
	http.Handler

	// Use 注册过滤器(中间件)
	//
	// 	可用于给 server 增加切片的功能
	// 	如可以创建注册一个用于校验是否登录的 中间件
	// 	注册的中间件会对此后的 handler 生效，在此之前注册的 handler 方法不会生效
	Use(ms ...MiddlewareFunc) Router

	// HandleStd 以http.Handler方式注册业务handler
	//
	// 	method  是http方法，如GET、POST,也可以使用逗号来连接同时传入多个，如 "GET,POST"
	// 	也可以用特殊的 ANY,会自动注册所有( ANY 的取值详见 MethodAny )
	// 	handler 是业务的逻辑
	// 	ms 是该接口特有的中间件函数
	HandleStd(methods string, path string, handler http.Handler, ms ...MiddlewareFunc)

	// HandleFunc 以HandlerFunc方式注册业务handler
	//
	// 	method  是http方法，如GET、POST,也可以使用逗号来连接同时传入多个，如 "GET,POST"
	// 	也可以用特殊的 ANY,会自动注册所有( ANY 的取值详见 MethodAny )
	// 	handler 是业务的逻辑
	// 	ms 是该接口特有的中间件函数
	HandleFunc(methods string, path string, handlerFunc HandlerFunc, ms ...MiddlewareFunc)

	// Group 路由分组
	//
	// 	如 可以将 /user/xxx 系列分成一个分组
	// 	prefix路由前缀，如 "/user"
	// 	ms 是该分组的中间件函数
	Group(prefix string, f func(r Router), ms ...MiddlewareFunc)
}