httpserver

Sep 6, 2025

Changes in this version

+ const DefaultTimeout

+ const EventTypeConfigLoaded

+ const EventTypeRequestHandled

+ const EventTypeRequestReceived

+ const EventTypeServerStarted

+ const EventTypeServerStopped

+ const EventTypeTLSConfigured

+ const EventTypeTLSEnabled

+ var ErrInvalidPort = errors.New("invalid port number")

+ var ErrNoSubjectForEventEmission = errors.New("no subject available for event emission")

+ var ErrRouterServiceNotHandler = errors.New("router service does not implement http.Handler")

+ var ErrTLSNoDomainsSpecified = errors.New("TLS auto-generation is enabled but no domains specified")

type HTTPServerModule

+ func (m *HTTPServerModule) EmitEvent(ctx context.Context, event cloudevents.Event) error

+ func (m *HTTPServerModule) GetRegisteredEventTypes() []string

+ func (m *HTTPServerModule) RegisterObservers(subject modular.Subject) error

Aug 3, 2025

Changes in this version

+ var ErrInvalidPortNumber = errors.New("invalid port number")

+ var ErrRouterNotHTTPHandler = errors.New("service does not implement http.Handler")

+ var ErrServerStartTimeout = errors.New("context cancelled while waiting for server to start")

+ var ErrTLSAutoGenerationNoDomains = errors.New("TLS auto-generation is enabled but no domains specified")

+ var ErrTLSNoCertificateFile = errors.New("TLS is enabled but no certificate file specified")

+ var ErrTLSNoKeyFile = errors.New("TLS is enabled but no key file specified")

Jun 5, 2025

Changes in this version

+ const DefaultTimeoutSeconds

+ const ModuleName

+ var ErrNoHandler = errors.New("no HTTP handler available")

+ var ErrServerNotStarted = errors.New("server not started")

+ func NewHTTPServerModule() modular.Module

+ type CertificateService interface

+ GetCertificate func(*tls.ClientHelloInfo) (*tls.Certificate, error)

+ type HTTPServerConfig struct

+ Host string

+ IdleTimeout int

+ Port int

+ ReadTimeout int

+ ShutdownTimeout int

+ TLS *TLSConfig

+ WriteTimeout int

+ func (c *HTTPServerConfig) GetTimeout(seconds int) time.Duration

+ func (c *HTTPServerConfig) Validate() error

+ type HTTPServerModule struct

+ func (m *HTTPServerModule) Constructor() modular.ModuleConstructor

+ func (m *HTTPServerModule) Init(app modular.Application) error

+ func (m *HTTPServerModule) Name() string

+ func (m *HTTPServerModule) ProvidesServices() []modular.ServiceProvider

+ func (m *HTTPServerModule) RegisterConfig(app modular.Application) error

+ func (m *HTTPServerModule) RequiresServices() []modular.ServiceDependency

+ func (m *HTTPServerModule) Start(ctx context.Context) error

+ func (m *HTTPServerModule) Stop(ctx context.Context) error

+ type TLSConfig struct

+ AutoGenerate bool

+ CertFile string

+ Domains []string

+ Enabled bool

+ KeyFile string

+ UseService bool