org.jivesoftware.smackx.muc

Interface ParticipantStatusListener

All Known Implementing Classes:

DefaultParticipantStatusListener

public interface ParticipantStatusListener

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

Method Summary

Modifier and Type	Method and Description
default void	adminGranted(org.jxmpp.jid.EntityFullJid participant) Called when an owner grants administrator privileges to a user.
default void	adminRevoked(org.jxmpp.jid.EntityFullJid participant) Called when an owner revokes administrator privileges from a user.
default void	banned(org.jxmpp.jid.EntityFullJid participant, org.jxmpp.jid.Jid actor, java.lang.String reason) Called when an administrator or owner banned a participant from the room.
default void	joined(org.jxmpp.jid.EntityFullJid participant) Called when a new room occupant has joined the room.
default void	kicked(org.jxmpp.jid.EntityFullJid participant, org.jxmpp.jid.Jid actor, java.lang.String reason) Called when a room participant has been kicked from the room.
default void	left(org.jxmpp.jid.EntityFullJid participant) Called when a room occupant has left the room on its own.
default void	membershipGranted(org.jxmpp.jid.EntityFullJid participant) Called when an administrator grants a user membership to the room.
default void	membershipRevoked(org.jxmpp.jid.EntityFullJid participant) Called when an administrator revokes a user membership to the room.
default void	moderatorGranted(org.jxmpp.jid.EntityFullJid participant) Called when an administrator grants moderator privileges to a user.
default void	moderatorRevoked(org.jxmpp.jid.EntityFullJid participant) Called when an administrator revokes moderator privileges from a user.
default void	nicknameChanged(org.jxmpp.jid.EntityFullJid participant, org.jxmpp.jid.parts.Resourcepart newNickname) Called when a participant changed his/her nickname in the room.
default void	ownershipGranted(org.jxmpp.jid.EntityFullJid participant) Called when an owner grants a user ownership on the room.
default void	ownershipRevoked(org.jxmpp.jid.EntityFullJid participant) Called when an owner revokes a user ownership on the room.
default void	parted(org.jxmpp.jid.EntityFullJid participant) Called when a participant is parted for whatever reason.
default void	voiceGranted(org.jxmpp.jid.EntityFullJid participant) Called when a moderator grants voice to a visitor.
default void	voiceRevoked(org.jxmpp.jid.EntityFullJid participant) Called when a moderator revokes voice from a participant.

Method Detail

joined

default void joined(org.jxmpp.jid.EntityFullJid participant)

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.

Parameters:

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

left

default void left(org.jxmpp.jid.EntityFullJid participant)

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.

Parameters:

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

parted

default void parted(org.jxmpp.jid.EntityFullJid participant)

Called when a participant is parted for whatever reason. This callback is always invoked if a participant parted the room, either voluntarily or involuntarily. Prior this callback, a callback with a more specific reason for the removal, like left(EntityFullJid) may be invoked.

Parameters:

participant - the participant that was removed from the room.

Since:

4.4

kicked

default void kicked(org.jxmpp.jid.EntityFullJid participant,
                    org.jxmpp.jid.Jid actor,
                    java.lang.String reason)

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

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

default void voiceGranted(org.jxmpp.jid.EntityFullJid participant)

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.

Parameters:

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

voiceRevoked

default void voiceRevoked(org.jxmpp.jid.EntityFullJid participant)

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.

Parameters:

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

banned

default void banned(org.jxmpp.jid.EntityFullJid participant,
                    org.jxmpp.jid.Jid actor,
                    java.lang.String reason)

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.

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

default void membershipGranted(org.jxmpp.jid.EntityFullJid participant)

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.

Parameters:

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

membershipRevoked

default void membershipRevoked(org.jxmpp.jid.EntityFullJid participant)

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.

Parameters:

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

moderatorGranted

default void moderatorGranted(org.jxmpp.jid.EntityFullJid participant)

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.

Parameters:

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

moderatorRevoked

default void moderatorRevoked(org.jxmpp.jid.EntityFullJid participant)

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.

Parameters:

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

ownershipGranted

default void ownershipGranted(org.jxmpp.jid.EntityFullJid participant)

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.

Parameters:

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

ownershipRevoked

default void ownershipRevoked(org.jxmpp.jid.EntityFullJid participant)

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.

Parameters:

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

adminGranted

default void adminGranted(org.jxmpp.jid.EntityFullJid participant)

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.

Parameters:

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

adminRevoked

default void adminRevoked(org.jxmpp.jid.EntityFullJid participant)

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.

Parameters:

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

nicknameChanged

default void nicknameChanged(org.jxmpp.jid.EntityFullJid participant,
                             org.jxmpp.jid.parts.Resourcepart newNickname)

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

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.