The framework of Robotlegs 2 is a lot smaller that it's predecessor. It's aim is to provide a small and lightweight base for installing other plugin base code with a few core features to initialize expandability.
The framework is the Context class which incorperates and combines a set of smaller functional classes.
The injector is at the heart of Robotlegs. It's a dependancy provider allowing you to provide different values for Interfaces or Classes. This enables us to easily re-use code.
The Extension Installer give the classes a reference to the context. Enabling them to have complete access to the framework.
The Config Manager allows user to configure based on pre-mapped values in the injector.
The Pin keeps reference of object instances preventing them being garbage collected.
The Guards are a simple class allowing/prevening things to happen.
The Hooks are simple actions that happen in order.
- Lifecycle State
- Log Manager
- Config Manager
- Object Processor
- Extension Installer
There are a lot of extensions avalible and installed for you in the MVCSBundle, and a lot of them work together to function correctly.
Lets talk about how some of them work.
View management, is something that is happening in the background listening to Views that get registered. And then giving that to the correct context to be processed.
The Container Registry has a static dictionary of all containers. A container is the root of all views (often a context view). The Container Registry knows the relation of each container (if they are parents, siblings or children). Because this dictionary is static, it persists throughout multiple contexts.
The View Manager knows about some containers. You have one assigned to a single context. Usually you will only have one container (the context view) but can have multiple root containers. When you add it here, it gets added to the container registry.
The Stage Crawler extension uses the ViewManager's containers, and scans all children for View's to register. This is done incase the view's registered early and were not processed.
The Context View just contains your root view, it assigns the view as a container to the View Manager.
Expanding The Context
The Stage Sync extension uses the ContextView's view as the object to sync the Context's lifecycle extension with.
The Viligence extension changes the
logger.Error("message") from the context into execeptions that are thrown.
We have added the IMatcher classes as for checking types before being processed. This is used to help in the EventCommand, ViewProcessor and MediatorMap.
The CommandCenter classes is some classes for other extensions to use. The command center give you the command executor. Which can execute commands with a payload. This is great, but as a robotlegs user, it is not part of an extensions. Nothing is mapped yet.
The DirectCommandMap is the simplist implementation of the CommamndCenter library. It mapps a class to give you a simple set of API to execute your commands with payloads.
The EventCommandMap is the event based command center. This stores event types and listenes for them on the event dispatcher. Then when it hears the event it will add a injection rule for the event class and then fire the command.
The MediatorMap adds a delegate to the ViewManager. This gives us the view when registered. The mediator map, attaches mediators and associates them with this view. The Mediator class uses the LocalEventMap a class to help manage listeners you've added and remove them all upon disposal.
The ViewProcessorMap adds rules with the IMatcher for all views and will perform a process on them (without creating a mediator).
The Modularity Extension establishes communication between each context by relaying events from Global Event Dispatcher's to each other. It uses the ModuleConnector to make different channels and relays events with the EventRelay class
A fairly detailed overview
- Command Center
- Context View
- Stage Sync
- Context View Listener Config
- Direct Command Map
- Enhanced Logging
- Event Command Map
- Event Dispatcher
- Local Event Map
- InstanceOf Matcher
- [Type Matcher](../src/robotlegs/bender/extensions/matching/readme.md#TypeMatcher Usage)
- [Namespace Matcher](../src/robotlegs/bender/extensions/matching/readme.md#NamespaceMatcher Usage)
- Modularity Extension
- Module Connector
- View Management
- Container Registry
- Parent Finder
- View Notifier
- View Processor