CppMicroServices

C++ Micro Services: ModuleFindHook Struct Reference
ModuleFindHook Struct Referenceabstract

Module Context Hook Service. More...

Public Member Functions

virtual ~ModuleFindHook ()
 
virtual void Find (const ModuleContext *context, ShrinkableVector< Module * > &modules)=0
 Find hook method. More...
 

Detailed Description

Module Context Hook Service.

Modules registering this service will be called during module find (get modules) operations.

Remarks
Implementations of this interface are required to be thread-safe.

Constructor & Destructor Documentation

virtual ModuleFindHook::~ModuleFindHook ( )
virtual

Member Function Documentation

virtual void ModuleFindHook::Find ( const ModuleContext context,
ShrinkableVector< Module * > &  modules 
)
pure virtual

Find hook method.

This method is called for module find operations using ModuleContext::GetBundle(long) and ModuleContext::GetModules() methods. The find method can filter the result of the find operation.

Note
A find operation using the ModuleContext::GetModule(const std::string&) method does not cause the find method to be called, neither does any call to the static methods of the ModuleRegistry class.
Parameters
contextThe module context of the module performing the find operation.
modulesA list of Modules to be returned as a result of the find operation. The implementation of this method may remove modules from the list to prevent the modules from being returned to the module performing the find operation.