mirror of
https://github.com/vanitasvitae/Smack.git
synced 2024-06-24 12:24:51 +02:00
fcc8414a92
There is a unsolveable race condition between the connection state and sendPacket(), i.e. the connection could go down, right after the method calling sendPacket is called, but before sendPacket() is invoked. Before this change, sendPacket() has thrown an unchecked IllegalStateException, which could be ignored by the Smack user, who would also not notice the race condition. We have decided to throw a checked Exception in this case now, to make the Smack user aware of this situation. SMACK-426
87 lines
3.1 KiB
Java
87 lines
3.1 KiB
Java
/**
|
|
*
|
|
* Copyright 2003-2007 Jive Software.
|
|
*
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
* you may not use this file except in compliance with the License.
|
|
* You may obtain a copy of the License at
|
|
*
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
*
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
* See the License for the specific language governing permissions and
|
|
* limitations under the License.
|
|
*/
|
|
|
|
package org.jivesoftware.smackx.xevent;
|
|
|
|
import org.jivesoftware.smack.SmackException.NotConnectedException;
|
|
|
|
/**
|
|
*
|
|
* A listener that is fired anytime a message event request is received.
|
|
* Message event requests are received when the received message includes an extension
|
|
* like this:
|
|
*
|
|
* <pre>
|
|
* <x xmlns='jabber:x:event'>
|
|
* <offline/>
|
|
* <delivered/>
|
|
* <composing/>
|
|
* </x>
|
|
* </pre>
|
|
*
|
|
* 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
|
|
* was delivered or when the receiver of the message is composing a reply.
|
|
*
|
|
* @author Gaston Dombiak
|
|
*/
|
|
public interface MessageEventRequestListener {
|
|
|
|
/**
|
|
* Called when a request for message delivered notification is received.
|
|
*
|
|
* @param from the user that sent the notification.
|
|
* @param packetID the id of the message that was sent.
|
|
* @param messageEventManager the messageEventManager that fired the listener.
|
|
* @throws NotConnectedException
|
|
*/
|
|
public void deliveredNotificationRequested(String from, String packetID,
|
|
MessageEventManager messageEventManager) throws NotConnectedException;
|
|
|
|
/**
|
|
* Called when a request for message displayed notification is received.
|
|
*
|
|
* @param from the user that sent the notification.
|
|
* @param packetID the id of the message that was sent.
|
|
* @param messageEventManager the messageEventManager that fired the listener.
|
|
*/
|
|
public void displayedNotificationRequested(String from, String packetID,
|
|
MessageEventManager messageEventManager);
|
|
|
|
/**
|
|
* Called when a request that the receiver of the message is composing a reply notification is
|
|
* received.
|
|
*
|
|
* @param from the user that sent the notification.
|
|
* @param packetID the id of the message that was sent.
|
|
* @param messageEventManager the messageEventManager that fired the listener.
|
|
*/
|
|
public void composingNotificationRequested(String from, String packetID,
|
|
MessageEventManager messageEventManager);
|
|
|
|
/**
|
|
* Called when a request that the receiver of the message is offline is received.
|
|
*
|
|
* @param from the user that sent the notification.
|
|
* @param packetID the id of the message that was sent.
|
|
* @param messageEventManager the messageEventManager that fired the listener.
|
|
*/
|
|
public void offlineNotificationRequested(String from, String packetID,
|
|
MessageEventManager messageEventManager);
|
|
|
|
}
|