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 org.jivesoftware.smack.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(org.jxmpp.jid.Jid registry, java.util.Collection<Tag> metaTags, boolean publicThing) Claim a thing by providing a collection of meta tags.
void	disownThing(org.jxmpp.jid.Jid thing)
void	disownThing(org.jxmpp.jid.Jid registry, org.jxmpp.jid.Jid thing, NodeInfo nodeInfo)
void	disownThing(org.jxmpp.jid.Jid thing, NodeInfo nodeInfo)
org.jxmpp.jid.Jid	findRegistry() Try to find an XMPP IoT registry.
static IoTDiscoveryManager	getInstanceFor(org.jivesoftware.smack.XMPPConnection connection) Get the manger instance responsible for the given connection.
ThingState	getStateFor(Thing thing)
boolean	isRegistry(org.jxmpp.jid.BareJid jid)
boolean	isRegistry(org.jxmpp.jid.Jid jid)
ThingState	registerThing(org.jxmpp.jid.Jid registry, Thing thing)
ThingState	registerThing(Thing thing)
void	removeThing(org.jxmpp.jid.BareJid thing)
void	removeThing(org.jxmpp.jid.BareJid thing, NodeInfo nodeInfo)
void	removeThing(org.jxmpp.jid.Jid registry, org.jxmpp.jid.BareJid thing, NodeInfo nodeInfo)
void	unregister()
void	unregister(org.jxmpp.jid.Jid registry, NodeInfo nodeInfo)
void	unregister(NodeInfo nodeInfo)

Methods inherited from class org.jivesoftware.smack.Manager

connection, getAuthenticatedConnectionOrThrow, schedule

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(org.jivesoftware.smack.XMPPConnection connection)

Get the manger instance responsible for the given connection.

Parameters:

connection - the XMPP connection.

Returns:

a manager instance.

findRegistry

public org.jxmpp.jid.Jid findRegistry()
                               throws org.jivesoftware.smack.SmackException.NoResponseException,
                                      org.jivesoftware.smack.XMPPException.XMPPErrorException,
                                      org.jivesoftware.smack.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

org.jivesoftware.smack.SmackException.NotConnectedException

org.jivesoftware.smack.XMPPException.XMPPErrorException

org.jivesoftware.smack.SmackException.NoResponseException

See Also:

XEP-0347 § 3.5 Finding Thing Registry

registerThing

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

Throws:

org.jivesoftware.smack.SmackException.NotConnectedException

java.lang.InterruptedException

org.jivesoftware.smack.SmackException.NoResponseException

org.jivesoftware.smack.XMPPException.XMPPErrorException

IoTClaimedException

registerThing

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

Throws:

org.jivesoftware.smack.SmackException.NotConnectedException

java.lang.InterruptedException

org.jivesoftware.smack.SmackException.NoResponseException

org.jivesoftware.smack.XMPPException.XMPPErrorException

IoTClaimedException

claimThing

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

Throws:

org.jivesoftware.smack.SmackException.NoResponseException

org.jivesoftware.smack.XMPPException.XMPPErrorException

org.jivesoftware.smack.SmackException.NotConnectedException

java.lang.InterruptedException

claimThing

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

Throws:

org.jivesoftware.smack.SmackException.NoResponseException

org.jivesoftware.smack.XMPPException.XMPPErrorException

org.jivesoftware.smack.SmackException.NotConnectedException

java.lang.InterruptedException

claimThing

public IoTClaimed claimThing(org.jxmpp.jid.Jid registry,
                             java.util.Collection<Tag> metaTags,
                             boolean publicThing)
                      throws org.jivesoftware.smack.SmackException.NoResponseException,
                             org.jivesoftware.smack.XMPPException.XMPPErrorException,
                             org.jivesoftware.smack.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:

org.jivesoftware.smack.SmackException.NoResponseException

org.jivesoftware.smack.XMPPException.XMPPErrorException

org.jivesoftware.smack.SmackException.NotConnectedException

java.lang.InterruptedException

removeThing

public void removeThing(org.jxmpp.jid.BareJid thing)
                 throws org.jivesoftware.smack.SmackException.NoResponseException,
                        org.jivesoftware.smack.XMPPException.XMPPErrorException,
                        org.jivesoftware.smack.SmackException.NotConnectedException,
                        java.lang.InterruptedException

Throws:

org.jivesoftware.smack.SmackException.NoResponseException

org.jivesoftware.smack.XMPPException.XMPPErrorException

org.jivesoftware.smack.SmackException.NotConnectedException

java.lang.InterruptedException

removeThing

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

Throws:

org.jivesoftware.smack.SmackException.NoResponseException

org.jivesoftware.smack.XMPPException.XMPPErrorException

org.jivesoftware.smack.SmackException.NotConnectedException

java.lang.InterruptedException

removeThing

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

Throws:

org.jivesoftware.smack.SmackException.NoResponseException

org.jivesoftware.smack.XMPPException.XMPPErrorException

org.jivesoftware.smack.SmackException.NotConnectedException

java.lang.InterruptedException

unregister

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

Throws:

org.jivesoftware.smack.SmackException.NoResponseException

org.jivesoftware.smack.XMPPException.XMPPErrorException

org.jivesoftware.smack.SmackException.NotConnectedException

java.lang.InterruptedException

unregister

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

Throws:

org.jivesoftware.smack.SmackException.NoResponseException

org.jivesoftware.smack.XMPPException.XMPPErrorException

org.jivesoftware.smack.SmackException.NotConnectedException

java.lang.InterruptedException

unregister

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

Throws:

org.jivesoftware.smack.SmackException.NoResponseException

org.jivesoftware.smack.XMPPException.XMPPErrorException

org.jivesoftware.smack.SmackException.NotConnectedException

java.lang.InterruptedException

disownThing

public void disownThing(org.jxmpp.jid.Jid thing)
                 throws org.jivesoftware.smack.SmackException.NoResponseException,
                        org.jivesoftware.smack.XMPPException.XMPPErrorException,
                        org.jivesoftware.smack.SmackException.NotConnectedException,
                        java.lang.InterruptedException

Throws:

org.jivesoftware.smack.SmackException.NoResponseException

org.jivesoftware.smack.XMPPException.XMPPErrorException

org.jivesoftware.smack.SmackException.NotConnectedException

java.lang.InterruptedException

disownThing

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

Throws:

org.jivesoftware.smack.SmackException.NoResponseException

org.jivesoftware.smack.XMPPException.XMPPErrorException

org.jivesoftware.smack.SmackException.NotConnectedException

java.lang.InterruptedException

disownThing

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

Throws:

org.jivesoftware.smack.SmackException.NoResponseException

org.jivesoftware.smack.XMPPException.XMPPErrorException

org.jivesoftware.smack.SmackException.NotConnectedException

java.lang.InterruptedException

isRegistry

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

Throws:

org.jivesoftware.smack.SmackException.NoResponseException

org.jivesoftware.smack.XMPPException.XMPPErrorException

org.jivesoftware.smack.SmackException.NotConnectedException

java.lang.InterruptedException

isRegistry

public boolean isRegistry(org.jxmpp.jid.Jid jid)

getStateFor

public ThingState getStateFor(Thing thing)