Examples of org.osgi.service.remoteserviceadmin.EndpointEventListener

Package org.osgi.service.remoteserviceadmin

Examples of org.osgi.service.remoteserviceadmin.EndpointEventListener

org.osgi.service.remoteserviceadmin.EndpointEventListener
A white board service that represents a listener for endpoints. An Endpoint Event Listener represents a participant in the distributed model that is interested in Endpoint Descriptions. This white board service can be used in many different scenarios. However, the primary use case is to allow a remote manager to be informed of Endpoint Descriptions available in the network and inform the network about available Endpoint Descriptions. Both the network bundle and the manager bundle register an Endpoint Event Listener service. The manager informs the network bundle about Endpoints that it creates. The network bundles then uses a protocol like SLP to announce these local end-points to the network. If the network bundle discovers a new Endpoint through its discovery protocol, then it sends an Endpoint Description to all the Endpoint Listener services that are registered (except its own) that have specified an interest in that endpoint. Endpoint Event Listener services can express their scope with the service property {@link #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 {@link EndpointListener} interfaceas it also supports notifications around modifications of endpoints. @ThreadSafe @since 1.1

            logError(logMethodName, message, e);
          }
        // and EndpointEventListenerEvents
        } else if (eventObject instanceof EndpointEventListenerEvent) {
          final EndpointEventListenerEvent event = (EndpointEventListenerEvent) eventObject;
          final EndpointEventListener endpointEventListener = event.getEndpointEventListener();
          final EndpointEvent endpointEvent = event.getEndpointEvent();
          final String matchingFilter = event.getMatchingFilter();
          try {
            trace("endpointEventListener.discovered=" + getEndpointEventTypeAsString(endpointEvent.getType()) + " ", "fwk=" + getFrameworkUUID() + ", endpointEventListener=" //$NON-NLS-1$ //$NON-NLS-2$ //$NON-NLS-3$ //$NON-NLS-4$
                    + endpointEventListener
                    + ", endpointEvent=" //$NON-NLS-1$
                    + endpointEvent + ", matchingFilter=" //$NON-NLS-1$
                    + matchingFilter);
            endpointEventListener.endpointChanged(endpointEvent,
                matchingFilter);
          } catch (Exception e) {
            String message = "Exception in EndpointEventListener listener=" //$NON-NLS-1$
                + endpointEventListener + " event=" //$NON-NLS-1$
                + endpointEvent + " matchingFilter=" //$NON-NLS-1$
                + matchingFilter;
            logError(logMethodName, message, e);
          } catch (LinkageError e) {
            String message = "LinkageError in EndpointEventListener listener=" //$NON-NLS-1$
                + endpointEventListener + " event=" //$NON-NLS-1$
                + endpointEvent + " matchingFilter=" //$NON-NLS-1$
                + matchingFilter;
            logError(logMethodName, message, e);
          } catch (AssertionError e) {
            String message = "AssertionError in EndpointEventListener listener=" //$NON-NLS-1$
                + endpointEventListener + " event=" //$NON-NLS-1$
                + endpointEvent + " matchingFilter=" //$NON-NLS-1$
                + matchingFilter;
            logError(logMethodName, message, e);
            
          }
        }
      }
    });
    // Register the endpoint listener tracker, so that endpoint listeners
    // that are subsequently added
    // will then be notified of discovered endpoints
    endpointListenerTracker = new ServiceTracker(context,
        EndpointListener.class.getName(),
        new ServiceTrackerCustomizer() {
          public Object addingService(ServiceReference reference) {
            if (context == null)
              return null;
            EndpointListener listener = (EndpointListener) context
                .getService(reference);
            if (listener == null)
              return null;
            Collection<org.osgi.service.remoteserviceadmin.EndpointDescription> allDiscoveredEndpointDescriptions = getAllDiscoveredEndpointDescriptions();
            for (org.osgi.service.remoteserviceadmin.EndpointDescription ed : allDiscoveredEndpointDescriptions) {
              EndpointDescriptionLocator.EndpointListenerHolder[] endpointListenerHolders = getMatchingEndpointListenerHolders(
                  new ServiceReference[] { reference }, ed);
              if (endpointListenerHolders != null) {
                for (int i = 0; i < endpointListenerHolders.length; i++) {
                  queueEndpointDescription(
                      endpointListenerHolders[i]
                          .getListener(),
                      endpointListenerHolders[i]
                          .getDescription(),
                      endpointListenerHolders[i]
                          .getMatchingFilter(), true);
                }
              }
            }
            return listener;
          }


          public void modifiedService(ServiceReference reference,
              Object service) {
          }


          public void removedService(ServiceReference reference,
              Object service) {
          }
        });


    endpointListenerTracker.open();


    // Register the endpoint event listener tracker, so that endpoint event listeners
    // that are subsequently added
    // will then be notified of discovered endpoints
    endpointEventListenerTracker = new ServiceTracker(context,
        EndpointEventListener.class.getName(),
        new ServiceTrackerCustomizer() {
          public Object addingService(ServiceReference reference) {
            if (context == null)
              return null;
            EndpointEventListener listener = (EndpointEventListener) context
                .getService(reference);
            if (listener == null)
              return null;
            Collection<org.osgi.service.remoteserviceadmin.EndpointDescription> allDiscoveredEndpointDescriptions = getAllDiscoveredEndpointDescriptions();
            for (org.osgi.service.remoteserviceadmin.EndpointDescription ed : allDiscoveredEndpointDescriptions) {

View Full Code Here

      ServiceReference[] refs, EndpointDescription description, int type) {
    if (refs == null)
      return null;
    List results = new ArrayList();
    for (int i = 0; i < refs.length; i++) {
      EndpointEventListener listener = (EndpointEventListener) context
          .getService(refs[i]);
      if (listener == null)
        continue;
      List<String> filters = PropertiesUtil.getStringPlusProperty(
          getMapFromProperties(refs[i]),

View Full Code Here

                      : message), e));
    }


    private void deliverSafe(EndpointEvent endpointEvent,
        String matchingFilter) {
      EndpointEventListener listener = Activator.this.basicTopologyManagerImpl;
      if (listener == null)
        return;
      try {
        listener.endpointChanged(endpointEvent, matchingFilter);
      } catch (Exception e) {
        String message = "Exception in EndpointEventListener listener=" //$NON-NLS-1$
            + listener + " event=" //$NON-NLS-1$
            + endpointEvent + " matchingFilter=" //$NON-NLS-1$
            + matchingFilter;

View Full Code Here

TOP

Related Classes of org.osgi.service.remoteserviceadmin.EndpointEventListener

org.eclipse.ecf.internal.osgi.services.distribution.Activator$ProxyEndpointEventListener

org.eclipse.ecf.osgi.services.remoteserviceadmin.EndpointDescriptionLocator

All source code are property of their respective owners. Java is a trademark of Sun Microsystems, Inc and owned by ORACLE Inc. Contact coftware#gmail.com.