Listeners

using ServiceListener = std::function<void(ServiceEvent const&)>

A ServiceEvent listener.

A ServiceListener can be any callable object and is registered with the Framework using the BundleContext#AddServiceListener(const ServiceListener&, const std::string&) method. ServiceListener instances are called with a ServiceEvent object when a service has been registered, unregistered, or modified.

See also

ServiceEvent

using BundleListener = std::function<void(BundleEvent const&)>

A BundleEvent listener.

When a BundleEvent is fired, it is asynchronously (if threading support is enabled) delivered to a BundleListener. The Framework delivers BundleEvent objects to a BundleListener in order and does not concurrently call a BundleListener.

A BundleListener can be any callable object and is registered with the Framework using the BundleContext#AddBundleListener(const BundleListener&) method. BundleListener instances are called with a BundleEvent object when a bundle has been installed, resolved, started, stopped, updated, unresolved, or uninstalled.

See also

BundleEvent

using FrameworkListener = std::function<void(FrameworkEvent const&)>

A FrameworkEvent listener.

When a BundleEvent is fired, it is asynchronously (if threading support is enabled) delivered to a FrameworkListener. The Framework delivers FrameworkEvent objects to a FrameworkListener in order and does not concurrently call a FrameworkListener.

A FrameworkListener can be any callable object and is registered with the Framework using the BundleContext#AddFrameworkListener(const FrameworkListener&) method. FrameworkListener instances are called with a FrameworkEvent object when a framework life-cycle event or notification message occured.

See also

FrameworkEvent

template<class R>
ServiceListener ServiceListenerMemberFunctor(R *receiver, void (R::* callback)(ServiceEvent const&))

A convenience function that binds the member function callback of an object of type R and returns a ServiceListener object.

This object can then be passed into AddServiceListener().

Deprecated since version 3.1.0: This function exists only to maintain backwards compatibility and will be removed in the next major release. Use std::bind instead.

Template Parameters:

R – The type containing the member function.

Parameters:
  • receiver – The object of type R.

  • callback – The member function pointer.

Returns:

a ServiceListener object.

template<class R>
BundleListener BundleListenerMemberFunctor(R *receiver, void (R::* callback)(BundleEvent const&))

A convenience function that binds the member function callback of an object of type R and returns a BundleListener object.

This object can then be passed into AddBundleListener().

Deprecated since version 3.1.0: This function exists only to maintain backwards compatibility and will be removed in the next major release. Use std::bind instead.

Template Parameters:

R – The type containing the member function.

Parameters:
  • receiver – The object of type R.

  • callback – The member function pointer.

Returns:

a BundleListener object.

template<class R>
FrameworkListener BindFrameworkListenerToFunctor(R *receiver, void (R::* callback)(FrameworkEvent const&))

A convenience function that binds the member function callback of an object of type R and returns a FrameworkListener object.

This object can then be passed into AddFrameworkListener().

Deprecated since version 3.1.0: This function exists only to maintain backwards compatibility and will be removed in the next major release. Use std::bind instead.

Template Parameters:

R – The type containing the member function.

Parameters:
  • receiver – The object of type R.

  • callback – The member function pointer.

Returns:

a FrameworkListener object.