1e94d9fe5a
This commit adds the following changes to router package: * it refactors Advertise() function which now does only what it claims to do: advertising * various router packages functions/methods have been renamed to make their functionality more obvious and more in line with what they actually do * function documentation changes related to the above bullet points
88 lines
1.9 KiB
Go
88 lines
1.9 KiB
Go
// Package router provides a network routing control plane
|
|
package router
|
|
|
|
import (
|
|
"time"
|
|
|
|
"github.com/micro/go-micro/network/router/table"
|
|
)
|
|
|
|
var (
|
|
// DefaultRouter is default network router
|
|
DefaultRouter = NewRouter()
|
|
)
|
|
|
|
// Router is an interface for a routing control plane
|
|
type Router interface {
|
|
// Router provides a routing table
|
|
table.Table
|
|
// Init initializes the router with options
|
|
Init(...Option) error
|
|
// Options returns the router options
|
|
Options() Options
|
|
// Advertise advertises routes to the network
|
|
Advertise() (<-chan *Advert, error)
|
|
// Process processes incoming adverts
|
|
Process(*Advert) error
|
|
// Status returns router status
|
|
Status() Status
|
|
// Stop stops the router
|
|
Stop() error
|
|
// Returns the router implementation
|
|
String() string
|
|
}
|
|
|
|
// Option used by the router
|
|
type Option func(*Options)
|
|
|
|
// StatusCode defines router status
|
|
type StatusCode int
|
|
|
|
const (
|
|
// Running means the router is up and running
|
|
Running StatusCode = iota
|
|
// Advertising means the router is advertising
|
|
Advertising
|
|
// Stopped means the router has been stopped
|
|
Stopped
|
|
// Error means the router has encountered error
|
|
Error
|
|
)
|
|
|
|
// Status is router status
|
|
type Status struct {
|
|
// Error is router error
|
|
Error error
|
|
// Code defines router status
|
|
Code StatusCode
|
|
}
|
|
|
|
// AdvertType is route advertisement type
|
|
type AdvertType int
|
|
|
|
const (
|
|
// Announce is advertised when the router announces itself
|
|
Announce AdvertType = iota
|
|
// Update advertises route updates
|
|
Update
|
|
)
|
|
|
|
// Advert contains a list of events advertised by the router to the network
|
|
type Advert struct {
|
|
// Id is the router Id
|
|
Id string
|
|
// Type is type of advert
|
|
Type AdvertType
|
|
// Timestamp marks the time when the update is sent
|
|
Timestamp time.Time
|
|
// TTL is Advert TTL
|
|
TTL time.Duration
|
|
// Events is a list of routing table events to advertise
|
|
Events []*table.Event
|
|
}
|
|
|
|
// NewRouter creates new Router and returns it
|
|
func NewRouter(opts ...Option) Router {
|
|
return newRouter(opts...)
|
|
}
|