com.taobao.config.client

接口 Subscriber

所有已知实现类:

DefaultSubscriber

public interface Subscriber

订阅者凭证

订阅者须通过此凭证获取数据

从以下版本开始:

1.2

作者:

wufeng

方法概要

限定符和类型	方法和说明
void	addExcListener(ExcListener listener)
String	getClientId()
String	getDataId()
SubscriberDataObserver	getDataObserver() 已过时。
SubscriberRegistration	getRegistration() 获取最初申请时填写的《订阅者登记表》
Subscription	getSubscription() 建立一份订阅，用于等待并获取订阅的数据。
List<Object>	peekData() 尝试获取订阅的数据。
void	setDataObserver(SubscriberDataObserver observer) 指定当前订阅者的数据观察员，它将在数据发布时得到通知。

方法详细资料

getSubscription

Subscription getSubscription()

建立一份订阅，用于等待并获取订阅的数据。（Future方式，推荐使用）

同一个订阅者可以建立多份订阅，每一份订阅均可独立的等待并获取数据。

返回:

Subscription 新建立的订阅

另请参阅:

Subscription

setDataObserver

void setDataObserver(SubscriberDataObserver observer)

指定当前订阅者的数据观察员，它将在数据发布时得到通知。（回调方式）

每一个订阅者只能指定一个数据观察员。如果希望有多个数据观察员，推荐使用更为灵活的Future方式。

另请参阅:

SubscriberDataObserver

getDataObserver

@Deprecated
SubscriberDataObserver getDataObserver()

已过时。

获取当前订阅者的数据观察员。

返回:

当前订阅者的数据观察员，null表示当前没有数据观察员。

另请参阅:

SubscriberDataObserver

peekData

List<Object> peekData()

尝试获取订阅的数据。（非阻塞）

不保证能得到数据（可能由于缺少发布者、网络通信不畅或者服务器离线），推荐使用异步的Future或回调方式。

注意：永远不要直接修改，或保存并在将来可能修改返回的List中的对象，这将影响到所有该数据的订阅者。 建议发布者只发布不可修改（Immutable）的数据类型，如String。

返回:

订阅的数据清单，如果数据尚不可用，则返回null。注意：这个清单是不可修改的（Immutable）

getRegistration

SubscriberRegistration getRegistration()

获取最初申请时填写的《订阅者登记表》

返回:

《订阅者登记表》

addExcListener

void addExcListener(ExcListener listener)

getDataId

String getDataId()

getClientId

String getClientId()