com.etherios.connector.core.network

Interface INetworkImplementation

All Known Implementing Classes:

ConnectorNetworkManager

public interface INetworkImplementation

This interface defines all the methods that should be implemented by the different platform connector implementations so that Cloud Connector knows how to perform the networking operations in that platform.

Field Summary

Fields

Modifier and Type	Field and Description
static byte[]	DEFAULT_LINK_SPEED Default Link Speed for PPP connection.
static byte[]	DEFAULT_PHONE_NUMBER Default Phone number for PPP connection.
static int	ETH_TYPE Network interface is of 'Ethernet' type.
static int	MOBILE_TYPE Network interface is of 'Mobile' type.
static int	UNKNOWN_TYPE Network interface is of 'Unknown' type.
static int	WIFI_TYPE Network interface is of 'Wi-Fi' type.

Method Summary

Modifier and Type	Method and Description
int	getActiveNetwork() Retrieves the active network connection identifier.
java.lang.String	getLocalIpAddress() Retrieves the active connection IP address.
byte[]	getPPPLinkSpeed() Retrieves the PPP link speed in bits per second.
byte[]	getPPPPhoneNumber() Retrieves the phone number that was dialed for the PPP connection.
MacAddress	getPrimaryMac() Retrieves the primary MAC address of the device depending on the active connection type.
ISocket	getSocket(java.lang.String address, int port) Returns a socket from the given address and port.
ISocket	getSSLSocket(java.lang.String address, int port) Returns a secure socket from the given address and port.
boolean	internetAvailable() Checks whether there is Internet connectivity or not.

Field Detail

DEFAULT_LINK_SPEED

static final byte[] DEFAULT_LINK_SPEED

Default Link Speed for PPP connection.

See Also:

MOBILE_TYPE

DEFAULT_PHONE_NUMBER

static final byte[] DEFAULT_PHONE_NUMBER

Default Phone number for PPP connection.

See Also:

MOBILE_TYPE

ETH_TYPE

static final int ETH_TYPE

Network interface is of 'Ethernet' type.

See Also:

Constant Field Values

MOBILE_TYPE

static final int MOBILE_TYPE

Network interface is of 'Mobile' type.

See Also:

Constant Field Values

UNKNOWN_TYPE

static final int UNKNOWN_TYPE

Network interface is of 'Unknown' type.

See Also:

Constant Field Values

WIFI_TYPE

static final int WIFI_TYPE

Network interface is of 'Wi-Fi' type.

See Also:

Constant Field Values

Method Detail

getActiveNetwork

int getActiveNetwork()

Retrieves the active network connection identifier.

Returns:

The active network connection identifier.

getLocalIpAddress

java.lang.String getLocalIpAddress()

Retrieves the active connection IP address.

Returns:

The active connection IP address.

getPPPLinkSpeed

byte[] getPPPLinkSpeed()

Retrieves the PPP link speed in bits per second. It should be a 4 octet integer.

This only is needed when the connection type is PPP (see MOBILE_TYPE).

Returns:

PPP link speed of the PPP connection. All zeros represents unknown speed.

See Also:

MOBILE_TYPE

getPPPPhoneNumber

byte[] getPPPPhoneNumber()

Retrieves the phone number that was dialed for the PPP connection. The phone number is a variable length string. It contains the phone number dialed, including any dialing prefixes.

This only is needed when the connection type is PPP (see MOBILE_TYPE).

Returns:

Phone number dialed, including any dialing prefixes.

See Also:

MOBILE_TYPE

getPrimaryMac

MacAddress getPrimaryMac()

Retrieves the primary MAC address of the device depending on the active connection type.

Returns:

Primary MAC Address of the device.

getSocket

ISocket getSocket(java.lang.String address,
                  int port)
           throws java.lang.Exception

Returns a socket from the given address and port.

Parameters:

address - The address of the host to connect.

port - The port of the connection.

Returns:

ISocket object with the secure connection support.

Throws:

java.lang.Exception - if any error occurs while getting a standard socket to the given address and port.

getSSLSocket

ISocket getSSLSocket(java.lang.String address,
                     int port)
              throws java.lang.Exception

Returns a secure socket from the given address and port.

Parameters:

address - The address of the host to connect.

port - The port of the connection.

Returns:

ISocket object with the secure connection support.

Throws:

java.lang.Exception - if any error occurs while getting a SSL socket to the given address and port.

internetAvailable

boolean internetAvailable()

Checks whether there is Internet connectivity or not.

Returns:

true if there is Internet connectivity, false otherwise.