/**
* Remove this particular regex/subscriber pair (UNTESTED AND API MAY CHANGE). If regex is null,
* all subscriptions for 'sub' are cancelled. If subscriber is null, any previous subscriptions
* matching the regular expression will be cancelled. If both 'sub' and 'regex' are null, all
* subscriptions will be cancelled.
*/
public void unsubscribe(String regex, ZCMSubscriber sub) {
if (this.closed) throw new IllegalStateException();
synchronized (this) {
for (Provider p : providers) p.unsubscribe(regex);
}
// TODO: providers don't seem to use anything beyond first channel
synchronized (subscriptions) {
// Find and remove subscriber from list
for (Iterator<SubscriptionRecord> it = subscriptions.iterator(); it.hasNext(); ) {
SubscriptionRecord sr = it.next();
if ((sub == null || sr.lcsub == sub) && (regex == null || sr.regex.equals(regex))) {
it.remove();
}
}
// Find and remove subscriber from map
for (String channel : subscriptionsMap.keySet()) {
for (Iterator<SubscriptionRecord> it = subscriptionsMap.get(channel).iterator();
it.hasNext(); ) {
SubscriptionRecord sr = it.next();
if ((sub == null || sr.lcsub == sub) && (regex == null || sr.regex.equals(regex))) {
it.remove();
}
}
}
}
}
/**
* Call this function to release all resources used by the ZCM instance. After calling this
* function, the ZCM instance should consume no resources, and cannot be used to receive or
* transmit messages.
*/
public synchronized void close() {
if (this.closed) throw new IllegalStateException();
for (Provider p : providers) {
p.close();
}
providers = null;
this.closed = true;
}