Support for SIP (Work in Progress)

filled the prebiously dummy body with meaningful content

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

@@ -9,11 +9,32 @@
 import java.util.*;
 
 /**
- * Allows notification for new call participants, theme changes and
- * other call state events.
+ * A call change listener receives events indicating that a call has changed and
+ * a participant has either left or joined.
+ *
  * @author Emil Ivov
  */
-public class CallChangeListener
-    implements EventListener
+public interface CallChangeListener
+    extends EventListener
 {
+    /**
+     * Indicates that a new call participant has joined the source call.
+     * @param evt the <tt>CallParticipantEvent</tt> containing the source call
+     * and call participant.
+     */
+    public void callParticipantAdded(CallParticipantEvent evt);
+
+    /**
+     * Indicates that a call participant has left the source call.
+     * @param evt the <tt>CallParticipantEvent</tt> containing the source call
+     * and call participant.
+     */
+    public void callParticipantRemoved(CallParticipantEvent evt);
+
+    /**
+     * Indicates that a change has occurred in the state of the source call.
+     * @param evt the <tt>CallChangeEvent</tt> instance containing the source
+     * calls and its old and new state.
+     */
+    public void callStateChanged(CallChangeEvent evt);
 }

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

@@ -10,10 +10,50 @@
 
 
 /**
+ * Receives events notifying of changes that have occurred within a
+ * <tt>CallParticipant</tt>. Such changes may pertain to current call
+ * participant state, their display name, address, image and (possibly in the
+ * future) others.
+ *
  * @author Emil Ivov
  */
 public interface CallParticipantListener
     extends EventListener
 {
-    public void participantChange(CallParticipantChangeEvent evt);
+
+    /**
+     * Indicates that a change has occurred in the status of the source
+     * CallParticipant.
+     *
+     * @param evt The <tt>CallParticipantChangeEvent</tt> instance containing
+     * the source event as well as its previous and its new status.
+     */
+    public void participantStateChanged(CallParticipantChangeEvent evt);
+
+    /**
+     * Indicates that a change has occurred in the display name of the source
+     * CallParticipant.
+     *
+     * @param evt The <tt>CallParticipantChangeEvent</tt> instance containing
+     * the source event as well as its previous and its new display names.
+     */
+    public void participantDisplayNameChanged(CallParticipantChangeEvent evt);
+
+    /**
+     * Indicates that a change has occurred in the address of the source
+     * CallParticipant.
+     *
+     * @param evt The <tt>CallParticipantChangeEvent</tt> instance containing
+     * the source event as well as its previous and its new address.
+     */
+    public void participantAddressChanged(CallParticipantChangeEvent evt);
+
+    /**
+     * Indicates that a change has occurred in the image of the source
+     * CallParticipant.
+     *
+     * @param evt The <tt>CallParticipantChangeEvent</tt> instance containing
+     * the source event as well as its previous and its new image.
+     */
+    public void participantImageChanged(CallParticipantChangeEvent evt);
 }