Module com.thecoderscorner.tcmenu.javaapi

Package com.thecoderscorner.menu.remote

Class StreamRemoteConnector

java.lang.Object

com.thecoderscorner.menu.remote.StreamRemoteConnector

All Implemented Interfaces:

RemoteConnector, RemoteConnectorContext

Direct Known Subclasses:

SocketBasedConnector

public abstract class StreamRemoteConnector
extends Object
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 class	StreamRemoteConnector.ReadMode

Field Summary

Fields

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

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method	Description
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)
protected void	connectionLog(System.Logger.Level l, String s, Throwable e)
static boolean	doesBufferHaveEOM(ByteBuffer inputBuffer)
protected abstract void	getAtLeastBytes(ByteBuffer inputBuffer, int len, StreamRemoteConnector.ReadMode mode)	Reads at least the number of bytes requested waiting if need be for more data.
AuthStatus	getAuthenticationStatus()
Clock	getClock()
RemoteInformation	getRemoteParty()
ScheduledExecutorService	getScheduledExecutor()
protected void	handleCoreConnectionStates(ConnectMode connectMode)
protected void	logByteBuffer(String msg, ByteBuffer inBuffer)	Helper method that logs the entire message buffer when at debug logging level.
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
MenuCommand	readCommandFromStream()
protected void	readCompleteMessage(ByteBuffer inputBuffer)
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	sendMenuCommand(MenuCommand msg)	Sends a command to the remote with the protocol and usual headers.
void	sendPairing()
void	setRemoteParty(RemoteInformation remote)
protected void	startThreadProc()
protected void	stopThreadProc()

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, start, stop

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

getConnectionName, isDeviceConnected, performConnection

Field Details

logger

protected final System.Logger logger

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

readCommandFromStream

public MenuCommand readCommandFromStream()
                                  throws IOException

Specified by:

readCommandFromStream in interface RemoteConnectorContext

Throws:

IOException

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

sendMenuCommand

public void sendMenuCommand(MenuCommand msg)
                     throws IOException

Sends a command to the remote with the protocol and usual headers.

Specified by:

sendMenuCommand in interface RemoteConnector

Parameters:

msg - the message to send.

Throws:

IOException - if there are issues with the transport

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

Parameters:

outputBuffer - the buffer data to be sent

Throws:

IOException - if there are problems writing

getAtLeastBytes

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

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

Parameters:

inputBuffer - the buffer to read from

len - the minimum number of bytes needed

Throws:

IOException - if there are problems reading.

readCompleteMessage

protected void readCompleteMessage(ByteBuffer inputBuffer)
                            throws IOException

Throws:

IOException

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

logByteBuffer

protected void logByteBuffer(String msg,
 ByteBuffer inBuffer)

Helper method that logs the entire message buffer when at debug logging level.

Parameters:

msg - the message to print first

inBuffer - the buffer to be logged

doesBufferHaveEOM

public static boolean doesBufferHaveEOM(ByteBuffer inputBuffer)

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)

connectionLog

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