2019-06-21 18:17:12 +03:00
|
|
|
// Package router provides a network routing control plane
|
2019-06-06 18:37:40 +03:00
|
|
|
package router
|
|
|
|
|
2019-07-08 18:51:55 +03:00
|
|
|
import (
|
|
|
|
"time"
|
|
|
|
)
|
2019-06-28 13:53:55 +03:00
|
|
|
|
2019-08-20 14:48:51 +03:00
|
|
|
var (
|
|
|
|
// DefaultAddress is default router address
|
|
|
|
DefaultAddress = ":9093"
|
|
|
|
// DefaultName is default router service name
|
|
|
|
DefaultName = "go.micro.router"
|
|
|
|
// DefaultNetwork is default micro network
|
|
|
|
DefaultNetwork = "go.micro"
|
|
|
|
// DefaultRouter is default network router
|
|
|
|
DefaultRouter = NewRouter()
|
|
|
|
)
|
|
|
|
|
2019-06-21 18:17:12 +03:00
|
|
|
// Router is an interface for a routing control plane
|
2019-06-06 18:37:40 +03:00
|
|
|
type Router interface {
|
2019-06-13 00:30:42 +03:00
|
|
|
// Init initializes the router with options
|
2019-06-06 18:37:40 +03:00
|
|
|
Init(...Option) error
|
2019-06-13 00:30:42 +03:00
|
|
|
// Options returns the router options
|
2019-06-06 18:37:40 +03:00
|
|
|
Options() Options
|
2019-07-29 20:57:40 +03:00
|
|
|
// The routing table
|
|
|
|
Table() Table
|
2019-07-08 18:16:50 +03:00
|
|
|
// Advertise advertises routes to the network
|
2019-07-04 04:06:59 +03:00
|
|
|
Advertise() (<-chan *Advert, error)
|
2019-07-10 09:45:27 +03:00
|
|
|
// Process processes incoming adverts
|
|
|
|
Process(*Advert) error
|
2019-09-05 19:59:14 +03:00
|
|
|
// Solicit advertises the whole routing table to the network
|
2019-09-05 15:23:33 +03:00
|
|
|
Solicit() error
|
2019-07-26 01:52:54 +03:00
|
|
|
// Lookup queries routes in the routing table
|
2019-10-09 19:13:52 +03:00
|
|
|
Lookup(...QueryOption) ([]Route, error)
|
2019-07-26 01:52:54 +03:00
|
|
|
// Watch returns a watcher which tracks updates to the routing table
|
2019-07-26 01:19:05 +03:00
|
|
|
Watch(opts ...WatchOption) (Watcher, error)
|
2019-08-12 20:18:17 +03:00
|
|
|
// Start starts the router
|
|
|
|
Start() error
|
2019-06-28 20:35:53 +03:00
|
|
|
// Status returns router status
|
|
|
|
Status() Status
|
2019-06-13 00:30:42 +03:00
|
|
|
// Stop stops the router
|
2019-06-12 01:59:25 +03:00
|
|
|
Stop() error
|
2019-07-10 09:56:52 +03:00
|
|
|
// Returns the router implementation
|
2019-06-07 15:29:09 +03:00
|
|
|
String() string
|
|
|
|
}
|
|
|
|
|
2019-08-20 23:11:27 +03:00
|
|
|
// Table is an interface for routing table
|
2019-07-29 20:57:40 +03:00
|
|
|
type Table interface {
|
|
|
|
// Create new route in the routing table
|
|
|
|
Create(Route) error
|
2019-08-20 23:11:27 +03:00
|
|
|
// Delete existing route from the routing table
|
2019-07-29 20:57:40 +03:00
|
|
|
Delete(Route) error
|
2019-08-20 23:11:27 +03:00
|
|
|
// Update route in the routing table
|
2019-07-29 20:57:40 +03:00
|
|
|
Update(Route) error
|
2019-08-20 23:11:27 +03:00
|
|
|
// List all routes in the table
|
2019-07-29 20:57:40 +03:00
|
|
|
List() ([]Route, error)
|
2019-08-20 23:11:27 +03:00
|
|
|
// Query routes in the routing table
|
2019-10-09 19:13:52 +03:00
|
|
|
Query(...QueryOption) ([]Route, error)
|
2019-07-29 20:57:40 +03:00
|
|
|
}
|
|
|
|
|
2019-07-03 21:50:07 +03:00
|
|
|
// Option used by the router
|
|
|
|
type Option func(*Options)
|
|
|
|
|
2019-07-24 19:16:52 +03:00
|
|
|
// 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
|
|
|
|
)
|
|
|
|
|
2019-07-27 18:01:30 +03:00
|
|
|
func (s StatusCode) String() string {
|
|
|
|
switch s {
|
|
|
|
case Running:
|
|
|
|
return "running"
|
|
|
|
case Advertising:
|
|
|
|
return "advertising"
|
|
|
|
case Stopped:
|
|
|
|
return "stopped"
|
|
|
|
case Error:
|
|
|
|
return "error"
|
|
|
|
default:
|
|
|
|
return "unknown"
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2019-07-24 19:16:52 +03:00
|
|
|
// Status is router status
|
|
|
|
type Status struct {
|
|
|
|
// Code defines router status
|
|
|
|
Code StatusCode
|
2019-08-12 20:18:17 +03:00
|
|
|
// Error contains error description
|
|
|
|
Error error
|
|
|
|
}
|
|
|
|
|
|
|
|
// String returns human readable status
|
|
|
|
func (s Status) String() string {
|
|
|
|
return s.Code.String()
|
2019-07-24 19:16:52 +03:00
|
|
|
}
|
|
|
|
|
2019-07-09 14:46:15 +03:00
|
|
|
// AdvertType is route advertisement type
|
|
|
|
type AdvertType int
|
2019-07-03 21:50:07 +03:00
|
|
|
|
2019-07-24 19:16:52 +03:00
|
|
|
const (
|
|
|
|
// Announce is advertised when the router announces itself
|
|
|
|
Announce AdvertType = iota
|
2019-07-26 01:19:05 +03:00
|
|
|
// RouteUpdate advertises route updates
|
|
|
|
RouteUpdate
|
2019-07-24 19:16:52 +03:00
|
|
|
)
|
|
|
|
|
2019-07-26 01:19:05 +03:00
|
|
|
// String returns human readable advertisement type
|
|
|
|
func (t AdvertType) String() string {
|
|
|
|
switch t {
|
|
|
|
case Announce:
|
|
|
|
return "announce"
|
|
|
|
case RouteUpdate:
|
|
|
|
return "update"
|
|
|
|
default:
|
|
|
|
return "unknown"
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2019-07-08 18:16:50 +03:00
|
|
|
// Advert contains a list of events advertised by the router to the network
|
2019-07-04 04:06:59 +03:00
|
|
|
type Advert struct {
|
2019-07-10 09:45:27 +03:00
|
|
|
// Id is the router Id
|
|
|
|
Id string
|
2019-07-09 14:46:15 +03:00
|
|
|
// Type is type of advert
|
|
|
|
Type AdvertType
|
2019-07-03 21:50:07 +03:00
|
|
|
// Timestamp marks the time when the update is sent
|
2019-06-28 13:53:55 +03:00
|
|
|
Timestamp time.Time
|
2019-07-08 23:03:54 +03:00
|
|
|
// TTL is Advert TTL
|
2019-07-11 14:36:39 +03:00
|
|
|
TTL time.Duration
|
2019-07-08 18:51:55 +03:00
|
|
|
// Events is a list of routing table events to advertise
|
2019-07-26 01:19:05 +03:00
|
|
|
Events []*Event
|
2019-06-28 00:52:51 +03:00
|
|
|
}
|
|
|
|
|
2019-06-06 18:37:40 +03:00
|
|
|
// NewRouter creates new Router and returns it
|
|
|
|
func NewRouter(opts ...Option) Router {
|
|
|
|
return newRouter(opts...)
|
|
|
|
}
|