rocks.xmpp.extensions.caps

Class EntityCapabilitiesManager

java.lang.Object

rocks.xmpp.core.session.Manager

rocks.xmpp.core.session.ExtensionManager

rocks.xmpp.extensions.caps.EntityCapabilitiesManager

public final class EntityCapabilitiesManager
extends ExtensionManager

This class manages XEP-0115: Entity Capabilities.

If this manager is enabled (default), entity capabilities are automatically included in every presence notification being sent.

You can check for an entity's capabilities by using getCapabilities(rocks.xmpp.core.Jid), which will either return cached capabilities or ask the entity.

Similarly you can ask if an entity supports a particular feature via isSupported(String, rocks.xmpp.core.Jid).

Author:

Christian Schudt

Field Summary

Fields inherited from class rocks.xmpp.core.session.ExtensionManager

features, xmppSession

Method Summary

Modifier and Type	Method and Description
rocks.xmpp.extensions.disco.model.info.InfoNode	getCapabilities(rocks.xmpp.core.Jid jid) Gets the capabilities of another XMPP entity.
String	getNode() Gets the node.
boolean	isSupported(String feature, rocks.xmpp.core.Jid jid) Checks whether the entity supports the given feature.
void	setNode(String node) Sets the node.

Methods inherited from class rocks.xmpp.core.session.ExtensionManager

setEnabled

Methods inherited from class rocks.xmpp.core.session.Manager

isEnabled

Methods inherited from class java.lang.Object

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

Method Detail

getNode

public String getNode()

Gets the node. If no node was set, a default node is returned.

Returns:

The node.

See Also:

setNode(String)

setNode

public void setNode(String node)

Sets the node.

4. Protocol

It is RECOMMENDED for the value of the 'node' attribute to be an HTTP URL at which a user could find further information about the software product, such as "http://psi-im.org" for the Psi client;

Parameters:

node - The node.

See Also:

getNode()

getCapabilities

public rocks.xmpp.extensions.disco.model.info.InfoNode getCapabilities(rocks.xmpp.core.Jid jid)
                                                                throws rocks.xmpp.core.XmppException

Gets the capabilities of another XMPP entity.

Parameters:

jid - The JID, which should usually be a full JID.

Returns:

The capabilities in form of a info node, which contains the identities, the features and service discovery extensions.

Throws:

rocks.xmpp.core.stanza.model.StanzaException - If the entity returned a stanza error.

NoResponseException - If the entity did not respond.

rocks.xmpp.core.XmppException

isSupported

public boolean isSupported(String feature,
                           rocks.xmpp.core.Jid jid)
                    throws rocks.xmpp.core.XmppException

Checks whether the entity supports the given feature. If the features are already known and cached

Parameters:

feature - The feature.

jid - The JID, which should usually be a full JID.

Returns:

True, if this entity supports the feature.

Throws:

rocks.xmpp.core.stanza.model.StanzaException - If the entity returned a stanza error.

NoResponseException - If the entity did not respond.

rocks.xmpp.core.XmppException