byucc.jhdl.apps.Stimulator
Class StimulatorThread

java.lang.Object
  byucc.jhdl.apps.util.SwingWorker
      byucc.jhdl.apps.util.SimulatorThread
          byucc.jhdl.apps.Stimulator.StimulatorThread

public class StimulatorThread

extends SimulatorThread

This thread should be used from GUIs to execute Stimulator puts to wires. This is important especially when using ClockThreads for executing long simulation runs that would otherwise lock up the GUI. If this Thread is used for any of the simulation control, it should be used for all of it. To be sure that simulator clock events (steps and cycles) are executed in the proper order relative to Stimulator events, make sure that you use ClockThreads as well.

It is crucial to note that StimulatorThreads are queued (in the SimulatorThread queue) in the order they are created, not necessarily in the order they are started by the creating thread.

Author:

Anthony L. Slade

See Also:

ClockThread

Constructor Summary

StimulatorThread(java.lang.String putFileName)
Creates and queues up a new StimulatorThread.

StimulatorThread(java.lang.String wireName, java.lang.String[] values)
Creates and queues up a new StimulatorThread.

Method Summary

java.lang.Object

construct() This is the SwingWorker method that gets called to do the work of this thread

Methods inherited from class byucc.jhdl.apps.util.SimulatorThread

addReturnedListener, finished, start

Methods inherited from class byucc.jhdl.apps.util.SwingWorker

get, getValue, interrupt

Methods inherited from class java.lang.Object

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

Constructor Detail

StimulatorThread

public StimulatorThread(java.lang.String wireName,
                        java.lang.String[] values)

Creates and queues up a new StimulatorThread. This constructor uses a wire name/values pair call to put.

Parameters:

wireName - the name of the wire to put to.

values - the values to put to the wire.

StimulatorThread

public StimulatorThread(java.lang.String putFileName)

Creates and queues up a new StimulatorThread. This constructor calls the Stimulator put method for a file of values to put.

Parameters:

putFileName - the name of the Properties file iwth

Method Detail

construct

public java.lang.Object construct()

This is the SwingWorker method that gets called to do the work of this thread

Specified by:

construct in class SwingWorker

Returns:

some object representative of the work of this thread, in this case it is simply a successful message, unless an exception was found, in which case that is returned.