From 85dcb0a5c45ecc224499d9988bd81755a734b087 Mon Sep 17 00:00:00 2001 From: Matt Tucker Date: Thu, 8 Feb 2007 06:12:01 +0000 Subject: [PATCH] Updated for new API. Thanks to Michael Hunter. git-svn-id: http://svn.igniterealtime.org/svn/repos/smack/trunk@7042 b35dd754-fafc-0310-a699-88a17e54d16e --- documentation/messaging.html | 74 +++++++++++++++++++++--------------- 1 file changed, 44 insertions(+), 30 deletions(-) diff --git a/documentation/messaging.html b/documentation/messaging.html index d9fc8c708..bf3856d15 100644 --- a/documentation/messaging.html +++ b/documentation/messaging.html @@ -1,74 +1,88 @@ - Smack: Chat - Jive Software - + Smack: Chat - Jive Software +
-Messaging using Chats + Messaging using Chats
-« Table of Contents + « Table of Contents

-Sending messages back and forth is at the core of instant messaging. Although individual messages -can be sent and received as packets, it's generally easier to treat the string of messages -as a chat using the org.jivesoftware.smack.Chat class. + Sending messages back and forth is at the core of instant messaging. Although individual + messages + can be sent and received as packets, it's generally easier to treat the string of messages + as a chat using the org.jivesoftware.smack.Chat class.

-Chat + Chat

-A chat creates a new thread of messages (using a thread ID) between two users. The +A chat creates a new thread of messages (using a thread ID) between two users. The following code snippet demonstrates how to create a new Chat with a user and then send them a text message:

-

-// Assume we've created an XMPPConnection name "connection".
-Chat newChat = connection.createChat("jsmith@jivesoftware.com", new MessageListener() {
+
// Assume we've created an XMPPConnection name
+    "connection". 
+ChatManager chatmanager = connection.getChatManager();
Chat newChat = chatmanager.createChat("jsmith@jivesoftware.com", new MessageListener() {
 
     public void processMessage(Chat chat, Message message) {
-        System.out.println("Received message: " + message);
-    }
-});
-chat.sendMessage("Howdy!");
-

+        System.out.println("Received message: " + message); 
+    } 
+}); 
try {
+    chat.sendMessage("Howdy!"); 
} catch (XMPPException e) {
    System.out.println("Error Delivering block");
}


+
+
+

-The Chat.sendMessage(String) method is a convenience method that creates a Message -object, sets the body using the String parameter, then sends the message. In the case -that you wish to set additional values on a Message before sending it, use the -Chat.createMessage() and Chat.sendMessage(Message) methods, as in the -following code snippet:

+ The Chat.sendMessage(String) method is a convenience method that creates a Message + object, sets the body using the String parameter, then sends the message. In the case + that you wish to set additional values on a Message before sending it, use the + Chat.createMessage() and Chat.sendMessage(Message) methods, as in the + following code snippet: + +

 Message newMessage = newChat.createMessage();
 newMessage.setBody("Howdy!");
 message.setProperty("favoriteColor", "red");
 newChat.sendMessage(newMessage);
-

+ + +

-You'll also notice in the example above that we specified a MessageListener when creating a chat. -The listener is notified any time a new message arrives from the other user in the chat. -The following code snippet uses the listener as a parrot-bot -- it echoes back everything the other user types.

+ You'll also notice in the example above that we specified a MessageListener when creating a + chat. + The listener is notified any time a new message arrives from the other user in the chat. + The following code snippet uses the listener as a parrot-bot -- it echoes back everything the + other user types. + +

-    // Assume a MessageListener we've setup with a chat.
+ // Assume a MessageListener we've setup with a chat.
 
     public void processMessage(Chat chat, Message message) {
         // Send back the same text the other user sent us.
         chat.sendMessage(message.getBody());
     }
-

+ + +

-


+


-Copyright © Jive Software 2002-2007 + Copyright © Jive Software 2002-2007