hydra

type Hydra struct {
	// Opts 配置选项，可选
	Opts *Options

	// DefaultListener 未识别的协议，可选
	// 若未设置，在运行时会自动初始化
	DefaultListener Listener
	// contains filtered or unexported fields
}

type Listener interface {
	net.Listener
	Dispatch(conn net.Conn)
	SetLocalAddr(addr net.Addr)
}

type Logger interface {
	Println(v ...any)
	Printf(format string, v ...any)
}

type Options struct {
	ListerChanSize int
	AcceptTimeout  time.Duration

	OnAcceptError func(err error)
}

type Protocol interface {
	// Name 协议名字
	Name() string

	// MinLen 为最小长度，用于做非判断( MustNot )
	MinLen() int

	// MustNot 通过 MinLen 长度的 header 判断，一定不是该协议
	// 	当确定不是该协议的时候，返回 true
	// 	若不确定，应该返回 false
	MustNot(header []byte) bool

	// MaxLen 最大长度，用于明确的判断不是该协议
	// 应确保 MaxLen >= MinLen > 0
	MaxLen() int

	// Is 通过 MaxLen 长度的 header 判断是否该协议
	Is(header []byte) bool
}

type Server interface {
	// Serve 启动 server
	Serve(net.Listener) error

	// Shutdown 优雅关闭
	Shutdown(context.Context) error
}

type Starter struct {
	Server   Server
	Listener net.Listener

	Timeout time.Duration
	Signals []os.Signal
	Logger  Logger
}