server

Documentation

Overview

Package server provides high-level contract about server and also provides a manager to manage all servers.

Index

• type Manager
  • func NewManager(servers []Server) *Manager
  • func (m *Manager) GracefulStop()
  • func (m *Manager) Serve()
• type Server

Types

type Manager

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

Manager manages the attached servers.

func NewManager

func NewManager(servers []Server) *Manager

NewManager creates an instance of Manager.

func (*Manager) GracefulStop

func (m *Manager) GracefulStop()

GracefulStop stops all servers gracefully. It waits for signal which currently implemented as signal.Notify(sign, syscall.SIGINT, syscall.SIGTERM).

func (*Manager) Serve

func (m *Manager) Serve()

Serve runs all attached servers. Each server will be run in an independent goroutine to make sure that no server blocking each others.

type Server

type Server interface {
	// Name represents server's name.
	Name() string
	// Port represents server's port.
	Port() string
	// Serve runs the server in a blocking way.
	// It is up to implementor to make it run in a goroutine so that it doesn't block
	// or just let it be a blocking method.
	Serve() error
	// GracefulStop stops the server gracefully.
	GracefulStop()
}

Server defines contract to implement server.