rocks.xmpp.core.session

Class ChatSession

java.lang.Object

rocks.xmpp.core.session.ChatSession

public final class ChatSession
extends Object

Implements a one-to-one chat session. They are described in 5.1. One-to-One Chat Sessions and XEP-0201: Best Practices for Message Threads.

5.1. One-to-One Chat Sessions

In practice, instant messaging activity between human users tends to occur in the form of a conversational burst that we call a "chat session": the exchange of multiple messages between two parties in relatively rapid succession within a relatively brief period of time.

In order to create a new chat session, use the chat manager.

Method Summary

Modifier and Type	Method and Description
void	addMessageListener(MessageListener stanzaListener) Adds a message listener, which will get notified, whenever a chat message has been received for this chat session.
Jid	getChatPartner() Gets the chat partner of this chat session.
String	getThread() Gets the thread id which is used for this chat session.
void	removeMessageListener(MessageListener stanzaListener) Removes a previously added message listener.
void	send(Message message) Sends a chat message to the chat partner.

Methods inherited from class java.lang.Object

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

Method Detail

addMessageListener

public void addMessageListener(MessageListener stanzaListener)

Adds a message listener, which will get notified, whenever a chat message has been received for this chat session.

Parameters:

stanzaListener - The listener.

See Also:

removeMessageListener(rocks.xmpp.core.stanza.MessageListener)

removeMessageListener

public void removeMessageListener(MessageListener stanzaListener)

Removes a previously added message listener.

Parameters:

stanzaListener - The listener.

See Also:

addMessageListener(rocks.xmpp.core.stanza.MessageListener)

send

public void send(Message message)

Sends a chat message to the chat partner.

Parameters:

message - The message.

getChatPartner

public Jid getChatPartner()

Gets the chat partner of this chat session.

Returns:

The chat partner.

getThread

public String getThread()

Gets the thread id which is used for this chat session.

Returns:

The thread id.