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 ContextHolder struct {
	// contains filtered or unexported fields
}

type Controller interface {
	Registration() *ControllerRegistration
}

type ControllerRegistration struct {
	Groups []string                   // 分组名称, 以 ',' 号分隔多个名称，如果为空表示默认分组
	Route  func(rp RouterProxy) 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 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 Routing struct {
	Method     string
	Path       string
	Priority   int
	NoMethod   bool
	NoRoute    bool
	Middleware bool
	Handlers   []gin.HandlerFunc
}