You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
42 lines
1.4 KiB
42 lines
1.4 KiB
4 years ago
|
package registry
|
||
|
|
|
||
|
|
// Registry is service registry.
|
||
|
|
type Registry interface {
|
||
|
|
// Register the registration.
|
||
|
|
Register(service *ServiceInstance) error
|
||
|
|
// Deregister the registration.
|
||
|
|
Deregister(service *ServiceInstance) error
|
||
|
|
// Service return the service instances in memory according to the service name.
|
||
|
|
Service(name string) ([]*ServiceInstance, error)
|
||
|
|
// Watch creates a watcher according to the service name.
|
||
|
|
Watch(name string) (Watcher, error)
|
||
|
|
}
|
||
|
|
|
||
|
|
// Watcher is service watcher.
|
||
|
|
type Watcher interface {
|
||
|
|
// Watch returns services in the following two cases:
|
||
|
|
// 1.the first time to watch and the service instance list is not empty.
|
||
|
|
// 2.any service instance changes found.
|
||
|
|
// if the above two conditions are not met, it will block until context deadline exceeded or canceled
|
||
|
|
Next() ([]*ServiceInstance, error)
|
||
|
|
// Close close the watcher.
|
||
|
|
Close() error
|
||
|
|
}
|
||
|
|
|
||
|
|
// ServiceInstance is an instance of a service in a discovery system.
|
||
|
|
type ServiceInstance struct {
|
||
|
|
// ID is the unique instance ID as registered.
|
||
|
|
ID string
|
||
|
|
// Name is the service name as registered.
|
||
|
|
Name string
|
||
|
|
// Version is the version of the compiled.
|
||
|
|
Version string
|
||
|
|
// Metadata is the kv pair metadata associated with the service instance.
|
||
|
|
Metadata map[string]string
|
||
|
|
// Endpoints is endpoint addresses of the service instance.
|
||
|
|
// schema:
|
||
|
|
// http://127.0.0.1:8000?isSecure=false
|
||
|
|
// grpc://127.0.0.1:9000?isSecure=false
|
||
|
|
Endpoints []string
|
||
|
|
}
|