de.ipcon.db.event

Class DBManEventSubscriptionManager

java.lang.Object

de.ipcon.db.event.DBManEventSubscriptionManager

Direct Known Subclasses:

DBManEventDemuxer

public class DBManEventSubscriptionManager
extends java.lang.Object

Manages a collection of DBManEventListeners along with their associated DBManEventFilters. The DBManEventSubscriptionManager class is responsible for handling and organizing DBManEventListeners in conjunction with their corresponding DBManEventFilters. It provides methods to add, remove, and manipulate subscriptions, making it a central component for managing event subscriptions within the MyTISM database management system.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	DBManEventSubscriptionManager.SubscriptionContainer

Constructor Summary

Constructors

Constructor and Description
DBManEventSubscriptionManager()

Method Summary

Modifier and Type	Method and Description
static DBManEventProviderI	findNextDBManEventProvider(BOLoaderI bol) Finds and returns the first DBManEventProviderI instance along the loader chain starting from the specified BOLoader or null if none is found.
DBManEventSubscriptionManager.SubscriptionContainer	getSubscriptions()
boolean	hasDeceasedListeners()
DBManEventSubscription	subscribeEvents(DBManEventListenerI listener, DBManEventFilter filter) Subscribes a listener/filter pair to the event subscriber list and returns the resulting DBManEventSubscription instance.
DBManEventSubscription[]	unsubscribeEvents(DBManEventListenerI listener)
DBManEventSubscription[]	unsubscribeEvents(DBManEventListenerI listener, DBManEventFilter filter)

Methods inherited from class java.lang.Object

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

Constructor Detail

DBManEventSubscriptionManager

public DBManEventSubscriptionManager()

Method Detail

subscribeEvents

public DBManEventSubscription subscribeEvents(DBManEventListenerI listener,
                                              DBManEventFilter filter)

Subscribes a listener/filter pair to the event subscriber list and returns the resulting DBManEventSubscription instance. This method allows you to register an event listener and an optional event filter to receive notifications of specific events within the database management system.

Parameters:

listener - The DBManEventListener instance to be added to the subscriber list.

filter - An optional DBManEventFilter instance used to filter events before notifying the listener. If null, all events will be passed to the listener.

Returns:

A DBManEventSubscription instance representing the subscription of the listener/filter pair. You can use this subscription to retrieve the listener or test if an event fits.

See Also:

DBManEventListenerI, DBManEventFilter, DBManEventSubscription

unsubscribeEvents

public DBManEventSubscription[] unsubscribeEvents(DBManEventListenerI listener)

unsubscribeEvents

public DBManEventSubscription[] unsubscribeEvents(DBManEventListenerI listener,
                                                  DBManEventFilter filter)

getSubscriptions

public DBManEventSubscriptionManager.SubscriptionContainer getSubscriptions()

hasDeceasedListeners

public boolean hasDeceasedListeners()

findNextDBManEventProvider

public static DBManEventProviderI findNextDBManEventProvider(BOLoaderI bol)

Finds and returns the first DBManEventProviderI instance along the loader chain starting from the specified BOLoader or null if none is found. This method traverses the loader chain to locate the first instance of DBManEventProviderI.

Parameters:

bol - The BOLoaderI from which the search for DBManEventProviderI begins.

Returns:

The first DBManEventProviderI instance found along the loader chain, or null if none is found.

See Also:

BOLoaderI, DBManEventProviderI