Package rocks.xmpp.extensions.caps.client

Class ClientEntityCapabilitiesManager

java.lang.Object

rocks.xmpp.extensions.caps.client.ClientEntityCapabilitiesManager

All Implemented Interfaces:

EntityCapabilitiesManager

public final class ClientEntityCapabilitiesManager
extends Object
implements EntityCapabilitiesManager

Caches entity capabilities.

This class is shared by both Entity Caps implementations, ClientEntityCapabilities1Protocol and ClientEntityCapabilities2Protocol and provides a single (global) cache to both of them.

It also allows to explicitly query for a entity capabilities. If they are already cached, the cached capabilities are returned, otherwise a Service Discovery query is made.

Constructor Summary

Constructors

Constructor	Description
ClientEntityCapabilitiesManager(XmppSession xmppSession)

Method Summary

Modifier and Type	Method	Description
AsyncResult<DiscoverableInfo>	discoverCapabilities(Jid jid)	Discovers the capabilities of another XMPP entity.
DiscoverableInfo	readCapabilities(Hash hash)
DiscoverableInfo	readEntityCapabilities(Jid entity)
void	writeCapabilities(Hash hash, DiscoverableInfo discoverableInfo)
void	writeEntityCapabilities(Jid entity, DiscoverableInfo discoverableInfo)

Methods inherited from class java.lang.Object

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

Methods inherited from interface rocks.xmpp.extensions.caps.EntityCapabilitiesManager

isSupported

Constructor Detail

ClientEntityCapabilitiesManager

public ClientEntityCapabilitiesManager(XmppSession xmppSession)

Method Detail

readCapabilities

public DiscoverableInfo readCapabilities(Hash hash)

Specified by:

readCapabilities in interface EntityCapabilitiesManager

writeCapabilities

public void writeCapabilities(Hash hash,
                              DiscoverableInfo discoverableInfo)

Specified by:

writeCapabilities in interface EntityCapabilitiesManager

readEntityCapabilities

public DiscoverableInfo readEntityCapabilities(Jid entity)

Specified by:

readEntityCapabilities in interface EntityCapabilitiesManager

writeEntityCapabilities

public void writeEntityCapabilities(Jid entity,
                                    DiscoverableInfo discoverableInfo)

Specified by:

writeEntityCapabilities in interface EntityCapabilitiesManager

discoverCapabilities

public final AsyncResult<DiscoverableInfo> discoverCapabilities(Jid jid)

Discovers the capabilities of another XMPP entity.

Specified by:

discoverCapabilities in interface EntityCapabilitiesManager

Parameters:

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

Returns:

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

See Also:

6.2 Discovering Capabilities