Module com.thecoderscorner.tcmenu.javaapi

Package com.thecoderscorner.menu.remote.socket

Class SocketBasedConnector

java.lang.Object

com.thecoderscorner.menu.remote.SharedStreamConnection

com.thecoderscorner.menu.remote.StreamRemoteConnector

com.thecoderscorner.menu.remote.socket.SocketBasedConnector

All Implemented Interfaces:

RemoteConnector, RemoteDevice, RemoteConnectorContext

public class SocketBasedConnector
extends StreamRemoteConnector

A remote connector that will communicate using a client socket. Normally configured with a host and port. Create using the builder below.

See Also:

• SocketControllerBuilder

Nested Class Summary

Nested classes/interfaces inherited from class com.thecoderscorner.menu.remote.StreamRemoteConnector

StreamRemoteConnector.ReadMode

Field Summary

Fields inherited from class com.thecoderscorner.menu.remote.StreamRemoteConnector

clock, executor, stateMachineMappings

Fields inherited from class com.thecoderscorner.menu.remote.SharedStreamConnection

cmdBuffer, inputBuffer, logger, MAX_MSG_EXPECTED, protocol

Constructor Summary

Constructors

Constructor	Description
SocketBasedConnector(LocalIdentifier localId, ScheduledExecutorService executor, Clock clock, MenuCommandProtocol protocol, String remoteHost, int remotePort, ConnectMode mode)

Method Summary

Modifier and Type	Method	Description
void	close()	Force close a connection when its known to be bad, the connector will try and establish a new connection.
protected void	getAtLeastBytes(ByteBuffer inputBuffer, int len, StreamRemoteConnector.ReadMode mode)	Reads at least the number of bytes requested waiting if need be for more data.
String	getConnectionName()	Gets the name of this connector locally
boolean	isDeviceConnected()	Indicates if the underlying device is actually connected.
void	performConnection()
protected void	sendInternal(ByteBuffer outputBuffer)	performs a send of all bytes in the output buffer until the output buffer is empty
void	start()	Starts the communication channel, so it will attempt to connect with the configured device
void	stop()	Stops the library and attempts to also stop any threads and other resources associated.

Methods inherited from class com.thecoderscorner.menu.remote.StreamRemoteConnector

canSendMessageNow, changeState, changeState, connectionLog, getAuthenticationStatus, getClock, getRemoteParty, getScheduledExecutor, getUserName, handleCoreConnectionStates, notifyConnection, notifyListeners, registerConnectionChangeListener, registerConnectorListener, sendAcknowledgement, sendHeartbeat, sendJoin, sendPairing, setRemoteParty, startThreadProc, stopThreadProc

Methods inherited from class com.thecoderscorner.menu.remote.SharedStreamConnection

connectionLog, doesBufferHaveEOM, logByteBuffer, readCommandFromStream, readCompleteMessage, sendMenuCommand

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.thecoderscorner.menu.remote.RemoteConnector

sendMenuCommand

Methods inherited from interface com.thecoderscorner.menu.remote.states.RemoteConnectorContext

readCommandFromStream

Constructor Details

SocketBasedConnector

public SocketBasedConnector(LocalIdentifier localId,
 ScheduledExecutorService executor,
 Clock clock,
 MenuCommandProtocol protocol,
 String remoteHost,
 int remotePort,
 ConnectMode mode)

Method Details

start

public void start()

Description copied from interface: RemoteConnector

Starts the communication channel, so it will attempt to connect with the configured device

stop

public void stop()

Description copied from interface: RemoteConnector

Stops the library and attempts to also stop any threads and other resources associated.

performConnection

public void performConnection()
                       throws IOException

Throws:

IOException

getAtLeastBytes

protected void getAtLeastBytes(ByteBuffer inputBuffer,
 int len,
 StreamRemoteConnector.ReadMode mode)
                        throws IOException

Description copied from class: SharedStreamConnection

Reads at least the number of bytes requested waiting if need be for more data.

Specified by:

getAtLeastBytes in class SharedStreamConnection

Parameters:

inputBuffer - the buffer to read from

len - the minimum number of bytes needed

Throws:

IOException - if there are problems reading.

sendInternal

protected void sendInternal(ByteBuffer outputBuffer)
                     throws IOException

Description copied from class: StreamRemoteConnector

performs a send of all bytes in the output buffer until the output buffer is empty

Specified by:

sendInternal in class StreamRemoteConnector

Parameters:

outputBuffer - the buffer data to be sent

Throws:

IOException - if there are problems writing

isDeviceConnected

public boolean isDeviceConnected()

Description copied from interface: RemoteConnector

Indicates if the underlying device is actually connected.

Specified by:

isDeviceConnected in interface RemoteConnector

Specified by:

isDeviceConnected in interface RemoteConnectorContext

Specified by:

isDeviceConnected in class SharedStreamConnection

Returns:

true if the underlying device is connected

getConnectionName

public String getConnectionName()

Description copied from interface: RemoteConnector

Gets the name of this connector locally

Specified by:

getConnectionName in interface RemoteConnector

Specified by:

getConnectionName in interface RemoteConnectorContext

Specified by:

getConnectionName in interface RemoteDevice

Specified by:

getConnectionName in class SharedStreamConnection

close

public void close()

Description copied from interface: RemoteConnector

Force close a connection when its known to be bad, the connector will try and establish a new connection.

Specified by:

close in interface RemoteConnector

Specified by:

close in interface RemoteConnectorContext

Overrides:

close in class StreamRemoteConnector