01. Robotlegs Context

A context is a scope. It is core to any application or module built using Robotlegs.

Creating a Context

To create a context simply instantiate a new Context and provide some configuration:

_context = new Context()
   .install(MVCSBundle)
   .configure([MyModuleConfig, new ContextView(view)]);

Note: you must hold on to that context reference. Failing to do so will result in the context instance being garbage collected. In the example above we are installing a bundle, a configuration and a reference to a Display Object Container. The Display Object Container will be used as the "contextView". The "contextView" should always be provided as the final configuration as it may trigger context initialization.

Bundles and Extensions

An extension integrates 3rd party code into a context. A bundle groups a selection of extensions together into a single drop-in package. Most extensions and bundles can be installed as classes:

_context.install(MVCSBundle, InjectorLoggingExtension);

Some extensions offer some extra configuration by way of constructor arguments:

_context.install(new EventDispatcherExtension(myExistingEventDispatcher));

Usually these extensions provide sensible default constructor arguments and can be installed as classes: _context.install(EventDispatcherExtension); Extensions

Configuration

Configurations can be provided as class references or object instances. Class Configs Configs are normally supplied as class references:

_context.configure(MyModuleConfig);

If the context has already been initialized an instance of the supplied class will be instantiated using the context's injector. If the context is not yet initialized the class will be queued. When the context is initialized an instance of the class will be instantiated. Such a config might look like this:

class MyModuleConfig implements IConfig
{
   @inject public var mediatorMap:IMediatorMap;
   public function configure():Void
   {
      mediatorMap.map(SomeView).toMediator(SomeMediator);
   }
}

If a config implements the IConfig interface configure() will be invoked after construction/injection. Object Configs

_context.configure(new MyModuleConfig("hello"));

If the context has already been initialized the supplied object will simply be injected into. If the context is not yet initialized the object will be queued. When the context is initialized the object will be injected into.