httpserver

README

httpserver

Another HTTP Server use handler with context & Response Render.

Quick Start

package main

import (
	"context"
	"log"
	"net/http"

	"github.com/x-mod/httpserver"
)

func main() {
	srv := httpserver.NewServer(
		httpserver.Address(":8080"),
	)
	srv.Route(
		httpserver.Pattern("/hello"),
		httpserver.Handler(http.HandlerFunc(Hello)),
	)
	log.Println("httpserver:", srv.Serve(context.TODO()))
}

func Hello(wr http.ResponseWriter, req *http.Request) {
	wr.WriteHeader(http.StatusOK)
	_, _ = wr.Write([]byte("I'm OK"))
}

Documentation

Index

• type MiddlewareFunc
• type RouteCfg
• type RouteOpt
  • func Handler(h http.Handler) RouteOpt
  • func Header(headers ...string) RouteOpt
  • func Host(host string) RouteOpt
  • func Method(methods ...string) RouteOpt
  • func Pattern(pattern string) RouteOpt
  • func Prefix(prefix string) RouteOpt
  • func Query(queries ...string) RouteOpt
  • func Schema(schemas ...string) RouteOpt
• type Server
  • func New(opts ...ServerOpt) *Server
  • func NewServer(opts ...ServerOpt) *Server
  • func (srv *Server) Close() <-chan struct{}
  • func (srv *Server) Route(opts ...RouteOpt)
  • func (srv *Server) Serve(ctx context.Context) error
  • func (srv *Server) ServeHTTP(w http.ResponseWriter, req *http.Request)
  • func (srv *Server) Serving() <-chan struct{}
  • func (srv *Server) Shutdown(ctx context.Context) error
• type ServerOpt
  • func Address(addr string) ServerOpt
  • func HTTPHandler(handler http.Handler) ServerOpt
  • func Middleware(m MiddlewareFunc) ServerOpt
  • func Name(name string) ServerOpt
  • func NetTrace(flag bool) ServerOpt
  • func TLSConfig(cf *tls.Config) ServerOpt

Types

type MiddlewareFunc

type MiddlewareFunc func(http.Handler) http.Handler

type RouteCfg

type RouteCfg struct {
	// contains filtered or unexported fields
}

type RouteOpt

type RouteOpt func(cf *RouteCfg)

func Handler

func Handler(h http.Handler) RouteOpt

func Header

func Header(headers ...string) RouteOpt

func Host

func Host(host string) RouteOpt

func Method

func Method(methods ...string) RouteOpt

func Pattern

func Pattern(pattern string) RouteOpt

func Prefix

func Prefix(prefix string) RouteOpt

func Query

func Query(queries ...string) RouteOpt

func Schema

func Schema(schemas ...string) RouteOpt

type Server

type Server struct {
	// contains filtered or unexported fields
}

func New

func New(opts ...ServerOpt) *Server

func NewServer

func NewServer(opts ...ServerOpt) *Server

func (*Server) Close

func (srv *Server) Close() <-chan struct{}

func (*Server) Route

func (srv *Server) Route(opts ...RouteOpt)

func (*Server) Serve

func (srv *Server) Serve(ctx context.Context) error

func (*Server) ServeHTTP

func (srv *Server) ServeHTTP(w http.ResponseWriter, req *http.Request)

ServeHTTP Implement http.Handler interface

func (*Server) Serving

func (srv *Server) Serving() <-chan struct{}

func (*Server) Shutdown

func (srv *Server) Shutdown(ctx context.Context) error

type ServerOpt

type ServerOpt func(*Server)

func Address

func Address(addr string) ServerOpt

func HTTPHandler

func HTTPHandler(handler http.Handler) ServerOpt

func Middleware

func Middleware(m MiddlewareFunc) ServerOpt

func Name

func Name(name string) ServerOpt

func NetTrace

func NetTrace(flag bool) ServerOpt

func TLSConfig

func TLSConfig(cf *tls.Config) ServerOpt