Class SimulationTime

java.lang.Object
de.bsvrz.dav.daf.main.impl.SimulationTime

public class SimulationTime extends Object
Klasse zum Zugriff auf den Zeitfluß einer Simulation. Nach dem Erzeugen eines Objekts dieser Klasse kann mit der Methode getTime() auf die simulierte Zeit der jeweiligen Simulation zugegriffen werden und mit den Methoden sleep(long) und sleepUntil(long) kann der aufrufende Thread für eine bestimmte Zeit im Zeitfluß der Simulation blockiert werden. Die Methode close() sollte aufgerufen werden, wenn das Objekt zum Zugriff auf den Zeitfluß einer Simulation nicht mehr benötigt wird.
  • Constructor Summary

    Constructors
    Constructor
    Description
    SimulationTime(short simulationVariant, ClientDavConnection connection)
    Erzeugt ein neues Objekt zum Zugriff auf den Zeitfluß einer bestimmten Simulation.
  • Method Summary

    Modifier and Type
    Method
    Description
    final void
    Terminiert dieses Objekt und veranlasst bei einer Offline-Simulation die notwendige Abmeldung der Simulationszeiten.
    final long
    Bestimmt die Zeit einer Simulation.
    final void
    sleep(long timeToSleep)
    Blockiert den aufrufenden Thread für die spezifizierte Zeit.
    final void
    sleepUntil(long absoluteTime)
    Blockiert den aufrufenden Thread bis die spezifizierte Zeit erreicht ist.

    Methods inherited from class java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
  • Constructor Details

    • SimulationTime

      public SimulationTime(short simulationVariant, ClientDavConnection connection)
      Erzeugt ein neues Objekt zum Zugriff auf den Zeitfluß einer bestimmten Simulation. Im Falle einer Offline-Simulation findet eine Anmeldung auf die Simulationszeit der entsprechenden Simulationsvariante statt, die vom Simulationsdatengenerator zur Verfügung gestellt wird.
      Parameters:
      simulationVariant - Simulationsvariante der zu betrachtenden Simulation.
      connection - Datenverteilerverbindung über die die Kommunikation mit dem Simulationsdatengenerator durchgeführt wird.
  • Method Details

    • getTime

      public final long getTime()
      Bestimmt die Zeit einer Simulation. Bei einer Online-Simulation wird die aktuelle Zeit zurückgegeben und bei einer Offline-Simulation die simulierte Zeit.
      Returns:
      Zeitpunkt in Millisekunden seit 1970.
      Throws:
      IllegalStateException - Wenn der simulierte Zeitfluss im Falle einer Offline-Simulation nicht bestimmt werden kann.
      See Also:
    • sleep

      public final void sleep(long timeToSleep)
      Blockiert den aufrufenden Thread für die spezifizierte Zeit. Die angegebene Dauer der Pause wird im Falle einer Online-Simulation in Realzeit und im Falle einer Offline-Simulation im Zeitfluss der Simulation berücksichtigt.
      Parameters:
      timeToSleep - Wartezeit in Millisekunden seit 1970.
      Throws:
      IllegalStateException - Wenn der simulierte Zeitfluss im Falle einer Offline-Simulation nicht bestimmt werden kann.
      See Also:
    • sleepUntil

      public final void sleepUntil(long absoluteTime)
      Blockiert den aufrufenden Thread bis die spezifizierte Zeit erreicht ist. Der angegebene Zeitpunkt wird im Falle einer Online-Simulation in Realzeit und im Falle einer Offline-Simulation im Zeitfluss der Simulation berücksichtigt.
      Parameters:
      absoluteTime - Abzuwartender Zeitpunkt in Millisekunden seit 1970.
      Throws:
      IllegalStateException - Wenn der simulierte Zeitfluss im Falle einer Offline-Simulation nicht bestimmt werden kann.
      See Also:
    • close

      public final void close()
      Terminiert dieses Objekt und veranlasst bei einer Offline-Simulation die notwendige Abmeldung der Simulationszeiten.