rocks.xmpp.extensions.muc

Class ChatService

java.lang.Object

rocks.xmpp.extensions.muc.ChatService

public final class ChatService
extends Object

A chat service hosts chat rooms. It allows you to discover public chat rooms or create new (instant) rooms, if allowed by the service.

You get an instance of this class by either using the MultiUserChatManager.createChatService(rocks.xmpp.core.Jid) method or by discovering the chat services at your connected domain.

Author:

Christian Schudt

See Also:

MultiUserChatManager.createChatService(rocks.xmpp.core.Jid)

Method Summary

Modifier and Type	Method and Description
ChatRoom	createRoom(String room) Creates a new chat room.
rocks.xmpp.core.Jid	getAddress() Gets the service address.
List<ChatRoom>	getPublicRooms() Gets the list of public chat rooms hosted by this chat service.
String	toString()

Methods inherited from class java.lang.Object

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

Method Detail

getPublicRooms

public List<ChatRoom> getPublicRooms()
                              throws rocks.xmpp.core.XmppException

Gets the list of public chat rooms hosted by this chat service.

Returns:

The public rooms.

Throws:

rocks.xmpp.core.stanza.model.StanzaException - If the chat service returned a stanza error.

NoResponseException - If the chat service did not respond.

rocks.xmpp.core.XmppException

createRoom

public ChatRoom createRoom(String room)

Creates a new chat room. Note that this room is only created locally.

Parameters:

room - The room. This is the local part of the room address, e.g. room@service.

Returns:

The chat room.

getAddress

public rocks.xmpp.core.Jid getAddress()

Gets the service address.

Returns:

The service address.

toString

public String toString()

Overrides:

toString in class Object