mirror of
https://github.com/vanitasvitae/Smack.git
synced 2024-06-13 07:04:49 +02:00
717090d272
Differentiate between asynchronous and synchronous ones. Asynchronous are the ones where the invocation order may not be the same as the order in which the stanzas arrived. Since it's no longer guaranteed that when a unit test calls processPacket(stanza) the stanza will be completely processed when the call returns, it was necessary to extend the unit tests (mostly Roster and ChatManager) with a packet listener that waits for his invocation. Since we now also use LinkedHashMaps as Map for the packet listeners (SMACK-531, SMACK-424), adding a packet listeners as last also means that it will be called as last. We exploit this behavior change now in the unit tests. Rename 'recvListeners' to 'syncRecvListeners' in AbstractXMPPConnection. Rename 'rosterInitialized' to 'loaded' in Roster. Add Roster.isLoaded(). Reset 'loaded' to false in Roster.setOfflinePresencesAndResetLoaded() (was setOfflinePresences()). Fixes SMACK-583, SMACK-532, SMACK-424
54 lines
1.9 KiB
Java
54 lines
1.9 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.smack;
|
|
|
|
import org.jivesoftware.smack.SmackException.NotConnectedException;
|
|
import org.jivesoftware.smack.packet.Packet;
|
|
|
|
/**
|
|
* Provides a mechanism to listen for packets that pass a specified filter.
|
|
* This allows event-style programming -- every time a new packet is found,
|
|
* the {@link #processPacket(Packet)} method will be called. This is the
|
|
* opposite approach to the functionality provided by a {@link PacketCollector}
|
|
* which lets you block while waiting for results.
|
|
* <p>
|
|
* Additionally you are able to intercept Packets that are going to be send and
|
|
* make modifications to them. You can register a PacketListener as interceptor
|
|
* by using {@link XMPPConnection#addPacketInterceptor(PacketListener,
|
|
* org.jivesoftware.smack.filter.PacketFilter)}
|
|
* </p>
|
|
*
|
|
* @see XMPPConnection#addAsyncPacketListener(PacketListener, org.jivesoftware.smack.filter.PacketFilter)
|
|
* @author Matt Tucker
|
|
*/
|
|
public interface PacketListener {
|
|
|
|
/**
|
|
* Process the next packet sent to this packet listener.
|
|
* <p>
|
|
* A single thread is responsible for invoking all listeners, so
|
|
* it's very important that implementations of this method not block
|
|
* for any extended period of time.
|
|
* </p>
|
|
*
|
|
* @param packet the packet to process.
|
|
*/
|
|
public void processPacket(Packet packet) throws NotConnectedException;
|
|
|
|
}
|