Package org.yamcs

Class ProcessRunner

java.lang.Object

com.google.common.util.concurrent.AbstractService

org.yamcs.AbstractYamcsService

org.yamcs.ProcessRunner

All Implemented Interfaces:

com.google.common.util.concurrent.Service, YamcsService

public class ProcessRunner
extends AbstractYamcsService

Global service that launches and supervises a configured program or script. The primary purpose is to run non-java code, or to decouple java code that uses a fragile or untested JNI layer.

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

Field Summary

Fields inherited from class org.yamcs.AbstractYamcsService

config, log, serviceName, yamcsInstance

Constructor Summary

Constructors

Constructor	Description
ProcessRunner()

Method Summary

Modifier and Type	Method	Description
protected void	doStart()
protected void	doStop()
Spec	getSpec()	Returns the valid configuration options for this service.
void	init(String yamcsInstance, String serviceName, YConfiguration config)	Initialize this service.
protected void	onProcessOutput(String line)

Methods inherited from class org.yamcs.AbstractYamcsService

getConfig, getYamcsInstance

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

addListener, awaitRunning, awaitRunning, awaitTerminated, awaitTerminated, 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

Methods inherited from interface com.google.common.util.concurrent.Service

addListener, awaitRunning, awaitRunning, awaitTerminated, awaitTerminated, failureCause, isRunning, startAsync, state, stopAsync

Methods inherited from interface org.yamcs.YamcsService

init

Constructor Detail

ProcessRunner

public ProcessRunner()

Method Detail

getSpec

public Spec getSpec()

Description copied from interface: YamcsService

Returns the valid configuration options for this service.

Returns:

the argument specification, or null if the args should not be validated.

init

public void init(String yamcsInstance,
                 String serviceName,
                 YConfiguration config)
          throws InitException

Description copied from interface: YamcsService

Initialize this service. This is called before the service is started. All operations should finish fast.

Specified by:

init in interface YamcsService

Overrides:

init in class AbstractYamcsService

Parameters:

yamcsInstance - The yamcs instance, or null if this is a global service.

serviceName - The service name.

config - The configured arguments for this service. If YamcsService.getSpec() is implemented then this contains the arguments after being validated (including any defaults).

Throws:

InitException - When something goes wrong during the execution of this method.

doStart

protected void doStart()

Specified by:

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

onProcessOutput

protected void onProcessOutput(String line)

doStop

protected void doStop()

Specified by:

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