netutil

Documentation

Index

• Variables
• func LimitListener(l net.Listener, n int32) net.Listener
• type Backoff
• type BackoffConfig
  • func (bc *BackoffConfig) Backoff(retries int) time.Duration
• type LimitListenerError
  • func (l *LimitListenerError) Error() string
  • func (l *LimitListenerError) Temporary() bool
  • func (l *LimitListenerError) Timeout() bool

Variables

var DefaultBackoffConfig = BackoffConfig{
	MaxDelay:  120 * time.Second,
	BaseDelay: 1.0 * time.Second,
	Factor:    1.6,
	Jitter:    0.2,
}

DefaultBackoffConfig uses values specified for backoff in common.

var (
	// ErrLimitListener listen limit error.
	ErrLimitListener = &LimitListenerError{}
)

Functions

func LimitListener

func LimitListener(l net.Listener, n int32) net.Listener

LimitListener returns a Listener that accepts at most n simultaneous connections from the provided Listener.

Types

type Backoff

type Backoff interface {
	// Backoff returns the amount of time to wait before the next retry given
	// the number of consecutive failures.
	Backoff(retries int) time.Duration
}

Backoff defines the methodology for backing off after a call failure.

type BackoffConfig

type BackoffConfig struct {
	// MaxDelay is the upper bound of backoff delay.
	MaxDelay time.Duration

	// baseDelay is the amount of time to wait before retrying after the first
	// failure.
	BaseDelay time.Duration

	// factor is applied to the backoff after each retry.
	Factor float64

	// jitter provides a range to randomize backoff delays.
	Jitter float64
}

BackoffConfig defines the parameters for the default backoff strategy.

func (*BackoffConfig) Backoff

func (bc *BackoffConfig) Backoff(retries int) time.Duration

Backoff returns the amount of time to wait before the next retry given the number of consecutive failures.

type LimitListenerError

type LimitListenerError struct{}

LimitListenerError limit max connections of listener.

func (*LimitListenerError) Error

func (l *LimitListenerError) Error() string

Error return error message of error.

func (*LimitListenerError) Temporary

func (l *LimitListenerError) Temporary() bool

Temporary is the error temporary.

func (*LimitListenerError) Timeout

func (l *LimitListenerError) Timeout() bool

Timeout is the error a timeout.