rocks.xmpp.extensions.caps

Class EntityCapabilitiesManager

java.lang.Object

rocks.xmpp.core.session.Manager

rocks.xmpp.extensions.caps.EntityCapabilitiesManager

public final class EntityCapabilitiesManager
extends Manager

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 discoverCapabilities(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, Jid).

This class is thread-safe.

See Also:

XEP-0115: Entity Capabilities

Method Summary

Modifier and Type	Method and Description
AsyncResult<InfoNode>	discoverCapabilities(Jid jid) Discovers the capabilities of another XMPP entity.
java.lang.String	getNode() Gets the node.
AsyncResult<java.lang.Boolean>	isSupported(java.lang.String feature, Jid jid) Checks whether the entity supports the given feature.
void	setNode(java.lang.String node) Sets the node.

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

isEnabled, setEnabled

Methods inherited from class java.lang.Object

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

Method Detail

getNode

public java.lang.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(java.lang.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()

discoverCapabilities

public final AsyncResult<InfoNode> discoverCapabilities(Jid jid)

Discovers the capabilities of another XMPP entity.

Parameters:

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

Returns:

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

See Also:

6.2 Discovering Capabilities

isSupported

public final AsyncResult<java.lang.Boolean> isSupported(java.lang.String feature,
                                                        Jid jid)

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:

The async result with true, if this entity supports the feature.