felix-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From pde...@apache.org
Subject svn commit: r1727768 [2/2] - in /felix/sandbox/pderop/dependencymanager-lambda: org.apache.felix.dependencymanager.lambda.itest/src/org/apache/felix/dm/lambda/itest/ org.apache.felix.dependencymanager.lambda/src/org/apache/felix/dm/lambda/
Date Sat, 30 Jan 2016 23:49:06 GMT
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.
  *



Mime
View raw message