httpserver

Documentation

Overview

Package httpserver composes application and management HTTP handlers and serves them independently.

Index

• func Run(ctx context.Context, applicationAddress string, managementAddress string, ...) error
• type Config
• type Handlers
  • func New(config Config) Handlers

Functions

func Run

func Run(
	ctx context.Context,
	applicationAddress string,
	managementAddress string,
	handlers Handlers,
	appLogger *slog.Logger,
	mgmtLogger *slog.Logger,
) error

Run serves application and optionally management traffic until shutdown or a listener fails.

Types

type Config

type Config struct {
	// Application serves application and API traffic.
	Application http.Handler
	// Management serves operational traffic such as health, readiness, and metrics.
	Management http.Handler
	// RoutePrefix mounts public routes beneath the deployment prefix; management routes remain unprefixed.
	RoutePrefix string
}

Config supplies public and operational routes and the application deployment prefix.

type Handlers

type Handlers struct {
	// Application is served on the public listener.
	Application http.Handler
	// Management is served on the operational listener when configured.
	Management http.Handler
}

Handlers contains the assembled application and management handlers.

func New

func New(config Config) Handlers

New constructs independent HTTP handlers; only application routes use the route prefix.