InvocationScope

public class InvocationScope
extends Object implements Scope

java.lang.Object
   ↳ com.android.tradefed.guice.InvocationScope

Scopes a single Tradefed invocation.

The scope can be initialized with one or more seed values by calling seed(key, value) before the injector will be called upon to provide for this key. A typical use is for a test invocation to enter/exit the scope, representing an invocation Scope, and seed configuration objects. For each key inserted with seed(), you must include a corresponding binding: 


   bind(key)
       .toProvider(SimpleScope.seededKeyProvider())
       .in(InvocationScoped.class);
FIXME: Possibly handle multi objects (like lists).

Summary

Public constructors

InvocationScope()

Public methods

void enter()

Start marking the scope of the Tradefed Invocation.

void exit()

Mark the end of the scope for the Tradefed Invocation.

static InvocationScope getDefault()
<T> Provider<T> scope(Key<T> key, Provider<T> unscoped)
<T> void seed(Key<T> key, T value)

Seed a key/value that will be available during the TF invocation scope to be used.

<T> void seed(Class<T> clazz, T value)

Seed a key/value that will be available during the TF invocation scope to be used.

void seedConfiguration(IConfiguration config)

Interface init between Tradefed and Guice: This is the place where TF object are seeded to the invocation scope to be used.

static <T> Provider<T> seededKeyProvider()

Returns a provider that always throws exception complaining that the object in question must be seeded before it can be injected.

Public constructors

InvocationScope

public InvocationScope ()

Public methods

enter

public void enter ()

Start marking the scope of the Tradefed Invocation.

exit

public void exit ()

Mark the end of the scope for the Tradefed Invocation.

getDefault

public static InvocationScope getDefault ()

Returns
InvocationScope

scope

public Provider<T> scope (Key<T> key, 
                Provider<T> unscoped)

Parameters
key Key

unscoped Provider

Returns
Provider<T>

seed

public void seed (Key<T> key, 
                T value)

Seed a key/value that will be available during the TF invocation scope to be used.

Parameters
key Key: the key used to represent the object.
value T: The actual object that will be available during the invocation.

seed

public void seed (Class<T> clazz, 
                T value)

Seed a key/value that will be available during the TF invocation scope to be used.

Parameters
clazz Class: the Class used to represent the object.
value T: The actual object that will be available during the invocation.

seedConfiguration

public void seedConfiguration (IConfiguration config)

Interface init between Tradefed and Guice: This is the place where TF object are seeded to the invocation scope to be used.

Parameters
config IConfiguration: The Tradefed configuration.

seededKeyProvider

public static Provider<T> seededKeyProvider ()

Returns a provider that always throws exception complaining that the object in question must be seeded before it can be injected.

Returns
Provider<T> typed provider