Modified: felix/sandbox/pderop/dependencymanager-lambda/org.apache.felix.dependencymanager.lambda/src/org/apache/felix/dm/lambda/ServiceCallbacksBuilder.java URL: http://svn.apache.org/viewvc/felix/sandbox/pderop/dependencymanager-lambda/org.apache.felix.dependencymanager.lambda/src/org/apache/felix/dm/lambda/ServiceCallbacksBuilder.java?rev=1727768&r1=1727767&r2=1727768&view=diff ============================================================================== --- felix/sandbox/pderop/dependencymanager-lambda/org.apache.felix.dependencymanager.lambda/src/org/apache/felix/dm/lambda/ServiceCallbacksBuilder.java (original) +++ felix/sandbox/pderop/dependencymanager-lambda/org.apache.felix.dependencymanager.lambda/src/org/apache/felix/dm/lambda/ServiceCallbacksBuilder.java Sat Jan 30 23:49:06 2016 @@ -107,14 +107,14 @@ import org.apache.felix.dm.lambda.callba */ public interface ServiceCallbacksBuilder<S, B extends ServiceCallbacksBuilder<S, B>> { /** - * Sets some <code>callback</code> methods to invoke on the component instance(s). When a service matches the service + * Sets <code>callback</code> methods to invoke on the component instance(s). When a service matches the service * filter, then the service is injected using the specified callback methods. When you specify one callback, it stands for the "add" callback. * When you specify two callbacks, the first one corresponds to the "add" callback, and the second one to the "remove" callback. When you specify three * callbacks, the first one stands for the "add" callback, the second one for the "change" callback, and the third one for the "remove" callback. * When you specify four callbacks, it stands for "add"/"change"/"remove"/swap callbacks. * * The following method signature are supported: - * {@code + * <pre>{@code * method(S service) * method(S service, Map<String, Object> serviceProperties) * method(S service, Dictionary<String, Object> serviceProperties) @@ -128,14 +128,15 @@ public interface ServiceCallbacksBuilder * swapMethod(ServiceReference<S> oldRef, S old, ServiceReference<S> newRef, S newService) * swapMethod(Component component, S oldService, S newService) * swapMethod(Component component, ServiceReference<S> oldRef, S old, ServiceReference<S> newRef, S newService) - * } + * }</pre> + * * @param callbacks a list of callbacks (1 param: "add", 2 params: "add"/remove", 3 params: "add"/"change"/"remove", 4 params: "add"/"change"/"remove"/"swap" callbacks). * @return this builder */ B cb(String ... callbacks); /** - * Sets some <code>callback instance</code> methods to invoke on a given Object instance. When a service matches the service + * Sets <code>callback instance</code> methods to invoke on a given Object instance. When a service matches the service * filter, then the service is injected using the specified callback methods. When you specify one callback, it stands for the "add" callback. * When you specify two callbacks, the first one corresponds to the "add" callback, and the second one to the "remove" callback. When you specify three * callbacks, the first one stands for the "add" callback, the second one for the "change" callback, and the third one for the "remove" callback. @@ -148,8 +149,8 @@ public interface ServiceCallbacksBuilder B cbi(Object callbackInstance, String ... callbacks); /** - * Sets a <code>callback</code> java8 method reference which is invoked when a service is added. - * The method reference must point to a Component implementation class method, and take as argument the service. + * Sets a <code>callback</code> invoked when a service is added. + * The method reference must point to a Component implementation class method. Callback argument(s): the service. * * @param <T> the type of the component instance class on which the callback is invoked. * @param add the method reference invoked when a service is added. @@ -158,8 +159,8 @@ public interface ServiceCallbacksBuilder <T> B cb(CbTypeService<T, S> add); /** - * Sets some <code>callback</code> java8 method references which is invoked when a service is added or removed. - * The method references must point to a Component implementation class method, and take as argument the service. + * Sets a <code>callback</code> invoked when a service is added or removed. + * The method reference must point to a Component implementation class method. Callback argument(s): the service. * * @param <T> the type of the component instance class on which the callback is invoked. * @param add the method reference invoked when a service is added. @@ -169,8 +170,8 @@ public interface ServiceCallbacksBuilder <T> B cb(CbTypeService<T, S> add, CbTypeService<T, S> remove); /** - * Sets some <code>callback</code> java8 method references which is invoked when a service is added, changed, or removed. - * The method references must point to a Component implementation class method, and take as argument the service. + * Sets a <code>callback</code> invoked when a service is added, changed, or removed. + * The method reference must point to a Component implementation class method. Callback argument(s): the service. * * @param <T> the type of the component instance class on which the callback is invoked. * @param add the method reference invoked when a service is added. @@ -181,8 +182,8 @@ public interface ServiceCallbacksBuilder <T> B cb(CbTypeService<T, S> add, CbTypeService<T, S> change, CbTypeService<T, S> remove); /** - * Sets a <code>callback</code> java8 method reference which is invoked when a service is added. - * The method reference must point to a Component implementation class method, and take as arguments the service, and a properties map. + * Sets a <code>callback</code> invoked when a service is added. + * The method reference must point to a Component implementation class method. Callback argument(s): the service, and a properties map. * * @param <T> the type of the component instance class on which the callback is invoked. * @param add the method reference invoked when a service is added. @@ -191,8 +192,8 @@ public interface ServiceCallbacksBuilder <T> B cb(CbTypeServiceMap<T, S> add); /** - * Sets some <code>callback</code> java8 method references which is invoked when a service is added or removed. - * The method references must point to a Component implementation class method, and take as arguments the service, and a properties map. + * Sets a <code>callback</code> invoked when a service is added or removed. + * The method reference must point to a Component implementation class method. Callback argument(s): the service, and a properties map. * * @param <T> the type of the component instance class on which the callback is invoked. * @param add the method reference invoked when a service is added. @@ -202,8 +203,8 @@ public interface ServiceCallbacksBuilder <T> B cb(CbTypeServiceMap<T, S> add, CbTypeServiceMap<T, S> remove); /** - * Sets some <code>callback</code> java8 method references which is invoked when a service is added, changed, or removed. - * The method references must point to a Component implementation class method, and take as arguments the service, and a properties map. + * Sets a <code>callback</code> invoked when a service is added, changed, or removed. + * The method reference must point to a Component implementation class method. Callback argument(s): the service, and a properties map. * * @param <T> the type of the component instance class on which the callback is invoked. * @param add the method reference invoked when a service is added. @@ -214,8 +215,8 @@ public interface ServiceCallbacksBuilder <T> B cb(CbTypeServiceMap<T, S> add, CbTypeServiceMap<T, S> change, CbTypeServiceMap<T, S> remove); /** - * Sets a <code>callback</code> java8 method reference which is invoked when a service is added. - * The method reference must point to a Component implementation class method, and take as arguments the service, and a properties dictionary. + * Sets a <code>callback</code> invoked when a service is added. + * The method reference must point to a Component implementation class method. Callback argument(s): the service, and a properties dictionary. * * @param <T> the type of the component instance class on which the callback is invoked. * @param add the method reference invoked when a service is added. @@ -224,8 +225,8 @@ public interface ServiceCallbacksBuilder <T> B cb(CbTypeServiceDict<T, S> add); /** - * Sets some <code>callback</code> java8 method references which is invoked when a service is added or removed. - * The method references must point to a Component implementation class method, and take as arguments the service, and a properties dictionary. + * Sets a <code>callback</code> invoked when a service is added or removed. + * The method reference must point to a Component implementation class method. Callback argument(s): the service, and a properties dictionary. * * @param <T> the type of the component instance class on which the callback is invoked. * @param add the method reference invoked when a service is added. @@ -235,8 +236,8 @@ public interface ServiceCallbacksBuilder <T> B cb(CbTypeServiceDict<T, S> add, CbTypeServiceDict<T, S> remove); /** - * Sets some <code>callback</code> java8 method references which is invoked when a service is added, changed, or removed. - * The method references must point to a Component implementation class method, and take as arguments the service, and a properties dictionary. + * Sets a <code>callback</code> invoked when a service is added, changed, or removed. + * The method reference must point to a Component implementation class method. Callback argument(s): the service, and a properties dictionary. * * @param <T> the type of the component instance class on which the callback is invoked. * @param add the method reference invoked when a service is added. @@ -247,8 +248,8 @@ public interface ServiceCallbacksBuilder <T> B cb(CbTypeServiceDict<T, S> add, CbTypeServiceDict<T, S> change, CbTypeServiceDict<T, S> remove); /** - * Sets a <code>callback</code> java8 method reference which is invoked when a service is added. - * The method reference must point to a Component implementation class method, and take as arguments the service reference, and the service. + * Sets a <code>callback</code> invoked when a service is added. + * The method reference must point to a Component implementation class method. Callback argument(s): the service reference, and the service. * * @param <T> the type of the component instance class on which the callback is invoked. * @param add the method reference invoked when a service is added. @@ -257,8 +258,8 @@ public interface ServiceCallbacksBuilder <T> B cb(CbTypeRefService<T, S> add); /** - * Sets some <code>callback</code> java8 method references which is invoked when a service is added or removed. - * The method references must point to a Component implementation class method, and take as arguments the service reference, and the service. + * Sets a <code>callback</code> invoked when a service is added or removed. + * The method reference must point to a Component implementation class method. Callback argument(s): the service reference, and the service. * * @param <T> the type of the component instance class on which the callback is invoked. * @param add the method reference invoked when a service is added. @@ -268,8 +269,8 @@ public interface ServiceCallbacksBuilder <T> B cb(CbTypeRefService<T, S> add, CbTypeRefService<T, S> remove); /** - * Sets some <code>callback</code> java8 method references which is invoked when a service is added, changed, or removed. - * The method references must point to a Component implementation class method, and take as arguments the service reference, and the service. + * Sets a <code>callback</code> invoked when a service is added, changed, or removed. + * The method reference must point to a Component implementation class method. Callback argument(s): the service reference, and the service. * * @param <T> the type of the component instance class on which the callback is invoked. * @param add the method reference invoked when a service is added. @@ -280,8 +281,8 @@ public interface ServiceCallbacksBuilder <T> B cb(CbTypeRefService<T, S> add, CbTypeRefService<T, S> change, CbTypeRefService<T, S> remove); /** - * Sets a <code>callback</code> java8 method reference which is invoked when a service is added. - * The method reference must point to a Component implementation class method, and take as argument the service reference. + * Sets a <code>callback</code> invoked when a service is added. + * The method reference must point to a Component implementation class method. Callback argument(s): the service reference. * * @param <T> the type of the component instance class on which the callback is invoked. * @param add the method reference invoked when a service is added. @@ -290,8 +291,8 @@ public interface ServiceCallbacksBuilder <T> B cb(CbTypeRef<T, S> add); /** - * Sets some <code>callback</code> java8 method references which is invoked when a service is added or removed. - * The method references must point to a Component implementation class method, and take as argument the service reference. + * Sets a <code>callback</code> invoked when a service is added or removed. + * The method reference must point to a Component implementation class method. Callback argument(s): the service reference. * * @param <T> the type of the component instance class on which the callback is invoked. * @param add the method reference invoked when a service is added. @@ -301,8 +302,8 @@ public interface ServiceCallbacksBuilder <T> B cb(CbTypeRef<T, S> add, CbTypeRef<T, S> remove); /** - * Sets some <code>callback</code> java8 method references which is invoked when a service is added, changed, or removed. - * The method references must point to a Component implementation class method, and take as argument the service reference. + * Sets a <code>callback</code> invoked when a service is added, changed, or removed. + * The method reference must point to a Component implementation class method. Callback argument(s): the service reference. * * @param <T> the type of the component instance class on which the callback is invoked. * @param add the method reference invoked when a service is added. @@ -313,8 +314,8 @@ public interface ServiceCallbacksBuilder <T> B cb(CbTypeRef<T, S> add, CbTypeRef<T, S> change, CbTypeRef<T, S> remove); /** - * Sets a <code>callback</code> java8 method reference which is invoked when a service is added. - * The method reference must point to a Component implementation class method, and take as argument the Component. + * Sets a <code>callback</code> invoked when a service is added. + * The method reference must point to a Component implementation class method. Callback argument(s): the Component. * * @param <T> the type of the component instance class on which the callback is invoked. * @param add the method reference invoked when a service is added. @@ -323,8 +324,8 @@ public interface ServiceCallbacksBuilder <T> B cb(CbTypeComponent<T> add); /** - * Sets some <code>callback</code> java8 method references which is invoked when a service is added or removed. - * The method references must point to a Component implementation class method, and take as argument the Component. + * Sets a <code>callback</code> invoked when a service is added or removed. + * The method reference must point to a Component implementation class method. Callback argument(s): the Component. * * @param <T> the type of the component instance class on which the callback is invoked. * @param add the method reference invoked when a service is added. @@ -334,8 +335,8 @@ public interface ServiceCallbacksBuilder <T> B cb(CbTypeComponent<T> add, CbTypeComponent<T> remove); /** - * Sets some <code>callback</code> java8 method references which is invoked when a service is added, changed, or removed. - * The method references must point to a Component implementation class method, and take as argument the Component. + * Sets a <code>callback</code> invoked when a service is added, changed, or removed. + * The method reference must point to a Component implementation class method. Callback argument(s): the Component. * * @param <T> the type of the component instance class on which the callback is invoked. * @param add the method reference invoked when a service is added. @@ -346,8 +347,8 @@ public interface ServiceCallbacksBuilder <T> B cb(CbTypeComponent<T> add, CbTypeComponent<T> change, CbTypeComponent<T> remove); /** - * Sets a <code>callback</code> java8 method reference which is invoked when a service is added. - * The method reference must point to a Component implementation class method, and take as arguments the Component, and the service reference. + * Sets a <code>callback</code> invoked when a service is added. + * The method reference must point to a Component implementation class method. Callback argument(s): the Component, and the service reference. * * @param <T> the type of the component instance class on which the callback is invoked. * @param add the method reference invoked when a service is added. @@ -356,8 +357,8 @@ public interface ServiceCallbacksBuilder <T> B cb(CbTypeComponentRef<T, S> add); /** - * Sets some <code>callback</code> java8 method references which is invoked when a service is added or removed. - * The method references must point to a Component implementation class method, and take as arguments the Component, and the service reference. + * Sets a <code>callback</code> invoked when a service is added or removed. + * The method reference must point to a Component implementation class method. Callback argument(s): the Component, and the service reference. * * @param <T> the type of the component instance class on which the callback is invoked. * @param add the method reference invoked when a service is added. @@ -367,8 +368,8 @@ public interface ServiceCallbacksBuilder <T> B cb(CbTypeComponentRef<T, S> add, CbTypeComponentRef<T, S> remove); /** - * Sets some <code>callback</code> java8 method references which is invoked when a service is added, changed, or removed. - * The method references must point to a Component implementation class method, and take as arguments the Component, and the service reference. + * Sets a <code>callback</code> invoked when a service is added, changed, or removed. + * The method reference must point to a Component implementation class method. Callback argument(s): the Component, and the service reference. * * @param <T> the type of the component instance class on which the callback is invoked. * @param add the method reference invoked when a service is added. @@ -379,8 +380,8 @@ public interface ServiceCallbacksBuilder <T> B cb(CbTypeComponentRef<T, S> add, CbTypeComponentRef<T, S> change, CbTypeComponentRef<T, S> remove); /** - * Sets a <code>callback</code> java8 method reference which is invoked when a service is added. - * The method reference must point to a Component implementation class method, and take as arguments the Component, and the service. + * Sets a <code>callback</code> invoked when a service is added. + * The method reference must point to a Component implementation class method. Callback argument(s): the Component, and the service. * * @param <T> the type of the component instance class on which the callback is invoked. * @param add the method reference invoked when a service is added. @@ -389,8 +390,8 @@ public interface ServiceCallbacksBuilder <T> B cb(CbTypeComponentService<T, S> add); /** - * Sets some <code>callback</code> java8 method references which is invoked when a service is added or removed. - * The method references must point to a Component implementation class method, and take as arguments the Component, and the service. + * Sets a <code>callback</code> invoked when a service is added or removed. + * The method reference must point to a Component implementation class method. Callback argument(s): the Component, and the service. * * @param <T> the type of the component instance class on which the callback is invoked. * @param add the method reference invoked when a service is added. @@ -400,8 +401,8 @@ public interface ServiceCallbacksBuilder <T> B cb(CbTypeComponentService<T, S> add, CbTypeComponentService<T, S> remove); /** - * Sets some <code>callback</code> java8 method references which is invoked when a service is added, changed, or removed. - * The method references must point to a Component implementation class method, and take as arguments the Component, and the service. + * Sets a <code>callback</code> invoked when a service is added, changed, or removed. + * The method reference must point to a Component implementation class method. Callback argument(s): the Component, and the service. * * @param <T> the type of the component instance class on which the callback is invoked. * @param add the method reference invoked when a service is added. @@ -412,8 +413,8 @@ public interface ServiceCallbacksBuilder <T> B cb(CbTypeComponentService<T, S> add, CbTypeComponentService<T, S> change, CbTypeComponentService<T, S> remove); /** - * Sets a <code>callback</code> java8 method reference which is invoked when a service is added. - * The method reference must point to a Component implementation class method, and take as arguments the Component, the service Reference and the service. + * Sets a <code>callback</code> invoked when a service is added. + * The method reference must point to a Component implementation class method. Callback argument(s): the Component, the service Reference and the service. * * @param <T> the type of the component instance class on which the callback is invoked. * @param add the method reference invoked when a service is added. @@ -422,8 +423,8 @@ public interface ServiceCallbacksBuilder <T> B cb(CbTypeComponentRefService<T, S> add); /** - * Sets some <code>callback</code> java8 method references which is invoked when a service is added or removed. - * The method references must point to a Component implementation class method, and take as arguments the Component, the service Reference and the service. + * Sets a <code>callback</code> invoked when a service is added or removed. + * The method reference must point to a Component implementation class method. Callback argument(s): the Component, the service Reference and the service. * * @param <T> the type of the component instance class on which the callback is invoked. * @param add the method reference invoked when a service is added. @@ -433,8 +434,8 @@ public interface ServiceCallbacksBuilder <T> B cb(CbTypeComponentRefService<T, S> add, CbTypeComponentRefService<T, S> remove); /** - * Sets some <code>callback</code> java8 method references which is invoked when a service is added, changed, or removed. - * The method references must point to a Component implementation class method, and take as arguments the Component, the service Reference and the service. + * Sets a <code>callback</code> invoked when a service is added, changed, or removed. + * The method reference must point to a Component implementation class method. Callback argument(s): the Component, the service Reference and the service. * * @param <T> the type of the component instance class on which the callback is invoked. * @param add the method reference invoked when a service is added. @@ -445,8 +446,8 @@ public interface ServiceCallbacksBuilder <T> B cb(CbTypeComponentRefService<T, S> add, CbTypeComponentRefService<T, S> change, CbTypeComponentRefService<T, S> remove); /** - * Sets a swap <code>callback</code> java8 method reference which is invoked when a service is swapped. - * The method references must point to a Component implementation class method, and take as arguments the old service and the new replacing service. + * Sets a <code>swap callback(Service, Service)</code> invoked when a service is swapped. + * The method reference must point to a Component implementation class method. Callback argument(s): the old service and the new replacing service. * * @param <T> the type of the component instance class on which the callback is invoked. * @param swap the method reference invoked when the service is swapped. @@ -455,8 +456,8 @@ public interface ServiceCallbacksBuilder <T> B sw(CbTypeServiceService<T, S> swap); /** - * Sets a swap <code>callback</code> java8 method reference which is invoked when a service is swapped. - * The method references must point to a Component implementation class method, and take as arguments the component, the old service and the new replacing service. + * Sets a <code>swap callback(Component, Service, Service)</code> invoked when a service is swapped. + * The method reference must point to a Component implementation class method. Callback argument(s): the component, the old service and the new replacing service. * * @param <T> the type of the component instance class on which the callback is invoked. * @param swap the method reference invoked when the service is swapped. @@ -465,8 +466,8 @@ public interface ServiceCallbacksBuilder <T> B sw(CbTypeComponentServiceService<T, S> swap); /** - * Sets a swap <code>callback</code> java8 method reference which is invoked when a service is swapped. - * The method references must point to a Component implementation class method, and take as arguments the old service reference, the old service, the new service reference, and + * Sets a <code>swap callback(ServiceReference, Service, ServiceReference, Service)</code> invoked when a service is swapped. + * The method reference must point to a Component implementation class method. Callback argument(s): the old service reference, the old service, the new service reference, and * the new service. * * @param <T> the type of the component instance class on which the callback is invoked. @@ -476,8 +477,8 @@ public interface ServiceCallbacksBuilder <T> B sw(CbTypeRefServiceRefService<T, S> swap); /** - * Sets a swap <code>callback</code> java8 method reference which is invoked when a service is swapped. - * The method references must point to a Component implementation class method, and take as arguments the component, the old service reference, the old service, the new service reference, and + * Sets a swap <code>callback</code> invoked when a service is swapped. + * The method reference must point to a Component implementation class method. Callback argument(s): the component, the old service reference, the old service, the new service reference, and * the new service. * * @param <T> the type of the component instance class on which the callback is invoked. @@ -487,8 +488,8 @@ public interface ServiceCallbacksBuilder <T> B sw(CbTypeComponentRefServiceRefService<T, S> swap); /** - * Sets a <code>callback instance </code> java8 method reference which is invoked when a service is added. - * The method reference must point to method from an Object instance, and take as argument a service. + * Sets a <code>callback instance</code> invoked when a service is added. + * The method reference must point to a method from an Object instance. Callback argument(s): a service. * * @param add the method reference invoked when a service is added. * @return this builder @@ -496,8 +497,8 @@ public interface ServiceCallbacksBuilder B cbi(CbService<S> add); /** - * Sets some <code>callback instance </code> java8 method references which are invoked when a service is added/removed. - * The method references must point to method from an Object instance, and take as argument a service. + * Sets a <code>callback instance</code> invoked when a service is added/removed. + * The method reference must point to method from an Object instance. Callback argument(s): a service. * * @param add the method reference invoked when a service is added. * @param remove the method reference invoked when a service is removed. @@ -506,8 +507,8 @@ public interface ServiceCallbacksBuilder B cbi(CbService<S> add, CbService<S> remove); /** - * Sets some <code>callback instance </code> java8 method references which are invoked when a service is added/changed/removed. - * The method references must point to method from an Object instance, and take as argument a service. + * Sets a <code>callback instance</code> invoked when a service is added/changed/removed. + * The method reference must point to method from an Object instance. Callback argument(s): a service. * * @param add the method reference invoked when a service is added. * @param change the method reference invoked when a service is changed. @@ -517,8 +518,8 @@ public interface ServiceCallbacksBuilder B cbi(CbService<S> add, CbService<S> change, CbService<S> remove); /** - * Sets a <code>callback instance </code> java8 method reference which is invoked when a service is added. - * The method reference must point to method from an Object instance, and take as arguments a service and a properties Map. + * Sets a <code>callback instance</code> invoked when a service is added. + * The method reference must point to a method from an Object instance. Callback argument(s): a service and a properties Map. * * @param add the method reference invoked when a service is added. * @return this builder @@ -526,8 +527,8 @@ public interface ServiceCallbacksBuilder B cbi(CbServiceMap<S> add); /** - * Sets some <code>callback instance </code> java8 method references which are invoked when a service is added/removed. - * The method references must point to method from an Object instance, and take as arguments a service and a properties Map. + * Sets a <code>callback instance</code> invoked when a service is added/removed. + * The method reference must point to method from an Object instance. Callback argument(s): a service and a properties Map. * * @param add the method reference invoked when a service is added. * @param remove the method reference invoked when a service is removed. @@ -536,8 +537,8 @@ public interface ServiceCallbacksBuilder B cbi(CbServiceMap<S> add, CbServiceMap<S> remove); /** - * Sets some <code>callback instance </code> java8 method references which are invoked when a service is added/changed/removed. - * The method references must point to method from an Object instance, and take as arguments a service and a properties Map. + * Sets a <code>callback instance</code> invoked when a service is added/changed/removed. + * The method reference must point to method from an Object instance. Callback argument(s): a service and a properties Map. * * @param add the method reference invoked when a service is added. * @param change the method reference invoked when a service is changed. @@ -547,8 +548,8 @@ public interface ServiceCallbacksBuilder B cbi(CbServiceMap<S> add, CbServiceMap<S> change, CbServiceMap<S> remove); /** - * Sets a <code>callback instance </code> java8 method reference which is invoked when a service is added. - * The method reference must point to method from an Object instance, and take as arguments a service and a properties Dictionary. + * Sets a <code>callback instance</code> invoked when a service is added. + * The method reference must point to a method from an Object instance. Callback argument(s): a service and a properties Dictionary. * * @param add the method reference invoked when a service is added. * @return this builder @@ -556,8 +557,8 @@ public interface ServiceCallbacksBuilder B cbi(CbServiceDict<S> add); /** - * Sets some <code>callback instance </code> java8 method references which are invoked when a service is added/removed. - * The method references must point to method from an Object instance, and take as arguments a service and a properties Dictionary. + * Sets a <code>callback instance</code> invoked when a service is added/removed. + * The method reference must point to method from an Object instance. Callback argument(s): a service and a properties Dictionary. * * @param add the method reference invoked when a service is added. * @param remove the method reference invoked when a service is removed. @@ -566,8 +567,8 @@ public interface ServiceCallbacksBuilder B cbi(CbServiceDict<S> add, CbServiceDict<S> remove); /** - * Sets some <code>callback instance </code> java8 method references which are invoked when a service is added/changed/removed. - * The method references must point to method from an Object instance, and take as arguments a service and a properties Dictionary. + * Sets a <code>callback instance</code> invoked when a service is added/changed/removed. + * The method reference must point to method from an Object instance. Callback argument(s): a service and a properties Dictionary. * * @param add the method reference invoked when a service is added. * @param change the method reference invoked when a service is changed. @@ -577,8 +578,8 @@ public interface ServiceCallbacksBuilder B cbi(CbServiceDict<S> add, CbServiceDict<S> change, CbServiceDict<S> remove); /** - * Sets a <code>callback instance </code> java8 method reference which is invoked when a service is added. - * The method reference must point to method from an Object instance, and take as arguments a service reference and a service. + * Sets a <code>callback instance</code> invoked when a service is added. + * The method reference must point to a method from an Object instance. Callback argument(s): a service reference and a service. * * @param add the method reference invoked when a service is added. * @return this builder @@ -586,8 +587,8 @@ public interface ServiceCallbacksBuilder B cbi(CbRefService<S> add); /** - * Sets some <code>callback instance </code> java8 method references which are invoked when a service is added/removed. - * The method references must point to method from an Object instance, and take as arguments a service reference and a service. + * Sets a <code>callback instance</code> invoked when a service is added/removed. + * The method reference must point to method from an Object instance. Callback argument(s): a service reference and a service. * * @param add the method reference invoked when a service is added. * @param remove the method reference invoked when a service is removed. @@ -596,8 +597,8 @@ public interface ServiceCallbacksBuilder B cbi(CbRefService<S> add, CbRefService<S> remove); /** - * Sets some <code>callback instance </code> java8 method references which are invoked when a service is added/changed/removed. - * The method references must point to method from an Object instance, and take as arguments a service reference and a service. + * Sets a <code>callback instance</code> invoked when a service is added/changed/removed. + * The method reference must point to method from an Object instance. Callback argument(s): a service reference and a service. * * @param add the method reference invoked when a service is added. * @param change the method reference invoked when a service is changed. @@ -607,8 +608,8 @@ public interface ServiceCallbacksBuilder B cbi(CbRefService<S> add, CbRefService<S> change, CbRefService<S> remove); /** - * Sets a <code>callback instance </code> java8 method reference which is invoked when a service is added. - * The method reference must point to method from an Object instance, and take as argument a service reference. + * Sets a <code>callback instance</code> invoked when a service is added. + * The method reference must point to a method from an Object instance. Callback argument(s): a service reference. * * @param add the method reference invoked when a service is added. * @return this builder @@ -616,8 +617,8 @@ public interface ServiceCallbacksBuilder B cbi(CbRef<S> add); /** - * Sets some <code>callback instance </code> java8 method references which are invoked when a service is added/removed. - * The method references must point to method from an Object instance, and take as argument a service reference. + * Sets a <code>callback instance</code> invoked when a service is added/removed. + * The method reference must point to method from an Object instance. Callback argument(s): a service reference. * * @param add the method reference invoked when a service is added. * @param remove the method reference invoked when a service is removed. @@ -626,8 +627,8 @@ public interface ServiceCallbacksBuilder B cbi(CbRef<S> add, CbRef<S> remove); /** - * Sets some <code>callback instance </code> java8 method references which are invoked when a service is added/changed/removed. - * The method references must point to method from an Object instance, and take as argument a service reference. + * Sets a <code>callback instance</code> invoked when a service is added/changed/removed. + * The method reference must point to method from an Object instance. Callback argument(s): a service reference. * * @param add the method reference invoked when a service is added. * @param change the method reference invoked when a service is changed. @@ -637,8 +638,8 @@ public interface ServiceCallbacksBuilder B cbi(CbRef<S> add, CbRef<S> change, CbRef<S> remove); /** - * Sets a <code>callback instance </code> java8 method reference which is invoked when a service is added. - * The method reference must point to method from an Object instance, and take as argument a Component. + * Sets a <code>callback instance</code> invoked when a service is added. + * The method reference must point to a method from an Object instance. Callback argument(s): a Component. * * @param add the method reference invoked when a service is added. * @return this builder @@ -646,8 +647,8 @@ public interface ServiceCallbacksBuilder B cbi(CbComponent add); /** - * Sets some <code>callback instance </code> java8 method references which are invoked when a service is added/removed. - * The method references must point to method from an Object instance, and take as argument a Component. + * Sets a <code>callback instance</code> invoked when a service is added/removed. + * The method reference must point to method from an Object instance. Callback argument(s): a Component. * * @param add the method reference invoked when a service is added. * @param remove the method reference invoked when a service is removed. @@ -656,8 +657,8 @@ public interface ServiceCallbacksBuilder B cbi(CbComponent add, CbComponent remove); /** - * Sets some <code>callback instance </code> java8 method references which are invoked when a service is added/changed/removed. - * The method references must point to method from an Object instance, and take as argument a Component. + * Sets a <code>callback instance</code> invoked when a service is added/changed/removed. + * The method reference must point to method from an Object instance. Callback argument(s): a Component. * * @param add the method reference invoked when a service is added. * @param change the method reference invoked when a service is changed. @@ -667,8 +668,8 @@ public interface ServiceCallbacksBuilder B cbi(CbComponent add, CbComponent change, CbComponent remove); /** - * Sets a <code>callback instance </code> java8 method reference which is invoked when a service is added. - * The method reference must point to method from an Object instance, and take as arguments a Component and a service reference. + * Sets a <code>callback instance</code> invoked when a service is added. + * The method reference must point to a method from an Object instance. Callback argument(s): a Component and a service reference. * * @param add the method reference invoked when a service is added. * @return this builder @@ -676,8 +677,8 @@ public interface ServiceCallbacksBuilder B cbi(CbComponentRef<S> add); /** - * Sets some <code>callback instance </code> java8 method references which are invoked when a service is added/removed. - * The method references must point to method from an Object instance, and take as arguments a Component and a service reference. + * Sets a <code>callback instance</code> invoked when a service is added/removed. + * The method reference must point to method from an Object instance. Callback argument(s): a Component and a service reference. * * @param add the method reference invoked when a service is added. * @param remove the method reference invoked when a service is removed. @@ -686,8 +687,8 @@ public interface ServiceCallbacksBuilder B cbi(CbComponentRef<S> add, CbComponentRef<S> remove); /** - * Sets some <code>callback instance </code> java8 method references which are invoked when a service is added/changed/removed. - * The method references must point to method from an Object instance, and take as arguments a Component and a service reference. + * Sets a <code>callback instance</code> invoked when a service is added/changed/removed. + * The method reference must point to method from an Object instance. Callback argument(s): a Component and a service reference. * * @param add the method reference invoked when a service is added. * @param change the method reference invoked when a service is changed. @@ -697,8 +698,8 @@ public interface ServiceCallbacksBuilder B cbi(CbComponentRef<S> add, CbComponentRef<S> change, CbComponentRef<S> remove); /** - * Sets a <code>callback instance </code> java8 method reference which is invoked when a service is added. - * The method reference must point to method from an Object instance, and take as arguments a Component and a service. + * Sets a <code>callback instance</code> invoked when a service is added. + * The method reference must point to a method from an Object instance. Callback argument(s): a Component and a service. * * @param add the method reference invoked when a service is added. * @return this builder @@ -706,8 +707,8 @@ public interface ServiceCallbacksBuilder B cbi(CbComponentService<S> add); /** - * Sets some <code>callback instance </code> java8 method references which are invoked when a service is added/removed. - * The method references must point to method from an Object instance, and take as arguments a Component and a service. + * Sets a <code>callback instance</code> invoked when a service is added/removed. + * The method reference must point to method from an Object instance. Callback argument(s): a Component and a service. * * @param add the method reference invoked when a service is added. * @param remove the method reference invoked when a service is removed. @@ -716,8 +717,8 @@ public interface ServiceCallbacksBuilder B cbi(CbComponentService<S> add, CbComponentService<S> remove); /** - * Sets some <code>callback instance </code> java8 method references which are invoked when a service is added/changed/removed. - * The method references must point to method from an Object instance, and take as arguments a Component and a service. + * Sets a <code>callback instance</code> invoked when a service is added/changed/removed. + * The method reference must point to method from an Object instance. Callback argument(s): a Component and a service. * * @param add the method reference invoked when a service is added. * @param change the method reference invoked when a service is changed. @@ -727,8 +728,8 @@ public interface ServiceCallbacksBuilder B cbi(CbComponentService<S> add, CbComponentService<S> change, CbComponentService<S> remove); /** - * Sets a <code>callback instance </code> java8 method reference which is invoked when a service is added. - * The method reference must point to method from an Object instance, and take as arguments a Component, a service reference, and a service. + * Sets a <code>callback instance</code> invoked when a service is added. + * The method reference must point to a method from an Object instance. Callback argument(s): a Component, a service reference, and a service. * * @param add the method reference invoked when a service is added. * @return this builder @@ -736,8 +737,8 @@ public interface ServiceCallbacksBuilder B cbi(CbComponentRefService<S> add); /** - * Sets some <code>callback instance </code> java8 method references which are invoked when a service is added/removed. - * The method references must point to method from an Object instance, and take as arguments a Component, a service reference, and a service. + * Sets a <code>callback instance</code> invoked when a service is added/removed. + * The method reference must point to method from an Object instance. Callback argument(s): a Component, a service reference, and a service. * * @param add the method reference invoked when a service is added. * @param remove the method reference invoked when a service is removed. @@ -746,8 +747,8 @@ public interface ServiceCallbacksBuilder B cbi(CbComponentRefService<S> add, CbComponentRefService<S> remove); /** - * Sets some <code>callback instance </code> java8 method references which are invoked when a service is added/changed/removed. - * The method references must point to method from an Object instance, and take as arguments a Component, a service reference, and a service. + * Sets a <code>callback instance</code> invoked when a service is added/changed/removed. + * The method reference must point to method from an Object instance. Callback argument(s): a Component, a service reference, and a service. * * @param add the method reference invoked when a service is added. * @param change the method reference invoked when a service is changed. @@ -757,8 +758,8 @@ public interface ServiceCallbacksBuilder B cbi(CbComponentRefService<S> add, CbComponentRefService<S> change, CbComponentRefService<S> remove); /** - * Sets a swap <code>callback instance</code> java8 method reference which is invoked when a service is swapped. - * The method references must point to a method from an Object instance, and take as arguments the old service, and the new service. + * Sets a swap <code>callback instance</code> invoked when a service is swapped. + * The method reference must point to a method from an Object instance. Callback argument(s): the old service, and the new service. * the new service. * * @param swap the method reference invoked when the service is swapped. @@ -767,8 +768,8 @@ public interface ServiceCallbacksBuilder B swi(CbServiceService<S> swap); /** - * Sets a swap <code>callback instance</code> java8 method reference which is invoked when a service is swapped. - * The method references must point to a method from an Object instance, and take as arguments the component, the old service, and the new service. + * Sets a swap <code>callback instance</code> invoked when a service is swapped. + * The method reference must point to a method from an Object instance. Callback argument(s): the component, the old service, and the new service. * the new service. * * @param swap the method reference invoked when the service is swapped. @@ -777,8 +778,8 @@ public interface ServiceCallbacksBuilder B swi(CbComponentServiceService<S> swap); /** - * Sets a swap <code>callback instance</code> java8 method reference which is invoked when a service is swapped. - * The method references must point to a method from an Object instance, and take as arguments the old service reference, the old service, the + * Sets a swap <code>callback instance</code> invoked when a service is swapped. + * The method reference must point to a method from an Object instance. Callback argument(s): the old service reference, the old service, the * new service reference, and the new service. * * @param swap the method reference invoked when the service is swapped. @@ -787,8 +788,8 @@ public interface ServiceCallbacksBuilder B swi(CbRefServiceRefService<S> swap); /** - * Sets a swap <code>callback instance</code> java8 method reference which is invoked when a service is swapped. - * The method references must point to a method from an Object instance, and take as arguments the component, old service reference, the old service, the + * Sets a swap <code>callback instance</code> invoked when a service is swapped. + * The method reference must point to a method from an Object instance. Callback argument(s): the component, old service reference, the old service, the * new service reference, and the new service. * * @param swap the method reference invoked when the service is swapped.
Modified: felix/sandbox/pderop/dependencymanager-lambda/org.apache.felix.dependencymanager.lambda/src/org/apache/felix/dm/lambda/ServiceDependencyBuilder.java URL: http://svn.apache.org/viewvc/felix/sandbox/pderop/dependencymanager-lambda/org.apache.felix.dependencymanager.lambda/src/org/apache/felix/dm/lambda/ServiceDependencyBuilder.java?rev=1727768&r1=1727767&r2=1727768&view=diff ============================================================================== --- felix/sandbox/pderop/dependencymanager-lambda/org.apache.felix.dependencymanager.lambda/src/org/apache/felix/dm/lambda/ServiceDependencyBuilder.java (original) +++ felix/sandbox/pderop/dependencymanager-lambda/org.apache.felix.dependencymanager.lambda/src/org/apache/felix/dm/lambda/ServiceDependencyBuilder.java Sat Jan 30 23:49:06 2016 @@ -8,8 +8,8 @@ import org.apache.felix.dm.ServiceDepend import org.osgi.framework.ServiceReference; /** - * Defines a Service dependency. Dependency callbacks can be defined using methods reflection like - * (like in original DM Api), or using Java8 method references. + * Builds a Dependency Manager Service Dependency. Dependency callbacks can be defined using methods reflection like + * in original DM API, or using Java8 method references. * * Unlike with original DM, dependencies are required by default. *
