/protocols/jain-megaco/megaco-api/src/main/java/javax/megaco/MegacoListener.java

 1package javax.megaco;
 2
 3import java.util.EventListener;
 4
 5/**
 6 * This interface defines the methods that must be implemented by any MEGACO
 7 * user application to receive and process JAIN MEGACO Events emitted by an
 8 * object that implements the MegacoProvider interface. Separate methods for
 9 * handling JAIN MEGACO Command Event Objects and JAIN MEGACO Association Event
10 * Objects are specified. An instance of a class that implements this interface
11 * must register with an instance of a class that implements the MegacoProvider
12 * interface to receive these Event Objects.
13 * 
14 * 
15 * 
16 */
17public interface MegacoListener extends EventListener {
18
19	/**
20	 * Processes a MEGACO Command event received from a MegacoProvider. Command
21	 * level event occurs when the MEGACO stack receives a command from the
22	 * peer. The stack after parsing the command parameters passes the command
23	 * to the application through this listener interface.
24	 * 
25	 * @param cmdEvent
26	 *            The JAIN MEGACO Command Event Object that is to be processed.
27	 */
28	public void processMegacoEvent(CommandEvent cmdEvent);
29
30	/**
31	 * Processes a MEGACO Association Event received from a MegacoProvider.
32	 * Association level event occurs whenever stack wants to send the response
33	 * of a request from the listener application or when the stack wants to
34	 * give indication of the change in the state of the association at the
35	 * stack.
36	 * 
37	 * 
38	 * @param assocEvent
39	 *            The JAIN MEGACO Association Event Object that is to be
40	 *            processed.
41	 */
42	public void processMegacoEvent(AssociationEvent assocEvent);
43}