jain.jcc
Interface EventFilter


public interface EventFilter

An instance of this EventFilter is supplied to the event source in the addxxxListener() method by the EventListener to indicate what Events are required by the EventListener. When an Event occurs, the event source will call the predicate getEventDisposition(Event) to determine if the Event should be fired to the EventListener. Given an event, getEventDisposition() returns

  1. EVENT_DISCARD if the listener is not interested in receiving the event.
  2. EVENT_NOTIFY if the listener should be sent a non-blocking notification.
  3. EVENT_BLOCK if the listener should be sent a blocking event (trigger). This return value applies to JccConnectionEvents only.
The EventFilter while providing flexibility will impact the performance of the platform. Hence, the JCC implementation is expected to provide for some standard EventFilters as explained in the JccProvider interface.


Field Summary
static int EVENT_BLOCK
          Predicate return constant: Indicates that the specified event is required and is a blocking Event, that is, call processing will be suspended until the continueProcessing() or any other valid method is called.
static int EVENT_DISCARD
          Predicate return constant: Indicates that the specified event is not required.
static int EVENT_NOTIFY
          Predicate return constant: Indicates that the specified event is required and is a non-blocking Event (notification only), that is, call processing will not be suspended.
 
Method Summary
 int getEventDisposition(Event event)
          This predicate indicates whether the specified Event is required by an EventListener.
 

Field Detail

EVENT_DISCARD

public static final int EVENT_DISCARD
Predicate return constant: Indicates that the specified event is not required. This is one of the possible return values of getEventDisposition()

EVENT_NOTIFY

public static final int EVENT_NOTIFY
Predicate return constant: Indicates that the specified event is required and is a non-blocking Event (notification only), that is, call processing will not be suspended. This is one of the possible return values of getEventDisposition()

EVENT_BLOCK

public static final int EVENT_BLOCK
Predicate return constant: Indicates that the specified event is required and is a blocking Event, that is, call processing will be suspended until the continueProcessing() or any other valid method is called. This is one of the possible return values of getEventDisposition()
Method Detail

getEventDisposition

public int getEventDisposition(Event event)
This predicate indicates whether the specified Event is required by an EventListener. This method will be called by the Event source prior to firing the event.
Parameters:
event - specifies the event.


3 Oct 2000
If you have any comments or queries, please mail them to jcc@research.telcordia.com


Copyright-2000 Sun Microsystems