Module com.thecoderscorner.tcmenu.javaapi

Package com.thecoderscorner.menu.remote

Class StreamRemoteConnector

java.lang.Object

com.thecoderscorner.menu.remote.SharedStreamConnection

com.thecoderscorner.menu.remote.StreamRemoteConnector

All Implemented Interfaces:

RemoteConnector, RemoteConnectorContext

Direct Known Subclasses:

SocketBasedConnector

public abstract class StreamRemoteConnector
extends SharedStreamConnection
implements RemoteConnector, RemoteConnectorContext

Stream remote connector is the base class for all stream implementations, such as Socket and RS232. Any remote with stream like semantics can use this as the base for building out an adapter.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static enum	StreamRemoteConnector.ReadMode

Field Summary

Fields

Modifier and Type	Field	Description
protected final Clock	clock
protected final ScheduledExecutorService	executor
protected final Map<AuthStatus,Class<? extends RemoteConnectorState>>	stateMachineMappings

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

cmdBuffer, inputBuffer, logger, MAX_MSG_EXPECTED, protocol

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	StreamRemoteConnector(LocalIdentifier ourLocalId, MenuCommandProtocol protocol, ScheduledExecutorService executor, Clock clock)

Method Summary

Modifier and Type	Method	Description
boolean	canSendMessageNow(MenuCommand cmd)
void	changeState(AuthStatus desiredState)
void	changeState(RemoteConnectorState newState)
void	close()	Force close a connection when its known to be bad, the connector will try and establish a new connection.
protected void	connectionLog(System.Logger.Level l, String s, Throwable e)
AuthStatus	getAuthenticationStatus()
Clock	getClock()
RemoteInformation	getRemoteParty()
ScheduledExecutorService	getScheduledExecutor()
protected void	handleCoreConnectionStates(ConnectMode connectMode)
protected void	notifyConnection()	Helper method that notifies all connection listeners of a change in connectivity
void	notifyListeners(MenuCommand mc)	Helper method that notifies all listeners of a new command message
void	registerConnectionChangeListener(ConnectionChangeListener listener)	Register for connection change events, when there is a change in connectivity status on the underlying transport.
void	registerConnectorListener(RemoteConnectorListener listener)	Register for connector messages, when new messages are received from this stream.
void	sendAcknowledgement(AckStatus ackStatus)
void	sendHeartbeat(int frequency, MenuHeartbeatCommand.HeartbeatMode mode)
protected abstract void	sendInternal(ByteBuffer outputBuffer)	performs a send of all bytes in the output buffer until the output buffer is empty
void	sendJoin()
void	sendPairing()
void	setRemoteParty(RemoteInformation remote)
protected void	startThreadProc()
protected void	stopThreadProc()

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

connectionLog, doesBufferHaveEOM, getAtLeastBytes, getConnectionName, isDeviceConnected, 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

getConnectionName, isDeviceConnected, sendMenuCommand, start, stop

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

getConnectionName, isDeviceConnected, performConnection, readCommandFromStream

Field Details

executor

protected final ScheduledExecutorService executor

clock

protected final Clock clock

stateMachineMappings

protected final Map<AuthStatus,Class<? extends RemoteConnectorState>> stateMachineMappings

Constructor Details

StreamRemoteConnector

protected StreamRemoteConnector(LocalIdentifier ourLocalId,
 MenuCommandProtocol protocol,
 ScheduledExecutorService executor,
 Clock clock)

Method Details

canSendMessageNow

public boolean canSendMessageNow(MenuCommand cmd)

Specified by:

canSendMessageNow in class SharedStreamConnection

stopThreadProc

protected void stopThreadProc()

startThreadProc

protected void startThreadProc()

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

handleCoreConnectionStates

protected void handleCoreConnectionStates(ConnectMode connectMode)

sendInternal

protected abstract void sendInternal(ByteBuffer outputBuffer)
                              throws IOException

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

Specified by:

sendInternal in class SharedStreamConnection

Parameters:

outputBuffer - the buffer data to be sent

Throws:

IOException - if there are problems writing

registerConnectorListener

public void registerConnectorListener(RemoteConnectorListener listener)

Register for connector messages, when new messages are received from this stream.

Specified by:

registerConnectorListener in interface RemoteConnector

Parameters:

listener - the listener to be registered

registerConnectionChangeListener

public void registerConnectionChangeListener(ConnectionChangeListener listener)

Register for connection change events, when there is a change in connectivity status on the underlying transport.

Specified by:

registerConnectionChangeListener in interface RemoteConnector

Parameters:

listener - the listener

notifyListeners

public void notifyListeners(MenuCommand mc)

Helper method that notifies all listeners of a new command message

Specified by:

notifyListeners in interface RemoteConnectorContext

Parameters:

mc - the message to notify

notifyConnection

protected void notifyConnection()

Helper method that notifies all connection listeners of a change in connectivity

changeState

public void changeState(AuthStatus desiredState)

Specified by:

changeState in interface RemoteConnectorContext

changeState

public void changeState(RemoteConnectorState newState)

Specified by:

changeState in interface RemoteConnectorContext

getRemoteParty

public RemoteInformation getRemoteParty()

Specified by:

getRemoteParty in interface RemoteConnector

Returns:

the remote party information of the current connection

setRemoteParty

public void setRemoteParty(RemoteInformation remote)

Specified by:

setRemoteParty in interface RemoteConnectorContext

getAuthenticationStatus

public AuthStatus getAuthenticationStatus()

Specified by:

getAuthenticationStatus in interface RemoteConnector

Returns:

the status of the connection and authentication.

sendHeartbeat

public void sendHeartbeat(int frequency,
 MenuHeartbeatCommand.HeartbeatMode mode)

Specified by:

sendHeartbeat in interface RemoteConnectorContext

sendJoin

public void sendJoin()
              throws IOException

Specified by:

sendJoin in interface RemoteConnectorContext

Throws:

IOException

sendAcknowledgement

public void sendAcknowledgement(AckStatus ackStatus)
                         throws IOException

Specified by:

sendAcknowledgement in interface RemoteConnectorContext

Throws:

IOException

sendPairing

public void sendPairing()
                 throws IOException

Specified by:

sendPairing in interface RemoteConnectorContext

Throws:

IOException

getScheduledExecutor

public ScheduledExecutorService getScheduledExecutor()

Specified by:

getScheduledExecutor in interface RemoteConnectorContext

getClock

public Clock getClock()

Specified by:

getClock in interface RemoteConnectorContext

connectionLog

protected void connectionLog(System.Logger.Level l,
 String s,
 Throwable e)