org.jmacs
Interface ISpi

public interface ISpi

service-provider interface, to be implemented by the JMACS Server vendor.

Version:

$Id: ISpi.java 639 2006-07-04 15:30:16Z rob $

Author:

Rob Dickens

See Also:

DiClients.getSpi()

Method Summary

IDiClient	newDiClient(String diName, IDiDriver driver, Object driverLock, String monitorGuiClassname, String controlsGuiClassname, Serializable constants) creates DI-client.
IDiClient	newDiClient(String diName, IDiDriver driver, String monitorGuiClassname, String controlsGuiClassname, Serializable constants) creates DI-client.
IDiClient	newDiClient(String diName, String driverClassname, String monitorGuiClassname, String controlsGuiClassname, Serializable constants) creates DI-client.

Method Detail

newDiClient

IDiClient newDiClient(String diName,
                      String driverClassname,
                      String monitorGuiClassname,
                      String controlsGuiClassname,
                      Serializable constants)
                      throws InterruptedException,
                             IOException

creates DI-client.

Parameters:

diName - fully-qualified domain.like.name of device interface, used to place the device interface in a hierarchy

driverClassname - fully-qualified name of class impl'ting IDiDriver and having public constructor optionally taking an argument of type Object, corr'ding to constants

monitorGuiClassname - ditto, but impl'ting IMonitorGui, or null

controlsGuiClassname - ditto, but impl'ting IControlsGui, or null (in which case commands will be limited to Strings submitted from a commandline)

constants - passed to the constructors of the named classes if non-null

Throws:

InterruptedException

IOException

newDiClient

IDiClient newDiClient(String diName,
                      IDiDriver driver,
                      String monitorGuiClassname,
                      String controlsGuiClassname,
                      Serializable constants)
                      throws InterruptedException,
                             IOException

creates DI-client.

Parameters:

driver - The caller undertakes not to access this subsequently.

Throws:

InterruptedException

IOException

newDiClient

IDiClient newDiClient(String diName,
                      IDiDriver driver,
                      Object driverLock,
                      String monitorGuiClassname,
                      String controlsGuiClassname,
                      Serializable constants)
                      throws InterruptedException,
                             IOException

creates DI-client.

Parameters:

driver - acquire driverLock before accessing this subsequently

Throws:

InterruptedException

IOException