public interface ServiceDiscovery<T>
extends java.io.Closeable
Modifier and Type | Method and Description |
---|---|
ServiceInstance<T> |
queryForInstance(java.lang.String name,
java.lang.String id)
Return a service instance POJO
|
java.util.Collection<ServiceInstance<T>> |
queryForInstances(java.lang.String name)
Return all known instances for the given service
|
java.util.Collection<java.lang.String> |
queryForNames()
Return the names of all known services
|
void |
registerService(ServiceInstance<T> service)
Register/re-register/update a service instance
|
ServiceCacheBuilder<T> |
serviceCacheBuilder()
Allocate a new service cache builder.
|
ServiceProviderBuilder<T> |
serviceProviderBuilder()
Allocate a new builder.
|
void |
start()
The discovery must be started before use
|
void |
unregisterService(ServiceInstance<T> service)
Unregister/remove a service instance
|
void start() throws java.lang.Exception
java.lang.Exception
- errorsvoid registerService(ServiceInstance<T> service) throws java.lang.Exception
service
- service to addjava.lang.Exception
- errorsvoid unregisterService(ServiceInstance<T> service) throws java.lang.Exception
service
- the servicejava.lang.Exception
- errorsServiceCacheBuilder<T> serviceCacheBuilder()
java.util.Collection<java.lang.String> queryForNames() throws java.lang.Exception
java.lang.Exception
- errorsjava.util.Collection<ServiceInstance<T>> queryForInstances(java.lang.String name) throws java.lang.Exception
name
- name of the servicejava.lang.Exception
- errorsServiceInstance<T> queryForInstance(java.lang.String name, java.lang.String id) throws java.lang.Exception
name
- name of the serviceid
- ID of the instancenull
if not foundjava.lang.Exception
- errorsServiceProviderBuilder<T> serviceProviderBuilder()
ServiceProviderBuilder.providerStrategy(com.netflix.curator.x.discovery.ProviderStrategy<T>)
is set to RoundRobinStrategy
and ServiceProviderBuilder.refreshPaddingMs(int)
is set to 1 second.