mirror of
https://codeberg.org/Mercury-IM/Smack
synced 2024-12-23 21:17:58 +01:00
comments modified to display fine in javadoc
git-svn-id: http://svn.igniterealtime.org/svn/repos/smack/trunk@2034 b35dd754-fafc-0310-a699-88a17e54d16e
This commit is contained in:
parent
69f8d71a65
commit
e516bf8730
2 changed files with 36 additions and 28 deletions
|
@ -58,11 +58,13 @@ package org.jivesoftware.smackx;
|
||||||
* Message event requests are received when the received message includes an extension
|
* Message event requests are received when the received message includes an extension
|
||||||
* like this:
|
* like this:
|
||||||
*
|
*
|
||||||
* <x xmlns='jabber:x:event'>
|
* <pre>
|
||||||
* <offline/>
|
* <x xmlns='jabber:x:event'>
|
||||||
* <delivered/>
|
* <offline/>
|
||||||
* <composing/>
|
* <delivered/>
|
||||||
* </x>
|
* <composing/>
|
||||||
|
* </x>
|
||||||
|
* </pre>
|
||||||
*
|
*
|
||||||
* In this example you can see that the sender of the message requests to be notified
|
* In this example you can see that the sender of the message requests to be notified
|
||||||
* when the user couldn't receive the message because he/she is offline, the message
|
* when the user couldn't receive the message because he/she is offline, the message
|
||||||
|
|
|
@ -58,30 +58,32 @@ import org.jivesoftware.smack.packet.PacketExtension;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Represents message events relating to the delivery, display, composition and cancellation of
|
* Represents message events relating to the delivery, display, composition and cancellation of
|
||||||
* messages.
|
* messages.<p>
|
||||||
*
|
*
|
||||||
* There are four message events currently defined in this namespace:
|
* There are four message events currently defined in this namespace:
|
||||||
* 1.Offline
|
* <ol>
|
||||||
|
* <li>Offline<br>
|
||||||
* Indicates that the message has been stored offline by the intended recipient's server. This
|
* Indicates that the message has been stored offline by the intended recipient's server. This
|
||||||
* event is triggered only if the intended recipient's server supports offline storage, has that
|
* event is triggered only if the intended recipient's server supports offline storage, has that
|
||||||
* support enabled, and the recipient is offline when the server receives the message for delivery.
|
* support enabled, and the recipient is offline when the server receives the message for delivery.</li>
|
||||||
*
|
*
|
||||||
* 2.Delivered
|
* <li>Delivered<br>
|
||||||
* Indicates that the message has been delivered to the recipient. This signifies that the message
|
* Indicates that the message has been delivered to the recipient. This signifies that the message
|
||||||
* has reached the recipient's XMPP client, but does not necessarily mean that the message has
|
* has reached the recipient's XMPP client, but does not necessarily mean that the message has
|
||||||
* been displayed. This event is to be raised by the XMPP client.
|
* been displayed. This event is to be raised by the XMPP client.</li>
|
||||||
*
|
*
|
||||||
* 3.Displayed
|
* <li>Displayed<br>
|
||||||
* Once the message has been received by the recipient's XMPP client, it may be displayed to the
|
* Once the message has been received by the recipient's XMPP client, it may be displayed to the
|
||||||
* user. This event indicates that the message has been displayed, and is to be raised by the
|
* user. This event indicates that the message has been displayed, and is to be raised by the
|
||||||
* XMPP client. Even if a message is displayed multiple times, this event should be raised only
|
* XMPP client. Even if a message is displayed multiple times, this event should be raised only
|
||||||
* once.
|
* once.</li>
|
||||||
*
|
*
|
||||||
* 4.Composing
|
* <li>Composing<br>
|
||||||
* In threaded chat conversations, this indicates that the recipient is composing a reply to a
|
* In threaded chat conversations, this indicates that the recipient is composing a reply to a
|
||||||
* message. The event is to be raised by the recipient's XMPP client. A XMPP client is allowed
|
* message. The event is to be raised by the recipient's XMPP client. A XMPP client is allowed
|
||||||
* to raise this event multiple times in response to the same request, providing the original
|
* to raise this event multiple times in response to the same request, providing the original
|
||||||
* event is cancelled first.
|
* event is cancelled first.</li>
|
||||||
|
* </ol>
|
||||||
*
|
*
|
||||||
* @author Gaston Dombiak
|
* @author Gaston Dombiak
|
||||||
*/
|
*/
|
||||||
|
@ -305,27 +307,31 @@ public class MessageEvent implements PacketExtension {
|
||||||
* Returns the XML representation of a Message Event according the specification.
|
* Returns the XML representation of a Message Event according the specification.
|
||||||
*
|
*
|
||||||
* Usually the XML representation will be inside of a Message XML representation like
|
* Usually the XML representation will be inside of a Message XML representation like
|
||||||
* in the following examples:
|
* in the following examples:<p>
|
||||||
*
|
*
|
||||||
* Request to be notified when displayed:
|
* Request to be notified when displayed:
|
||||||
* <message
|
* <pre>
|
||||||
|
* <message
|
||||||
* to='romeo@montague.net/orchard'
|
* to='romeo@montague.net/orchard'
|
||||||
* from='juliet@capulet.com/balcony'
|
* from='juliet@capulet.com/balcony'
|
||||||
* id='message22'>
|
* id='message22'>
|
||||||
* <x xmlns='jabber:x:event'>
|
* <x xmlns='jabber:x:event'>
|
||||||
* <displayed/>
|
* <displayed/>
|
||||||
* </x>
|
* </x>
|
||||||
* </message>
|
* </message>
|
||||||
|
* </pre>
|
||||||
*
|
*
|
||||||
* Notification of displayed:
|
* Notification of displayed:
|
||||||
* <message
|
* <pre>
|
||||||
|
* <message
|
||||||
* from='romeo@montague.net/orchard'
|
* from='romeo@montague.net/orchard'
|
||||||
* to='juliet@capulet.com/balcony'>
|
* to='juliet@capulet.com/balcony'>
|
||||||
* <x xmlns='jabber:x:event'>
|
* <x xmlns='jabber:x:event'>
|
||||||
* <displayed/>
|
* <displayed/>
|
||||||
* <id>message22</id>
|
* <id>message22</id>
|
||||||
* </x>
|
* </x>
|
||||||
* </message>
|
* </message>
|
||||||
|
* </pre>
|
||||||
*
|
*
|
||||||
*/
|
*/
|
||||||
public String toXML() {
|
public String toXML() {
|
||||||
|
|
Loading…
Reference in a new issue