Interface RegistryClient

All Superinterfaces:
AutoCloseable
public interface RegistryClient extends AutoCloseable
Thread-safe registry client SPI.

Implementations own any registry connections or embedded stores. Methods must filter expired records and wrap implementation failures in middleware exceptions.

  • Method Details

    • bind

      void bind(RegistryRecord record)
      Binds or replaces one registry record.
      Parameters:
      record - registry record

    • unbind

      void unbind(ObjectRef ref)
      Unbinds one object reference. The method is idempotent.
      Parameters:
      ref - object reference

    • lookup

      Optional<RegistryRecord> lookup(ObjectRef ref)
      Looks up one concrete reference.
      Parameters:
      ref - object reference
      Returns:
      non-expired record if present

    • list

      List<RegistryRecord> list(RegistryQuery query)
      Lists matching non-expired records.
      Parameters:
      query - registry query
      Returns:
      immutable list of matching records

    • heartbeat

      void heartbeat(ObjectRef ref, long leaseUntil)
      Renews a record lease.
      Parameters:
      ref - object reference
      leaseUntil - new lease timestamp

    • peers

      List<RegistryPeerStatus> peers(PeerQuery query)
      Returns known registry peers.
      Parameters:
      query - peer query
      Returns:
      immutable peer list

    • close

      void close()
      Closes registry resources.
      Specified by:
      close in interface AutoCloseable