org.jivesoftware.smackx.muc
Class DefaultParticipantStatusListener

java.lang.Object
  org.jivesoftware.smackx.muc.DefaultParticipantStatusListener

All Implemented Interfaces:

ParticipantStatusListener

public class DefaultParticipantStatusListener
extends Object
implements ParticipantStatusListener

Default implementation of the ParticipantStatusListener interface.

This class does not provide any behavior by default. It just avoids having to implement all the inteface methods if the user is only interested in implementing some of the methods.

Author:

Gaston Dombiak

Constructor Summary

DefaultParticipantStatusListener()

Method Summary

void	adminGranted(String participant) Called when an owner grants administrator privileges to a user.
void	adminRevoked(String participant) Called when an owner revokes administrator privileges from a user.
void	banned(String participant, String actor, String reason) Called when an administrator or owner banned a participant from the room.
void	joined(String participant) Called when a new room occupant has joined the room.
void	kicked(String participant, String actor, String reason) Called when a room participant has been kicked from the room.
void	left(String participant) Called when a room occupant has left the room on its own.
void	membershipGranted(String participant) Called when an administrator grants a user membership to the room.
void	membershipRevoked(String participant) Called when an administrator revokes a user membership to the room.
void	moderatorGranted(String participant) Called when an administrator grants moderator privileges to a user.
void	moderatorRevoked(String participant) Called when an administrator revokes moderator privileges from a user.
void	nicknameChanged(String participant, String newNickname) Called when a participant changed his/her nickname in the room.
void	ownershipGranted(String participant) Called when an owner grants a user ownership on the room.
void	ownershipRevoked(String participant) Called when an owner revokes a user ownership on the room.
void	voiceGranted(String participant) Called when a moderator grants voice to a visitor.
void	voiceRevoked(String participant) Called when a moderator revokes voice from a participant.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

DefaultParticipantStatusListener

public DefaultParticipantStatusListener()

Method Detail

joined

public void joined(String participant)

Description copied from interface: ParticipantStatusListener

Called when a new room occupant has joined the room. Note: Take in consideration that when you join a room you will receive the list of current occupants in the room. This message will be sent for each occupant.

Specified by:

joined in interface ParticipantStatusListener

Parameters:

participant - the participant that has just joined the room (e.g. room@conference.jabber.org/nick).

left

public void left(String participant)

Description copied from interface: ParticipantStatusListener

Called when a room occupant has left the room on its own. This means that the occupant was neither kicked nor banned from the room.

Specified by:

left in interface ParticipantStatusListener

Parameters:

participant - the participant that has left the room on its own. (e.g. room@conference.jabber.org/nick).

kicked

public void kicked(String participant,
                   String actor,
                   String reason)

Description copied from interface: ParticipantStatusListener

Called when a room participant has been kicked from the room. This means that the kicked participant is no longer participating in the room.

Specified by:

kicked in interface ParticipantStatusListener

Parameters:

participant - the participant that was kicked from the room (e.g. room@conference.jabber.org/nick).

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

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

voiceGranted

public void voiceGranted(String participant)

Description copied from interface: ParticipantStatusListener

Called when a moderator grants voice to a visitor. This means that the visitor can now participate in the moderated room sending messages to all occupants.

Specified by:

voiceGranted in interface ParticipantStatusListener

Parameters:

participant - the participant that was granted voice in the room (e.g. room@conference.jabber.org/nick).

voiceRevoked

public void voiceRevoked(String participant)

Description copied from interface: ParticipantStatusListener

Called when a moderator revokes voice from a participant. This means that the participant in the room was able to speak and now is a visitor that can't send messages to the room occupants.

Specified by:

voiceRevoked in interface ParticipantStatusListener

Parameters:

participant - the participant that was revoked voice from the room (e.g. room@conference.jabber.org/nick).

banned

public void banned(String participant,
                   String actor,
                   String reason)

Description copied from interface: ParticipantStatusListener

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

Specified by:

banned in interface ParticipantStatusListener

Parameters:

participant - the participant that was banned from the room (e.g. room@conference.jabber.org/nick).

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

reason - the reason provided by the administrator to ban the occupant.

membershipGranted

public void membershipGranted(String participant)

Description copied from interface: ParticipantStatusListener

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

Specified by:

membershipGranted in interface ParticipantStatusListener

Parameters:

participant - the participant that was granted membership in the room (e.g. room@conference.jabber.org/nick).

membershipRevoked

public void membershipRevoked(String participant)

Description copied from interface: ParticipantStatusListener

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

Specified by:

membershipRevoked in interface ParticipantStatusListener

Parameters:

participant - the participant that was revoked membership from the room (e.g. room@conference.jabber.org/nick).

moderatorGranted

public void moderatorGranted(String participant)

Description copied from interface: ParticipantStatusListener

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

Specified by:

moderatorGranted in interface ParticipantStatusListener

Parameters:

participant - the participant that was granted moderator privileges in the room (e.g. room@conference.jabber.org/nick).

moderatorRevoked

public void moderatorRevoked(String participant)

Description copied from interface: ParticipantStatusListener

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

Specified by:

moderatorRevoked in interface ParticipantStatusListener

Parameters:

participant - the participant that was revoked moderator privileges in the room (e.g. room@conference.jabber.org/nick).

ownershipGranted

public void ownershipGranted(String participant)

Description copied from interface: ParticipantStatusListener

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

Specified by:

ownershipGranted in interface ParticipantStatusListener

Parameters:

participant - the participant that was granted ownership on the room (e.g. room@conference.jabber.org/nick).

ownershipRevoked

public void ownershipRevoked(String participant)

Description copied from interface: ParticipantStatusListener

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

Specified by:

ownershipRevoked in interface ParticipantStatusListener

Parameters:

participant - the participant that was revoked ownership on the room (e.g. room@conference.jabber.org/nick).

adminGranted

public void adminGranted(String participant)

Description copied from interface: ParticipantStatusListener

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

Specified by:

adminGranted in interface ParticipantStatusListener

Parameters:

participant - the participant that was granted administrator privileges (e.g. room@conference.jabber.org/nick).

adminRevoked

public void adminRevoked(String participant)

Description copied from interface: ParticipantStatusListener

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

Specified by:

adminRevoked in interface ParticipantStatusListener

Parameters:

participant - the participant that was revoked administrator privileges (e.g. room@conference.jabber.org/nick).

nicknameChanged

public void nicknameChanged(String participant,
                            String newNickname)

Description copied from interface: ParticipantStatusListener

Called when a participant changed his/her nickname in the room. The new participant's nickname will be informed with the next available presence.

Specified by:

nicknameChanged in interface ParticipantStatusListener

Parameters:

participant - the participant that was revoked administrator privileges (e.g. room@conference.jabber.org/nick).

newNickname - the new nickname that the participant decided to use.