org.jivesoftware.wildfire.user
Class PresenceEventDispatcher

java.lang.Object
  org.jivesoftware.wildfire.user.PresenceEventDispatcher

public class PresenceEventDispatcher
extends Object

Dispatches presence events. The following events are supported:

• availableSession --> A session is now available to receive communication.
• unavailableSession --> A session is now longer available.
• presencePriorityChanged --> The priority of a resource has changed.
• presenceChanged --> The show or status value of an available session has changed.

Use addListener(PresenceEventListener) and removeListener(PresenceEventListener) to add or remove PresenceEventListener.

Author:

Gaston Dombiak

Constructor Summary

PresenceEventDispatcher()

Method Summary

static void	addListener(PresenceEventListener listener) Registers a listener to receive events.
static void	availableSession(ClientSession session, Presence presence) Notification message indicating that a session that was not available is now available.
static void	presenceChanged(ClientSession session, Presence presence) Notification message indicating that an available session has changed its presence.
static void	presencePriorityChanged(ClientSession session, Presence presence) Notification message indicating that the presence priority of a session has been modified.
static void	removeListener(PresenceEventListener listener) Unregisters a listener to receive events.
static void	unavailableSession(ClientSession session, Presence presence) Notification message indicating that a session that was available is no longer available.

Methods inherited from class java.lang.Object

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

Constructor Detail

PresenceEventDispatcher

public PresenceEventDispatcher()

Method Detail

addListener

public static void addListener(PresenceEventListener listener)

Registers a listener to receive events.

Parameters:

listener - the listener.

removeListener

public static void removeListener(PresenceEventListener listener)

Unregisters a listener to receive events.

Parameters:

listener - the listener.

availableSession

public static void availableSession(ClientSession session,
                                    Presence presence)

Notification message indicating that a session that was not available is now available. A session becomes available when an available presence is received. Sessions that are available will have a route in the routing table thus becoming eligible for receiving messages (in particular messages sent to the user bare JID).

Parameters:

session - the session that is now available.

presence - the received available presence.

unavailableSession

public static void unavailableSession(ClientSession session,
                                      Presence presence)

Notification message indicating that a session that was available is no longer available. A session becomes unavailable when an unavailable presence is received. The entity may still be connected to the server and may send an available presence later to indicate that communication can proceed.

Parameters:

session - the session that is no longer available.

presence - the received unavailable presence.

presencePriorityChanged

public static void presencePriorityChanged(ClientSession session,
                                           Presence presence)

Notification message indicating that the presence priority of a session has been modified. Presence priorities are used when deciding which session of the same user should receive a message that was sent to the user bare's JID.

Parameters:

session - the affected session.

presence - the presence that changed the priority.

presenceChanged

public static void presenceChanged(ClientSession session,
                                   Presence presence)

Notification message indicating that an available session has changed its presence. This is the case when the user presence changed the show value (e.g. away, dnd, etc.) or the presence status message.

Parameters:

session - the affected session.

presence - the received available presence with the new information.