aboutsummaryrefslogtreecommitdiffstats
path: root/src/net/java/sip/communicator/service/protocol/event/CallParticipantAdapter.java
blob: e61197e930b68d7aa2c0b0493407d3217e784814 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
/*
 * 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;

/**
 * An abstract adapter class for receiving call participant (change) events.
 * This class exists only as a convenience for creating listener objects.
 * <p>
 * Extend this class to create a <tt>CallParticipantChangeEvent</tt> listener
 * and override the methods for the events of interest. (If you implement the
 * <tt>CallParticipantListener</tt> interface, you have to define all of the
 * methods in it. This abstract class defines null methods for them all, so you
 * only have to define methods for events you care about.)
 * </p>
 *
 * @see CallParticipantChangeEvent
 * @see CallParticipantListener
 *
 * @author Lubomir Marinov
 */
public abstract class CallParticipantAdapter
    implements CallParticipantListener
{

    /**
     * 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 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 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)
    {
    }

    /**
     * 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 transport address that we use
     * to communicate with the participant.
     * 
     * @param evt The <tt>CallParticipantChangeEvent</tt> instance containing
     *            the source event as well as its previous and its new transport
     *            address.
     */
    public void participantTransportAddressChanged(
        CallParticipantChangeEvent evt)
    {
    }
}