Package org.apache.dubbo.registry.support

Class FailbackRegistry

java.lang.Object
org.apache.dubbo.registry.support.AbstractRegistry
org.apache.dubbo.registry.support.FailbackRegistry
All Implemented Interfaces:
Node, Registry, RegistryService
Direct Known Subclasses:
CacheableFailbackRegistry, ServiceDiscoveryRegistry
public abstract class FailbackRegistry extends AbstractRegistry
A template implementation of registry service that provides auto-retry ability. (SPI, Prototype, ThreadSafe)

  • Constructor Details

    • FailbackRegistry

      public FailbackRegistry(URL url)

  • Method Details

    • removeFailedRegisteredTask

      public void removeFailedRegisteredTask(URL url)

    • removeFailedUnregisteredTask

      public void removeFailedUnregisteredTask(URL url)

    • removeFailedSubscribedTask

      public void removeFailedSubscribedTask(URL url, NotifyListener listener)

    • removeFailedUnsubscribedTask

      public void removeFailedUnsubscribedTask(URL url, NotifyListener listener)

    • removeFailedSubscribed

      public void removeFailedSubscribed(URL url, NotifyListener listener)

    • register

      public void register(URL url)
      Description copied from interface: RegistryService
      Register data, such as : provider service, consumer address, route rule, override rule and other data.

      Registering is required to support the contract:
      1. When the URL sets the check=false parameter. When the registration fails, the exception is not thrown and retried in the background. Otherwise, the exception will be thrown.
      2. When URL sets the dynamic=false parameter, it needs to be stored persistently, otherwise, it should be deleted automatically when the registrant has an abnormal exit.
      3. When the URL sets category=routers, it means classified storage, the default category is providers, and the data can be notified by the classified section.
      4. When the registry is restarted, network jitter, data can not be lost, including automatically deleting data from the broken line.
      5. Allow URLs which have the same URL but different parameters to coexist,they can't cover each other.

      Specified by:
      register in interface RegistryService
      Overrides:
      register in class AbstractRegistry
      Parameters:
      url - Registration information , is not allowed to be empty, e.g: dubbo://10.20.153.10/org.apache.dubbo.foo.BarService?version=1.0.0invalid input: '&application'=kylin

    • reExportRegister

      public void reExportRegister(URL url)

    • unregister

      public void unregister(URL url)
      Description copied from interface: RegistryService
      Unregister

      Unregistering is required to support the contract:
      1. If it is the persistent stored data of dynamic=false, the registration data can not be found, then the IllegalStateException is thrown, otherwise it is ignored.
      2. Unregister according to the full url match.

      Specified by:
      unregister in interface RegistryService
      Overrides:
      unregister in class AbstractRegistry
      Parameters:
      url - Registration information , is not allowed to be empty, e.g: dubbo://10.20.153.10/org.apache.dubbo.foo.BarService?version=1.0.0invalid input: '&application'=kylin

    • reExportUnregister

      public void reExportUnregister(URL url)

    • subscribe

      public void subscribe(URL url, NotifyListener listener)
      Description copied from interface: RegistryService
      Subscribe to eligible registered data and automatically push when the registered data is changed.

      Subscribing need to support contracts:
      1. When the URL sets the check=false parameter. When the registration fails, the exception is not thrown and retried in the background.
      2. When URL sets category=routers, it only notifies the specified classification data. Multiple classifications are separated by commas, and allows asterisk to match, which indicates that all categorical data are subscribed.
      3. Allow interface, group, version, and classifier as a conditional query, e.g.: interface=org.apache.dubbo.foo.BarServiceinvalid input: '&version'=1.0.0
      4. And the query conditions allow the asterisk to be matched, subscribe to all versions of all the packets of all interfaces, e.g. :interface=*invalid input: '&group'=*invalid input: '&version'=*invalid input: '&classifier'=*
      5. When the registry is restarted and network jitter, it is necessary to automatically restore the subscription request.
      6. Allow URLs which have the same URL but different parameters to coexist,they can't cover each other.
      7. The subscription process must be blocked, when the first notice is finished and then returned.

      Specified by:
      subscribe in interface RegistryService
      Overrides:
      subscribe in class AbstractRegistry
      Parameters:
      url - Subscription condition, not allowed to be empty, e.g. consumer://10.20.153.10/org.apache.dubbo.foo.BarService?version=1.0.0invalid input: '&application'=kylin
      listener - A listener of the change event, not allowed to be empty

    • unsubscribe

      public void unsubscribe(URL url, NotifyListener listener)
      Description copied from interface: RegistryService
      Unsubscribe

      Unsubscribing is required to support the contract:
      1. If you don't subscribe, ignore it directly.
      2. Unsubscribe by full URL match.

      Specified by:
      unsubscribe in interface RegistryService
      Overrides:
      unsubscribe in class AbstractRegistry
      Parameters:
      url - Subscription condition, not allowed to be empty, e.g. consumer://10.20.153.10/org.apache.dubbo.foo.BarService?version=1.0.0invalid input: '&application'=kylin
      listener - A listener of the change event, not allowed to be empty

    • destroy

      public void destroy()
      Specified by:
      destroy in interface Node
      Overrides:
      destroy in class AbstractRegistry

    • doRegister

      public abstract void doRegister(URL url)

    • doUnregister

      public abstract void doUnregister(URL url)

    • doSubscribe

      public abstract void doSubscribe(URL url, NotifyListener listener)

    • doUnsubscribe

      public abstract void doUnsubscribe(URL url, NotifyListener listener)