de.morknet.mrw.comm.dummy

Class DummyConnection

java.lang.Object

de.morknet.mrw.comm.Connection

de.morknet.mrw.comm.dummy.DummyConnection

public class DummyConnection
extends Connection

Diese Klasse simuliert eine Kommunikationsverbindung zu einer Eisenbahnanlage. Sie ist in der Lage diverse Fehlerfälle zu simulieren, was zum Testen brauchbar ist.

Author:

sm

Field Summary

Fields inherited from class de.morknet.mrw.comm.Connection

processor

Constructor Summary

Constructors

Constructor and Description
DummyConnection()

Method Summary

Methods

Modifier and Type	Method and Description
void	close() Diese Methode baut die Kommunikationsverbindung wieder ab.
int	read() Diese Methode liest ein einzelnes Byte über diese Verbindung ein.
void	setChecksumError(int maxErrorOffset, boolean oneshot) Diese Methode stellt das Fehlerverhalten bzgl. der Prüfsummenfehler ein.
void	setRejectFullAnswer(boolean rejectAnswer) Diese Methode stellt das Fehlerverhalten aller Schaltkommandos ein.
void	setRejectSwitchAnswer(boolean rejectSwitchAnswer) Diese Methode stellt das Fehlerverhalten für Weichenschaltkommandos ein.
void	setSwitchFailureMode(boolean forceSwitchFailure) Diese Methode stellt das Fehlerverhalten für Weichenschaltkommandos ein.
void	simulateReception(CANMessage msg) Diese Methode simuliert das Empfangen einer CAN-Message über diese Verbindung.
protected void	start() Diese Methode wird aufgerufen, wenn die Methode Connection.setByteProcessor(ByteProcessor) einen ByteProcessor setzt, der ungleich null ist.
protected void	stop() Diese Methode wird aufgerufen, wenn die Methode Connection.setByteProcessor(ByteProcessor) einen ByteProcessor setzt, der gleich null ist.
void	write(byte[] bytes) Diese Methode schreibt ein Array aus Bytes über die Kommunikationsverbindung.
void	write(int input) Diese Methode schreibt ein einzelnes Byte über die Kommunikationsverbindung.

Methods inherited from class de.morknet.mrw.comm.Connection

getDefaultConnection, getSyncSequence, handleChecksumException, isReal, setByteProcessor, sync

Methods inherited from class java.lang.Object

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

Constructor Detail

DummyConnection

public DummyConnection()

Method Detail

start

protected void start()

Description copied from class: Connection

Diese Methode wird aufgerufen, wenn die Methode Connection.setByteProcessor(ByteProcessor) einen ByteProcessor setzt, der ungleich null ist. Dadurch soll das Verarbeiten von Bytes seinen Betrieb aufnehmen.

Specified by:

start in class Connection

stop

protected void stop()

Description copied from class: Connection

Diese Methode wird aufgerufen, wenn die Methode Connection.setByteProcessor(ByteProcessor) einen ByteProcessor setzt, der gleich null ist. Dadurch soll das Verarbeiten von eingehenden Bytes abgeschaltet werden.

Specified by:

stop in class Connection

close

public void close()

Description copied from class: Connection

Diese Methode baut die Kommunikationsverbindung wieder ab.

Specified by:

close in class Connection

read

public int read()
         throws java.io.IOException

Description copied from class: Connection

Diese Methode liest ein einzelnes Byte über diese Verbindung ein.

Specified by:

read in class Connection

Returns:

Das gelesene Byte

Throws:

java.io.IOException - Diese Exception wird geworfen, wenn das Lesen fehlschlug.

write

public void write(int input)
           throws java.io.IOException

Description copied from class: Connection

Diese Methode schreibt ein einzelnes Byte über die Kommunikationsverbindung.

Specified by:

write in class Connection

Parameters:

input - Das zu schreibende Byte.

Throws:

java.io.IOException - Diese Exception wird geworfen, wenn das Schreiben fehlschlug.

write

public void write(byte[] bytes)
           throws java.io.IOException

Description copied from class: Connection

Diese Methode schreibt ein Array aus Bytes über die Kommunikationsverbindung.

Specified by:

write in class Connection

Parameters:

bytes - Die zu schreibenden Bytes.

Throws:

java.io.IOException - Diese Exception wird geworfen, wenn das Schreiben fehlschlug.

simulateReception

public void simulateReception(CANMessage msg)
                       throws java.io.IOException

Diese Methode simuliert das Empfangen einer CAN-Message über diese Verbindung. Evtl. eingestelltes Fehlerverhalten greift hier.

Parameters:

msg - Die zu empfangende CAN-Message.

Throws:

java.io.IOException - Die Exception, die geworfen wird, falls beim Empfang was schief lief.

setSwitchFailureMode

public void setSwitchFailureMode(boolean forceSwitchFailure)

Diese Methode stellt das Fehlerverhalten für Weichenschaltkommandos ein. Ist der Fehlermodus aktiviert, wird jedes Weichenschaltkommando mit einem MsgCode.MSG_SWITCH_FAILED quittiert.

Parameters:

forceSwitchFailure - Flag, ob Weichenschaltfehler gemeldet werden sollen.

setRejectSwitchAnswer

public void setRejectSwitchAnswer(boolean rejectSwitchAnswer)

Diese Methode stellt das Fehlerverhalten für Weichenschaltkommandos ein. Ist dieser Fehlermodus aktiviert, kommen auf Weichenschaltkommandos keine Vollzugsantworten MsgCode.MSG_OK mehr. Dies kann bei einer Verklemmung einer Weiche passieren.

Parameters:

rejectSwitchAnswer - Flag, ob Vollzugsmeldungen gesendet werden sollen.

setRejectFullAnswer

public void setRejectFullAnswer(boolean rejectAnswer)

Diese Methode stellt das Fehlerverhalten aller Schaltkommandos ein. Ist dieser Fehlermodus aktiviert, kommen keine Vollzugsantworten mehr MsgCode.MSG_OK. Das System verhält sich dann so, als ob die Anlage nicht mehr verbunden ist.

Parameters:

rejectAnswer - Flag, ob überhaupt Vollzugsmeldungen gesendet werden sollen.

setChecksumError

public void setChecksumError(int maxErrorOffset,
                    boolean oneshot)

Diese Methode stellt das Fehlerverhalten bzgl. der Prüfsummenfehler ein. Dabei können sporadisch fehlerhaft empfangene Bytes simuliert werden, wodurch letztlich Prüfsummenfehler auftreten. Dabei kann gewählt werden, ob einmalig ein Fehler verursacht werden soll, oder wiederholt. Letzteres stellt eine instabile Kommunikationsverbindung dar. Das Auftreten kann zufällig nach maximal einstellbarer Bytezahl gewählt werden.

Parameters:

maxErrorOffset - Die Maximalzahl an Bytes, bis zu der ein Fehler wahrscheinlich aufgetreten sein muss.

oneshot - Flag, ob einmalig oder wiederholt Bytes verfälscht werden sollen.