org.apache.twill.api

Interface TwillRunner

All Known Subinterfaces:

TwillRunnerService

public interface TwillRunner

This interface prepares execution of TwillRunnable and TwillApplication.

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static interface	TwillRunner.LiveInfo Interface to represents information of a live application.

Method Summary

Methods

Modifier and Type	Method and Description
Iterable<TwillController>	lookup(String applicationName) Gets an Iterable of TwillController for all running instances of the given application.
TwillController	lookup(String applicationName, RunId runId) Gets a TwillController for the given application and runId.
Iterable<TwillRunner.LiveInfo>	lookupLive() Gets an Iterable of TwillRunner.LiveInfo.
TwillPreparer	prepare(TwillApplication application) Prepares to run the given TwillApplication as specified by the application.
TwillPreparer	prepare(TwillRunnable runnable) Prepares to run the given TwillRunnable with ResourceSpecification.BASIC resource specification.
TwillPreparer	prepare(TwillRunnable runnable, ResourceSpecification resourceSpecification) Prepares to run the given TwillRunnable with the given resource specification.
Cancellable	scheduleSecureStoreUpdate(SecureStoreUpdater updater, long initialDelay, long delay, TimeUnit unit) Schedules a periodic update of SecureStore.

Method Detail

prepare

TwillPreparer prepare(TwillRunnable runnable)

Prepares to run the given TwillRunnable with ResourceSpecification.BASIC resource specification.

Parameters:

runnable - The runnable to run through Twill when TwillPreparer.start() is called.

Returns:

A TwillPreparer for setting up runtime options.

prepare

TwillPreparer prepare(TwillRunnable runnable,
                    ResourceSpecification resourceSpecification)

Prepares to run the given TwillRunnable with the given resource specification.

Parameters:

runnable - The runnable to run through Twill when TwillPreparer.start() is called.

resourceSpecification - The resource specification for running the runnable.

Returns:

A TwillPreparer for setting up runtime options.

prepare

TwillPreparer prepare(TwillApplication application)

Prepares to run the given TwillApplication as specified by the application.

Parameters:

application - The application to run through Twill when TwillPreparer.start() is called.

Returns:

A TwillPreparer for setting up runtime options.

lookup

TwillController lookup(String applicationName,
                     RunId runId)

Gets a TwillController for the given application and runId.

Parameters:

applicationName - Name of the application.

runId - The runId of the running application.

Returns:

A TwillController to interact with the application or null if no such runId is found.

lookup

Iterable<TwillController> lookup(String applicationName)

Gets an Iterable of TwillController for all running instances of the given application.

Parameters:

applicationName - Name of the application.

Returns:

A live Iterable that gives the latest TwillController set for all running instances of the application when Iterable.iterator() is invoked.

lookupLive

Iterable<TwillRunner.LiveInfo> lookupLive()

Gets an Iterable of TwillRunner.LiveInfo.

Returns:

A live Iterable that gives the latest information on the set of applications that have running instances when Iterable.iterator()} is invoked.

scheduleSecureStoreUpdate

Cancellable scheduleSecureStoreUpdate(SecureStoreUpdater updater,
                                    long initialDelay,
                                    long delay,
                                    TimeUnit unit)

Schedules a periodic update of SecureStore. The first call to the given SecureStoreUpdater will be made after initialDelay, and subsequently with the given delay between completion of one update and starting of the next. If exception is thrown on call SecureStoreUpdater.update(String, RunId), the exception will only get logged and won't suppress the next update call.

Parameters:

updater - A SecureStoreUpdater for creating new SecureStore.

initialDelay - Delay before the first call to update method.

delay - Delay between completion of one update call to the next one.

unit - time unit for the initialDelay and delay.

Returns:

A Cancellable for cancelling the scheduled update.