libgin

type Connector interface {
	Registration() *ConnectorRegistration
}

type ConnectorRegistration struct {
	Name      string
	Connector Connector
}

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

type ContentTypeRegistration struct {
	ContentType string
	Suffixes    []string
}

type ContentTypeRegistry interface {
	ListRegistrations() []*ContentTypeRegistration
}

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

type Controller interface {
	Registration() *ControllerRegistration
}

type ControllerRegistration struct {
	Groups []string                       // 分组名称, 以 ',' 号分隔多个名称，如果为空表示默认分组
	Route  func(g *gin.RouterGroup) error // 控制器

}

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

type GroupRegistration struct {
	Name  string
	Path  string
	Group Group
}

type Responder interface {
	ResponderRegistry

	Accept(resp *Response) bool

	Send(resp *Response)
}

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

type ResponderRegistry interface {
	Registration() *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 RouterRegistration struct {
	Name   string
	Router Router
}