Hooking up to the Server Context Tree

ContextPlugin interface provides several groups of methods to attach some new elements to the Iotellect Server context tree. Every group has two methods: one "startup" method called at server startup or context creation and one "shutdown" method called at server shutdown or context destruction.

When a new context plugin is created, server calls its initialize() method that may contain some generic initialization code.

When the plugin going to be destroyed, server calls its deinitialize() method.

Every time when new context is created or re-created on server startup, server calls install(Context context) method of the plugin. Its implementation may:

• Add some variable/function/event/action definitions to the context and optionally provide their "custom code" (variable getters/setters, function implementations)

• Add event listeners to the context

Please avoid accessing other server contexts from the install(Context context) method. Since server context tree creation is concurrent, certain server contexts may be available at the time of debugging and become unavailable in production environment, causing unpredictable behaviour. To access the whole context tree, add your code to install(ContextManager contextManager) or launch() methods.

The install(ContextManager contextManager) method is called once right after server context tree finishes loading and all contexts were created. Its implementation may retrieve certain server contexts using ContextManager.get() method and add variable/function/event/action definitions and/or event listeners to them.

launch() method of the plugin is called in the very end of server startup, when all server contexts and components are up and running. It should be implemented only if some code fails to work properly from any of the methods described above.

Was this page helpful?

Tell us more

Send

Thank you!