Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

httpserver

package module

Go to main page

Versions in this module

v0

v0.1.2

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

v0.1.0

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")

v0.0.4

Jun 28, 2025

v0.0.3

Jun 27, 2025

v0.0.2

Jun 11, 2025

v0.0.1

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