|
ABLE, Version 1.1b | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object | +--com.ibm.able.platform.agents.PlatformAgentProxyEventHandler
This class defines a listener and processor of remote events. An instance of this object can serve as a proxy between a remote generator of events and some other event listener/processor object that can't or doesn't want to make itself visible across a remote interface.
This object simply receives all remote events and immediately forwards them on to the specified (presumably local and ultimate) listener/processor object.
Constructor Summary | |
PlatformAgentProxyEventHandler(java.lang.Object theSpecifiedHandler)
Create a new event handler. |
Method Summary | |
static java.lang.String |
Copyright()
Determine the copyright of this class. |
com.ibm.logging.Logger |
getLogger()
Retrieve a logger object from the event queue's container. |
void |
handleAbleEvent(AbleEvent theAbleEvent)
Handle an Able event. |
void |
processAbleEvent(AbleEvent theAbleEvent)
Process an Able event synchronously; that is, on the same thread as the caller. |
void |
processNoEventProcessingEnabledSituation()
Process the situation where neither timer nor Able event processing is enabled in the event queue, but the event queue's asynchronous thread of control has been started. |
void |
processTimerEvent()
Process a timer expiration event synchronously; that is, on the same thread as the caller. |
void |
setState(int theState)
Set the state of the event queue's container. |
Methods inherited from class java.lang.Object |
clone,
equals,
finalize,
getClass,
hashCode,
notify,
notifyAll,
toString,
wait,
wait,
wait |
Constructor Detail |
public PlatformAgentProxyEventHandler(java.lang.Object theSpecifiedHandler) throws java.rmi.RemoteException
theSpecifiedHandler
- Any object that wants to listen for or process
events. Any events caught by this listener are
forwarded to the specified handler, which must
implement both the AbleEventListener and
AbleEventProcessor interfaces.
Method Detail |
public void handleAbleEvent(AbleEvent theAbleEvent) throws java.rmi.RemoteException
This method should be called by all Able event source objects in order to hand off an event to the object implementing this interface. Most implementations will check to see if the event should be processed synchronously (on the same thread as the caller) or asynchronously (on a separate thread).
In this implementation, the event is simply forwarded on to another Able event listener.
theAbleEvent
- The event to handle.
public void processAbleEvent(AbleEvent theAbleEvent) throws java.rmi.RemoteException
This method is called by an AbleEventQueue when the queue
gets around to processing an asynchronous event. Note
that this method also can be called directly from the
handleAbleEvent() method described in the AbleEventListener
interface when that method is given a synchronous event to
handle.
theAbleEvent
- The event to process.
public void processTimerEvent() throws java.rmi.RemoteException
This method is called by an AbleEventQueue when the queue's sleep timer goes off.
public void processNoEventProcessingEnabledSituation() throws java.rmi.RemoteException
This method is called by an AbleEventQueue when the queue is neither enabled for timer processing nor Able event processing. When neither type of processing is enabled, the queue is in a tight processing loop, consuming CPU cycles. This method is called so that the event queue's container can do something about the situation or perform some other type of asynchronous processing.
public void setState(int theState) throws java.rmi.RemoteException
This method is called by an AbleEventQueue when the queue's run time loop changes state; for example, from Waiting to Active.
theState
- An AbleState.public com.ibm.logging.Logger getLogger() throws java.rmi.RemoteException
public static java.lang.String Copyright()
|
ABLE, Version 1.1b | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |