ModuleActivator Struct Reference

Customizes the starting and stopping of a CppMicroServices module. More...

Public Member Functions
virtual	~ModuleActivator ()
virtual void	Load (ModuleContext *context)=0
	Called when this module is loaded. More...
virtual void	Unload (ModuleContext *context)=0
	Called when this module is unloaded. More...

Detailed Description

Customizes the starting and stopping of a CppMicroServices module.

ModuleActivator is an interface that can be implemented by CppMicroServices modules. The CppMicroServices library can create instances of a module's ModuleActivator as required. If an instance's ModuleActivator::Load method executes successfully, it is guaranteed that the same instance's ModuleActivator::Unload method will be called when the module is to be unloaded. The CppMicroServices library does not concurrently call a ModuleActivator object.

ModuleActivator is an abstract class interface whose implementations must be exported via a special macro. Implementations are usually declared and defined directly in .cpp files.

class MyActivator : public ModuleActivator
{

public:

  void Load(ModuleContext* /*context*/)
  { /* register stuff */ }


  void Unload(ModuleContext* /*context*/)
  { /* cleanup */ }

};

US_EXPORT_MODULE_ACTIVATOR(mylibname, MyActivator)

The class implementing the ModuleActivator interface must have a public default constructor so that a ModuleActivator object can be created by the CppMicroServices library.

Constructor & Destructor Documentation

virtual ModuleActivator::~ModuleActivator ( )

inlinevirtual

Member Function Documentation

virtual void ModuleActivator::Load ( ModuleContext *  context )

pure virtual

Called when this module is loaded.

This method can be used to register services or to allocate any resources that this module may need globally (during the whole module lifetime).

This method must complete and return to its caller in a timely manner.

Parameters

context

The execution context of the module being loaded.

Exceptions

std::exception

If this method throws an exception, this module is marked as stopped and the framework will remove this module's listeners, unregister all services registered by this module, and release all services used by this module.

virtual void ModuleActivator::Unload ( ModuleContext *  context )

pure virtual

Called when this module is unloaded.

In general, this method should undo the work that the ModuleActivator::Load method started. There should be no active threads that were started by this module when this method returns.

This method must complete and return to its caller in a timely manner.

Parameters

context

The execution context of the module being unloaded.

Exceptions

std::exception

If this method throws an exception, the module is still marked as unloaded, and the framework will remove the module's listeners, unregister all services registered by the module, and release all services used by the module.