diff options
Diffstat (limited to 'bundles/org.eclipse.osgi/osgi/src/org/osgi/framework/ServiceListener.java')
-rw-r--r-- | bundles/org.eclipse.osgi/osgi/src/org/osgi/framework/ServiceListener.java | 40 |
1 files changed, 19 insertions, 21 deletions
diff --git a/bundles/org.eclipse.osgi/osgi/src/org/osgi/framework/ServiceListener.java b/bundles/org.eclipse.osgi/osgi/src/org/osgi/framework/ServiceListener.java index d73f8e9b4..601dfda61 100644 --- a/bundles/org.eclipse.osgi/osgi/src/org/osgi/framework/ServiceListener.java +++ b/bundles/org.eclipse.osgi/osgi/src/org/osgi/framework/ServiceListener.java @@ -1,5 +1,5 @@ /* - * Copyright (c) OSGi Alliance (2000, 2010). All Rights Reserved. + * Copyright (c) OSGi Alliance (2000, 2012). All Rights Reserved. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. @@ -19,33 +19,31 @@ package org.osgi.framework; import java.util.EventListener; /** - * A {@code ServiceEvent} listener. {@code ServiceListener} is a - * listener interface that may be implemented by a bundle developer. When a + * A {@code ServiceEvent} listener. {@code ServiceListener} is a listener + * interface that may be implemented by a bundle developer. When a * {@code ServiceEvent} is fired, it is synchronously delivered to a - * {@code ServiceListener}. The Framework may deliver - * {@code ServiceEvent} objects to a {@code ServiceListener} out - * of order and may concurrently call and/or reenter a - * {@code ServiceListener}. + * {@code ServiceListener}. The Framework may deliver {@code ServiceEvent} + * objects to a {@code ServiceListener} out of order and may concurrently call + * and/or reenter a {@code ServiceListener}. * * <p> - * A {@code ServiceListener} object is registered with the Framework - * using the {@code BundleContext.addServiceListener} method. - * {@code ServiceListener} objects are called with a - * {@code ServiceEvent} object when a service is registered, modified, or - * is in the process of unregistering. + * A {@code ServiceListener} object is registered with the Framework using the + * {@code BundleContext.addServiceListener} method. {@code ServiceListener} + * objects are called with a {@code ServiceEvent} object when a service is + * registered, modified, or is in the process of unregistering. * * <p> - * {@code ServiceEvent} object delivery to {@code ServiceListener} - * objects is filtered by the filter specified when the listener was registered. - * If the Java Runtime Environment supports permissions, then additional - * filtering is done. {@code ServiceEvent} objects are only delivered to - * the listener if the bundle which defines the listener object's class has the - * appropriate {@code ServicePermission} to get the service using at - * least one of the named classes under which the service was registered. + * {@code ServiceEvent} object delivery to {@code ServiceListener} objects is + * filtered by the filter specified when the listener was registered. If the + * Java Runtime Environment supports permissions, then additional filtering is + * done. {@code ServiceEvent} objects are only delivered to the listener if the + * bundle which defines the listener object's class has the appropriate + * {@code ServicePermission} to get the service using at least one of the named + * classes under which the service was registered. * * <p> - * {@code ServiceEvent} object delivery to {@code ServiceListener} - * objects is further filtered according to package sources as defined in + * {@code ServiceEvent} object delivery to {@code ServiceListener} objects is + * further filtered according to package sources as defined in * {@link ServiceReference#isAssignableTo(Bundle, String)}. * * @see ServiceEvent |