org.jivesoftware.smackx.iot.discovery

Class IoTDiscoveryManager

java.lang.Object

org.jivesoftware.smack.Manager

org.jivesoftware.smackx.iot.discovery.IoTDiscoveryManager

public final class IoTDiscoveryManager
extends Manager

A manager for XEP-0347: Internet of Things - Discovery. Used to register and discover things.

See Also:

XEP-0347: Internet of Things - Discovery

Method Summary

Modifier and Type	Method and Description
IoTClaimed	claimThing(java.util.Collection<Tag> metaTags)
IoTClaimed	claimThing(java.util.Collection<Tag> metaTags, boolean publicThing)
IoTClaimed	claimThing(Jid registry, java.util.Collection<Tag> metaTags, boolean publicThing) Claim a thing by providing a collection of meta tags.
void	disownThing(Jid thing)
void	disownThing(Jid registry, Jid thing, NodeInfo nodeInfo)
void	disownThing(Jid thing, NodeInfo nodeInfo)
Jid	findRegistry() Try to find an XMPP IoT registry.
static IoTDiscoveryManager	getInstanceFor(XMPPConnection connection) Get the manger instance responsible for the given connection.
ThingState	getStateFor(Thing thing)
boolean	isRegistry(BareJid jid)
boolean	isRegistry(Jid jid)
ThingState	registerThing(Jid registry, Thing thing)
ThingState	registerThing(Thing thing)
void	removeThing(BareJid thing)
void	removeThing(BareJid thing, NodeInfo nodeInfo)
void	removeThing(Jid registry, BareJid thing, NodeInfo nodeInfo)
void	unregister()
void	unregister(Jid registry, NodeInfo nodeInfo)
void	unregister(NodeInfo nodeInfo)

Methods inherited from class org.jivesoftware.smack.Manager

connection, getAuthenticatedConnectionOrThrow

Methods inherited from class java.lang.Object

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

Method Detail

getInstanceFor

public static IoTDiscoveryManager getInstanceFor(XMPPConnection connection)

Get the manger instance responsible for the given connection.

Parameters:

connection - the XMPP connection.

Returns:

a manager instance.

findRegistry

public Jid findRegistry()
                 throws SmackException.NoResponseException,
                        XMPPException.XMPPErrorException,
                        SmackException.NotConnectedException,
                        java.lang.InterruptedException

Try to find an XMPP IoT registry.

Returns:

the JID of a Thing Registry if one could be found, null otherwise.

Throws:

java.lang.InterruptedException

SmackException.NotConnectedException

XMPPException.XMPPErrorException

SmackException.NoResponseException

See Also:

XEP-0347 § 3.5 Finding Thing Registry

registerThing

public ThingState registerThing(Thing thing)
                         throws SmackException.NotConnectedException,
                                java.lang.InterruptedException,
                                SmackException.NoResponseException,
                                XMPPException.XMPPErrorException,
                                IoTClaimedException

Throws:

SmackException.NotConnectedException

java.lang.InterruptedException

SmackException.NoResponseException

XMPPException.XMPPErrorException

IoTClaimedException

registerThing

public ThingState registerThing(Jid registry,
                                Thing thing)
                         throws SmackException.NotConnectedException,
                                java.lang.InterruptedException,
                                SmackException.NoResponseException,
                                XMPPException.XMPPErrorException,
                                IoTClaimedException

Throws:

SmackException.NotConnectedException

java.lang.InterruptedException

SmackException.NoResponseException

XMPPException.XMPPErrorException

IoTClaimedException

claimThing

public IoTClaimed claimThing(java.util.Collection<Tag> metaTags)
                      throws SmackException.NoResponseException,
                             XMPPException.XMPPErrorException,
                             SmackException.NotConnectedException,
                             java.lang.InterruptedException

Throws:

SmackException.NoResponseException

XMPPException.XMPPErrorException

SmackException.NotConnectedException

java.lang.InterruptedException

claimThing

public IoTClaimed claimThing(java.util.Collection<Tag> metaTags,
                             boolean publicThing)
                      throws SmackException.NoResponseException,
                             XMPPException.XMPPErrorException,
                             SmackException.NotConnectedException,
                             java.lang.InterruptedException

Throws:

SmackException.NoResponseException

XMPPException.XMPPErrorException

SmackException.NotConnectedException

java.lang.InterruptedException

claimThing

public IoTClaimed claimThing(Jid registry,
                             java.util.Collection<Tag> metaTags,
                             boolean publicThing)
                      throws SmackException.NoResponseException,
                             XMPPException.XMPPErrorException,
                             SmackException.NotConnectedException,
                             java.lang.InterruptedException

Claim a thing by providing a collection of meta tags. If the claim was successful, then a IoTClaimed instance will be returned, which contains the XMPP address of the thing. Use IoTClaimed.getJid() to retrieve this address.

Parameters:

registry - the registry use to claim the thing.

metaTags - a collection of meta tags used to identify the thing.

publicThing - if this is a public thing.

Returns:

a IoTClaimed if successful.

Throws:

SmackException.NoResponseException

XMPPException.XMPPErrorException

SmackException.NotConnectedException

java.lang.InterruptedException

removeThing

public void removeThing(BareJid thing)
                 throws SmackException.NoResponseException,
                        XMPPException.XMPPErrorException,
                        SmackException.NotConnectedException,
                        java.lang.InterruptedException

Throws:

SmackException.NoResponseException

XMPPException.XMPPErrorException

SmackException.NotConnectedException

java.lang.InterruptedException

removeThing

public void removeThing(BareJid thing,
                        NodeInfo nodeInfo)
                 throws SmackException.NoResponseException,
                        XMPPException.XMPPErrorException,
                        SmackException.NotConnectedException,
                        java.lang.InterruptedException

Throws:

SmackException.NoResponseException

XMPPException.XMPPErrorException

SmackException.NotConnectedException

java.lang.InterruptedException

removeThing

public void removeThing(Jid registry,
                        BareJid thing,
                        NodeInfo nodeInfo)
                 throws SmackException.NoResponseException,
                        XMPPException.XMPPErrorException,
                        SmackException.NotConnectedException,
                        java.lang.InterruptedException

Throws:

SmackException.NoResponseException

XMPPException.XMPPErrorException

SmackException.NotConnectedException

java.lang.InterruptedException

unregister

public void unregister()
                throws SmackException.NoResponseException,
                       XMPPException.XMPPErrorException,
                       SmackException.NotConnectedException,
                       java.lang.InterruptedException

Throws:

SmackException.NoResponseException

XMPPException.XMPPErrorException

SmackException.NotConnectedException

java.lang.InterruptedException

unregister

public void unregister(NodeInfo nodeInfo)
                throws SmackException.NoResponseException,
                       XMPPException.XMPPErrorException,
                       SmackException.NotConnectedException,
                       java.lang.InterruptedException

Throws:

SmackException.NoResponseException

XMPPException.XMPPErrorException

SmackException.NotConnectedException

java.lang.InterruptedException

unregister

public void unregister(Jid registry,
                       NodeInfo nodeInfo)
                throws SmackException.NoResponseException,
                       XMPPException.XMPPErrorException,
                       SmackException.NotConnectedException,
                       java.lang.InterruptedException

Throws:

SmackException.NoResponseException

XMPPException.XMPPErrorException

SmackException.NotConnectedException

java.lang.InterruptedException

disownThing

public void disownThing(Jid thing)
                 throws SmackException.NoResponseException,
                        XMPPException.XMPPErrorException,
                        SmackException.NotConnectedException,
                        java.lang.InterruptedException

Throws:

SmackException.NoResponseException

XMPPException.XMPPErrorException

SmackException.NotConnectedException

java.lang.InterruptedException

disownThing

public void disownThing(Jid thing,
                        NodeInfo nodeInfo)
                 throws SmackException.NoResponseException,
                        XMPPException.XMPPErrorException,
                        SmackException.NotConnectedException,
                        java.lang.InterruptedException

Throws:

SmackException.NoResponseException

XMPPException.XMPPErrorException

SmackException.NotConnectedException

java.lang.InterruptedException

disownThing

public void disownThing(Jid registry,
                        Jid thing,
                        NodeInfo nodeInfo)
                 throws SmackException.NoResponseException,
                        XMPPException.XMPPErrorException,
                        SmackException.NotConnectedException,
                        java.lang.InterruptedException

Throws:

SmackException.NoResponseException

XMPPException.XMPPErrorException

SmackException.NotConnectedException

java.lang.InterruptedException

isRegistry

public boolean isRegistry(BareJid jid)
                   throws SmackException.NoResponseException,
                          XMPPException.XMPPErrorException,
                          SmackException.NotConnectedException,
                          java.lang.InterruptedException

Throws:

SmackException.NoResponseException

XMPPException.XMPPErrorException

SmackException.NotConnectedException

java.lang.InterruptedException

isRegistry

public boolean isRegistry(Jid jid)

getStateFor

public ThingState getStateFor(Thing thing)