true if this chat room is a system room and
+ * false otherwise.
+ *
+ * @return true if this chat room is a system room and
+ * false otherwise.
+ */
public boolean isSystem()
{
return false;
@@ -592,4 +640,117 @@ public boolean isPersistent()
{
return true;
}
+
+ /**
+ * Grants admin role to the participant given by address.
+ * @param address the address of the participant to grant admin role to
+ */
+ public void grantAdmin(String address)
+ {
+ throw new UnsupportedOperationException("Not supported yet.");
+ }
+
+ /**
+ * Grants membership role to the participant given by address.
+ * @param address the address of the participant to grant membership role to
+ */
+ public void grantMembership(String address)
+ {
+ throw new UnsupportedOperationException("Not supported yet.");
+ }
+
+ /**
+ * Grants moderator role to the participant given by address.
+ * @param address the address of the participant to grant moderator role to
+ */
+ public void grantModerator(String address)
+ {
+ throw new UnsupportedOperationException("Not supported yet.");
+ }
+
+ /**
+ * Grants ownership role to the participant given by address.
+ * @param address the address of the participant to grant ownership role to
+ */
+ public void grantOwnership(String address)
+ {
+ throw new UnsupportedOperationException("Not supported yet.");
+ }
+
+ /**
+ * Grants voice to the participant given by address.
+ * @param address the address of the participant to grant voice to
+ */
+ public void grantVoice(String address)
+ {
+ throw new UnsupportedOperationException("Not supported yet.");
+ }
+
+ /**
+ * Revokes the admin role for the participant given by address.
+ * @param address the address of the participant to revoke admin role for
+ */
+ public void revokeAdmin(String address)
+ {
+ throw new UnsupportedOperationException("Not supported yet.");
+ }
+
+ /**
+ * Revokes the membership role for the participant given by address.
+ * @param address the address of the participant to revoke membership role
+ * for
+ */
+ public void revokeMembership(String address)
+ {
+ throw new UnsupportedOperationException("Not supported yet.");
+ }
+
+ /**
+ * Revokes the moderator role for the participant given by address.
+ * @param address the address of the participant to revoke moderator role
+ * for
+ */
+ public void revokeModerator(String address)
+ {
+ throw new UnsupportedOperationException("Not supported yet.");
+ }
+
+ /**
+ * Revokes the ownership role for the participant given by address.
+ * @param address the address of the participant to revoke ownership role
+ * for
+ */
+ public void revokeOwnership(String address)
+ {
+ throw new UnsupportedOperationException("Not supported yet.");
+ }
+
+ /**
+ * Revokes the voice for the participant given by address.
+ * @param address the address of the participant to revoke voice for
+ */
+ public void revokeVoice(String address)
+ {
+ throw new UnsupportedOperationException("Not supported yet.");
+ }
+
+ /**
+ * Returns the local user role.
+ * @return the local user role
+ */
+ public ChatRoomMemberRole getUserRole()
+ {
+ throw new UnsupportedOperationException("Not supported yet.");
+ }
+
+ /**
+ * Sets the local user role.
+ * @param role the role to set
+ * @throws OperationFailedException if the operation don't succeed
+ */
+ public void setUserRole(ChatRoomMemberRole role)
+ throws OperationFailedException
+ {
+ throw new UnsupportedOperationException("Not supported yet.");
+ }
}
diff --git a/src/net/java/sip/communicator/impl/protocol/mock/MockChatRoomMember.java b/src/net/java/sip/communicator/impl/protocol/mock/MockChatRoomMember.java
index 8860145cd..ef0b98572 100644
--- a/src/net/java/sip/communicator/impl/protocol/mock/MockChatRoomMember.java
+++ b/src/net/java/sip/communicator/impl/protocol/mock/MockChatRoomMember.java
@@ -21,6 +21,18 @@ public class MockChatRoomMember
private Contact contact;
private byte[] avatar;
+ /**
+ * Creates an instance of MockChatRoomMember by specifying the
+ * name of the member, the chatRoom, to which it belongs,
+ * its role in the room, the contact corresponding to it
+ * and its avatar.
+ * @param name the name of the member
+ * @param chatRoom the chat room to which the member belongs
+ * @param role the role of the member in the room
+ * @param contact the contact corresponding to this member in the local
+ * contact list
+ * @param avatar the avatar of the member
+ */
public MockChatRoomMember(String name, ChatRoom chatRoom,
ChatRoomMemberRole role, Contact contact, byte[] avatar)
{
@@ -92,6 +104,15 @@ public ChatRoomMemberRole getRole()
return role;
}
+ /**
+ * Sets the role of this member.
+ * @param role the role to set
+ */
+ public void setRole(ChatRoomMemberRole role)
+ {
+ throw new UnsupportedOperationException("Not supported yet.");
+ }
+
/**
* Returns the avatar of this member, that can be used when including it in
* user interface.
diff --git a/src/net/java/sip/communicator/service/protocol/ChatRoom.java b/src/net/java/sip/communicator/service/protocol/ChatRoom.java
index 027508db6..587618651 100644
--- a/src/net/java/sip/communicator/service/protocol/ChatRoom.java
+++ b/src/net/java/sip/communicator/service/protocol/ChatRoom.java
@@ -16,6 +16,7 @@
*
* @author Emil Ivov
* @author Yana Stamcheva
+ * @author Valentin Martinet
*/
public interface ChatRoom
{
@@ -141,6 +142,25 @@ public void setSubject(String subject)
*/
public String getUserNickname();
+ /**
+ * Returns the local user's role in the context of this chat room or
+ * null if not currently joined.
+ *
+ * @return the role currently being used by the local user in the context of
+ * the chat room.
+ */
+ public ChatRoomMemberRole getUserRole();
+
+ /**
+ * Changes the the local user's nickname in the context of this chatroom.
+ *
+ * @param role the new role to set for the local user.
+ *
+ * @throws OperationFailedException if an error occurs.
+ */
+ public void setUserRole(ChatRoomMemberRole role)
+ throws OperationFailedException;
+
/**
* Changes the the local user's nickname in the context of this chatroom.
*
@@ -261,14 +281,12 @@ public void removeMemberPropertyChangeListener(
*
* @return a List of ChatRoomMember instances
* corresponding to all room members.
- * @throws OperationFailedException if we fail retrieving the list of room
- * participants.
*/
public List
- * @param obj the reference object with which to compare.
- * @return true if obj is a role instance that has the same
- * name and role index as this one.
- */
- public boolean equals(Object obj)
- {
- if (obj == this)
- return true;
-
- /*
- * XXX Implementing Object#equals(Object) with instanceof is error
- * prone. The safe and recommended approach is to return true only if
- * the runtime types of the two Objects being tested are one and the
- * same i.e. getClass().equals(obj.getClass()).
- */
- if (!(obj instanceof ChatRoomMemberRole))
- return false;
-
- ChatRoomMemberRole role = (ChatRoomMemberRole) obj;
-
- return role.getRoleName().equals(getRoleName())
- && (role.getRoleIndex() == getRoleIndex());
- }
-
- /**
- * Returns a hash code value for the object. This method is
- * supported for the benefit of hashtables such as those provided by
- * java.util.Hashtable.
- *
- * @return a hash code value for this object. - */ - public int hashCode() - { - return getRoleName().hashCode(); - } - - /** - * Compares this role's role index with that of the specified object for - * order. Returns a negative integer, zero, or a positive integer as this - * role is less than, equal to, or greater than the specified object. - * - * @param obj the object to be compared. - * @return a negative integer, zero, or a positive integer as this object - * is less than, equal to, or greater than the specified object. - * - * @throws ClassCastException if the specified object's type is not an - * instance of ChatRoomMemberRole. - */ - public int compareTo(ChatRoomMemberRole obj) - throws ClassCastException - { - return getRoleIndex() - obj.getRoleIndex(); - } }