com.etherios.connector.core.network

Class ConnectorNetworkManager

java.lang.Object

com.etherios.connector.core.network.ConnectorNetworkManager

All Implemented Interfaces:

INetworkImplementation

public class ConnectorNetworkManager
extends java.lang.Object
implements INetworkImplementation

This class is used by the connector to work with the device network variables and methods. It is used also to perform common actions related with network to all connectors.

Field Summary

Fields inherited from interface com.etherios.connector.core.network.INetworkImplementation

DEFAULT_LINK_SPEED, DEFAULT_PHONE_NUMBER, ETH_TYPE, MOBILE_TYPE, UNKNOWN_TYPE, WIFI_TYPE

Constructor Summary

Constructors

Constructor and Description
ConnectorNetworkManager(INetworkImplementation networkImpl) Class constructor.

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.

Methods inherited from class java.lang.Object

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

Constructor Detail

ConnectorNetworkManager

public ConnectorNetworkManager(INetworkImplementation networkImpl)

Class constructor. Instances a new object of type NetworkManager with the given parameters.

Parameters:

networkImpl - Class implementing INetworkImplementation interface in charge of managing all network methods that are platform dependent.

Method Detail

getActiveNetwork

public int getActiveNetwork()

Description copied from interface: INetworkImplementation

Retrieves the active network connection identifier.

Specified by:

getActiveNetwork in interface INetworkImplementation

Returns:

The active network connection identifier.

getLocalIpAddress

public java.lang.String getLocalIpAddress()

Description copied from interface: INetworkImplementation

Retrieves the active connection IP address.

Specified by:

getLocalIpAddress in interface INetworkImplementation

Returns:

The active connection IP address.

getPPPLinkSpeed

public byte[] getPPPLinkSpeed()

Description copied from interface: INetworkImplementation

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).

Specified by:

getPPPLinkSpeed in interface INetworkImplementation

Returns:

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

See Also:

INetworkImplementation.MOBILE_TYPE

getPPPPhoneNumber

public byte[] getPPPPhoneNumber()

Description copied from interface: INetworkImplementation

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).

Specified by:

getPPPPhoneNumber in interface INetworkImplementation

Returns:

Phone number dialed, including any dialing prefixes.

See Also:

INetworkImplementation.MOBILE_TYPE

getPrimaryMac

public MacAddress getPrimaryMac()

Description copied from interface: INetworkImplementation

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

Specified by:

getPrimaryMac in interface INetworkImplementation

Returns:

Primary MAC Address of the device.

getSocket

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

Description copied from interface: INetworkImplementation

Returns a socket from the given address and port.

Specified by:

getSocket in interface INetworkImplementation

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

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

Description copied from interface: INetworkImplementation

Returns a secure socket from the given address and port.

Specified by:

getSSLSocket in interface INetworkImplementation

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

public boolean internetAvailable()

Description copied from interface: INetworkImplementation

Checks whether there is Internet connectivity or not.

Specified by:

internetAvailable in interface INetworkImplementation

Returns:

true if there is Internet connectivity, false otherwise.