org.asteriskjava.manager

Class ManagerEventListenerProxy

java.lang.Object

org.asteriskjava.manager.ManagerEventListenerProxy

All Implemented Interfaces:

EventListener, ManagerEventListener

public class ManagerEventListenerProxy
extends Object
implements ManagerEventListener

Proxies a ManagerEventListener and dispatches events asynchronously by using a single threaded executor.

Use this proxy to prevent the reader thread from being blocked while your application processes ManagerEvents. If you want to use the ManagerConnection for sending actions in your ManagerEventListener using a proxy like this one is mandatory; otherwise you will always run into a timeout because the reader thread that is supposed to read the response to your action is still blocked processing the event.

If in doubt use the proxy as it won't hurt.

Example:

 ManagerConnection connection;
 ManagerEventListener myListener;
 ...
 connection.addEventListener(new ManagerEventListenerProxy(myListener));
 

Since:

0.3

Author:

srt, fink

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ManagerEventListenerProxy.Access

Constructor Summary

Constructors

Constructor and Description
ManagerEventListenerProxy(ManagerEventListener target) Creates a new ManagerEventListenerProxy that notifies the given target asynchronously when new events are received.

Method Summary

Modifier and Type	Method and Description
void	onManagerEvent(ManagerEvent event) This method is called when an event is received.
void	shutdown()

Methods inherited from class java.lang.Object

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

Constructor Detail

ManagerEventListenerProxy

public ManagerEventListenerProxy(ManagerEventListener target)

Creates a new ManagerEventListenerProxy that notifies the given target asynchronously when new events are received.

Parameters:

target - the target listener to invoke.

See Also:

Executors.newSingleThreadExecutor(ThreadFactory)

Method Detail

onManagerEvent

public void onManagerEvent(ManagerEvent event)

Description copied from interface: ManagerEventListener

This method is called when an event is received.

Specified by:

onManagerEvent in interface ManagerEventListener

Parameters:

event - the event that has been received

shutdown

public void shutdown()