buzz.getcoco.iot

Class CapabilityTunnel

java.lang.Object

buzz.getcoco.iot.Capability

buzz.getcoco.iot.CapabilityTunnel

All Implemented Interfaces:

java.lang.Iterable<Attribute>

public class CapabilityTunnel
extends Capability

This class describes Commands and Attributes for Tunneling Capability of a Resource.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	CapabilityTunnel.AttributeId enum denoting various possible attributes of the CapabilityTunnel.
static class	CapabilityTunnel.CommandId enum denoting the possible Commands that can be sent for CapabilityTunnel.
static class	CapabilityTunnel.IpVersion enum denoting possible values for Ip version.
static class	CapabilityTunnel.Protocol enum denoting possible values for tunnel protocol.
static class	CapabilityTunnel.State enum denoting possible values for tunnel state.
static class	CapabilityTunnel.TransportType enum denoting possible values for type of transport.
static interface	CapabilityTunnel.TunnelStatusListener Listener which will be triggered after the callback.
static class	CapabilityTunnel.TunnelType enum denoting possible values for type of tunnel.

Nested classes/interfaces inherited from class buzz.getcoco.iot.Capability

Capability.CapabilityId, Capability.CommandStatusListener<T extends Capability.CommandId>

Field Summary

Fields

Modifier and Type	Field and Description
static Capability.CapabilityId	ID

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	CapabilityTunnel(int id, Resource parent) Constructor of the current class.

Method Summary

Modifier and Type	Method and Description
void	close(long tunnelHandle, long timeout) This function is used to close the existing tunnel present of this capability.
void	closeAllTunnels(long timeout) A function used to close an existing tunnel.
protected Command<? extends Capability.CommandId>	extendedCreateCommand(int primitiveCommandId, com.google.gson.JsonElement commandParams) A function to create the command from the Json params.
int	getPort(long tunnelHandle) This function is used to get the port over which the tunnel is open.
CapabilityTunnel.State	getState(long tunnelHandle) This function is used to get The state of the tunnel which is represented by the enum State.
protected java.util.Map<java.lang.Long,buzz.getcoco.iot.CapabilityTunnel.StatePort>	getTunnelHandleMap()
void	open(java.lang.String forwardHostName, int forwardHostPort, java.lang.String listeningHostName, int listeningHostPort, CapabilityTunnel.TransportType transportType, CapabilityTunnel.TunnelType tunnelType, CapabilityTunnel.Protocol protocol, CapabilityTunnel.IpVersion ipVersion, long timeout, CapabilityTunnel.TunnelStatusListener listener) This function is used to open Tunnel.
void	openTcpTunnel(java.lang.String listeningHostName, int listeningHostPort, CapabilityTunnel.TunnelType tunnelType, CapabilityTunnel.IpVersion ipVersion, long timeout, CapabilityTunnel.TunnelStatusListener listener) A function to open TCP tunnel (simple wrap of open(java.lang.String, int, java.lang.String, int, buzz.getcoco.iot.CapabilityTunnel.TransportType, buzz.getcoco.iot.CapabilityTunnel.TunnelType, buzz.getcoco.iot.CapabilityTunnel.Protocol, buzz.getcoco.iot.CapabilityTunnel.IpVersion, long, buzz.getcoco.iot.CapabilityTunnel.TunnelStatusListener)).
void	openUdpTunnel(java.lang.String forwardHostName, int forwardHostPort, CapabilityTunnel.TunnelType tunnelType, CapabilityTunnel.IpVersion ipVersion, long timeout, CapabilityTunnel.TunnelStatusListener listener) A function to open UDP tunnel (simple wrap of open(java.lang.String, int, java.lang.String, int, buzz.getcoco.iot.CapabilityTunnel.TransportType, buzz.getcoco.iot.CapabilityTunnel.TunnelType, buzz.getcoco.iot.CapabilityTunnel.Protocol, buzz.getcoco.iot.CapabilityTunnel.IpVersion, long, buzz.getcoco.iot.CapabilityTunnel.TunnelStatusListener)).
boolean	supports(Capability.CommandId commandId) This function checks if a command is supported or not, pass null to check if capability supports any commands at all.

Methods inherited from class buzz.getcoco.iot.Capability

clearAndSetStandardCommandSet, containsAttribute, containsAttribute, createCommand, createCommandResponseArgs, getAttribute, getAttribute, getAttributeMap, getCapabilityWrapper, getId, getName, getParent, getSupportedCommands, hashCode, interceptCommand, internalAddAttribute, internalMarkAsReady, internalRemoveAttribute, internalSetName, internalSetParent, isReady, iterator, sendResourceCommand, setCapabilityWrapper, toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Field Detail

ID

public static final Capability.CapabilityId ID

Constructor Detail

CapabilityTunnel

protected CapabilityTunnel(int id,
                           Resource parent)

Constructor of the current class.

Parameters:

id - The unique id Of the capability

parent - The parent Resource of the capability.

Method Detail

supports

public boolean supports(Capability.CommandId commandId)

Description copied from class: Capability

This function checks if a command is supported or not, pass null to check if capability supports any commands at all. NOTE: Check the overridden function also for a complete view.

Overrides:

supports in class Capability

Parameters:

commandId - The Id denoting the command to be sent.

Returns:

boolean: If the command is supported then True is returned.

openUdpTunnel

public void openUdpTunnel(java.lang.String forwardHostName,
                          int forwardHostPort,
                          CapabilityTunnel.TunnelType tunnelType,
                          CapabilityTunnel.IpVersion ipVersion,
                          long timeout,
                          CapabilityTunnel.TunnelStatusListener listener)

A function to open UDP tunnel (simple wrap of open(java.lang.String, int, java.lang.String, int, buzz.getcoco.iot.CapabilityTunnel.TransportType, buzz.getcoco.iot.CapabilityTunnel.TunnelType, buzz.getcoco.iot.CapabilityTunnel.Protocol, buzz.getcoco.iot.CapabilityTunnel.IpVersion, long, buzz.getcoco.iot.CapabilityTunnel.TunnelStatusListener)).

Parameters:

forwardHostName - The hostname which will receive the data

forwardHostPort - The port over which data will be received

tunnelType - The type of the tunnel (LISTEN/CONNECT)

ipVersion - The ipVersion used for identification (ipV4/ipV6)

timeout - The timeout for this command in millis

listener - The listener which will be triggered after the callback This will be useful in tracking in tunnelStatusCbs

openTcpTunnel

public void openTcpTunnel(java.lang.String listeningHostName,
                          int listeningHostPort,
                          CapabilityTunnel.TunnelType tunnelType,
                          CapabilityTunnel.IpVersion ipVersion,
                          long timeout,
                          CapabilityTunnel.TunnelStatusListener listener)

A function to open TCP tunnel (simple wrap of open(java.lang.String, int, java.lang.String, int, buzz.getcoco.iot.CapabilityTunnel.TransportType, buzz.getcoco.iot.CapabilityTunnel.TunnelType, buzz.getcoco.iot.CapabilityTunnel.Protocol, buzz.getcoco.iot.CapabilityTunnel.IpVersion, long, buzz.getcoco.iot.CapabilityTunnel.TunnelStatusListener)).

Parameters:

listeningHostName - The hostname of the transmitting device

listeningHostPort - The port over which the device will transmit data

tunnelType - The type of the tunnel (LISTEN/CONNECT)

ipVersion - The ipVersion used for identification (ipV4/ipV6)

timeout - The timeout for this command in millis

listener - The listener which will be triggered after the callback. This will be useful in tracking in tunnelStatusCbs

open

public void open(java.lang.String forwardHostName,
                 int forwardHostPort,
                 java.lang.String listeningHostName,
                 int listeningHostPort,
                 CapabilityTunnel.TransportType transportType,
                 CapabilityTunnel.TunnelType tunnelType,
                 CapabilityTunnel.Protocol protocol,
                 CapabilityTunnel.IpVersion ipVersion,
                 long timeout,
                 CapabilityTunnel.TunnelStatusListener listener)

This function is used to open Tunnel.

Parameters:

forwardHostName - The hostname which will receive the data

forwardHostPort - The port over which data will be received

listeningHostName - The hostname of the transmitting device

listeningHostPort - The port over which the device will transmit data

transportType - The TransportType (TCP/UDP) on which the transmission shall take place

tunnelType - The type of the tunnel (LISTEN/CONNECT)

protocol - The protocol of the transmission (RTSP)

ipVersion - The ipVersion used for identification (ipV4/ipV6)

timeout - The timeout for this command in millis

listener - The listener which will be triggered after the callback. This will be useful in tracking in tunnelStatusCbs

closeAllTunnels

public void closeAllTunnels(long timeout)

A function used to close an existing tunnel.

Parameters:

timeout - timeout defined for the operation

close

public void close(long tunnelHandle,
                  long timeout)

This function is used to close the existing tunnel present of this capability.

Throws:

java.lang.RuntimeException - on failure to close the tunnel.

getPort

public int getPort(long tunnelHandle)

This function is used to get the port over which the tunnel is open.

Returns:

int: The port number which is available for transmission.

getState

public CapabilityTunnel.State getState(long tunnelHandle)

This function is used to get The state of the tunnel which is represented by the enum State.

Returns:

State: The enum denoting the state of the tunnel.

extendedCreateCommand

protected Command<? extends Capability.CommandId> extendedCreateCommand(int primitiveCommandId,
                                                                        com.google.gson.JsonElement commandParams)

A function to create the command from the Json params.

Specified by:

extendedCreateCommand in class Capability

Parameters:

primitiveCommandId - The int form of the commandId

commandParams - The Json params that can form a command

Returns:

The command which is formed

getTunnelHandleMap

protected java.util.Map<java.lang.Long,buzz.getcoco.iot.CapabilityTunnel.StatePort> getTunnelHandleMap()