Class StaticDiscovery

java.lang.Object
com.loomcache.server.discovery.StaticDiscovery
All Implemented Interfaces:
DiscoveryStrategy
public class StaticDiscovery extends Object implements DiscoveryStrategy
Static discovery strategy using a fixed list of seed addresses.

Peers are configured at construction time and never change. This is the simple, reliable fallback for peer discovery.

Thread-safe.

  • Constructor Details

    • StaticDiscovery

      public StaticDiscovery(List<String> seedAddresses)
      Create a static discovery strategy from a list of seed addresses.
      Parameters:
      seedAddresses - list of seed addresses in format "host:port" or "[host]:port"

  • Method Details

    • discoverPeers

      public List<PeerAddress> discoverPeers()
      Description copied from interface: DiscoveryStrategy
      Discover available peers.

      Returns a snapshot of currently known peers. If no peers are available, an empty list is returned (not null). The returned list is mutable and modifications should not affect internal strategy state.

      Specified by:
      discoverPeers in interface DiscoveryStrategy
      Returns:
      list of discovered peer addresses; empty list if none available

    • start

      public void start()
      Description copied from interface: DiscoveryStrategy
      Start the discovery strategy.

      Initializes the discovery mechanism and starts any background threads or I/O operations (e.g., watching files, listening to multicast, resolving DNS). Implementations must handle errors gracefully and should not leave resources in an inconsistent state if startup fails.

      Specified by:
      start in interface DiscoveryStrategy

    • stop

      public void stop()
      Description copied from interface: DiscoveryStrategy
      Stop the discovery strategy and release resources.

      Cleanly shuts down the discovery mechanism, including stopping any background threads and closing I/O resources. Safe to call multiple times and must be idempotent (calling twice should have no additional effect).

      Specified by:
      stop in interface DiscoveryStrategy

    • getName

      public String getName()
      Description copied from interface: DiscoveryStrategy
      Get the name of this discovery strategy.

      Used for logging, metrics, and debugging purposes.

      Specified by:
      getName in interface DiscoveryStrategy
      Returns:
      human-readable strategy name (e.g., "FileBasedDiscovery", "MulticastDiscovery")