org.lsst.ccs.gconsole.agent.command

Class CommandSender

java.lang.Object

org.lsst.ccs.gconsole.agent.command.CommandSender

public class CommandSender
extends Object

Utility class for sending commands to remote subsystems and processing responses. The sender can be configured by calling its setter methods. This class is thread-safe, all methods can be called on any thread.

Author:

onoprien

Constructor Summary

Constructors

Constructor and Description
CommandSender(org.lsst.ccs.messaging.AgentMessagingLayer messenger, Executor callbackExecutor, Executor workerExecutor, org.lsst.ccs.utilities.scheduler.Scheduler timer) Creates an instance of CommandSender.

Method Summary

Modifier and Type	Method and Description
CommandTask	execute(CommandHandle handle, Duration timeout, String command, Object... args) Sends a command to a remote subsystem.
void	setCommandHandle(CommandHandle defaultCommandHandle) Sets the default command handle for this sender.
void	setTimeout(Duration defaultTimeout) Sets the default command timeout for this sender.

Methods inherited from class java.lang.Object

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

Constructor Detail

CommandSender

public CommandSender(org.lsst.ccs.messaging.AgentMessagingLayer messenger,
                     Executor callbackExecutor,
                     Executor workerExecutor,
                     org.lsst.ccs.utilities.scheduler.Scheduler timer)

Creates an instance of CommandSender.

Parameters:

messenger - Messaging access point. If null, the environment messaging access will be used.

callbackExecutor - Executor for running CommandHandle methods. If null, a dedicated single-threaded executor will be created.

workerExecutor - Executor for running potentially time-consuming tasks. If null, a dedicated executor will be created.

timer - Scheduling executor for timing commands.

Method Detail

setTimeout

public void setTimeout(Duration defaultTimeout)

Sets the default command timeout for this sender. The specified timeout will be used for command execution requests that do not provide their own timeout values. If this method has not been called, the default timeout value is 10 seconds.

Parameters:

defaultTimeout - Default timeout. Zero means the command will never time out. Negative timeout means its absolute value will be used and the custom timeout suggested by the target subsystem through an ACK will be ignored.

setCommandHandle

public void setCommandHandle(CommandHandle defaultCommandHandle)

Sets the default command handle for this sender. The specified handle will be used for command execution requests that do not provide their own handle.

Parameters:

defaultCommandHandle - Default command handle.

execute

public CommandTask execute(CommandHandle handle,
                           Duration timeout,
                           String command,
                           Object... args)

Sends a command to a remote subsystem. This method returns immediately, without waiting for the command to be processed by the messaging service or the target subsystem. Synchronous command execution can be done by calling get() or getResult() on the CommandTask returned by this method.

Parameters:

handle - Handle for processing the command responses. If null, the default command handle of this sender will be used if it has been set, or no processing will be performed if it has not been set..

timeout - Timeout. If null, the default timeout of this sender will be used. Zero means the command will never time out. Negative timeout means its absolute value will be used and the custom timeout suggested by the target subsystem through an ACK will be ignored.

command - Command in subsystem/path format.

args - Command arguments.

Returns:

CommandTask created to process the command. Can be used to wait for the response or cancel the command processing.