org.jivesoftware.wildfire.muc
Interface MUCRole

All Known Implementing Classes:

MUCRoleImpl

public interface MUCRole

Defines the permissions and actions that a MUCUser may use in a particular room. Each MUCRole defines the relationship between a MUCRoom and a MUCUser.

MUCUsers can play different roles in different chatrooms.

Author:

Gaston Dombiak

Nested Class Summary

static class	MUCRole.Affiliation
static class	MUCRole.Role

Method Summary

void	changeNickname(String nickname) Changes the nickname of the occupant within the room to the new nickname.
MUCRole.Affiliation	getAffiliation() Obtain the affiliation state of the user.
MUCRoom	getChatRoom() Obtain the chat room that hosts this user's role.
MUCUser	getChatUser() Obtain the chat user that plays this role.
org.dom4j.Element	getExtendedPresenceInformation() Returns the extended presence information that includes information about roles, affiliations, JIDs, etc.
String	getNickname() Obtain the nickname for the user in the chatroom.
Presence	getPresence() Obtain the current presence status of a user in a chatroom.
MUCRole.Role	getRole() Obtain the role state of the user.
JID	getRoleAddress() Obtain the XMPPAddress representing this role in a room: room@server/nickname
boolean	isVoiceOnly() Returns true if the room occupant does not want to get messages broadcasted to all room occupants.
void	send(Packet packet) Sends a packet to the user.
void	setAffiliation(MUCRole.Affiliation newAffiliation) Call this method to promote or demote a user's affiliation in a chatroom.
void	setPresence(Presence presence) Set the current presence status of a user in a chatroom.
void	setRole(MUCRole.Role newRole) Call this method to promote or demote a user's role in a chatroom.

Method Detail

getPresence

Presence getPresence()

Obtain the current presence status of a user in a chatroom.

Returns:

The presence of the user in the room.

getExtendedPresenceInformation

org.dom4j.Element getExtendedPresenceInformation()

Returns the extended presence information that includes information about roles, affiliations, JIDs, etc.

Returns:

the extended presence information that includes information about roles, affiliations.

setPresence

void setPresence(Presence presence)

Set the current presence status of a user in a chatroom.

Parameters:

presence - The presence of the user in the room.

setRole

void setRole(MUCRole.Role newRole)
             throws NotAllowedException

Call this method to promote or demote a user's role in a chatroom. It is common for the chatroom or other chat room members to change the role of users (a moderator promoting another user to moderator status for example).

Owning ChatUsers should have their membership roles updated.

Parameters:

newRole - The new role that the user will play.

Throws:

NotAllowedException - Thrown if trying to change the moderator role to an owner or administrator.

getRole

MUCRole.Role getRole()

Obtain the role state of the user.

Returns:

The role status of this user.

setAffiliation

void setAffiliation(MUCRole.Affiliation newAffiliation)
                    throws NotAllowedException

Call this method to promote or demote a user's affiliation in a chatroom.

Parameters:

newAffiliation - the new affiliation that the user will play.

Throws:

NotAllowedException - thrown if trying to ban an owner or an administrator.

getAffiliation

MUCRole.Affiliation getAffiliation()

Obtain the affiliation state of the user.

Returns:

The affiliation status of this user.

getNickname

String getNickname()

Obtain the nickname for the user in the chatroom.

Returns:

The user's nickname in the room or null if invisible.

changeNickname

void changeNickname(String nickname)

Changes the nickname of the occupant within the room to the new nickname.

Parameters:

nickname - the new nickname of the occupant in the room.

isVoiceOnly

boolean isVoiceOnly()

Returns true if the room occupant does not want to get messages broadcasted to all room occupants. This type of users are called "deaf" occupants. Deaf occupants will still be able to get private messages, presences, IQ packets or room history.

To be a deaf occupant the initial presence sent to the room while joining the room has to include the following child element:

 <x xmlns='http://jivesoftware.org/protocol/muc'>
     <deaf-occupant/>
 </x>
 

Note that this is a custom extension to the MUC specification.

Returns:

true if the room occupant does not want to get messages broadcasted to all room occupants.

getChatUser

MUCUser getChatUser()

Obtain the chat user that plays this role.

Returns:

The chatuser playing this role.

getChatRoom

MUCRoom getChatRoom()

Obtain the chat room that hosts this user's role.

Returns:

The chatroom hosting this role.

getRoleAddress

JID getRoleAddress()

Obtain the XMPPAddress representing this role in a room: room@server/nickname

Returns:

The Jabber ID that represents this role in the room.

send

void send(Packet packet)

Sends a packet to the user.

Parameters:

packet - The packet to send