1
0
mirror of https://github.com/go-micro/go-micro.git synced 2024-12-24 10:07:04 +02:00
go-micro/registry/registry.go

61 lines
1.4 KiB
Go
Raw Normal View History

2015-01-14 01:31:27 +02:00
package registry
2016-02-25 14:42:31 +02:00
import (
"errors"
)
2016-01-30 23:13:34 +02:00
// The registry provides an interface for service discovery
// and an abstraction over varying implementations
// {consul, etcd, zookeeper, ...}
2015-01-14 01:31:27 +02:00
type Registry interface {
2016-01-27 01:32:27 +02:00
Register(*Service, ...RegisterOption) error
Deregister(*Service) error
2015-11-08 03:48:48 +02:00
GetService(string) ([]*Service, error)
ListServices() ([]*Service, error)
Watch() (Watcher, error)
2015-12-19 23:56:14 +02:00
String() string
}
2015-12-19 20:28:08 +02:00
type Option func(*Options)
2016-01-27 01:32:27 +02:00
type RegisterOption func(*RegisterOptions)
2015-01-14 01:31:27 +02:00
var (
2016-03-16 00:20:21 +02:00
DefaultRegistry = newConsulRegistry()
2016-02-25 14:42:31 +02:00
ErrNotFound = errors.New("not found")
2015-01-14 01:31:27 +02:00
)
2016-03-16 00:20:21 +02:00
func NewRegistry(opts ...Option) Registry {
return newConsulRegistry(opts...)
}
2016-01-30 23:13:34 +02:00
// Register a service node. Additionally supply options such as TTL.
2016-01-27 01:32:27 +02:00
func Register(s *Service, opts ...RegisterOption) error {
return DefaultRegistry.Register(s, opts...)
2015-01-14 01:31:27 +02:00
}
2016-01-30 23:13:34 +02:00
// Deregister a service node
func Deregister(s *Service) error {
2015-01-14 01:31:27 +02:00
return DefaultRegistry.Deregister(s)
}
2016-01-30 23:13:34 +02:00
// Retrieve a service. A slice is returned since we separate Name/Version.
2015-11-08 03:48:48 +02:00
func GetService(name string) ([]*Service, error) {
2015-01-14 01:31:27 +02:00
return DefaultRegistry.GetService(name)
}
2016-01-30 23:13:34 +02:00
// List the services. Only returns service names
func ListServices() ([]*Service, error) {
return DefaultRegistry.ListServices()
}
2015-12-05 03:12:29 +02:00
2016-01-30 23:13:34 +02:00
// Watch returns a watcher which allows you to track updates to the registry.
2015-12-05 03:12:29 +02:00
func Watch() (Watcher, error) {
return DefaultRegistry.Watch()
}
2015-12-19 23:56:14 +02:00
func String() string {
return DefaultRegistry.String()
}