org.jivesoftware.smackx.muc

Interface UserStatusListener

All Known Implementing Classes:

DefaultUserStatusListener

public interface UserStatusListener

A listener that is fired anytime your participant's status in a room is changed, such as the user being kicked, banned, or granted admin permissions.

Author:

Gaston Dombiak

Method Summary

Modifier and Type	Method and Description
void	adminGranted() Called when an owner grants administrator privileges to your user.
void	adminRevoked() Called when an owner revokes administrator privileges from your user.
void	banned(String actor, String reason) Called when an administrator or owner banned your user from the room.
void	kicked(String actor, String reason) Called when a moderator kicked your user from the room.
void	membershipGranted() Called when an administrator grants your user membership to the room.
void	membershipRevoked() Called when an administrator revokes your user membership to the room.
void	moderatorGranted() Called when an administrator grants moderator privileges to your user.
void	moderatorRevoked() Called when an administrator revokes moderator privileges from your user.
void	ownershipGranted() Called when an owner grants to your user ownership on the room.
void	ownershipRevoked() Called when an owner revokes from your user ownership on the room.
void	voiceGranted() Called when a moderator grants voice to your user.
void	voiceRevoked() Called when a moderator revokes voice from your user.

Method Detail

kicked

void kicked(String actor,
            String reason)

Called when a moderator kicked your user from the room. This means that you are no longer participanting in the room.

Parameters:

actor - the moderator that kicked your user from the room (e.g. user@host.org).

reason - the reason provided by the actor to kick you from the room.

voiceGranted

void voiceGranted()

Called when a moderator grants voice to your user. This means that you were a visitor in the moderated room before and now you can participate in the room by sending messages to all occupants.

voiceRevoked

void voiceRevoked()

Called when a moderator revokes voice from your user. This means that you were a participant in the room able to speak and now you are a visitor that can't send messages to the room occupants.

banned

void banned(String actor,
            String reason)

Called when an administrator or owner banned your user from the room. This means that you will no longer be able to join the room unless the ban has been removed.

Parameters:

actor - the administrator that banned your user (e.g. user@host.org).

reason - the reason provided by the administrator to banned you.

membershipGranted

void membershipGranted()

Called when an administrator grants your user membership to the room. This means that you will be able to join the members-only room.

membershipRevoked

void membershipRevoked()

Called when an administrator revokes your user membership to the room. This means that you will not be able to join the members-only room.

moderatorGranted

void moderatorGranted()

Called when an administrator grants moderator privileges to your user. This means that you will be able to kick users, grant and revoke voice, invite other users, modify room's subject plus all the partcipants privileges.

moderatorRevoked

void moderatorRevoked()

Called when an administrator revokes moderator privileges from your user. This means that you will no longer be able to kick users, grant and revoke voice, invite other users, modify room's subject plus all the partcipants privileges.

ownershipGranted

void ownershipGranted()

Called when an owner grants to your user ownership on the room. This means that you will be able to change defining room features as well as perform all administrative functions.

ownershipRevoked

void ownershipRevoked()

Called when an owner revokes from your user ownership on the room. This means that you will no longer be able to change defining room features as well as perform all administrative functions.

adminGranted

void adminGranted()

Called when an owner grants administrator privileges to your user. This means that you will be able to perform administrative functions such as banning users and edit moderator list.

adminRevoked

void adminRevoked()

Called when an owner revokes administrator privileges from your user. This means that you will no longer be able to perform administrative functions such as banning users and edit moderator list.