org.jivesoftware.smackx.iqlast

Class LastActivityManager

java.lang.Object

org.jivesoftware.smack.Manager

org.jivesoftware.smackx.iqlast.LastActivityManager

public class LastActivityManager
extends Manager

A last activity manager for handling information about the last activity associated with a Jabber ID. A manager handles incoming LastActivity requests of existing Connections. It also allows to request last activity information of other users.

LastActivity (XEP-0012) based on the sending JID's type allows for retrieval of:

1. How long a particular user has been idle
2. How long a particular user has been logged-out and the message the specified when doing so.
3. How long a host has been up.

For example to get the idle time of a user logged in a resource, simple send the LastActivity stanza(/packet) to them, as in the following code:

 XMPPConnection con = new XMPPTCPConnection("jabber.org");
 con.login("john", "doe");
 LastActivity activity = LastActivity.getLastActivity(con, "xray@jabber.org/Smack");
 

To get the lapsed time since the last user logout is the same as above but with out the resource:

 LastActivity activity = LastActivity.getLastActivity(con, "xray@jabber.org");
 

To get the uptime of a host, you simple send the LastActivity stanza(/packet) to it, as in the following code example:

 LastActivity activity = LastActivity.getLastActivity(con, "jabber.org");
 

See Also:

XEP-0012: Last Activity

Method Summary

Modifier and Type	Method and Description
void	disable()
void	enable()
static LastActivityManager	getInstanceFor(XMPPConnection connection)
LastActivity	getLastActivity(String jid) Returns the last activity of a particular jid.
boolean	isLastActivitySupported(String jid) Returns true if Last Activity (XEP-0012) is supported by a given JID
static void	setEnabledPerDefault(boolean enabledPerDefault) Enable or disable Last Activity for new XMPPConnections.

Methods inherited from class org.jivesoftware.smack.Manager

connection

Methods inherited from class java.lang.Object

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

Method Detail

setEnabledPerDefault

public static void setEnabledPerDefault(boolean enabledPerDefault)

Enable or disable Last Activity for new XMPPConnections.

Parameters:

enabledPerDefault -

getInstanceFor

public static LastActivityManager getInstanceFor(XMPPConnection connection)

enable

public void enable()

disable

public void disable()

getLastActivity

public LastActivity getLastActivity(String jid)
                             throws SmackException.NoResponseException,
                                    XMPPException.XMPPErrorException,
                                    SmackException.NotConnectedException

Returns the last activity of a particular jid. If the jid is a full JID (i.e., a JID of the form of 'user@host/resource') then the last activity is the idle time of that connected resource. On the other hand, when the jid is a bare JID (e.g. 'user@host') then the last activity is the lapsed time since the last logout or 0 if the user is currently logged in. Moreover, when the jid is a server or component (e.g., a JID of the form 'host') the last activity is the uptime.

Parameters:

jid - the JID of the user.

Returns:

the LastActivity stanza(/packet) of the jid.

Throws:

XMPPException.XMPPErrorException - thrown if a server error has occured.

SmackException.NoResponseException - if there was no response from the server.

SmackException.NotConnectedException

isLastActivitySupported

public boolean isLastActivitySupported(String jid)
                                throws SmackException.NoResponseException,
                                       XMPPException.XMPPErrorException,
                                       SmackException.NotConnectedException

Returns true if Last Activity (XEP-0012) is supported by a given JID

Parameters:

jid - a JID to be tested for Last Activity support

Returns:

true if Last Activity is supported, otherwise false

Throws:

SmackException.NotConnectedException

XMPPException.XMPPErrorException

SmackException.NoResponseException