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:

ServiceDiscoveryRegistry

public abstract class FailbackRegistry
extends AbstractRegistry

FailbackRegistry. (SPI, Prototype, ThreadSafe)

Constructor Summary

Constructors

Constructor and Description
FailbackRegistry(URL url)

Method Summary

Modifier and Type	Method and Description
void	destroy()
abstract void	doRegister(URL url)
abstract void	doSubscribe(URL url, NotifyListener listener)
abstract void	doUnregister(URL url)
abstract void	doUnsubscribe(URL url, NotifyListener listener)
void	register(URL url) Register data, such as : provider service, consumer address, route rule, override rule and other data.
void	removeFailedNotifiedTask(URL url, NotifyListener listener)
void	removeFailedRegisteredTask(URL url)
void	removeFailedSubscribedTask(URL url, NotifyListener listener)
void	removeFailedUnregisteredTask(URL url)
void	removeFailedUnsubscribedTask(URL url, NotifyListener listener)
void	subscribe(URL url, NotifyListener listener) Subscribe to eligible registered data and automatically push when the registered data is changed.
void	unregister(URL url) Unregister
void	unsubscribe(URL url, NotifyListener listener) Unsubscribe

Methods inherited from class org.apache.dubbo.registry.support.AbstractRegistry

doSaveProperties, getCacheFile, getCacheProperties, getCacheUrls, getLastCacheChanged, getNotified, getRegistered, getSubscribed, getUrl, lookup, toString

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.apache.dubbo.common.Node

isAvailable

Constructor Detail

FailbackRegistry

public FailbackRegistry(URL url)

Method Detail

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)

removeFailedNotifiedTask

public void removeFailedNotifiedTask(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.0&application=kylin

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.0&application=kylin

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.BarService&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=*&group=*&version=*&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.0&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 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.0&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)