Support for SIP (Work in Progress)

Events distributed by telephony operation sets.

src/net/java/sip/communicator/service/protocol/event/CallEvent.java

@@ -0,0 +1,82 @@
+/*
+ * SIP Communicator, the OpenSource Java VoIP and Instant Messaging client.
+ *
+ * Distributable under LGPL license.
+ * See terms of license at gnu.org.
+ */
+
+package net.java.sip.communicator.service.protocol.event;
+
+import java.util.*;
+
+import net.java.sip.communicator.service.protocol.*;
+
+/**
+ * An event class representing that an incoming or an outgoing call has been
+ * created. The event id indicates the exact reason for this event.
+ *
+ * @author Emil Ivov
+ */
+public class CallEvent
+    extends EventObject
+{
+    /**
+     * An event id value indicating that this event has been triggerred as a
+     * result of an outgoing call.
+     */
+    public static final int CALL_INITIATED = 1;
+
+    /**
+     * An event id value indicating that this event has been triggerred as a
+     * result of an incoming call.
+     */
+    public static final int CALL_RECEIVED  = 2;
+
+    /**
+     * An event id value indicating that this event has been triggerred as a
+     * result of a call being ended (all its participants have left).
+     */
+    public static final int CALL_ENDED  = 3;
+
+
+    /**
+     * Determines whether this event has been fired to indicate an incoming or
+     * an outgoing call.
+     */
+    private int eventID;
+
+    /**
+     * Creates an event instance indicating that an incoming/outgoing call
+     * has been created
+     *
+     * @param call the call that triggerred this event.
+     * @param eventID determines whether this is an incoming or an outgoing
+     * call.
+     */
+    public CallEvent(Call call, int eventID)
+    {
+        super(call);
+        this.eventID = eventID;
+    }
+
+    /**
+     * Returns the <tt>Call</tt> that trigerred this event.
+     *
+     * @return the <tt>Call</tt> that trigerred this event.
+     */
+    public Call getSourceCall()
+    {
+        return (Call)getSource();
+    }
+
+    /**
+     * Returns an event ID int indicating whether this event was triggerred by
+     * an outgoing or an incoming call.
+     *
+     * @return on of the CALL_XXX static member ints.
+     */
+    public int getEventID()
+    {
+        return this.eventID;
+    }
+}