org.apache.slider.core.main

Interface RunService

All Superinterfaces:

AutoCloseable, Closeable, org.apache.hadoop.service.Service

All Known Implementing Classes:

AbstractSliderLaunchedService, LaunchedWorkflowCompositeService, Slider, SliderAppMaster, SliderClient

public interface RunService
extends org.apache.hadoop.service.Service

An interface which services can implement to have their execution managed by the ServiceLauncher. The command line options will be passed down before the Service.init(Configuration) operation is invoked via an invocation of bindArgs(Configuration, String...) After the service has been successfully started via Service.start() the runService() method is called to execute the service. When this method returns, the service launcher will exit, using the return code from the method as its exit option.

Nested Class Summary

Nested classes/interfaces inherited from interface org.apache.hadoop.service.Service

org.apache.hadoop.service.Service.STATE

Method Summary

Methods

Modifier and Type	Method and Description
org.apache.hadoop.conf.Configuration	bindArgs(org.apache.hadoop.conf.Configuration config, String... args) Propagate the command line arguments.
int	runService() Run a service.

Methods inherited from interface org.apache.hadoop.service.Service

close, getBlockers, getConfig, getFailureCause, getFailureState, getLifecycleHistory, getName, getServiceState, getStartTime, init, isInState, registerServiceListener, start, stop, unregisterServiceListener, waitForServiceToStop

Method Detail

bindArgs

org.apache.hadoop.conf.Configuration bindArgs(org.apache.hadoop.conf.Configuration config,
                                            String... args)
                                              throws Exception

Propagate the command line arguments. This method is called before Service.init(Configuration); the configuration that is returned from this operation is the one that is passed on to the init operation. This permits implemenations to change the configuration before the init operation.n

Parameters:

config - the initial configuration build up by the service launcher.

args - argument list list of arguments passed to the command line after any launcher-specific commands have been stripped.

Returns:

the configuration to init the service with. This MUST NOT be null. Recommended: pass down the config parameter with any changes

Throws:

Exception - any problem

runService

int runService()
               throws Throwable

Run a service. This called after Service.start()

Returns:

the exit code

Throws:

Throwable - any exception to report