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
InfoNode	discoverCapabilities(Jid jid) Discovers the capabilities of another XMPP entity.
String	getNode() Gets the node.
boolean	isSupported(String feature, 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.Manager

isEnabled, setEnabled

Methods inherited from class java.lang.Object

equals, 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()

discoverCapabilities

public final InfoNode discoverCapabilities(Jid jid)
                                    throws XmppException

Discovers 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:

StanzaException - If the entity returned a stanza error.

NoResponseException - If the entity did not respond.

XmppException

See Also:

6.2 Discovering Capabilities

isSupported

public final boolean isSupported(String feature,
                                 Jid jid)
                          throws 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:

NoResponseException - If the entity did not respond.

XmppException