v1.0.0

features/inbound/inbound.go

@@ -0,0 +1,42 @@
+package inbound
+
+import (
+	"context"
+
+	"github.com/xtls/xray-core/v1/common"
+	"github.com/xtls/xray-core/v1/common/net"
+	"github.com/xtls/xray-core/v1/features"
+)
+
+// Handler is the interface for handlers that process inbound connections.
+//
+// xray:api:stable
+type Handler interface {
+	common.Runnable
+	// The tag of this handler.
+	Tag() string
+
+	// Deprecated: Do not use in new code.
+	GetRandomInboundProxy() (interface{}, net.Port, int)
+}
+
+// Manager is a feature that manages InboundHandlers.
+//
+// xray:api:stable
+type Manager interface {
+	features.Feature
+	// GetHandlers returns an InboundHandler for the given tag.
+	GetHandler(ctx context.Context, tag string) (Handler, error)
+	// AddHandler adds the given handler into this Manager.
+	AddHandler(ctx context.Context, handler Handler) error
+
+	// RemoveHandler removes a handler from Manager.
+	RemoveHandler(ctx context.Context, tag string) error
+}
+
+// ManagerType returns the type of Manager interface. Can be used for implementing common.HasType.
+//
+// xray:api:stable
+func ManagerType() interface{} {
+	return (*Manager)(nil)
+}