com.orderlysoftware.orderlycalls.asterisk.manager.event
Interface ManagerEventListener

All Superinterfaces:
java.util.EventListener
All Known Implementing Classes:
ExampleManagerEventListener

public interface ManagerEventListener
extends java.util.EventListener

NOTE TO APPLICATION DEVELOPERS:

You can develop proprietary applications by creating your own classes that implement this interface. Put the business logic in these classes.

These classes remain your property, and do not need to be disclosed to us, or released as open source.

On the other hand, if you find you need to modify any of the other classes in this distribution, please do let us know.

We're also always very happy to hear how people are using this software, so please do consider telling us (confidentially) so we can stick a pin in our map - you'll make our day!

You MAY pool ManagerEventlisteners using ObjectPool for later reuse.

You MAY use a single ManagerEventListener object to listen for events from multiple ManagerClients.
You can determine WHICH ManagerClient received the event by calling getClient() on the passed ManagerEvent object.

You SHOULD ensure that your ManagerEventListener is thread safe - that is, you must take care when accessing any member fields you define. You can ensure thread safety by making the handleEvent method synchronized. This is not necessary if your ManagerEventListener does not use member fields.

Author:
Matt King, M.A. Oxon.

Method Summary
 void handleManagerEvent(ManagerEvent e)
          Implement this method to handle incoming events.
 

Method Detail

handleManagerEvent

void handleManagerEvent(ManagerEvent e)
Implement this method to handle incoming events.

Each event triggers calls to each listener in a separate thread, so it's safe to call blocking functions in the event listener.

These threads are re-used for performance.

Parameters:
e - the ManagerEvent received.