com.ibm.websphere.management.dynamicproxy
Interface EventHandler


public interface EventHandler

DynamicProxy MBean event aggregation handler interface. Implementation of this interface can be specified in MBeanDescriptor's MBean xml tag's attribute called "eventHandlerClass."

example MBeanDescriptor header & initial MBean tag:

 <?xml version="1.0" encoding="UTF-8"?> 
 <!DOCTYPE MBean SYSTEM "MbeanDescriptor.dtd"> 
 < MBean type="SampleStateMBean" 
  collaboratorClass="com.ibm.ws390.scaffold.SampleStateMBeanProxy" 
  aggregationHandlerClass="com.ibm.ws390.scaffold.SampleStateAggregationHandler" 
  eventHandlerClass="com.ibm.ws390.scaffold.SampleStateEventHandler" 
  invocationHandlerClass="com.ibm.ws390.scaffold.SampleStateInvocationHandler" 
  stateObjectClass="com.ibm.ws390.scaffold.SampleState" 
  version="5.0" 
  platform="dynamicproxy" 
  description="Sample state MBean."> 
 : 
 : 
 

This interface defines the method that must be implemented by MBean provider who wants to handle event aggregation in dynamicproxy enabled MBean for WebSphere for z/OS. Implementation of this interface should be able to properly handle all incoming servant MBeans' events & aggregate them to filter out duplicate events from multiple SR MBeans and send only ONE event back to the listener of this dynamicproxy MBean. Also implementation of this class should be able to properly adjust the current dynamicproxy MBean's state accordingly to MBean provider's requirements.


Method Summary
 boolean handleServantNotification(StateObject stateObject, javax.management.Notification notification)
          Handles a Notification that was generated by a servant MBean & properly aggregates/compiles them using the current state.
 

Method Detail

handleServantNotification

public boolean handleServantNotification(StateObject stateObject,
                                         javax.management.Notification notification)
Handles a Notification that was generated by a servant MBean & properly aggregates/compiles them using the current state. IF the state of dynamicproxy MBean's is required to be updated, then directly update the stateObject passed in. Also determine whether the input notification should be sent back to the listeners of dynamicproxy MBean or whether it should be discarded/filtered out in order to avoid duplicate notifications being sent to the listeners.

Parameters:
stateObject - MBean provider provided StateObject used by dynamicproxy MBean in CR to manage its state. Note: this object MAY BE null if "stateObjectClass" was not specified OR internal error occurred during initialization of this dynamicproxy MBean. Implmentation MUST properly handle "null" input.
notification - Notification that was emitted by a servant MBean.
Returns:
boolean should an input servantNotification be sent to the listeners given the current dynamicproxy's state & the input Notification content?