@ConsumerType public interface EndpointEventListener
ENDPOINT_LISTENER_SCOPE. This service property is a list of filters. An Endpoint Description should only be given to a Endpoint Event Listener when there is at least one filter that matches the Endpoint Description properties. This filter model is quite flexible. For example, a discovery bundle is only interested in locally originating Endpoint Descriptions. The following filter ensures that it only sees local endpoints.
(org.osgi.framework.uuid=72dc5fd9-5f8f-4f8f-9821-9ebb433a5b72)In the same vein, a manager that is only interested in remote Endpoint Descriptions can use a filter like:
(!(org.osgi.framework.uuid=72dc5fd9-5f8f-4f8f-9821-9ebb433a5b72))Where in both cases, the given UUID is the UUID of the local framework that can be found in the Framework properties. The Endpoint Event Listener's scope maps very well to the service hooks. A manager can just register all filters found from the Listener Hook as its scope. This will automatically provide it with all known endpoints that match the given scope, without having to inspect the filter string. In general, when an Endpoint Description is discovered, it should be dispatched to all registered Endpoint Event Listener services. If a new Endpoint Event Listener is registered, it should be informed about all currently known Endpoints that match its scope. If a getter of the Endpoint Listener service is unregistered, then all its registered Endpoint Description objects must be removed. The Endpoint Event Listener models a best effort approach. Participating bundles should do their utmost to keep the listeners up to date, but implementers should realize that many endpoints come through unreliable discovery processes. The Endpoint Event Listener supersedes the
EndpointListenerinterface as it also supports notifications around modifications of endpoints.
|Modifier and Type||Field and Description|
Specifies the interest of this listener with filters.
|Modifier and Type||Method and Description|
Notification that an endpoint has changed.
static final java.lang.String ENDPOINT_LISTENER_SCOPE
void endpointChanged(EndpointEvent event, java.lang.String filter)
event- The event containing the details about the change.
filter- The filter from the
ENDPOINT_LISTENER_SCOPEthat matches (or for
EndpointEvent.REMOVEDused to match) the endpoint, must not be
Copyright © OSGi Alliance (2000, 2018). All Rights Reserved. Licensed under the OSGi Specification License, Version 2.0