libgin

type Connector interface {
}

type ConnectorRegistration struct {
	Name      string
	Connector Connector
}

type ConnectorRegistry interface {
	ListRegistrations() []*ConnectorRegistration
}

type ContentTypeManager interface {
	FindTypeBySuffix(suffix string) (string, error)
}

type Context interface {
	GetConnectorByName(name string) (Connector, error)
	GetGroupByName(name string) (Group, error)
	GetRouterByName(name string) (Router, error)
	ListControllersForGroup(groupName string) ([]*ControllerRegistration, error)
}

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

type Controller interface {
	Registration() *ControllerRegistration
}

type ControllerRegistration struct {
	Groups []string                   // 分组名称, 如果为空表示默认分组
	Route  func(rp RouterProxy) error // 控制器
}

type Executor struct {
	Responder Responder
	Context   *gin.Context

	Body1  any
	Body2  any
	Error  error
	Status int

	// callbacks
	OnOpen  ExecutorOnOpenFunc
	OnSend  ExecutorOnSendFunc
	OnTask  ExecutorOnTaskFunc
	OnError ExecutorOnErrorFunc
	OnPanic ExecutorOnPanicFunc
	OnClose ExecutorOnCloseFunc
}

type ExecutorOnCloseFunc func()

type ExecutorOnErrorFunc func(err error)

type ExecutorOnOpenFunc func(c *gin.Context) error

type ExecutorOnPanicFunc func(x any)

type ExecutorOnSendFunc func(err error)

type ExecutorOnTaskFunc func() error

type Group interface {
	// Registration( ... ) *GroupRegistration
	Route(r Router) error
}

type GroupRegistration struct {
	Enabled bool
	Name    string
	Path    string
	Group   Group
}

type GroupRegistry interface {
	ListRegistrations() []*GroupRegistration
}

type Responder interface {
	Accept(resp *Response) bool

	Send(resp *Response)
}

type ResponderRegistration struct {
	Priority  int // 优先级，数值越大，越先处理
	Name      string
	Enabled   bool
	Responder Responder
}

type ResponderRegistry interface {
	ListRegistrations() []*ResponderRegistration
}

type Response struct {
	Context   *gin.Context
	Status    int
	Error     error
	Responder string // 用于选择 Responder，它的值为 ResponderRegistration.Name
	Data      any
}

type Router interface {
	// Registration(  ) *RouterRegistration
	Engine() *gin.Engine
}

type RouterProxy interface {
	For(path string) RouterProxy
	Route(r *Routing)
	Handle(method string, path string, h ...gin.HandlerFunc)
	NoMethod(h ...gin.HandlerFunc)
	NoRoute(h ...gin.HandlerFunc)

	GET(path string, h ...gin.HandlerFunc)
	POST(path string, h ...gin.HandlerFunc)
	PUT(path string, h ...gin.HandlerFunc)
	DELETE(path string, h ...gin.HandlerFunc)
}

type RouterRegistration struct {
	Name   string
	Router Router
}

type RouterRegistry interface {
	ListRegistrations() []*RouterRegistration
}

type Routing struct {
	Method      string
	Path        string
	Priority    int
	NoMethod    bool
	NoRoute     bool
	Middleware  bool
	AsIndexPage bool
	Handlers    []gin.HandlerFunc
}