rocks.xmpp.core.session

Class ChatManager

java.lang.Object

rocks.xmpp.core.session.ChatManager

public final class ChatManager
extends Object

This class manages one-to-one chat sessions, which are described in 5.1. One-to-One Chat Sessions and XEP-0201: Best Practices for Message Threads.

Creating a new chat session

 ChatSession chatSession = xmppSession.getChatManager().createChatSession(chatPartner);
 

Listen for new chat sessions

When a contact initiates a new chat session with you, you can listen for it with the ChatSessionListener. The listener will be called either if you created the session programmatically as shown above, or if it is created by a contact, i.e. because he or she sent you a chat message.

You should add a MessageListener to the chat session in order to listen for messages.

 xmppSession.getChatManager().addChatSessionListener(new ChatSessionListener() {
      @Override
     public void chatSessionCreated(ChatSessionEvent chatSessionEvent) {
         ChatSession chatSession = chatSessionEvent.getChatSession();
         chatSession.addMessageListener(new MessageListener() {
              @Override
             public void handle(MessageEvent e) {
                 Message message = e.getMessage();
             }
         });
     }
 });
 
 

Constructor Summary

Constructors

Constructor and Description
ChatManager(XmppSession xmppSession) Creates the chat manager.

Method Summary

Modifier and Type	Method and Description
void	addChatSessionListener(ChatSessionListener chatSessionListener) Adds a chat session listener.
ChatSession	createChatSession(Jid chatPartner) Creates a new chat session and notifies any chat session listeners about it.
void	destroyChatSession(ChatSession chatSession) Destroys the chat session.
void	removeChatSessionListener(ChatSessionListener chatSessionListener) Removes a previously added chat session listener.

Methods inherited from class java.lang.Object

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

Constructor Detail

ChatManager

public ChatManager(XmppSession xmppSession)

Creates the chat manager.

Parameters:

xmppSession - The connection.

Method Detail

addChatSessionListener

public void addChatSessionListener(ChatSessionListener chatSessionListener)

Adds a chat session listener.

Parameters:

chatSessionListener - The listener.

See Also:

removeChatSessionListener(ChatSessionListener)

removeChatSessionListener

public void removeChatSessionListener(ChatSessionListener chatSessionListener)

Removes a previously added chat session listener.

Parameters:

chatSessionListener - The listener.

See Also:

addChatSessionListener(ChatSessionListener)

createChatSession

public ChatSession createChatSession(Jid chatPartner)

Creates a new chat session and notifies any chat session listeners about it.

Parameters:

chatPartner - The chat partner.

Returns:

The chat session.

destroyChatSession

public void destroyChatSession(ChatSession chatSession)

Destroys the chat session.

Parameters:

chatSession - The chat session.