Package org.apache.pekko.discovery

Class ServiceDiscovery

java.lang.Object

org.apache.pekko.discovery.ServiceDiscovery

public abstract class ServiceDiscovery
extends Object

Implement to provide a service discovery method

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	ServiceDiscovery.DiscoveryTimeoutException	Future returned by resolve(name, timeout) should be failed with this exception if the underlying mechanism was unable to resolve the name within the given timeout.
static final class	ServiceDiscovery.Resolved	Result of a successful resolve request
static class	ServiceDiscovery.Resolved$
static final class	ServiceDiscovery.ResolvedTarget	Resolved target host, with optional port and the IP address.
static class	ServiceDiscovery.ResolvedTarget$

Constructor Summary

Constructors

Constructor	Description
ServiceDiscovery()

Method Summary

Modifier and Type	Method	Description
CompletionStage<ServiceDiscovery.Resolved>	lookup(String serviceName, Duration resolveTimeout)	Java API
scala.concurrent.Future<ServiceDiscovery.Resolved>	lookup(String serviceName, scala.concurrent.duration.FiniteDuration resolveTimeout)	Scala API: Perform lookup using underlying discovery implementation.
CompletionStage<ServiceDiscovery.Resolved>	lookup(Lookup query, Duration resolveTimeout)	Java API: Perform basic lookup using underlying discovery implementation.
abstract scala.concurrent.Future<ServiceDiscovery.Resolved>	lookup(Lookup lookup, scala.concurrent.duration.FiniteDuration resolveTimeout)	Scala API: Perform lookup using underlying discovery implementation.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

ServiceDiscovery

public ServiceDiscovery()

Method Details

lookup

public abstract scala.concurrent.Future<ServiceDiscovery.Resolved> lookup(Lookup lookup,
 scala.concurrent.duration.FiniteDuration resolveTimeout)

Scala API: Perform lookup using underlying discovery implementation.

Parameters:

lookup - A service discovery lookup.

resolveTimeout - Timeout. Up to the discovery-method to adhere to his

Returns:

Resolved future should be failed with a [DiscoveryTimeoutException] if the resolveTimeout is exceeded.

lookup

public scala.concurrent.Future<ServiceDiscovery.Resolved> lookup(String serviceName,
 scala.concurrent.duration.FiniteDuration resolveTimeout)

Scala API: Perform lookup using underlying discovery implementation.

Convenience for when only a name is required.

lookup

public CompletionStage<ServiceDiscovery.Resolved> lookup(Lookup query,
 Duration resolveTimeout)

Java API: Perform basic lookup using underlying discovery implementation.

While the implementation may provide other settings and ways to configure timeouts, the passed resolveTimeout should never be exceeded, as it signals the application's eagerness to wait for a result for this specific lookup.

The returned future should be failed once resolveTimeout has passed with a ServiceDiscovery.DiscoveryTimeoutException.

lookup

public CompletionStage<ServiceDiscovery.Resolved> lookup(String serviceName,
 Duration resolveTimeout)

Java API

Parameters:

serviceName - A name, see discovery-method's docs for how this is interpreted

resolveTimeout - Timeout. Up to the discovery-method to adhere to this and complete the CompletionStage with a [DiscoveryTimeoutException]