diff options
Diffstat (limited to 'bundles/org.eclipse.osgi/osgi/src/org/osgi/framework/hooks/service/ListenerHook.java')
| -rw-r--r-- | bundles/org.eclipse.osgi/osgi/src/org/osgi/framework/hooks/service/ListenerHook.java | 42 |
1 files changed, 18 insertions, 24 deletions
diff --git a/bundles/org.eclipse.osgi/osgi/src/org/osgi/framework/hooks/service/ListenerHook.java b/bundles/org.eclipse.osgi/osgi/src/org/osgi/framework/hooks/service/ListenerHook.java index 959ee37e1..94029e2b7 100644 --- a/bundles/org.eclipse.osgi/osgi/src/org/osgi/framework/hooks/service/ListenerHook.java +++ b/bundles/org.eclipse.osgi/osgi/src/org/osgi/framework/hooks/service/ListenerHook.java @@ -1,5 +1,5 @@ /* - * Copyright (c) OSGi Alliance (2008, 2011). All Rights Reserved. + * Copyright (c) OSGi Alliance (2008, 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. @@ -17,7 +17,6 @@ package org.osgi.framework.hooks.service; import java.util.Collection; - import org.osgi.framework.BundleContext; /** @@ -43,8 +42,8 @@ public interface ListenerHook { * @param listeners A collection of {@link ListenerInfo}s for newly added * service listeners which are now listening to service events. * Attempting to add to or remove from the collection will result in - * an {@code UnsupportedOperationException}. The collection is - * not synchronized. + * an {@code UnsupportedOperationException}. The collection is not + * synchronized. */ void added(Collection<ListenerInfo> listeners); @@ -57,8 +56,8 @@ public interface ListenerHook { * @param listeners A collection of {@link ListenerInfo}s for newly removed * service listeners which are no longer listening to service events. * Attempting to add to or remove from the collection will result in - * an {@code UnsupportedOperationException}. The collection is - * not synchronized. + * an {@code UnsupportedOperationException}. The collection is not + * synchronized. */ void removed(Collection<ListenerInfo> listeners); @@ -81,17 +80,15 @@ public interface ListenerHook { * Return the filter string with which the listener was added. * * @return The filter string with which the listener was added. This may - * be {@code null} if the listener was added without a - * filter. + * be {@code null} if the listener was added without a filter. */ String getFilter(); /** * Return the state of the listener for this addition and removal life - * cycle. Initially this method will return {@code false} - * indicating the listener has been added but has not been removed. - * After the listener has been removed, this method must always return - * {@code true}. + * cycle. Initially this method will return {@code false} indicating the + * listener has been added but has not been removed. After the listener + * has been removed, this method must always return {@code true}. * * <p> * There is an extremely rare case in which removed notification to @@ -109,19 +106,16 @@ public interface ListenerHook { boolean isRemoved(); /** - * Compares this {@code ListenerInfo} to another - * {@code ListenerInfo}. Two {@code ListenerInfo}s are equals - * if they refer to the same listener for a given addition and removal - * life cycle. If the same listener is added again, it must have a - * different {@code ListenerInfo} which is not equal to this - * {@code ListenerInfo}. + * Compares this {@code ListenerInfo} to another {@code ListenerInfo}. + * Two {@code ListenerInfo}s are equals if they refer to the same + * listener for a given addition and removal life cycle. If the same + * listener is added again, it must have a different + * {@code ListenerInfo} which is not equal to this {@code ListenerInfo}. * - * @param obj The object to compare against this - * {@code ListenerInfo}. - * @return {@code true} if the other object is a - * {@code ListenerInfo} object and both objects refer to - * the same listener for a given addition and removal life - * cycle. + * @param obj The object to compare against this {@code ListenerInfo}. + * @return {@code true} if the other object is a {@code ListenerInfo} + * object and both objects refer to the same listener for a + * given addition and removal life cycle. */ boolean equals(Object obj); |