Package org.yamcs.cmdhistory

Class CommandHistoryRequestManager

java.lang.Object

com.google.common.util.concurrent.AbstractService

org.yamcs.cmdhistory.CommandHistoryRequestManager

All Implemented Interfaces:

com.google.common.util.concurrent.Service

public class CommandHistoryRequestManager
extends com.google.common.util.concurrent.AbstractService

Part of processors: handles filtered requests for command history. We handle two kind of subscriptions:

• subscription to specific commands
• subscription to all the commands but filtered on source and time.

It receives commands from the cmd_history stream

Nested Class Summary

Nested classes/interfaces inherited from interface com.google.common.util.concurrent.Service

com.google.common.util.concurrent.Service.Listener, com.google.common.util.concurrent.Service.State

Constructor Summary

Constructors

Constructor	Description
CommandHistoryRequestManager(Processor processor)

Method Summary

Modifier and Type	Method	Description
void	addCommand(PreparedCommand pc)	Called when a new command has to be added to the command history (i.e. when a users sends a telecommand)
void	addSubscription(CommandHistoryFilter filter, CommandHistoryConsumer consumer)	Called by the CommandHistoryImpl to move the subscription from another command history manager to this one
void	commandFinished(Commanding.CommandId cmdId)	Called when there can be no more events for this command.
protected void	doStart()
protected void	doStop()
String	getInstance()
Commanding.CommandHistoryEntry	subscribeCommand(Commanding.CommandId cmdId, CommandHistoryConsumer consumer)	Add a consumer to the subscriber list for a command
CommandHistoryFilter	subscribeCommandHistory(String commandsOrigin, long commandsSince, CommandHistoryConsumer consumer)	Called by the CommandHistory consumers when they want to receive all updates corresponding to a command.
void	unsubscribeCommand(Commanding.CommandId cmdId, CommandHistoryConsumer consumer)	removes a consumer from the subscribers for a command (if existing).
CommandHistoryFilter	unsubscribeCommandHistory(int id)	Called by the CommandHistory consumers to remove the subscription
void	updateCommand(Commanding.CommandId cmdId, List<Attribute> attrs)	send updates.

Methods inherited from class com.google.common.util.concurrent.AbstractService

addListener, awaitRunning, awaitRunning, awaitRunning, awaitTerminated, awaitTerminated, awaitTerminated, doCancelStart, failureCause, isRunning, notifyFailed, notifyStarted, notifyStopped, startAsync, state, stopAsync, toString

Methods inherited from class java.lang.Object

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

Constructor Details

CommandHistoryRequestManager

public CommandHistoryRequestManager(Processor processor)
                             throws ConfigurationException

Throws:

ConfigurationException

Method Details

subscribeCommand

public Commanding.CommandHistoryEntry subscribeCommand(Commanding.CommandId cmdId,
 CommandHistoryConsumer consumer)
                                                throws InvalidCommandId

Add a consumer to the subscriber list for a command

Parameters:

cmdId -

consumer -

Returns:

all the entries existing so far for the command

Throws:

InvalidCommandId

unsubscribeCommand

public void unsubscribeCommand(Commanding.CommandId cmdId,
 CommandHistoryConsumer consumer)

removes a consumer from the subscribers for a command (if existing).

Parameters:

cmdId -

consumer -

subscribeCommandHistory

public CommandHistoryFilter subscribeCommandHistory(String commandsOrigin,
 long commandsSince,
 CommandHistoryConsumer consumer)

Called by the CommandHistory consumers when they want to receive all updates corresponding to a command.

unsubscribeCommandHistory

public CommandHistoryFilter unsubscribeCommandHistory(int id)

Called by the CommandHistory consumers to remove the subscription

Parameters:

id -

addSubscription

public void addSubscription(CommandHistoryFilter filter,
 CommandHistoryConsumer consumer)

Called by the CommandHistoryImpl to move the subscription from another command history manager to this one

Parameters:

filter -

addCommand

public void addCommand(PreparedCommand pc)

Called when a new command has to be added to the command history (i.e. when a users sends a telecommand)

updateCommand

public void updateCommand(Commanding.CommandId cmdId,
 List<Attribute> attrs)

send updates.

Parameters:

cmdId -

attrs -

commandFinished

public void commandFinished(Commanding.CommandId cmdId)

Called when there can be no more events for this command.

We remove it from the active commands only after a few seconds because some tools may subscribe to it after being sent and if there was no verifier, the command would immediately disappear so the subscription would fail.

doStart

protected void doStart()

Specified by:

doStart in class com.google.common.util.concurrent.AbstractService

doStop

protected void doStop()

Specified by:

doStop in class com.google.common.util.concurrent.AbstractService

getInstance

public String getInstance()