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

http

package

Go to main page

Versions in this module

v3

v3.1.2

Mar 18, 2026

v3.1.1

Mar 17, 2026

v3.1.0

Mar 17, 2026

v3.0.1

Mar 8, 2026

v3.0.0

Mar 8, 2026

Changes in this version

+ const ConstraintAlpha

+ const ConstraintAlphaLowercase

+ const ConstraintAlphaNumeric

+ const ConstraintNumeric

+ const ContentTypeJson

+ const ContentTypeTextHtml

+ const ContentTypeTextPlain

+ const EventHttpRequestProfile

+ const HeaderRequestId

+ const KernelExceptionListenerPriority

+ const KernelHttpProfilerListenerPriority

+ const KernelResponseNormalizerListenerPriority

+ const KernelTerminateAccessLogListenerPriority

+ const RequestAttributeSession

+ const RouteAttributeHost

+ const RouteAttributeLocale

+ const RouteAttributeLocales

+ const RouteAttributeMethods

+ const RouteAttributeName

+ const RouteAttributePattern

+ const RouteAttributeSchemes

+ const ServiceRequestContext

+ const ServiceRouteRegistry

+ const ServiceRouter

+ const ServiceUrlGenerator

+ func DeleteCookie(response httpcontract.Response, name string, path string)

+ func ErrorJsonBodyHasExtraData() error

+ func ErrorUnsupportedContentType() error

+ func JoinPaths(prefix string, pattern string) string

+ func NewRequirements(requirements ...Requirement) map[string]string

+ func NewRouteGroup(router httpcontract.Router, pathPrefix string) httpcontract.RouteGroup

+ func NewRouteOptions(name string, methods []string, host string, schemes []string, ...) httpcontract.RouteOptions

+ func NormalizeResultToResponse(runtimeInstance runtimecontract.Runtime, request httpcontract.Request, ...) (httpcontract.Response, error)

+ func PrefersHtml(request httpcontract.Request) bool

+ func RecoverToError(recoveredValue any) error

+ func RegisterKernelExceptionListener(eventDispatcher eventcontract.EventDispatcher, debugMode bool)

+ func RegisterKernelHttpProfilerListener(eventDispatcher eventcontract.EventDispatcher)

+ func RegisterKernelResponseNormalizerListener(eventDispatcher eventcontract.EventDispatcher)

+ func RegisterKernelTerminateAccessLogListener(eventDispatcher eventcontract.EventDispatcher)

+ func RouteRegistryMustFromContainer(serviceContainer containercontract.Container) httpcontract.RouteRegistry

+ func RouterMustFromContainer(serviceContainer containercontract.Container) httpcontract.Router

+ func SetCookie(response httpcontract.Response, cookie *nethttp.Cookie)

+ func UrlGeneratorMustFromContainer(serviceContainer containercontract.Container) httpcontract.UrlGenerator

+ func WrapResultHandler(resultHandler ResultHandler) httpcontract.Handler

+ func WriteToHttpResponseWriter(runtimeInstance runtimecontract.Runtime, request httpcontract.Request, ...) error

+ type ErrorResponsePayload struct

+ Error string

+ Time string

+ func NewErrorResponsePayload(message string, timeString string) *ErrorResponsePayload

+ type HttpRequestProfile struct

+ func NewHttpRequestProfile(requestId string, method string, path string, routeName string, ...) *HttpRequestProfile

+ func (instance *HttpRequestProfile) Duration() time.Duration

+ func (instance *HttpRequestProfile) FinishedAt() time.Time

+ func (instance *HttpRequestProfile) Method() string

+ func (instance *HttpRequestProfile) Path() string

+ func (instance *HttpRequestProfile) RequestId() string

+ func (instance *HttpRequestProfile) RouteName() string

+ func (instance *HttpRequestProfile) RoutePattern() string

+ func (instance *HttpRequestProfile) StartedAt() time.Time

+ func (instance *HttpRequestProfile) StatusCode() int

+ type Kernel struct

+ func NewKernel(router httpcontract.Router) *Kernel

+ func (instance *Kernel) ServeHttp(serviceContainer containercontract.Container) nethttp.Handler

+ func (instance *Kernel) SetErrorHandler(handler httpcontract.ErrorHandler)

+ func (instance *Kernel) SetForwardedHeadersPolicy(policy httpcontract.ForwardedHeadersPolicy)

+ func (instance *Kernel) SetNotFoundHandler(handler httpcontract.Handler)

+ func (instance *Kernel) SetSessionCookiePolicy(policy httpcontract.SessionCookiePolicy)

+ func (instance *Kernel) Use(middlewares ...httpcontract.Middleware)

+ type KernelControllerEvent struct

+ func NewKernelControllerEvent(runtimeInstance runtimecontract.Runtime, request httpcontract.Request) *KernelControllerEvent

+ func (instance *KernelControllerEvent) Request() httpcontract.Request

+ func (instance *KernelControllerEvent) Response() httpcontract.Response

+ func (instance *KernelControllerEvent) Runtime() runtimecontract.Runtime

+ func (instance *KernelControllerEvent) SetResponse(response httpcontract.Response)

+ type KernelExceptionEvent struct

+ func NewKernelExceptionEvent(runtimeInstance runtimecontract.Runtime, request httpcontract.Request, ...) *KernelExceptionEvent

+ func (instance *KernelExceptionEvent) Err() error

+ func (instance *KernelExceptionEvent) Request() httpcontract.Request

+ func (instance *KernelExceptionEvent) Response() httpcontract.Response

+ func (instance *KernelExceptionEvent) Runtime() runtimecontract.Runtime

+ func (instance *KernelExceptionEvent) SetResponse(response httpcontract.Response)

+ type KernelOptions struct

+ ForwardedHeadersPolicy httpcontract.ForwardedHeadersPolicy

+ MethodPolicy MethodPolicy

+ SessionCookiePolicy httpcontract.SessionCookiePolicy

+ func DefaultKernelOptions() KernelOptions

+ type KernelRequestEvent struct

+ func NewKernelRequestEvent(runtimeInstance runtimecontract.Runtime, request httpcontract.Request) *KernelRequestEvent

+ func (instance *KernelRequestEvent) Request() httpcontract.Request

+ func (instance *KernelRequestEvent) Response() httpcontract.Response

+ func (instance *KernelRequestEvent) Runtime() runtimecontract.Runtime

+ func (instance *KernelRequestEvent) SetResponse(response httpcontract.Response)

+ type KernelResponseEvent struct

+ func NewKernelResponseEvent(request httpcontract.Request, response httpcontract.Response) *KernelResponseEvent

+ func (instance *KernelResponseEvent) Request() httpcontract.Request

+ func (instance *KernelResponseEvent) Response() httpcontract.Response

+ func (instance *KernelResponseEvent) SetResponse(response httpcontract.Response)

+ type KernelTerminateEvent struct

+ func NewKernelTerminateEvent(runtimeInstance runtimecontract.Runtime, request httpcontract.Request, ...) *KernelTerminateEvent

+ func (instance *KernelTerminateEvent) Request() httpcontract.Request

+ func (instance *KernelTerminateEvent) Response() httpcontract.Response

+ func (instance *KernelTerminateEvent) Runtime() runtimecontract.Runtime

+ type MethodPolicy struct

+ AutomaticOptions bool

+ HeadFallbackToGet bool

+ type Request struct

+ func NewRequest(httpRequest *nethttp.Request, routeParams map[string]string, ...) *Request

+ func (instance *Request) Attributes() bagcontract.ParameterBag

+ func (instance *Request) BindJson(target any) error

+ func (instance *Request) BindJsonAndValidate(target any) error

+ func (instance *Request) ContentType() string

+ func (instance *Request) Cookie(name string) (*nethttp.Cookie, error)

+ func (instance *Request) Cookies() []*nethttp.Cookie

+ func (instance *Request) FormValue(key string) string

+ func (instance *Request) Header(name string) string

+ func (instance *Request) HttpRequest() *nethttp.Request

+ func (instance *Request) Input(key string) string

+ func (instance *Request) Locale() string

+ func (instance *Request) Method() string

+ func (instance *Request) Param(name string) (string, bool)

+ func (instance *Request) Params() map[string]string

+ func (instance *Request) ParseFormBody() error

+ func (instance *Request) Path() string

+ func (instance *Request) Post() bagcontract.ParameterBag

+ func (instance *Request) Query() bagcontract.ParameterBag

+ func (instance *Request) RequestContext() httpcontract.RequestContext

+ func (instance *Request) RouteName() string

+ func (instance *Request) RoutePattern() string

+ func (instance *Request) RuntimeInstance() runtimecontract.Runtime

+ type RequestContext struct

+ func NewRequestContext(requestId string, startedAt time.Time) *RequestContext

+ func (instance *RequestContext) RequestId() string

+ func (instance *RequestContext) StartedAt() time.Time

+ type Requirement struct

+ func NewRequirement(parameterName string, pattern string) *Requirement

+ func RequireAlpha(parameterName string) *Requirement

+ func RequireAlphaLowercase(parameterName string) *Requirement

+ func RequireAlphaNumeric(parameterName string) *Requirement

+ func RequireNumeric(parameterName string) *Requirement

+ func (instance *Requirement) ParameterName() string

+ func (instance *Requirement) Pattern() string

+ type Response struct

+ func AttachmentResponse(statusCode int, path string, filename string) (*Response, error)

+ func EmptyResponse(statusCode int) *Response

+ func FileResponse(statusCode int, path string) (*Response, error)

+ func HtmlResponse(statusCode int, html string) *Response

+ func JsonErrorResponse(statusCode int, message string) *Response

+ func JsonResponse(statusCode int, payload any) (*Response, error)

+ func NewResponse(statusCode int, body []byte) *Response

+ func RedirectFound(location string) *Response

+ func RedirectMovedPermanently(location string) *Response

+ func RedirectResponse(location string, statusCode int) *Response

+ func TextResponse(statusCode int, message string) *Response

+ func (instance *Response) BodyReader() io.Reader

+ func (instance *Response) Headers() nethttp.Header

+ func (instance *Response) SetBodyReader(reader io.Reader)

+ func (instance *Response) SetHeaders(headers nethttp.Header)

+ func (instance *Response) SetStatusCode(statusCode int)

+ func (instance *Response) StatusCode() int

+ type ResultHandler func(runtimeInstance runtimecontract.Runtime, writer nethttp.ResponseWriter, ...) (any, error)

+ type RouteDefinition struct

+ func NewRouteDefinition(name string, pattern string, methods []string, host string, schemes []string, ...) *RouteDefinition

+ func (instance *RouteDefinition) Attributes() map[string]any

+ func (instance *RouteDefinition) Defaults() map[string]string

+ func (instance *RouteDefinition) Host() string

+ func (instance *RouteDefinition) Locales() []string

+ func (instance *RouteDefinition) MarshalJSON() ([]byte, error)

+ func (instance *RouteDefinition) Methods() []string

+ func (instance *RouteDefinition) Name() string

+ func (instance *RouteDefinition) Pattern() string

+ func (instance *RouteDefinition) Priority() int

+ func (instance *RouteDefinition) Requirements() map[string]string

+ func (instance *RouteDefinition) Schemes() []string

+ type RouteGroup struct

+ func (instance *RouteGroup) Handle(method string, pattern string, handler httpcontract.Handler)

+ func (instance *RouteGroup) HandleController(method string, pattern string, controller any)

+ func (instance *RouteGroup) HandleNamed(name string, method string, pattern string, handler httpcontract.Handler)

+ func (instance *RouteGroup) HandleNamedController(name string, method string, pattern string, controller any)

+ func (instance *RouteGroup) HandleWithOptions(pattern string, handler httpcontract.Handler, ...)

+ func (instance *RouteGroup) WithDefaults(defaults map[string]string)

+ func (instance *RouteGroup) WithNamePrefix(namePrefix string)

+ func (instance *RouteGroup) WithRequirements(requirements map[string]string)

+ type RouteOptions struct

+ func (instance *RouteOptions) Attributes() map[string]any

+ func (instance *RouteOptions) Defaults() map[string]string

+ func (instance *RouteOptions) Host() string

+ func (instance *RouteOptions) Locales() []string

+ func (instance *RouteOptions) Methods() []string

+ func (instance *RouteOptions) Name() string

+ func (instance *RouteOptions) Priority() int

+ func (instance *RouteOptions) Requirements() map[string]string

+ func (instance *RouteOptions) Schemes() []string

+ func (instance *RouteOptions) SetDefaults(defaults map[string]string)

+ func (instance *RouteOptions) SetName(name string)

+ func (instance *RouteOptions) SetRequirements(requirements map[string]string)

+ type RouteRegistry struct

+ func NewRouteRegistry() *RouteRegistry

+ func (instance *RouteRegistry) RouteDefinition(routeName string) (httpcontract.RouteDefinition, bool)

+ func (instance *RouteRegistry) RouteDefinitionForUrlGeneration(routeName string) (httpcontract.UrlGenerationRouteDefinition, bool)

+ func (instance *RouteRegistry) RouteDefinitions() []httpcontract.RouteDefinition

+ type Router struct

+ func NewRouter() *Router

+ func NewRouterWithRouteRegistry(routeRegistry *RouteRegistry) *Router

+ func (instance *Router) AllowedMethods(path string, host string, scheme string) []string

+ func (instance *Router) Group(pathPrefix string) httpcontract.RouteGroup

+ func (instance *Router) Handle(method string, pattern string, handler httpcontract.Handler)

+ func (instance *Router) HandleController(method string, pattern string, controller any)

+ func (instance *Router) HandleNamed(name string, method string, pattern string, handler httpcontract.Handler)

+ func (instance *Router) HandleNamedController(name string, method string, pattern string, controller any)

+ func (instance *Router) HandleWithOptions(pattern string, handler httpcontract.Handler, ...)

+ func (instance *Router) Match(method string, path string, host string, scheme string) (*httpcontract.MatchResult, bool)

+ func (instance *Router) RouteDefinition(routeName string) (httpcontract.RouteDefinition, bool)

+ func (instance *Router) RouteDefinitions() []httpcontract.RouteDefinition

+ func (instance *Router) RouteRegistry() httpcontract.RouteRegistry

+ type UrlGenerationRouteDefinition struct

+ func NewUrlGenerationRouteDefinition(routeValue route) *UrlGenerationRouteDefinition

+ func (instance *UrlGenerationRouteDefinition) Defaults() map[string]string

+ func (instance *UrlGenerationRouteDefinition) Pattern() string

+ func (instance *UrlGenerationRouteDefinition) Requirements() map[string]*regexp.Regexp

+ type UrlGenerator struct

+ func NewUrlGenerator(routeRegistry httpcontract.RouteRegistry) *UrlGenerator

+ func (instance *UrlGenerator) GeneratePath(routeName string, parameters map[string]string) (string, error)

+ func (instance *UrlGenerator) GenerateUrl(routeName string, params map[string]string, queryParams map[string]string) (string, error)

Other modules containing this package

github.com/precision-soft/melody

github.com/precision-soft/melody/v2