charly.server.resources
Interface ChRsrcManager

All Superinterfaces:

java.rmi.Remote

All Known Implementing Classes:

ChRsrcManagerImpl

public interface ChRsrcManager

extends java.rmi.Remote

Here only the methods the client can call are listed. Not included are the methods the devices on the server can call. The user usually does not have to call these methods.

Field Summary

static java.lang.String

DELIMITERCHAR The character separating a resource name from its parent resource name.

Method Summary

void	abortTask(java.lang.String taskID) abnormal abort of a running task. this method is usually called by ChMonitor.abortTask(String).
java.util.Set	getTasks() returns all known tasks.
java.lang.String	startTask(ChClientTask task, java.lang.String taskName, java.util.Set rsrcs) This method asks the Ressource-Manager to start the given task.
void	stopTask(ChClientTask task) normal finish of a task.
void	stopTask(java.lang.String taskID) normal finish of a task.

Field Detail

DELIMITERCHAR

public static final java.lang.String DELIMITERCHAR

The character separating a resource name from its parent resource name. It is by definition a slash ('/')..

See Also:

Constant Field Values

Method Detail

startTask

public java.lang.String startTask(ChClientTask task,
                                  java.lang.String taskName,
                                  java.util.Set rsrcs)
                           throws java.rmi.RemoteException,
                                  ChAlreadyStartingException,
                                  ChAlreadyStartedException

This method asks the Ressource-Manager to start the given task. For performance-reasons taskName and rscrs are parameters and are not asked subsequentially from the task.

Parameters:

task - the client-side task. Its taskStarted()-method is called.

taskName - the name of the task. The taskID is created on the base of this name.

rsrcs - this is a Set of String describing each a resource on the server, e.g. "GPIB/7".

Returns:

taskID this taskID describes the clientTask

Throws:

java.rmi.RemoteException

ChAlreadyStartingException

ChAlreadyStartedException

stopTask

public void stopTask(ChClientTask task)
              throws java.rmi.RemoteException,
                     ChTaskNotRunningException

normal finish of a task. This method is called by ChTask.stop()

Throws:

java.rmi.RemoteException

ChTaskNotRunningException

See Also:

stopTask(String)

stopTask

public void stopTask(java.lang.String taskID)
              throws java.rmi.RemoteException,
                     ChTaskNotRunningException

normal finish of a task. This method is called by ChTask.stop()

Throws:

java.rmi.RemoteException

ChTaskNotRunningException

See Also:

stopTask(ChClientTask), abortTask(String taskID)

abortTask

public void abortTask(java.lang.String taskID)
               throws java.rmi.RemoteException

abnormal abort of a running task. this method is usually called by ChMonitor.abortTask(String).

Throws:

java.rmi.RemoteException

getTasks

public java.util.Set getTasks()
                       throws java.rmi.RemoteException

returns all known tasks.

Returns:

Set of ChTaskInfo

Throws:

java.rmi.RemoteException