org.jivesoftware.smackx.muc.MultiUserChat

public class MultiUserChat extends Object

A MultiUserChat room (XEP-45), created with MultiUserChatManager.getMultiUserChat(EntityBareJid).

A MultiUserChat is a conversation that takes place among many users in a virtual room. A room could have many occupants with different affiliation and roles. Possible affiliations are "owner", "admin", "member", and "outcast". Possible roles are "moderator", "participant", and "visitor". Each role and affiliation guarantees different privileges (e.g. Send messages to all occupants, Kick participants and visitors, Grant voice, Edit member list, etc.).

Note: Make sure to leave the MUC (leave()) when you don't need it anymore or otherwise you may leak the instance.

Nested Class Summary

Nested Classes

Modifier and Type

Class

Description

class

MultiUserChat.MucCreateConfigFormHandle

A handle used to configure a newly created room.
Method Summary

Modifier and Type

Method

Description

boolean

addInvitationRejectionListener(InvitationRejectionListener listener)

Adds a listener to invitation rejections notifications.

boolean

addMessageInterceptor(MucMessageInterceptor interceptor)

boolean

addMessageListener(MessageListener listener)

Adds a stanza listener that will be notified of any new messages in the group chat.

boolean

addParticipantListener(PresenceListener listener)

Adds a stanza listener that will be notified of any new Presence packets sent to the group chat.

boolean

addParticipantStatusListener(ParticipantStatusListener listener)

Adds a listener that will be notified of changes in occupants status in the room such as the user being kicked, banned, or granted admin permissions.

void

addPresenceInterceptor(Consumer<PresenceBuilder> presenceInterceptor)

Adds a new StanzaListener that will be invoked every time a new presence is going to be sent by this MultiUserChat to the server.

boolean

addSubjectUpdatedListener(SubjectUpdatedListener listener)

Adds a listener to subject change notifications.

boolean

addUserStatusListener(UserStatusListener listener)

Adds a listener that will be notified of changes in your status in the room such as the user being kicked, banned, or granted admin permissions.

void

banUser(BareJid jid, String reason)

Bans a user from the room.

void

banUsers(Collection<? extends BareJid> jids)

Bans users from the room.

MessageBuilder

buildMessage()

Constructs a new message builder for messages send to this MUC room.

void

changeAvailabilityStatus(String status, Presence.Mode mode)

Changes the occupant's availability status within the room.

void

changeNickname(Resourcepart nickname)

Changes the occupant's nickname to a new nickname within the room.

void

changeSubject(String subject)

Changes the subject within the room.

MultiUserChat.MucCreateConfigFormHandle

create(Resourcepart nickname)

Creates the room according to some default configuration, assign the requesting user as the room owner, and add the owner to the room but not allow anyone else to enter the room (effectively "locking" the room).

Message

createMessage()

Deprecated.
use buildMessage() instead.

MultiUserChat.MucCreateConfigFormHandle

createOrJoin(MucEnterConfiguration mucEnterConfiguration)

Like create(Resourcepart), but will return a MultiUserChat.MucCreateConfigFormHandle if the room creation was acknowledged by the service (with an 201 status code).

MultiUserChat.MucCreateConfigFormHandle

createOrJoin(Resourcepart nickname)

Create or join the MUC room with the given nickname.

MultiUserChat.MucCreateConfigFormHandle

createOrJoinIfNecessary(Resourcepart nickname, String password)

Create or join a MUC if it is necessary, i.e.

Chat

createPrivateChat(EntityFullJid occupant, ChatMessageListener listener)

Returns a new Chat for sending private messages to a given room occupant.

void

destroy()

Sends a request to destroy the room.

void

destroy(String reason, EntityBareJid alternateJID)

Sends a request to the server to destroy the room.

void

destroy(String reason, EntityBareJid alternateJID, String password)

Sends a request to the server to destroy the room.

List<Affiliate>

getAdmins()

Returns a list of Affiliate with the room administrators.

MucConfigFormManager

getConfigFormManager()

Get a MucConfigFormManager to configure this room.

Form

getConfigurationForm()

Returns the room's configuration form that the room's owner can use.

MucEnterConfiguration.Builder

getEnterConfigurationBuilder(Resourcepart nickname)

Get a new MUC enter configuration builder.

List<Affiliate>

getMembers()

Returns a list of Affiliate with the room members.

List<Occupant>

getModerators()

Returns a list of Occupant with the room moderators.

EntityFullJid

getMyRoomJid()

Return the full JID of the user in the room, or null if the room is not joined.

Resourcepart

getNickname()

Returns the nickname that was used to join the room, or null if not currently joined.

Occupant

getOccupant(EntityFullJid user)

Returns the Occupant information for a particular occupant, or null if the user is not in the room.

Presence

getOccupantPresence(EntityFullJid user)

Returns the presence info for a particular user, or null if the user is not in the room.

List<EntityFullJid>

getOccupants()

Returns an List for the list of fully qualified occupants in the group chat.

int

getOccupantsCount()

Returns the number of occupants in the group chat.

List<Affiliate>

getOutcasts()

Returns a list of Affiliate with the room outcasts.

List<Affiliate>

getOwners()

Returns a list of Affiliate with the room owners.

List<Occupant>

getParticipants()

Returns a list of Occupant with the room participants.

Form

getRegistrationForm()

Returns the room's registration form that an unaffiliated user, can use to become a member of the room or null if no registration is possible.

String

getReservedNickname()

Returns the reserved room nickname for the user in the room.

EntityBareJid

getRoom()

Returns the name of the room this MultiUserChat object represents.

String

getSubject()

Returns the last known room's subject or null if the user hasn't joined the room or the room does not have a subject yet.

XMPPConnection

getXmppConnection()

Get the XMPP connection associated with this chat instance.

void

grantAdmin(Collection<? extends BareJid> jids)

Grants administrator privileges to other users.

void

grantAdmin(BareJid jid)

Grants administrator privileges to another user.

void

grantMembership(Collection<? extends Jid> jids)

Grants membership to other users.

void

grantMembership(BareJid jid)

Grants membership to a user.

void

grantModerator(Collection<Resourcepart> nicknames)

Grants moderator privileges to participants or visitors.

void

grantModerator(Resourcepart nickname)

Grants moderator privileges to a participant or visitor.

void

grantOwnership(Collection<? extends BareJid> jids)

Grants ownership privileges to other users.

void

grantOwnership(BareJid jid)

Grants ownership privileges to another user.

void

grantVoice(Collection<Resourcepart> nicknames)

Grants voice to visitors in the room.

void

grantVoice(Resourcepart nickname)

Grants voice to a visitor in the room.

void

invite(MessageBuilder messageBuilder, EntityBareJid user, String reason)

Invites another user to the room in which one is an occupant using a given Message.

void

invite(EntityBareJid user, String reason)

Invites another user to the room in which one is an occupant.

void

inviteDirectly(EntityBareJid address)

Invites another user to the room in which one is an occupant.

void

inviteDirectly(EntityBareJid address, String reason, String password, boolean continueAsOneToOneChat, String thread)

Invites another user to the room in which one is an occupant.

boolean

isJoined()

Returns true if currently in the multi user chat (after calling the join(Resourcepart) method).

Presence

join(MucEnterConfiguration mucEnterConfiguration)

Joins the chat room using the specified nickname and password.

Presence

join(Resourcepart nickname)

Joins the chat room using the specified nickname.

void

join(Resourcepart nickname, String password)

Joins the chat room using the specified nickname and password.

void

kickParticipant(Resourcepart nickname, String reason)

Kicks a visitor or participant from the room.

Presence

leave()

Leave the chat room.

Message

nextMessage()

Returns the next available message in the chat.

Message

nextMessage(long timeout)

Returns the next available message in the chat.

Message

pollMessage()

Polls for and returns the next message, or null if there isn't a message immediately available.

boolean

removeInvitationRejectionListener(InvitationRejectionListener listener)

Removes a listener from invitation rejections notifications.

boolean

removeMessageInterceptor(MucMessageInterceptor interceptor)

boolean

removeMessageListener(MessageListener listener)

Removes a stanza listener that was being notified of any new messages in the multi user chat.

boolean

removeParticipantListener(PresenceListener listener)

Removes a stanza listener that was being notified of any new Presence packets sent to the group chat.

boolean

removeParticipantStatusListener(ParticipantStatusListener listener)

Removes a listener that was being notified of changes in occupants status in the room such as the user being kicked, banned, or granted admin permissions.

void

removePresenceInterceptor(Consumer<PresenceBuilder> presenceInterceptor)

Removes a StanzaListener that was being invoked every time a new presence was being sent by this MultiUserChat to the server.

boolean

removeSubjectUpdatedListener(SubjectUpdatedListener listener)

Removes a listener from subject change notifications.

boolean

removeUserStatusListener(UserStatusListener listener)

Removes a listener that was being notified of changes in your status in the room such as the user being kicked, banned, or granted admin permissions.

void

requestVoice()

Sends a voice request to the MUC.

void

revokeAdmin(Collection<? extends BareJid> jids)

Revokes administrator privileges from users.

void

revokeAdmin(BareJid jid)

Revokes administrator privileges from a user.

void

revokeMembership(Collection<? extends BareJid> jids)

Revokes users' membership.

void

revokeMembership(BareJid jid)

Revokes a user's membership.

void

revokeModerator(Collection<Resourcepart> nicknames)

Revokes moderator privileges from other users.

void

revokeModerator(Resourcepart nickname)

Revokes moderator privileges from another user.

void

revokeOwnership(Collection<? extends BareJid> jids)

Revokes ownership privileges from other users.

void

revokeOwnership(BareJid jid)

Revokes ownership privileges from another user.

void

revokeVoice(Collection<Resourcepart> nicknames)

Revokes voice from participants in the room.

void

revokeVoice(Resourcepart nickname)

Revokes voice from a participant in the room.

void

sendConfigurationForm(FillableForm form)

Sends the completed configuration form to the server.

void

sendMessage(String text)

Sends a message to the chat room.

MessageView

sendMessage(MessageBuilder messageBuilder)

Sends a Message to the chat room.

void

sendRegistrationForm(FillableForm form)

Sends the completed registration form to the server.

boolean

serviceSupportsStableIds()

String

toString()

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Method Details
- getRoom
  
  public EntityBareJid getRoom()
  
  Returns the name of the room this MultiUserChat object represents.
  
  Returns:
  
  the multi user chat room name.
- getEnterConfigurationBuilder
  
  public MucEnterConfiguration.Builder getEnterConfigurationBuilder(Resourcepart nickname)
  
  Get a new MUC enter configuration builder.
  
  Parameters:
  
  nickname - the nickname used when entering the MUC room.
  
  Returns:
  
  a new MUC enter configuration builder.
  
  Since:
  
  4.2
- create
  
  public MultiUserChat.MucCreateConfigFormHandle create(Resourcepart nickname) throws SmackException.NoResponseException, XMPPException.XMPPErrorException, InterruptedException, MultiUserChatException.MucAlreadyJoinedException, SmackException.NotConnectedException, MultiUserChatException.MissingMucCreationAcknowledgeException, MultiUserChatException.NotAMucServiceException
  
  Creates the room according to some default configuration, assign the requesting user as the room owner, and add the owner to the room but not allow anyone else to enter the room (effectively "locking" the room). The requesting user will join the room under the specified nickname as soon as the room has been created.
  To create an "Instant Room", that means a room with some default configuration that is available for immediate access, the room's owner should send an empty form after creating the room. Simply call MultiUserChat.MucCreateConfigFormHandle.makeInstant() on the returned MultiUserChat.MucCreateConfigFormHandle.
  
  To create a "Reserved Room", that means a room manually configured by the room creator before anyone is allowed to enter, the room's owner should complete and send a form after creating the room. Once the completed configuration form is sent to the server, the server will unlock the room. You can use the returned MultiUserChat.MucCreateConfigFormHandle to configure the room.
  
  Parameters:
  
  nickname - the nickname to use.
  
  Returns:
  
  a handle to the MUC create configuration form API.
  
  Throws:
  
  XMPPException.XMPPErrorException - if the room couldn't be created for some reason (e.g. 405 error if the user is not allowed to create the room)
  
  SmackException.NoResponseException - if there was no response from the server.
  
  InterruptedException - if the calling thread was interrupted.
  
  SmackException.NotConnectedException - if the XMPP connection is not connected.
  
  MultiUserChatException.MucAlreadyJoinedException - if already joined the Multi-User Chat.7y
  
  MultiUserChatException.MissingMucCreationAcknowledgeException - if there MUC creation was not acknowledged by the service.
  
  MultiUserChatException.NotAMucServiceException - if the entity is not a MUC service.
- createOrJoin
  
  public MultiUserChat.MucCreateConfigFormHandle createOrJoin(Resourcepart nickname) throws SmackException.NoResponseException, XMPPException.XMPPErrorException, InterruptedException, MultiUserChatException.MucAlreadyJoinedException, SmackException.NotConnectedException, MultiUserChatException.NotAMucServiceException
  
  Create or join the MUC room with the given nickname.
  
  Parameters:
  
  nickname - the nickname to use in the MUC room.
  
  Returns:
  
  A MultiUserChat.MucCreateConfigFormHandle if the room was created while joining, or null if the room was just joined.
  
  Throws:
  
  SmackException.NoResponseException - if there was no response from the remote entity.
  
  XMPPException.XMPPErrorException - if there was an XMPP error returned.
  
  InterruptedException - if the calling thread was interrupted.
  
  SmackException.NotConnectedException - if the XMPP connection is not connected.
  
  MultiUserChatException.MucAlreadyJoinedException - if already joined the Multi-User Chat.7y
  
  MultiUserChatException.NotAMucServiceException - if the entity is not a MUC service.
- createOrJoin
  
  public MultiUserChat.MucCreateConfigFormHandle createOrJoin(MucEnterConfiguration mucEnterConfiguration) throws SmackException.NoResponseException, XMPPException.XMPPErrorException, InterruptedException, MultiUserChatException.MucAlreadyJoinedException, SmackException.NotConnectedException, MultiUserChatException.NotAMucServiceException
  
  Like create(Resourcepart), but will return a MultiUserChat.MucCreateConfigFormHandle if the room creation was acknowledged by the service (with an 201 status code). It's up to the caller to decide, based on the return value, if he needs to continue sending the room configuration. If null is returned, the room already existed and the user is able to join right away, without sending a form.
  
  Parameters:
  
  mucEnterConfiguration - the configuration used to enter the MUC.
  
  Returns:
  
  A MultiUserChat.MucCreateConfigFormHandle if the room was created while joining, or null if the room was just joined.
  
  Throws:
  
  XMPPException.XMPPErrorException - if the room couldn't be created for some reason (e.g. 405 error if the user is not allowed to create the room)
  
  SmackException.NoResponseException - if there was no response from the server.
  
  InterruptedException - if the calling thread was interrupted.
  
  MultiUserChatException.MucAlreadyJoinedException - if the MUC is already joined
  
  SmackException.NotConnectedException - if the XMPP connection is not connected.
  
  MultiUserChatException.NotAMucServiceException - if the entity is not a MUC service.
- createOrJoinIfNecessary
  
  public MultiUserChat.MucCreateConfigFormHandle createOrJoinIfNecessary(Resourcepart nickname, String password) throws SmackException.NoResponseException, XMPPException.XMPPErrorException, SmackException.NotConnectedException, InterruptedException, MultiUserChatException.NotAMucServiceException
  
  Create or join a MUC if it is necessary, i.e. if not the MUC is not already joined.
  
  Parameters:
  
  nickname - the required nickname to use.
  
  password - the optional password required to join
  
  Returns:
  
  A MultiUserChat.MucCreateConfigFormHandle if the room was created while joining, or null if the room was just joined.
  
  Throws:
  
  SmackException.NoResponseException - if there was no response from the remote entity.
  
  XMPPException.XMPPErrorException - if there was an XMPP error returned.
  
  SmackException.NotConnectedException - if the XMPP connection is not connected.
  
  InterruptedException - if the calling thread was interrupted.
  
  MultiUserChatException.NotAMucServiceException - if the entity is not a MUC service.
- join
  
  public Presence join(Resourcepart nickname) throws SmackException.NoResponseException, XMPPException.XMPPErrorException, SmackException.NotConnectedException, InterruptedException, MultiUserChatException.NotAMucServiceException
  
  Joins the chat room using the specified nickname. If already joined using another nickname, this method will first leave the room and then re-join using the new nickname. The default connection timeout for a reply from the group chat server that the join succeeded will be used. After joining the room, the room will decide the amount of history to send.
  
  Parameters:
  
  nickname - the nickname to use.
  
  Returns:
  
  the leave self-presence as reflected by the MUC.
  
  Throws:
  
  SmackException.NoResponseException - if there was no response from the remote entity.
  
  XMPPException.XMPPErrorException - if an error occurs joining the room. In particular, a 401 error can occur if no password was provided and one is required; or a 403 error can occur if the user is banned; or a 404 error can occur if the room does not exist or is locked; or a 407 error can occur if user is not on the member list; or a 409 error can occur if someone is already in the group chat with the same nickname.
  
  SmackException.NoResponseException - if there was no response from the server.
  
  SmackException.NotConnectedException - if the XMPP connection is not connected.
  
  InterruptedException - if the calling thread was interrupted.
  
  MultiUserChatException.NotAMucServiceException - if the entity is not a MUC service.
- join
  
  public void join(Resourcepart nickname, String password) throws XMPPException.XMPPErrorException, InterruptedException, SmackException.NoResponseException, SmackException.NotConnectedException, MultiUserChatException.NotAMucServiceException
  
  Joins the chat room using the specified nickname and password. If already joined using another nickname, this method will first leave the room and then re-join using the new nickname. The default connection timeout for a reply from the group chat server that the join succeeded will be used. After joining the room, the room will decide the amount of history to send.
  A password is required when joining password protected rooms. If the room does not require a password there is no need to provide one.
  
  Parameters:
  
  nickname - the nickname to use.
  
  password - the password to use.
  
  Throws:
  
  XMPPException.XMPPErrorException - if an error occurs joining the room. In particular, a 401 error can occur if no password was provided and one is required; or a 403 error can occur if the user is banned; or a 404 error can occur if the room does not exist or is locked; or a 407 error can occur if user is not on the member list; or a 409 error can occur if someone is already in the group chat with the same nickname.
  
  InterruptedException - if the calling thread was interrupted.
  
  SmackException.NotConnectedException - if the XMPP connection is not connected.
  
  SmackException.NoResponseException - if there was no response from the server.
  
  MultiUserChatException.NotAMucServiceException - if the entity is not a MUC service.
- join
  
  public Presence join(MucEnterConfiguration mucEnterConfiguration) throws XMPPException.XMPPErrorException, SmackException.NoResponseException, SmackException.NotConnectedException, InterruptedException, MultiUserChatException.NotAMucServiceException
  
  Joins the chat room using the specified nickname and password. If already joined using another nickname, this method will first leave the room and then re-join using the new nickname.
  To control the amount of history to receive while joining a room you will need to provide a configured DiscussionHistory object.
  A password is required when joining password protected rooms. If the room does not require a password there is no need to provide one.
  If the room does not already exist when the user seeks to enter it, the server will decide to create a new room or not.
  
  Parameters:
  
  mucEnterConfiguration - the configuration used to enter the MUC.
  
  Returns:
  
  the join self-presence as reflected by the MUC.
  
  Throws:
  
  XMPPException.XMPPErrorException - if an error occurs joining the room. In particular, a 401 error can occur if no password was provided and one is required; or a 403 error can occur if the user is banned; or a 404 error can occur if the room does not exist or is locked; or a 407 error can occur if user is not on the member list; or a 409 error can occur if someone is already in the group chat with the same nickname.
  
  SmackException.NoResponseException - if there was no response from the server.
  
  SmackException.NotConnectedException - if the XMPP connection is not connected.
  
  InterruptedException - if the calling thread was interrupted.
  
  MultiUserChatException.NotAMucServiceException - if the entity is not a MUC service.
- isJoined
  
  public boolean isJoined()
  
  Returns true if currently in the multi user chat (after calling the join(Resourcepart) method).
  
  Returns:
  
  true if currently in the multi user chat room.
- leave
  
  public Presence leave() throws SmackException.NotConnectedException, InterruptedException, SmackException.NoResponseException, XMPPException.XMPPErrorException, MultiUserChatException.MucNotJoinedException
  
  Leave the chat room.
  
  Returns:
  
  the leave presence as reflected by the MUC.
  
  Throws:
  
  SmackException.NotConnectedException - if the XMPP connection is not connected.
  
  InterruptedException - if the calling thread was interrupted.
  
  XMPPException.XMPPErrorException - if there was an XMPP error returned.
  
  SmackException.NoResponseException - if there was no response from the remote entity.
  
  MultiUserChatException.MucNotJoinedException - if not joined to the Multi-User Chat.
- getConfigFormManager
  
  public MucConfigFormManager getConfigFormManager() throws SmackException.NoResponseException, XMPPException.XMPPErrorException, SmackException.NotConnectedException, InterruptedException
  
  Get a MucConfigFormManager to configure this room.
  Only room owners are able to configure a room.
  Returns:
  
  a MUC configuration form manager for this room.
  
  Throws:
  
  SmackException.NoResponseException - if there was no response from the remote entity.
  
  XMPPException.XMPPErrorException - if there was an XMPP error returned.
  
  SmackException.NotConnectedException - if the XMPP connection is not connected.
  
  InterruptedException - if the calling thread was interrupted.
  
  Since:
  
  4.2
  
  See Also:
  
  XEP-45 § 10.2 Subsequent Room Configuration
- getConfigurationForm
  
  public Form getConfigurationForm() throws SmackException.NoResponseException, XMPPException.XMPPErrorException, SmackException.NotConnectedException, InterruptedException
  
  Returns the room's configuration form that the room's owner can use. The configuration form allows to set the room's language, enable logging, specify room's type, etc.
  
  Returns:
  
  the Form that contains the fields to complete together with the instructions or null if no configuration is possible.
  
  Throws:
  
  XMPPException.XMPPErrorException - if an error occurs asking the configuration form for the room.
  
  SmackException.NoResponseException - if there was no response from the server.
  
  SmackException.NotConnectedException - if the XMPP connection is not connected.
  
  InterruptedException - if the calling thread was interrupted.
- sendConfigurationForm
  
  public void sendConfigurationForm(FillableForm form) throws SmackException.NoResponseException, XMPPException.XMPPErrorException, SmackException.NotConnectedException, InterruptedException
  
  Sends the completed configuration form to the server. The room will be configured with the new settings defined in the form.
  
  Parameters:
  
  form - the form with the new settings.
  
  Throws:
  
  XMPPException.XMPPErrorException - if an error occurs setting the new rooms' configuration.
  
  SmackException.NoResponseException - if there was no response from the server.
  
  SmackException.NotConnectedException - if the XMPP connection is not connected.
  
  InterruptedException - if the calling thread was interrupted.
- getRegistrationForm
  
  public Form getRegistrationForm() throws SmackException.NoResponseException, XMPPException.XMPPErrorException, SmackException.NotConnectedException, InterruptedException
  
  Returns the room's registration form that an unaffiliated user, can use to become a member of the room or null if no registration is possible. Some rooms may restrict the privilege to register members and allow only room admins to add new members.
  If the user requesting registration requirements is not allowed to register with the room (e.g. because that privilege has been restricted), the room will return a "Not Allowed" error to the user (error code 405).
  
  Returns:
  
  the registration Form that contains the fields to complete together with the instructions or null if no registration is possible.
  
  Throws:
  
  XMPPException.XMPPErrorException - if an error occurs asking the registration form for the room or a 405 error if the user is not allowed to register with the room.
  
  SmackException.NoResponseException - if there was no response from the server.
  
  SmackException.NotConnectedException - if the XMPP connection is not connected.
  
  InterruptedException - if the calling thread was interrupted.
- sendRegistrationForm
  
  public void sendRegistrationForm(FillableForm form) throws SmackException.NoResponseException, XMPPException.XMPPErrorException, SmackException.NotConnectedException, InterruptedException
  
  Sends the completed registration form to the server. After the user successfully submits the form, the room may queue the request for review by the room admins or may immediately add the user to the member list by changing the user's affiliation from "none" to "member.
  If the desired room nickname is already reserved for that room, the room will return a "Conflict" error to the user (error code 409). If the room does not support registration, it will return a "Service Unavailable" error to the user (error code 503).
  
  Parameters:
  
  form - the completed registration form.
  
  Throws:
  
  XMPPException.XMPPErrorException - if an error occurs submitting the registration form. In particular, a 409 error can occur if the desired room nickname is already reserved for that room; or a 503 error can occur if the room does not support registration.
  
  SmackException.NoResponseException - if there was no response from the server.
  
  SmackException.NotConnectedException - if the XMPP connection is not connected.
  
  InterruptedException - if the calling thread was interrupted.
- destroy
  
  public void destroy() throws SmackException.NoResponseException, XMPPException.XMPPErrorException, SmackException.NotConnectedException, InterruptedException
  
  Sends a request to destroy the room.
  Throws:
  
  XMPPException.XMPPErrorException - if an error occurs while trying to destroy the room. An error can occur which will be wrapped by an XMPPException -- XMPP error code 403. The error code can be used to present more appropriate error messages to end-users.
  
  SmackException.NoResponseException - if there was no response from the server.
  
  SmackException.NotConnectedException - if the XMPP connection is not connected.
  
  InterruptedException - if the calling thread was interrupted.
  
  Since:
  
  4.5
  
  See Also:
  
  destroy(String, EntityBareJid)
- destroy
  
  public void destroy(String reason, EntityBareJid alternateJID) throws SmackException.NoResponseException, XMPPException.XMPPErrorException, SmackException.NotConnectedException, InterruptedException
  
  Sends a request to the server to destroy the room. The sender of the request should be the room's owner. If the sender of the destroy request is not the room's owner then the server will answer a "Forbidden" error (403).
  
  Parameters:
  
  reason - an optional reason for the room destruction.
  
  alternateJID - an optional JID of an alternate location.
  
  Throws:
  
  XMPPException.XMPPErrorException - if an error occurs while trying to destroy the room. An error can occur which will be wrapped by an XMPPException -- XMPP error code 403. The error code can be used to present more appropriate error messages to end-users.
  
  SmackException.NoResponseException - if there was no response from the server.
  
  SmackException.NotConnectedException - if the XMPP connection is not connected.
  
  InterruptedException - if the calling thread was interrupted.
- destroy
  
  public void destroy(String reason, EntityBareJid alternateJID, String password) throws SmackException.NoResponseException, XMPPException.XMPPErrorException, SmackException.NotConnectedException, InterruptedException
  
  Sends a request to the server to destroy the room. The sender of the request should be the room's owner. If the sender of the destroy request is not the room's owner then the server will answer a "Forbidden" error (403).
  
  Parameters:
  
  reason - an optional reason for the room destruction.
  
  alternateJID - an optional JID of an alternate location.
  
  password - an optional password for the alternate location
  
  Throws:
  
  XMPPException.XMPPErrorException - if an error occurs while trying to destroy the room. An error can occur which will be wrapped by an XMPPException -- XMPP error code 403. The error code can be used to present more appropriate error messages to end-users.
  
  SmackException.NoResponseException - if there was no response from the server.
  
  SmackException.NotConnectedException - if the XMPP connection is not connected.
  
  InterruptedException - if the calling thread was interrupted.
- invite
  
  public void invite(EntityBareJid user, String reason) throws SmackException.NotConnectedException, InterruptedException
  
  Invites another user to the room in which one is an occupant. The invitation will be sent to the room which in turn will forward the invitation to the invitee.
  If the room is password-protected, the invitee will receive a password to use to join the room. If the room is members-only, the invitee may be added to the member list.
  
  Parameters:
  
  user - the user to invite to the room.(e.g. hecate@shakespeare.lit)
  
  reason - the reason why the user is being invited.
  
  Throws:
  
  SmackException.NotConnectedException - if the XMPP connection is not connected.
  
  InterruptedException - if the calling thread was interrupted.
- invite
  
  public void invite(MessageBuilder messageBuilder, EntityBareJid user, String reason) throws SmackException.NotConnectedException, InterruptedException
  
  Invites another user to the room in which one is an occupant using a given Message. The invitation will be sent to the room which in turn will forward the invitation to the invitee.
  If the room is password-protected, the invitee will receive a password to use to join the room. If the room is members-only, the invitee may be added to the member list.
  
  Parameters:
  
  messageBuilder - the message to use for sending the invitation.
  
  user - the user to invite to the room.(e.g. hecate@shakespeare.lit)
  
  reason - the reason why the user is being invited.
  
  Throws:
  
  SmackException.NotConnectedException - if the XMPP connection is not connected.
  
  InterruptedException - if the calling thread was interrupted.
- inviteDirectly
  
  public void inviteDirectly(EntityBareJid address) throws SmackException.NotConnectedException, InterruptedException
  
  Invites another user to the room in which one is an occupant. In contrast to the method "invite", the invitation is sent directly to the user rather than via the chat room. This is useful when the user being invited is offline, as otherwise the invitation would be dropped.
  
  Parameters:
  
  address - the user to send the invitation to
  
  Throws:
  
  SmackException.NotConnectedException - if the XMPP connection is not connected.
  
  InterruptedException - if the calling thread was interrupted.
- inviteDirectly
  
  public void inviteDirectly(EntityBareJid address, String reason, String password, boolean continueAsOneToOneChat, String thread) throws SmackException.NotConnectedException, InterruptedException
  
  Invites another user to the room in which one is an occupant. In contrast to the method "invite", the invitation is sent directly to the user rather than via the chat room. This is useful when the user being invited is offline, as otherwise the invitation would be dropped.
  
  Parameters:
  
  address - the user to send the invitation to
  
  reason - the purpose for the invitation
  
  password - specifies a password needed for entry
  
  continueAsOneToOneChat - specifies if the groupchat room continues a one-to-one chat having the designated thread
  
  thread - the thread to continue
  
  Throws:
  
  SmackException.NotConnectedException - if the XMPP connection is not connected.
  
  InterruptedException - if the calling thread was interrupted.
- addInvitationRejectionListener
  
  public boolean addInvitationRejectionListener(InvitationRejectionListener listener)
  
  Adds a listener to invitation rejections notifications. The listener will be fired anytime an invitation is declined.
  
  Parameters:
  
  listener - an invitation rejection listener.
  
  Returns:
  
  true if the listener was not already added.
- removeInvitationRejectionListener
  
  public boolean removeInvitationRejectionListener(InvitationRejectionListener listener)
  
  Removes a listener from invitation rejections notifications. The listener will be fired anytime an invitation is declined.
  
  Parameters:
  
  listener - an invitation rejection listener.
  
  Returns:
  
  true if the listener was registered and is now removed.
- addSubjectUpdatedListener
  
  public boolean addSubjectUpdatedListener(SubjectUpdatedListener listener)
  
  Adds a listener to subject change notifications. The listener will be fired anytime the room's subject changes.
  
  Parameters:
  
  listener - a subject updated listener.
  
  Returns:
  
  true if the listener was not already added.
- removeSubjectUpdatedListener
  
  public boolean removeSubjectUpdatedListener(SubjectUpdatedListener listener)
  
  Removes a listener from subject change notifications. The listener will be fired anytime the room's subject changes.
  
  Parameters:
  
  listener - a subject updated listener.
  
  Returns:
  
  true if the listener was registered and is now removed.
- addPresenceInterceptor
  
  public void addPresenceInterceptor(Consumer<PresenceBuilder> presenceInterceptor)
  
  Adds a new StanzaListener that will be invoked every time a new presence is going to be sent by this MultiUserChat to the server. Stanza interceptors may add new extensions to the presence that is going to be sent to the MUC service.
  
  Parameters:
  
  presenceInterceptor - the new stanza interceptor that will intercept presence packets.
- removePresenceInterceptor
  
  public void removePresenceInterceptor(Consumer<PresenceBuilder> presenceInterceptor)
  
  Removes a StanzaListener that was being invoked every time a new presence was being sent by this MultiUserChat to the server. Stanza interceptors may add new extensions to the presence that is going to be sent to the MUC service.
  
  Parameters:
  
  presenceInterceptor - the stanza interceptor to remove.
- getSubject
  
  public String getSubject()
  
  Returns the last known room's subject or null if the user hasn't joined the room or the room does not have a subject yet. In case the room has a subject, as soon as the user joins the room a message with the current room's subject will be received.
  To be notified every time the room's subject change you should add a listener to this room. addSubjectUpdatedListener(SubjectUpdatedListener)
  To change the room's subject use changeSubject(String).
  
  Returns:
  
  the room's subject or null if the user hasn't joined the room or the room does not have a subject yet.
- getReservedNickname
  
  public String getReservedNickname() throws SmackException, InterruptedException
  
  Returns the reserved room nickname for the user in the room. A user may have a reserved nickname, for example through explicit room registration or database integration. In such cases it may be desirable for the user to discover the reserved nickname before attempting to enter the room.
  
  Returns:
  
  the reserved room nickname or null if none.
  
  Throws:
  
  SmackException - if there was no response from the server.
  
  InterruptedException - if the calling thread was interrupted.
- getNickname
  
  public Resourcepart getNickname()
  
  Returns the nickname that was used to join the room, or null if not currently joined.
  
  Returns:
  
  the nickname currently being used.
- getMyRoomJid
  
  public EntityFullJid getMyRoomJid()
  
  Return the full JID of the user in the room, or null if the room is not joined.
  
  Returns:
  
  the full JID of the user in the room, or null.
  
  Since:
  
  4.5.0
- changeNickname
  
  public void changeNickname(Resourcepart nickname) throws SmackException.NoResponseException, XMPPException.XMPPErrorException, SmackException.NotConnectedException, InterruptedException, MultiUserChatException.MucNotJoinedException
  
  Changes the occupant's nickname to a new nickname within the room. Each room occupant will receive two presence packets. One of type "unavailable" for the old nickname and one indicating availability for the new nickname. The unavailable presence will contain the new nickname and an appropriate status code (namely 303) as extended presence information. The status code 303 indicates that the occupant is changing his/her nickname.
  
  Parameters:
  
  nickname - the new nickname within the room.
  
  Throws:
  
  XMPPException.XMPPErrorException - if the new nickname is already in use by another occupant.
  
  SmackException.NoResponseException - if there was no response from the server.
  
  SmackException.NotConnectedException - if the XMPP connection is not connected.
  
  InterruptedException - if the calling thread was interrupted.
  
  MultiUserChatException.MucNotJoinedException - if not joined to the Multi-User Chat.
- changeAvailabilityStatus
  
  public void changeAvailabilityStatus(String status, Presence.Mode mode) throws SmackException.NotConnectedException, InterruptedException, MultiUserChatException.MucNotJoinedException
  
  Changes the occupant's availability status within the room. The presence type will remain available but with a new status that describes the presence update and a new presence mode (e.g. Extended away).
  
  Parameters:
  
  status - a text message describing the presence update.
  
  mode - the mode type for the presence update.
  
  Throws:
  
  SmackException.NotConnectedException - if the XMPP connection is not connected.
  
  InterruptedException - if the calling thread was interrupted.
  
  MultiUserChatException.MucNotJoinedException - if not joined to the Multi-User Chat.
- kickParticipant
  
  public void kickParticipant(Resourcepart nickname, String reason) throws XMPPException.XMPPErrorException, SmackException.NoResponseException, SmackException.NotConnectedException, InterruptedException
  
  Kicks a visitor or participant from the room. The kicked occupant will receive a presence of type "unavailable" including a status code 307 and optionally along with the reason (if provided) and the bare JID of the user who initiated the kick. After the occupant was kicked from the room, the rest of the occupants will receive a presence of type "unavailable". The presence will include a status code 307 which means that the occupant was kicked from the room.
  
  Parameters:
  
  nickname - the nickname of the participant or visitor to kick from the room (e.g. "john").
  
  reason - the reason why the participant or visitor is being kicked from the room.
  
  Throws:
  
  XMPPException.XMPPErrorException - if an error occurs kicking the occupant. In particular, a 405 error can occur if a moderator or a user with an affiliation of "owner" or "admin" was intended to be kicked (i.e. Not Allowed error); or a 403 error can occur if the occupant that intended to kick another occupant does not have kicking privileges (i.e. Forbidden error); or a 400 error can occur if the provided nickname is not present in the room.
  
  SmackException.NoResponseException - if there was no response from the server.
  
  SmackException.NotConnectedException - if the XMPP connection is not connected.
  
  InterruptedException - if the calling thread was interrupted.
- requestVoice
  
  public void requestVoice() throws SmackException.NotConnectedException, InterruptedException
  
  Sends a voice request to the MUC. The room moderators usually need to approve this request.
  Throws:
  
  SmackException.NotConnectedException - if the XMPP connection is not connected.
  
  InterruptedException - if the calling thread was interrupted.
  
  Since:
  
  4.1
  
  See Also:
  
  XEP-45 § 7.13 Requesting Voice
- grantVoice
  
  public void grantVoice(Collection<Resourcepart> nicknames) throws XMPPException.XMPPErrorException, SmackException.NoResponseException, SmackException.NotConnectedException, InterruptedException
  
  Grants voice to visitors in the room. In a moderated room, a moderator may want to manage who does and does not have "voice" in the room. To have voice means that a room occupant is able to send messages to the room occupants.
  
  Parameters:
  
  nicknames - the nicknames of the visitors to grant voice in the room (e.g. "john").
  
  Throws:
  
  XMPPException.XMPPErrorException - if an error occurs granting voice to a visitor. In particular, a 403 error can occur if the occupant that intended to grant voice is not a moderator in this room (i.e. Forbidden error); or a 400 error can occur if the provided nickname is not present in the room.
  
  SmackException.NoResponseException - if there was no response from the server.
  
  SmackException.NotConnectedException - if the XMPP connection is not connected.
  
  InterruptedException - if the calling thread was interrupted.
- grantVoice
  
  public void grantVoice(Resourcepart nickname) throws XMPPException.XMPPErrorException, SmackException.NoResponseException, SmackException.NotConnectedException, InterruptedException
  
  Grants voice to a visitor in the room. In a moderated room, a moderator may want to manage who does and does not have "voice" in the room. To have voice means that a room occupant is able to send messages to the room occupants.
  
  Parameters:
  
  nickname - the nickname of the visitor to grant voice in the room (e.g. "john").
  
  Throws:
  
  XMPPException.XMPPErrorException - if an error occurs granting voice to a visitor. In particular, a 403 error can occur if the occupant that intended to grant voice is not a moderator in this room (i.e. Forbidden error); or a 400 error can occur if the provided nickname is not present in the room.
  
  SmackException.NoResponseException - if there was no response from the server.
  
  SmackException.NotConnectedException - if the XMPP connection is not connected.
  
  InterruptedException - if the calling thread was interrupted.
- revokeVoice
  
  public void revokeVoice(Collection<Resourcepart> nicknames) throws XMPPException.XMPPErrorException, SmackException.NoResponseException, SmackException.NotConnectedException, InterruptedException
  
  Revokes voice from participants in the room. In a moderated room, a moderator may want to revoke an occupant's privileges to speak. To have voice means that a room occupant is able to send messages to the room occupants.
  
  Parameters:
  
  nicknames - the nicknames of the participants to revoke voice (e.g. "john").
  
  Throws:
  
  XMPPException.XMPPErrorException - if an error occurs revoking voice from a participant. In particular, a 405 error can occur if a moderator or a user with an affiliation of "owner" or "admin" was tried to revoke his voice (i.e. Not Allowed error); or a 400 error can occur if the provided nickname is not present in the room.
  
  SmackException.NoResponseException - if there was no response from the server.
  
  SmackException.NotConnectedException - if the XMPP connection is not connected.
  
  InterruptedException - if the calling thread was interrupted.
- revokeVoice
  
  public void revokeVoice(Resourcepart nickname) throws XMPPException.XMPPErrorException, SmackException.NoResponseException, SmackException.NotConnectedException, InterruptedException
  
  Revokes voice from a participant in the room. In a moderated room, a moderator may want to revoke an occupant's privileges to speak. To have voice means that a room occupant is able to send messages to the room occupants.
  
  Parameters:
  
  nickname - the nickname of the participant to revoke voice (e.g. "john").
  
  Throws:
  
  XMPPException.XMPPErrorException - if an error occurs revoking voice from a participant. In particular, a 405 error can occur if a moderator or a user with an affiliation of "owner" or "admin" was tried to revoke his voice (i.e. Not Allowed error); or a 400 error can occur if the provided nickname is not present in the room.
  
  SmackException.NoResponseException - if there was no response from the server.
  
  SmackException.NotConnectedException - if the XMPP connection is not connected.
  
  InterruptedException - if the calling thread was interrupted.
- banUsers
  
  public void banUsers(Collection<? extends BareJid> jids) throws XMPPException.XMPPErrorException, SmackException.NoResponseException, SmackException.NotConnectedException, InterruptedException
  
  Bans users from the room. An admin or owner of the room can ban users from a room. This means that the banned user will no longer be able to join the room unless the ban has been removed. If the banned user was present in the room then he/she will be removed from the room and notified that he/she was banned along with the reason (if provided) and the bare XMPP user ID of the user who initiated the ban.
  
  Parameters:
  
  jids - the bare XMPP user IDs of the users to ban.
  
  Throws:
  
  XMPPException.XMPPErrorException - if an error occurs banning a user. In particular, a 405 error can occur if a moderator or a user with an affiliation of "owner" or "admin" was tried to be banned (i.e. Not Allowed error).
  
  SmackException.NoResponseException - if there was no response from the server.
  
  SmackException.NotConnectedException - if the XMPP connection is not connected.
  
  InterruptedException - if the calling thread was interrupted.
- banUser
  
  public void banUser(BareJid jid, String reason) throws XMPPException.XMPPErrorException, SmackException.NoResponseException, SmackException.NotConnectedException, InterruptedException
  
  Bans a user from the room. An admin or owner of the room can ban users from a room. This means that the banned user will no longer be able to join the room unless the ban has been removed. If the banned user was present in the room then he/she will be removed from the room and notified that he/she was banned along with the reason (if provided) and the bare XMPP user ID of the user who initiated the ban.
  
  Parameters:
  
  jid - the bare XMPP user ID of the user to ban (e.g. "user@host.org").
  
  reason - the optional reason why the user was banned.
  
  Throws:
  
  XMPPException.XMPPErrorException - if an error occurs banning a user. In particular, a 405 error can occur if a moderator or a user with an affiliation of "owner" or "admin" was tried to be banned (i.e. Not Allowed error).
  
  SmackException.NoResponseException - if there was no response from the server.
  
  SmackException.NotConnectedException - if the XMPP connection is not connected.
  
  InterruptedException - if the calling thread was interrupted.
- grantMembership
  
  public void grantMembership(Collection<? extends Jid> jids) throws XMPPException.XMPPErrorException, SmackException.NoResponseException, SmackException.NotConnectedException, InterruptedException
  
  Grants membership to other users. Only administrators are able to grant membership. A user that becomes a room member will be able to enter a room of type Members-Only (i.e. a room that a user cannot enter without being on the member list).
  
  Parameters:
  
  jids - the XMPP user IDs of the users to grant membership.
  
  Throws:
  
  XMPPException.XMPPErrorException - if an error occurs granting membership to a user.
  
  SmackException.NoResponseException - if there was no response from the server.
  
  SmackException.NotConnectedException - if the XMPP connection is not connected.
  
  InterruptedException - if the calling thread was interrupted.
- grantMembership
  
  public void grantMembership(BareJid jid) throws XMPPException.XMPPErrorException, SmackException.NoResponseException, SmackException.NotConnectedException, InterruptedException
  
  Grants membership to a user. Only administrators are able to grant membership. A user that becomes a room member will be able to enter a room of type Members-Only (i.e. a room that a user cannot enter without being on the member list).
  
  Parameters:
  
  jid - the XMPP user ID of the user to grant membership (e.g. "user@host.org").
  
  Throws:
  
  XMPPException.XMPPErrorException - if an error occurs granting membership to a user.
  
  SmackException.NoResponseException - if there was no response from the server.
  
  SmackException.NotConnectedException - if the XMPP connection is not connected.
  
  InterruptedException - if the calling thread was interrupted.
- revokeMembership
  
  public void revokeMembership(Collection<? extends BareJid> jids) throws XMPPException.XMPPErrorException, SmackException.NoResponseException, SmackException.NotConnectedException, InterruptedException
  
  Revokes users' membership. Only administrators are able to revoke membership. A user that becomes a room member will be able to enter a room of type Members-Only (i.e. a room that a user cannot enter without being on the member list). If the user is in the room and the room is of type members-only then the user will be removed from the room.
  
  Parameters:
  
  jids - the bare XMPP user IDs of the users to revoke membership.
  
  Throws:
  
  XMPPException.XMPPErrorException - if an error occurs revoking membership to a user.
  
  SmackException.NoResponseException - if there was no response from the server.
  
  SmackException.NotConnectedException - if the XMPP connection is not connected.
  
  InterruptedException - if the calling thread was interrupted.
- revokeMembership
  
  public void revokeMembership(BareJid jid) throws XMPPException.XMPPErrorException, SmackException.NoResponseException, SmackException.NotConnectedException, InterruptedException
  
  Revokes a user's membership. Only administrators are able to revoke membership. A user that becomes a room member will be able to enter a room of type Members-Only (i.e. a room that a user cannot enter without being on the member list). If the user is in the room and the room is of type members-only then the user will be removed from the room.
  
  Parameters:
  
  jid - the bare XMPP user ID of the user to revoke membership (e.g. "user@host.org").
  
  Throws:
  
  XMPPException.XMPPErrorException - if an error occurs revoking membership to a user.
  
  SmackException.NoResponseException - if there was no response from the server.
  
  SmackException.NotConnectedException - if the XMPP connection is not connected.
  
  InterruptedException - if the calling thread was interrupted.
- grantModerator
  
  public void grantModerator(Collection<Resourcepart> nicknames) throws XMPPException.XMPPErrorException, SmackException.NoResponseException, SmackException.NotConnectedException, InterruptedException
  
  Grants moderator privileges to participants or visitors. Room administrators may grant moderator privileges. A moderator is allowed to kick users, grant and revoke voice, invite other users, modify room's subject plus all the participant privileges.
  
  Parameters:
  
  nicknames - the nicknames of the occupants to grant moderator privileges.
  
  Throws:
  
  XMPPException.XMPPErrorException - if an error occurs granting moderator privileges to a user.
  
  SmackException.NoResponseException - if there was no response from the server.
  
  SmackException.NotConnectedException - if the XMPP connection is not connected.
  
  InterruptedException - if the calling thread was interrupted.
- grantModerator
  
  public void grantModerator(Resourcepart nickname) throws XMPPException.XMPPErrorException, SmackException.NoResponseException, SmackException.NotConnectedException, InterruptedException
  
  Grants moderator privileges to a participant or visitor. Room administrators may grant moderator privileges. A moderator is allowed to kick users, grant and revoke voice, invite other users, modify room's subject plus all the participant privileges.
  
  Parameters:
  
  nickname - the nickname of the occupant to grant moderator privileges.
  
  Throws:
  
  XMPPException.XMPPErrorException - if an error occurs granting moderator privileges to a user.
  
  SmackException.NoResponseException - if there was no response from the server.
  
  SmackException.NotConnectedException - if the XMPP connection is not connected.
  
  InterruptedException - if the calling thread was interrupted.
- revokeModerator
  
  public void revokeModerator(Collection<Resourcepart> nicknames) throws XMPPException.XMPPErrorException, SmackException.NoResponseException, SmackException.NotConnectedException, InterruptedException
  
  Revokes moderator privileges from other users. The occupant that loses moderator privileges will become a participant. Room administrators may revoke moderator privileges only to occupants whose affiliation is member or none. This means that an administrator is not allowed to revoke moderator privileges from other room administrators or owners.
  
  Parameters:
  
  nicknames - the nicknames of the occupants to revoke moderator privileges.
  
  Throws:
  
  XMPPException.XMPPErrorException - if an error occurs revoking moderator privileges from a user.
  
  SmackException.NoResponseException - if there was no response from the server.
  
  SmackException.NotConnectedException - if the XMPP connection is not connected.
  
  InterruptedException - if the calling thread was interrupted.
- revokeModerator
  
  public void revokeModerator(Resourcepart nickname) throws XMPPException.XMPPErrorException, SmackException.NoResponseException, SmackException.NotConnectedException, InterruptedException
  
  Revokes moderator privileges from another user. The occupant that loses moderator privileges will become a participant. Room administrators may revoke moderator privileges only to occupants whose affiliation is member or none. This means that an administrator is not allowed to revoke moderator privileges from other room administrators or owners.
  
  Parameters:
  
  nickname - the nickname of the occupant to revoke moderator privileges.
  
  Throws:
  
  XMPPException.XMPPErrorException - if an error occurs revoking moderator privileges from a user.
  
  SmackException.NoResponseException - if there was no response from the server.
  
  SmackException.NotConnectedException - if the XMPP connection is not connected.
  
  InterruptedException - if the calling thread was interrupted.
- grantOwnership
  
  public void grantOwnership(Collection<? extends BareJid> jids) throws XMPPException.XMPPErrorException, SmackException.NoResponseException, SmackException.NotConnectedException, InterruptedException
  
  Grants ownership privileges to other users. Room owners may grant ownership privileges. Some room implementations will not allow to grant ownership privileges to other users. An owner is allowed to change defining room features as well as perform all administrative functions.
  
  Parameters:
  
  jids - the collection of bare XMPP user IDs of the users to grant ownership.
  
  Throws:
  
  XMPPException.XMPPErrorException - if an error occurs granting ownership privileges to a user.
  
  SmackException.NoResponseException - if there was no response from the server.
  
  SmackException.NotConnectedException - if the XMPP connection is not connected.
  
  InterruptedException - if the calling thread was interrupted.
- grantOwnership
  
  public void grantOwnership(BareJid jid) throws XMPPException.XMPPErrorException, SmackException.NoResponseException, SmackException.NotConnectedException, InterruptedException
  
  Grants ownership privileges to another user. Room owners may grant ownership privileges. Some room implementations will not allow to grant ownership privileges to other users. An owner is allowed to change defining room features as well as perform all administrative functions.
  
  Parameters:
  
  jid - the bare XMPP user ID of the user to grant ownership (e.g. "user@host.org").
  
  Throws:
  
  XMPPException.XMPPErrorException - if an error occurs granting ownership privileges to a user.
  
  SmackException.NoResponseException - if there was no response from the server.
  
  SmackException.NotConnectedException - if the XMPP connection is not connected.
  
  InterruptedException - if the calling thread was interrupted.
- revokeOwnership
  
  public void revokeOwnership(Collection<? extends BareJid> jids) throws XMPPException.XMPPErrorException, SmackException.NoResponseException, SmackException.NotConnectedException, InterruptedException
  
  Revokes ownership privileges from other users. The occupant that loses ownership privileges will become an administrator. Room owners may revoke ownership privileges. Some room implementations will not allow to grant ownership privileges to other users.
  
  Parameters:
  
  jids - the bare XMPP user IDs of the users to revoke ownership.
  
  Throws:
  
  XMPPException.XMPPErrorException - if an error occurs revoking ownership privileges from a user.
  
  SmackException.NoResponseException - if there was no response from the server.
  
  SmackException.NotConnectedException - if the XMPP connection is not connected.
  
  InterruptedException - if the calling thread was interrupted.
- revokeOwnership
  
  public void revokeOwnership(BareJid jid) throws XMPPException.XMPPErrorException, SmackException.NoResponseException, SmackException.NotConnectedException, InterruptedException
  
  Revokes ownership privileges from another user. The occupant that loses ownership privileges will become an administrator. Room owners may revoke ownership privileges. Some room implementations will not allow to grant ownership privileges to other users.
  
  Parameters:
  
  jid - the bare XMPP user ID of the user to revoke ownership (e.g. "user@host.org").
  
  Throws:
  
  XMPPException.XMPPErrorException - if an error occurs revoking ownership privileges from a user.
  
  SmackException.NoResponseException - if there was no response from the server.
  
  SmackException.NotConnectedException - if the XMPP connection is not connected.
  
  InterruptedException - if the calling thread was interrupted.
- grantAdmin
  
  public void grantAdmin(Collection<? extends BareJid> jids) throws XMPPException.XMPPErrorException, SmackException.NoResponseException, SmackException.NotConnectedException, InterruptedException
  
  Grants administrator privileges to other users. Room owners may grant administrator privileges to a member or unaffiliated user. An administrator is allowed to perform administrative functions such as banning users and edit moderator list.
  
  Parameters:
  
  jids - the bare XMPP user IDs of the users to grant administrator privileges.
  
  Throws:
  
  XMPPException.XMPPErrorException - if an error occurs granting administrator privileges to a user.
  
  SmackException.NoResponseException - if there was no response from the server.
  
  SmackException.NotConnectedException - if the XMPP connection is not connected.
  
  InterruptedException - if the calling thread was interrupted.
- grantAdmin
  
  public void grantAdmin(BareJid jid) throws XMPPException.XMPPErrorException, SmackException.NoResponseException, SmackException.NotConnectedException, InterruptedException
  
  Grants administrator privileges to another user. Room owners may grant administrator privileges to a member or unaffiliated user. An administrator is allowed to perform administrative functions such as banning users and edit moderator list.
  
  Parameters:
  
  jid - the bare XMPP user ID of the user to grant administrator privileges (e.g. "user@host.org").
  
  Throws:
  
  XMPPException.XMPPErrorException - if an error occurs granting administrator privileges to a user.
  
  SmackException.NoResponseException - if there was no response from the server.
  
  SmackException.NotConnectedException - if the XMPP connection is not connected.
  
  InterruptedException - if the calling thread was interrupted.
- revokeAdmin
  
  public void revokeAdmin(Collection<? extends BareJid> jids) throws XMPPException.XMPPErrorException, SmackException.NoResponseException, SmackException.NotConnectedException, InterruptedException
  
  Revokes administrator privileges from users. The occupant that loses administrator privileges will become a member. Room owners may revoke administrator privileges from a member or unaffiliated user.
  
  Parameters:
  
  jids - the bare XMPP user IDs of the user to revoke administrator privileges.
  
  Throws:
  
  XMPPException.XMPPErrorException - if an error occurs revoking administrator privileges from a user.
  
  SmackException.NoResponseException - if there was no response from the server.
  
  SmackException.NotConnectedException - if the XMPP connection is not connected.
  
  InterruptedException - if the calling thread was interrupted.
- revokeAdmin
  
  public void revokeAdmin(BareJid jid) throws XMPPException.XMPPErrorException, SmackException.NoResponseException, SmackException.NotConnectedException, InterruptedException
  
  Revokes administrator privileges from a user. The occupant that loses administrator privileges will become a member. Room owners may revoke administrator privileges from a member or unaffiliated user.
  
  Parameters:
  
  jid - the bare XMPP user ID of the user to revoke administrator privileges (e.g. "user@host.org").
  
  Throws:
  
  XMPPException.XMPPErrorException - if an error occurs revoking administrator privileges from a user.
  
  SmackException.NoResponseException - if there was no response from the server.
  
  SmackException.NotConnectedException - if the XMPP connection is not connected.
  
  InterruptedException - if the calling thread was interrupted.
- getOccupantsCount
  
  public int getOccupantsCount()
  
  Returns the number of occupants in the group chat.
  Note: this value will only be accurate after joining the group chat, and may fluctuate over time. If you query this value directly after joining the group chat it may not be accurate, as it takes a certain amount of time for the server to send all presence packets to this client.
  
  Returns:
  
  the number of occupants in the group chat.
- getOccupants
  
  public List<EntityFullJid> getOccupants()
  
  Returns an List for the list of fully qualified occupants in the group chat. For example, "conference@chat.jivesoftware.com/SomeUser". Typically, a client would only display the nickname of the occupant. To get the nickname from the fully qualified name, use the XmppStringUtils.parseResource(String) method. Note: this value will only be accurate after joining the group chat, and may fluctuate over time.
  
  Returns:
  
  a List of the occupants in the group chat.
- getOccupantPresence
  
  public Presence getOccupantPresence(EntityFullJid user)
  
  Returns the presence info for a particular user, or null if the user is not in the room.
  
  Parameters:
  
  user - the room occupant to search for his presence. The format of user must be: roomName@service/nickname (e.g. darkcave@macbeth.shakespeare.lit/thirdwitch).
  
  Returns:
  
  the occupant's current presence, or null if the user is unavailable or if no presence information is available.
- getOccupant
  
  public Occupant getOccupant(EntityFullJid user)
  
  Returns the Occupant information for a particular occupant, or null if the user is not in the room. The Occupant object may include information such as full JID of the user as well as the role and affiliation of the user in the room.
  
  Parameters:
  
  user - the room occupant to search for his presence. The format of user must be: roomName@service/nickname (e.g. darkcave@macbeth.shakespeare.lit/thirdwitch).
  
  Returns:
  
  the Occupant or null if the user is unavailable (i.e. not in the room).
- addParticipantListener
  
  public boolean addParticipantListener(PresenceListener listener)
  
  Adds a stanza listener that will be notified of any new Presence packets sent to the group chat. Using a listener is a suitable way to know when the list of occupants should be re-loaded due to any changes.
  
  Parameters:
  
  listener - a stanza listener that will be notified of any presence packets sent to the group chat.
  
  Returns:
  
  true if the listener was not already added.
- removeParticipantListener
  
  public boolean removeParticipantListener(PresenceListener listener)
  
  Removes a stanza listener that was being notified of any new Presence packets sent to the group chat.
  
  Parameters:
  
  listener - a stanza listener that was being notified of any presence packets sent to the group chat.
  
  Returns:
  
  true if the listener was removed, otherwise the listener was not added previously.
- getOwners
  
  public List<Affiliate> getOwners() throws SmackException.NoResponseException, XMPPException.XMPPErrorException, SmackException.NotConnectedException, InterruptedException
  
  Returns a list of Affiliate with the room owners.
  
  Returns:
  
  a list of Affiliate with the room owners.
  
  Throws:
  
  XMPPException.XMPPErrorException - if you don't have enough privileges to get this information.
  
  SmackException.NoResponseException - if there was no response from the server.
  
  SmackException.NotConnectedException - if the XMPP connection is not connected.
  
  InterruptedException - if the calling thread was interrupted.
- getAdmins
  
  public List<Affiliate> getAdmins() throws SmackException.NoResponseException, XMPPException.XMPPErrorException, SmackException.NotConnectedException, InterruptedException
  
  Returns a list of Affiliate with the room administrators.
  
  Returns:
  
  a list of Affiliate with the room administrators.
  
  Throws:
  
  XMPPException.XMPPErrorException - if you don't have enough privileges to get this information.
  
  SmackException.NoResponseException - if there was no response from the server.
  
  SmackException.NotConnectedException - if the XMPP connection is not connected.
  
  InterruptedException - if the calling thread was interrupted.
- getMembers
  
  public List<Affiliate> getMembers() throws SmackException.NoResponseException, XMPPException.XMPPErrorException, SmackException.NotConnectedException, InterruptedException
  
  Returns a list of Affiliate with the room members.
  
  Returns:
  
  a list of Affiliate with the room members.
  
  Throws:
  
  XMPPException.XMPPErrorException - if you don't have enough privileges to get this information.
  
  SmackException.NoResponseException - if there was no response from the server.
  
  SmackException.NotConnectedException - if the XMPP connection is not connected.
  
  InterruptedException - if the calling thread was interrupted.
- getOutcasts
  
  public List<Affiliate> getOutcasts() throws SmackException.NoResponseException, XMPPException.XMPPErrorException, SmackException.NotConnectedException, InterruptedException
  
  Returns a list of Affiliate with the room outcasts.
  
  Returns:
  
  a list of Affiliate with the room outcasts.
  
  Throws:
  
  XMPPException.XMPPErrorException - if you don't have enough privileges to get this information.
  
  SmackException.NoResponseException - if there was no response from the server.
  
  SmackException.NotConnectedException - if the XMPP connection is not connected.
  
  InterruptedException - if the calling thread was interrupted.
- getModerators
  
  public List<Occupant> getModerators() throws SmackException.NoResponseException, XMPPException.XMPPErrorException, SmackException.NotConnectedException, InterruptedException
  
  Returns a list of Occupant with the room moderators.
  
  Returns:
  
  a list of Occupant with the room moderators.
  
  Throws:
  
  XMPPException.XMPPErrorException - if you don't have enough privileges to get this information.
  
  SmackException.NoResponseException - if there was no response from the server.
  
  SmackException.NotConnectedException - if the XMPP connection is not connected.
  
  InterruptedException - if the calling thread was interrupted.
- getParticipants
  
  public List<Occupant> getParticipants() throws SmackException.NoResponseException, XMPPException.XMPPErrorException, SmackException.NotConnectedException, InterruptedException
  
  Returns a list of Occupant with the room participants.
  
  Returns:
  
  a list of Occupant with the room participants.
  
  Throws:
  
  XMPPException.XMPPErrorException - if you don't have enough privileges to get this information.
  
  SmackException.NoResponseException - if there was no response from the server.
  
  SmackException.NotConnectedException - if the XMPP connection is not connected.
  
  InterruptedException - if the calling thread was interrupted.
- sendMessage
  
  public void sendMessage(String text) throws SmackException.NotConnectedException, InterruptedException
  
  Sends a message to the chat room.
  
  Parameters:
  
  text - the text of the message to send.
  
  Throws:
  
  SmackException.NotConnectedException - if the XMPP connection is not connected.
  
  InterruptedException - if the calling thread was interrupted.
- createPrivateChat
  
  public Chat createPrivateChat(EntityFullJid occupant, ChatMessageListener listener)
  
  Returns a new Chat for sending private messages to a given room occupant. The Chat's occupant address is the room's JID (i.e. roomName@service/nick). The server service will change the 'from' address to the sender's room JID and delivering the message to the intended recipient's full JID.
  
  Parameters:
  
  occupant - occupant unique room JID (e.g. 'darkcave@macbeth.shakespeare.lit/Paul').
  
  listener - the listener is a message listener that will handle messages for the newly created chat.
  
  Returns:
  
  new Chat for sending private messages to a given room occupant.
- createMessage
  
  @Deprecated public Message createMessage()
  
  Deprecated.
  use buildMessage() instead.
  
  Creates a new Message to send to the chat room.
  
  Returns:
  
  a new Message addressed to the chat room.
- buildMessage
  
  public MessageBuilder buildMessage()
  
  Constructs a new message builder for messages send to this MUC room.
  
  Returns:
  
  a new message builder.
- sendMessage
  
  public MessageView sendMessage(MessageBuilder messageBuilder) throws SmackException.NotConnectedException, InterruptedException
  
  Sends a Message to the chat room.
  
  Parameters:
  
  messageBuilder - the message.
  
  Returns:
  
  a read-only view of the send message.
  
  Throws:
  
  SmackException.NotConnectedException - if the XMPP connection is not connected.
  
  InterruptedException - if the calling thread was interrupted.
- pollMessage
  
  public Message pollMessage() throws MultiUserChatException.MucNotJoinedException
  
  Polls for and returns the next message, or null if there isn't a message immediately available. This method provides significantly different functionality than the nextMessage() method since it's non-blocking. In other words, the method call will always return immediately, whereas the nextMessage method will return only when a message is available (or after a specific timeout).
  
  Returns:
  
  the next message if one is immediately available and null otherwise.
  
  Throws:
  
  MultiUserChatException.MucNotJoinedException - if not joined to the Multi-User Chat.
- nextMessage
  
  public Message nextMessage() throws MultiUserChatException.MucNotJoinedException, InterruptedException
  
  Returns the next available message in the chat. The method call will block (not return) until a message is available.
  
  Returns:
  
  the next message.
  
  Throws:
  
  MultiUserChatException.MucNotJoinedException - if not joined to the Multi-User Chat.
  
  InterruptedException - if the calling thread was interrupted.
- nextMessage
  
  public Message nextMessage(long timeout) throws MultiUserChatException.MucNotJoinedException, InterruptedException
  
  Returns the next available message in the chat. The method call will block (not return) until a stanza is available or the timeout has elapsed. If the timeout elapses without a result, null will be returned.
  
  Parameters:
  
  timeout - the maximum amount of time to wait for the next message.
  
  Returns:
  
  the next message, or null if the timeout elapses without a message becoming available.
  
  Throws:
  
  MultiUserChatException.MucNotJoinedException - if not joined to the Multi-User Chat.
  
  InterruptedException - if the calling thread was interrupted.
- addMessageListener
  
  public boolean addMessageListener(MessageListener listener)
  
  Adds a stanza listener that will be notified of any new messages in the group chat. Only "group chat" messages addressed to this group chat will be delivered to the listener. If you wish to listen for other packets that may be associated with this group chat, you should register a PacketListener directly with the XMPPConnection with the appropriate PacketListener.
  
  Parameters:
  
  listener - a stanza listener.
  
  Returns:
  
  true if the listener was not already added.
- removeMessageListener
  
  public boolean removeMessageListener(MessageListener listener)
  
  Removes a stanza listener that was being notified of any new messages in the multi user chat. Only "group chat" messages addressed to this multi user chat were being delivered to the listener.
  
  Parameters:
  
  listener - a stanza listener.
  
  Returns:
  
  true if the listener was removed, otherwise the listener was not added previously.
- addMessageInterceptor
  
  public boolean addMessageInterceptor(MucMessageInterceptor interceptor)
- removeMessageInterceptor
  
  public boolean removeMessageInterceptor(MucMessageInterceptor interceptor)
- changeSubject
  
  public void changeSubject(String subject) throws SmackException.NoResponseException, XMPPException.XMPPErrorException, SmackException.NotConnectedException, InterruptedException
  
  Changes the subject within the room. As a default, only users with a role of "moderator" are allowed to change the subject in a room. Although some rooms may be configured to allow a mere participant or even a visitor to change the subject.
  
  Parameters:
  
  subject - the new room's subject to set.
  
  Throws:
  
  XMPPException.XMPPErrorException - if someone without appropriate privileges attempts to change the room subject will throw an error with code 403 (i.e. Forbidden)
  
  SmackException.NoResponseException - if there was no response from the server.
  
  SmackException.NotConnectedException - if the XMPP connection is not connected.
  
  InterruptedException - if the calling thread was interrupted.
- addUserStatusListener
  
  public boolean addUserStatusListener(UserStatusListener listener)
  
  Adds a listener that will be notified of changes in your status in the room such as the user being kicked, banned, or granted admin permissions.
  
  Parameters:
  
  listener - a user status listener.
  
  Returns:
  
  true if the user status listener was not already added.
- removeUserStatusListener
  
  public boolean removeUserStatusListener(UserStatusListener listener)
  
  Removes a listener that was being notified of changes in your status in the room such as the user being kicked, banned, or granted admin permissions.
  
  Parameters:
  
  listener - a user status listener.
  
  Returns:
  
  true if the listener was registered and is now removed.
- addParticipantStatusListener
  
  public boolean addParticipantStatusListener(ParticipantStatusListener listener)
  
  Adds a listener that will be notified of changes in occupants status in the room such as the user being kicked, banned, or granted admin permissions.
  
  Parameters:
  
  listener - a participant status listener.
  
  Returns:
  
  true if the listener was not already added.
- removeParticipantStatusListener
  
  public boolean removeParticipantStatusListener(ParticipantStatusListener listener)
  
  Removes a listener that was being notified of changes in occupants status in the room such as the user being kicked, banned, or granted admin permissions.
  
  Parameters:
  
  listener - a participant status listener.
  
  Returns:
  
  true if the listener was registered and is now removed.
- getXmppConnection
  
  public XMPPConnection getXmppConnection()
  
  Get the XMPP connection associated with this chat instance.
  
  Returns:
  
  the associated XMPP connection.
  
  Since:
  
  4.3.0
- serviceSupportsStableIds
  
  public boolean serviceSupportsStableIds()
- toString
  
  public String toString()
  
  Overrides:
  
  toString in class Object

Class MultiUserChat

Nested Class Summary

Method Summary

Methods inherited from class java.lang.Object

Method Details

getRoom

getEnterConfigurationBuilder

create

createOrJoin

createOrJoin

createOrJoinIfNecessary

join

join

join

isJoined

leave

getConfigFormManager

getConfigurationForm

sendConfigurationForm

getRegistrationForm

sendRegistrationForm

destroy

destroy

destroy

invite

invite

inviteDirectly

inviteDirectly

addInvitationRejectionListener

removeInvitationRejectionListener

addSubjectUpdatedListener

removeSubjectUpdatedListener

addPresenceInterceptor

removePresenceInterceptor

getSubject

getReservedNickname

getNickname

getMyRoomJid

changeNickname

changeAvailabilityStatus

kickParticipant

requestVoice

grantVoice

grantVoice

revokeVoice

revokeVoice

banUsers

banUser

grantMembership

grantMembership

revokeMembership

revokeMembership

grantModerator

grantModerator

revokeModerator

revokeModerator

grantOwnership

grantOwnership

revokeOwnership

revokeOwnership

grantAdmin

grantAdmin

revokeAdmin

revokeAdmin

getOccupantsCount

getOccupants

getOccupantPresence

getOccupant

addParticipantListener

removeParticipantListener

getOwners

getAdmins

getMembers

getOutcasts

getModerators

getParticipants

sendMessage

createPrivateChat

createMessage

buildMessage