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
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
|
/*
* Jitsi, 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.*;
/**
* Dispatched to notify interested parties that a change in our presence in
* the source chat room has occured. Changes may include us being kicked, join,
* left, etc.
*
* @author Emil Ivov
* @author Stephane Remy
*/
public class LocalUserChatRoomPresenceChangeEvent
extends EventObject
{
/**
* Serial version UID.
*/
private static final long serialVersionUID = 0L;
/**
* Indicates that this event was triggered as a result of the local
* participant joining a chat room.
*/
public static final String LOCAL_USER_JOINED = "LocalUserJoined";
/**
* Indicates that this event was triggered as a result of the local
* participant failed to join a chat room.
*/
public static final String LOCAL_USER_JOIN_FAILED = "LocalUserJoinFailed";
/**
* Indicates that this event was triggered as a result of the local
* participant leaving a chat room.
*/
public static final String LOCAL_USER_LEFT = "LocalUserLeft";
/**
* Indicates that this event was triggered as a result of the local
* participant being kicked from a chat room.
*/
public static final String LOCAL_USER_KICKED = "LocalUserKicked";
/**
* Indicates that this event was triggered as a result of the local
* participant beeing disconnected from the server brutally, or ping timeout.
*/
public static final String LOCAL_USER_DROPPED = "LocalUserDropped";
/**
* The <tt>ChatRoom</tt> to which the change is related.
*/
private ChatRoom chatRoom = null;
/**
* The type of this event.
*/
private String eventType = null;
/**
* An optional String indicating a possible reason as to why the event
* might have occurred.
*/
private String reason = null;
/**
* An optional String indicating new address for the room, normally
* send when room is destroyed.
*/
private String alternateAddress = null;
/**
* Creates a <tt>ChatRoomLocalUserPresenceChangeEvent</tt> representing that
* a change in local participant presence in the source chat room has
* occured.
*
* @param source the <tt>OperationSetMultiUserChat</tt>, which produced this
* event
* @param chatRoom the <tt>ChatRoom</tt> that this event is about
* @param eventType the type of this event.
* @param reason the reason explaining why this event might have occurred
*/
public LocalUserChatRoomPresenceChangeEvent(OperationSetMultiUserChat source,
ChatRoom chatRoom,
String eventType,
String reason)
{
this(source, chatRoom, eventType, reason, null);
}
/**
* Creates a <tt>ChatRoomLocalUserPresenceChangeEvent</tt> representing that
* a change in local participant presence in the source chat room has
* occured.
*
* @param source the <tt>OperationSetMultiUserChat</tt>, which produced this
* event
* @param chatRoom the <tt>ChatRoom</tt> that this event is about
* @param eventType the type of this event.
* @param reason the reason explaining why this event might have occurred
*/
public LocalUserChatRoomPresenceChangeEvent(OperationSetMultiUserChat source,
ChatRoom chatRoom,
String eventType,
String reason,
String alternateAddress)
{
super(source);
this.chatRoom = chatRoom;
this.eventType = eventType;
this.reason = reason;
this.alternateAddress = alternateAddress;
}
/**
* Returns the <tt>OperationSetMultiUserChat</tt>, where this event has
* occurred.
*
* @return the <tt>OperationSetMultiUserChat</tt>, where this event has
* occurred
*/
public OperationSetMultiUserChat getMultiUserChatOpSet()
{
return (OperationSetMultiUserChat) getSource();
}
/**
* Returns the <tt>ChatRoom</tt>, that this event is about.
*
* @return the <tt>ChatRoom</tt>, that this event is about
*/
public ChatRoom getChatRoom()
{
return this.chatRoom;
}
/**
* A reason string indicating a human readable reason for this event.
*
* @return a human readable String containing the reason for this event,
* or null if no particular reason was specified
*/
public String getReason()
{
return reason;
}
/**
* Returns the type of this event which could be one of the LOCAL_USER_XXX
* member fields.
*
* @return one of the LOCAL_USER_XXX fields indicating the type of this event.
*/
public String getEventType()
{
return eventType;
}
/**
* An optional String indicating new address for the room, normally
* send when room is destroyed.
* @return alternate address for the destroyed room.
*/
public String getAlternateAddress()
{
return alternateAddress;
}
/**
* Returns a String representation of this event.
*
* @return String representation of this event
*/
@Override
public String toString()
{
return "ChatRoomLocalUserPresenceChangeEvent[type="
+ getEventType()
+ " sourceRoom="
+ getChatRoom()
+ "]";
}
}
|
