felix-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From pde...@apache.org
Subject svn commit: r1731995 [11/38] - in /felix/site/trunk/content/apidocs: dependencymanager.annotations/r7/ dependencymanager.annotations/r7/org/ dependencymanager.annotations/r7/org/apache/ dependencymanager.annotations/r7/org/apache/felix/ dependencymanag...
Date Wed, 24 Feb 2016 00:11:43 GMT
Modified: felix/site/trunk/content/apidocs/dependencymanager.lambda/r7/org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html
URL: http://svn.apache.org/viewvc/felix/site/trunk/content/apidocs/dependencymanager.lambda/r7/org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html?rev=1731995&r1=1731994&r2=1731995&view=diff
==============================================================================
--- felix/site/trunk/content/apidocs/dependencymanager.lambda/r7/org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html (original)
+++ felix/site/trunk/content/apidocs/dependencymanager.lambda/r7/org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html Wed Feb 24 00:11:41 2016
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_72) on Thu Feb 04 08:50:09 CET 2016 -->
+<!-- Generated by javadoc (1.8.0_74) on Wed Feb 24 01:07:32 CET 2016 -->
 <title>ConfigurationDependencyBuilder</title>
-<meta name="date" content="2016-02-04">
+<meta name="date" content="2016-02-24">
 <link rel="stylesheet" type="text/css" href="../../../../../stylesheet.css" title="Style">
 <script type="text/javascript" src="../../../../../script.js"></script>
 </head>
@@ -18,7 +18,7 @@
     catch(err) {
     }
 //-->
-var methods = {"i0":6,"i1":6,"i2":6,"i3":6,"i4":6,"i5":6,"i6":6,"i7":6,"i8":6,"i9":6,"i10":6};
+var methods = {"i0":6,"i1":6,"i2":6,"i3":6,"i4":6,"i5":6,"i6":6,"i7":6,"i8":6,"i9":6,"i10":6,"i11":6,"i12":6,"i13":6,"i14":6};
 var tabs = {65535:["t0","All Methods"],2:["t2","Instance Methods"],4:["t3","Abstract Methods"]};
 var altColor = "altColor";
 var rowColor = "rowColor";
@@ -107,17 +107,113 @@ var activeTableTab = "activeTableTab";
 <pre>public interface <span class="typeNameLabel">ConfigurationDependencyBuilder</span>
 extends <a href="../../../../../org/apache/felix/dm/lambda/DependencyBuilder.html" title="interface in org.apache.felix.dm.lambda">DependencyBuilder</a>&lt;org.apache.felix.dm.ConfigurationDependency&gt;</pre>
 <div class="block">Builds a Dependency Manager Configuration Dependency.
- By default, the updated callback is "updated", like in original DM API.
+ Two families of callbacks are supported: <p>
  
- <p> Code example with a component that defines a Configuration Dependency. the ServiceImpl modified method
- callback is declared using a method reference (see the "cb(ServiceImpl::modified)" code):
+ <ul> 
+ <li>reflection based callbacks: you specify a callback method name
+ <li>method reference callbacks: you specify a java8 method reference
+ </ul>
+ 
+ <p> Callbacks may accept a Dictionary, a Component, or a user defined configuration type interface.
+ 
+ If you only specify a pid, by default the callback method name is assumed to be "updated".
+ 
+ <p> Configuration types are a new feature that allows you to specify an interface that is implemented 
+ by DM and such interface is then injected to your callback instead of the actual Dictionary.
+ Using such configuration interface provides a way for creating type-safe configurations from a actual <code>Dictionary</code> that is
+ normally injected by Dependency Manager.
+ The callback accepts in argument an interface that you have to provide, and DM will inject a proxy that converts
+ method calls from your configuration-type to lookups in the actual map or dictionary. The results of these lookups are then
+ converted to the expected return type of the invoked configuration method.<br>
+ As proxies are injected, no implementations of the desired configuration-type are necessary!
+ </p>
+ <p>
+ The lookups performed are based on the name of the method called on the configuration type. The method names are
+ "mangled" to the following form: <tt>[lower case letter] [any valid character]*</tt>. Method names starting with
+ <tt>get</tt> or <tt>is</tt> (JavaBean convention) are stripped from these prefixes. For example: given a dictionary
+ with the key <tt>"foo"</tt> can be accessed from a configuration-type using the following method names:
+ <tt>foo()</tt>, <tt>getFoo()</tt> and <tt>isFoo()</tt>.
+ </p>
+ <p>
+ The return values supported are: primitive types (or their object wrappers), strings, enums, arrays of
+ primitives/strings, <code>Collection</code> types, <code>Map</code> types, <code>Class</code>es and interfaces. When an interface is
+ returned, it is treated equally to a configuration type, that is, it is returned as a proxy.
+ </p>
+ <p>
+ Arrays can be represented either as comma-separated values, optionally enclosed in square brackets. For example:
+ <tt>[ a, b, c ]</tt> and <tt>a, b,c</tt> are both considered an array of length 3 with the values "a", "b" and "c".
+ Alternatively, you can append the array index to the key in the dictionary to obtain the same: a dictionary with
+ "arr.0" =&gt; "a", "arr.1" =&gt; "b", "arr.2" =&gt; "c" would result in the same array as the earlier examples.
+ </p>
+ <p>
+ Maps can be represented as single string values similarly as arrays, each value consisting of both the key and value
+ separated by a dot. Optionally, the value can be enclosed in curly brackets. Similar to array, you can use the same
+ dot notation using the keys. For example, a dictionary with 
+ 
+ <pre><code> "map" =&gt; "{key1.value1, key2.value2}"</code></pre> 
+ 
+ and a dictionary with <p>
+ 
+ <pre><code> "map.key1" =&gt; "value1", "map2.key2" =&gt; "value2"</code></pre> 
+ 
+ result in the same map being returned.
+ Instead of a map, you could also define an interface with the methods <tt>getKey1()</tt> and <tt>getKey2</tt> and use
+ that interface as return type instead of a <code>Map</code>.
+ </p>
+ <p>
+ In case a lookup does not yield a value from the underlying map or dictionary, the following rules are applied:
+ <ol>
+ <li>primitive types yield their default value, as defined by the Java Specification;
+ <li>string, <code>Class</code>es and enum values yield <code>null</code>;
+ <li>for arrays, collections and maps, an empty array/collection/map is returned;
+ <li>for other interface types that are treated as configuration type a null-object is returned.
+ </ol>
+ </p>
+ 
+ <b> Sample codes: </b>
+ 
+ <p> Code example with a component that defines a Configuration Dependency using a specific callback method reference,
+ and the method accepts in argument a configuration type (the pid is assumed to be the fqdn of the configuration type):
  
  <pre> <code>
  public class Activator extends DependencyManagerActivator {
-     public void activate() throws Exception { 
+     public void init(BundleContext ctx, DependencyManager dm) throws Exception { 
          component(comp -&gt; comp
            .impl(ServiceImpl.class)
-           .withConf(conf -&gt; conf.pid(ServiceConsumer.class).cb(ServiceImpl::modified)));  
+           .withCnf(conf -&gt; conf.update(MyConfig.class, ServiceImpl::modified)));  
+    }
+ }
+ </code></pre>
+ 
+ <p> Code example with a component that defines a Configuration Dependency using a specific callback method reference
+ which accepts a Dictionary in argument:
+ 
+ <pre> <code>
+ public class Activator extends DependencyManagerActivator {
+     public void init(BundleContext ctx, DependencyManager dm) throws Exception { 
+         component(comp -&gt; comp
+           .impl(ServiceImpl.class)
+           .withCnf(conf -&gt; conf.pid("my.pid").update(ServiceImpl::modified)));
+    }
+ }
+ </code></pre>
+ 
+ <p> Code example which defines a configuration dependency injected in the "ServiceImpl.updated(Dictionary)" callback:
+ 
+ <pre> <code>
+ public class Activator extends DependencyManagerActivator {
+     public void init(BundleContext ctx, DependencyManager dm) throws Exception { 
+         component(comp -&gt; comp.impl(ServiceImpl.class).withCnf("my.pid"));
+    }
+ }
+ </code></pre>
+ 
+ <p> Code example with a component that defines a Configuration Dependency using a specific callback method name:
+ 
+ <pre> <code>
+ public class Activator extends DependencyManagerActivator {
+     public void init(BundleContext ctx, DependencyManager dm) throws Exception { 
+         component(comp -&gt; comp.impl(ServiceImpl.class).withCnf(conf -&gt; conf.pid("my.pid").update("modified")));  
     }
  }
  </code></pre></div>
@@ -140,70 +236,101 @@ extends <a href="../../../../../org/apac
 <th class="colLast" scope="col">Method and Description</th>
 </tr>
 <tr id="i0" class="altColor">
-<td class="colFirst"><code>&lt;T&gt;&nbsp;<a href="../../../../../org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html" title="interface in org.apache.felix.dm.lambda">ConfigurationDependencyBuilder</a></code></td>
-<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html#cb-org.apache.felix.dm.lambda.callbacks.CbTypeComponentDictionary-">cb</a></span>(<a href="../../../../../org/apache/felix/dm/lambda/callbacks/CbTypeComponentDictionary.html" title="interface in org.apache.felix.dm.lambda.callbacks">CbTypeComponentDictionary</a>&lt;T&gt;&nbsp;callback)</code>
-<div class="block">Sets the <code>callback</code> method reference used to invoke an update method.</div>
+<td class="colFirst"><code><a href="../../../../../org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html" title="interface in org.apache.felix.dm.lambda">ConfigurationDependencyBuilder</a></code></td>
+<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html#pid-java.lang.String-">pid</a></span>(java.lang.String&nbsp;pid)</code>
+<div class="block">Sets the pid for this configuration dependency.</div>
 </td>
 </tr>
 <tr id="i1" class="rowColor">
-<td class="colFirst"><code>&lt;T&gt;&nbsp;<a href="../../../../../org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html" title="interface in org.apache.felix.dm.lambda">ConfigurationDependencyBuilder</a></code></td>
-<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html#cb-org.apache.felix.dm.lambda.callbacks.CbTypeDictionary-">cb</a></span>(<a href="../../../../../org/apache/felix/dm/lambda/callbacks/CbTypeDictionary.html" title="interface in org.apache.felix.dm.lambda.callbacks">CbTypeDictionary</a>&lt;T&gt;&nbsp;callback)</code>
-<div class="block">Sets a <code>callback</code> method reference used to invoke an update method.</div>
+<td class="colFirst"><code><a href="../../../../../org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html" title="interface in org.apache.felix.dm.lambda">ConfigurationDependencyBuilder</a></code></td>
+<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html#propagate--">propagate</a></span>()</code>
+<div class="block">Sets propagation of the configuration to the service properties (false by default).</div>
 </td>
 </tr>
 <tr id="i2" class="altColor">
 <td class="colFirst"><code><a href="../../../../../org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html" title="interface in org.apache.felix.dm.lambda">ConfigurationDependencyBuilder</a></code></td>
-<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html#cb-java.lang.String-">cb</a></span>(java.lang.String&nbsp;updateMethod)</code>
-<div class="block">Sets a <code>callback</code> to call on the component instance(s) when the configuration is updated.</div>
+<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html#propagate-boolean-">propagate</a></span>(boolean&nbsp;propagate)</code>
+<div class="block">Sets propagation of the configuration properties to the service properties (false by default).</div>
 </td>
 </tr>
 <tr id="i3" class="rowColor">
-<td class="colFirst"><code><a href="../../../../../org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html" title="interface in org.apache.felix.dm.lambda">ConfigurationDependencyBuilder</a></code></td>
-<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html#cbi-org.apache.felix.dm.lambda.callbacks.CbComponentDictionary-">cbi</a></span>(<a href="../../../../../org/apache/felix/dm/lambda/callbacks/CbComponentDictionary.html" title="interface in org.apache.felix.dm.lambda.callbacks">CbComponentDictionary</a>&nbsp;updated)</code>
-<div class="block">Sets a <code>callback instance</code> method reference used to invoke the update method.</div>
+<td class="colFirst"><code>&lt;T&gt;&nbsp;<a href="../../../../../org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html" title="interface in org.apache.felix.dm.lambda">ConfigurationDependencyBuilder</a></code></td>
+<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html#update-org.apache.felix.dm.lambda.callbacks.CbDictionary-">update</a></span>(<a href="../../../../../org/apache/felix/dm/lambda/callbacks/CbDictionary.html" title="interface in org.apache.felix.dm.lambda.callbacks">CbDictionary</a>&lt;T&gt;&nbsp;callback)</code>
+<div class="block">Sets a reference to a "callback(Dictionary)" method from one of the component implementation classes.</div>
 </td>
 </tr>
 <tr id="i4" class="altColor">
-<td class="colFirst"><code><a href="../../../../../org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html" title="interface in org.apache.felix.dm.lambda">ConfigurationDependencyBuilder</a></code></td>
-<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html#cbi-org.apache.felix.dm.lambda.callbacks.CbDictionary-">cbi</a></span>(<a href="../../../../../org/apache/felix/dm/lambda/callbacks/CbDictionary.html" title="interface in org.apache.felix.dm.lambda.callbacks">CbDictionary</a>&nbsp;updated)</code>
-<div class="block">Sets a <code>callback instance</code> method reference used to invoke the update method.</div>
+<td class="colFirst"><code>&lt;T&gt;&nbsp;<a href="../../../../../org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html" title="interface in org.apache.felix.dm.lambda">ConfigurationDependencyBuilder</a></code></td>
+<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html#update-org.apache.felix.dm.lambda.callbacks.CbDictionaryComponent-">update</a></span>(<a href="../../../../../org/apache/felix/dm/lambda/callbacks/CbDictionaryComponent.html" title="interface in org.apache.felix.dm.lambda.callbacks">CbDictionaryComponent</a>&lt;T&gt;&nbsp;callback)</code>
+<div class="block">Sets a reference to a "callback(Dictionary, Component)" method from one of the component implementation classes.</div>
 </td>
 </tr>
 <tr id="i5" class="rowColor">
 <td class="colFirst"><code><a href="../../../../../org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html" title="interface in org.apache.felix.dm.lambda">ConfigurationDependencyBuilder</a></code></td>
-<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html#cbi-java.lang.Object-java.lang.String-">cbi</a></span>(java.lang.Object&nbsp;callbackInstance,
-   java.lang.String&nbsp;updateMethod)</code>
-<div class="block">Sets a <code>callback instance</code> to call on a given object instance when the configuration is updated.</div>
+<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html#update-java.lang.Class-java.lang.Object-java.lang.String-">update</a></span>(java.lang.Class&lt;?&gt;&nbsp;configType,
+      java.lang.Object&nbsp;callbackInstance,
+      java.lang.String&nbsp;updateMethod)</code>
+<div class="block">Sets a callback method to call on a given Object instance when the configuration is updated.</div>
 </td>
 </tr>
 <tr id="i6" class="altColor">
 <td class="colFirst"><code><a href="../../../../../org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html" title="interface in org.apache.felix.dm.lambda">ConfigurationDependencyBuilder</a></code></td>
-<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html#needsInstance-boolean-">needsInstance</a></span>(boolean&nbsp;needsInstance)</code>
-<div class="block">Configures whether or not the component instance should be instantiated at the time the updated callback is invoked.</div>
+<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html#update-java.lang.Class-java.lang.String-">update</a></span>(java.lang.Class&lt;?&gt;&nbsp;configType,
+      java.lang.String&nbsp;updateMethod)</code>
+<div class="block">Sets a callback method to call on the component implementation class(es) when the configuration is updated.</div>
 </td>
 </tr>
 <tr id="i7" class="rowColor">
-<td class="colFirst"><code><a href="../../../../../org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html" title="interface in org.apache.felix.dm.lambda">ConfigurationDependencyBuilder</a></code></td>
-<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html#pid-java.lang.Class-">pid</a></span>(java.lang.Class&lt;?&gt;&nbsp;pidClass)</code>
-<div class="block">Sets the class which fqdn represents the pid for this configuration dependency.</div>
+<td class="colFirst"><code>&lt;T&gt;&nbsp;<a href="../../../../../org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html" title="interface in org.apache.felix.dm.lambda">ConfigurationDependencyBuilder</a></code></td>
+<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html#update-java.lang.Class-org.apache.felix.dm.lambda.callbacks.InstanceCbConfiguration-">update</a></span>(java.lang.Class&lt;T&gt;&nbsp;configType,
+      <a href="../../../../../org/apache/felix/dm/lambda/callbacks/InstanceCbConfiguration.html" title="interface in org.apache.felix.dm.lambda.callbacks">InstanceCbConfiguration</a>&lt;T&gt;&nbsp;updated)</code>
+<div class="block">Sets a reference to a "callback(Configuration)" method from an Object instance.</div>
 </td>
 </tr>
 <tr id="i8" class="altColor">
-<td class="colFirst"><code><a href="../../../../../org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html" title="interface in org.apache.felix.dm.lambda">ConfigurationDependencyBuilder</a></code></td>
-<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html#pid-java.lang.String-">pid</a></span>(java.lang.String&nbsp;pid)</code>
-<div class="block">Sets the pid for this configuration dependency.</div>
+<td class="colFirst"><code>&lt;T&gt;&nbsp;<a href="../../../../../org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html" title="interface in org.apache.felix.dm.lambda">ConfigurationDependencyBuilder</a></code></td>
+<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html#update-java.lang.Class-org.apache.felix.dm.lambda.callbacks.InstanceCbConfigurationComponent-">update</a></span>(java.lang.Class&lt;T&gt;&nbsp;configType,
+      <a href="../../../../../org/apache/felix/dm/lambda/callbacks/InstanceCbConfigurationComponent.html" title="interface in org.apache.felix.dm.lambda.callbacks">InstanceCbConfigurationComponent</a>&lt;T&gt;&nbsp;updated)</code>
+<div class="block">Sets a reference to a "callback(Configuration, Component)" method from an Object instance.</div>
 </td>
 </tr>
 <tr id="i9" class="rowColor">
-<td class="colFirst"><code><a href="../../../../../org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html" title="interface in org.apache.felix.dm.lambda">ConfigurationDependencyBuilder</a></code></td>
-<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html#propagate--">propagate</a></span>()</code>
-<div class="block">Sets propagation of the configuration properties to the service properties (false by default).</div>
+<td class="colFirst"><code>&lt;T,U&gt;&nbsp;<a href="../../../../../org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html" title="interface in org.apache.felix.dm.lambda">ConfigurationDependencyBuilder</a></code></td>
+<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html#update-java.lang.Class-org.apache.felix.dm.lambda.callbacks.CbConfiguration-">update</a></span>(java.lang.Class&lt;U&gt;&nbsp;configType,
+      <a href="../../../../../org/apache/felix/dm/lambda/callbacks/CbConfiguration.html" title="interface in org.apache.felix.dm.lambda.callbacks">CbConfiguration</a>&lt;T,U&gt;&nbsp;callback)</code>
+<div class="block">Sets a reference to a "callback(Configuration)" method from one of the component implementation classes.</div>
 </td>
 </tr>
 <tr id="i10" class="altColor">
+<td class="colFirst"><code>&lt;T,U&gt;&nbsp;<a href="../../../../../org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html" title="interface in org.apache.felix.dm.lambda">ConfigurationDependencyBuilder</a></code></td>
+<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html#update-java.lang.Class-org.apache.felix.dm.lambda.callbacks.CbConfigurationComponent-">update</a></span>(java.lang.Class&lt;U&gt;&nbsp;configType,
+      <a href="../../../../../org/apache/felix/dm/lambda/callbacks/CbConfigurationComponent.html" title="interface in org.apache.felix.dm.lambda.callbacks">CbConfigurationComponent</a>&lt;T,U&gt;&nbsp;callback)</code>
+<div class="block">Sets a reference to a "callback(Configuration, Component)" method from one of the component implementation classes.</div>
+</td>
+</tr>
+<tr id="i11" class="rowColor">
 <td class="colFirst"><code><a href="../../../../../org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html" title="interface in org.apache.felix.dm.lambda">ConfigurationDependencyBuilder</a></code></td>
-<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html#propagate-boolean-">propagate</a></span>(boolean&nbsp;propagate)</code>
-<div class="block">Sets propagation of the configuration properties to the service properties (false by default).</div>
+<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html#update-org.apache.felix.dm.lambda.callbacks.InstanceCbDictionary-">update</a></span>(<a href="../../../../../org/apache/felix/dm/lambda/callbacks/InstanceCbDictionary.html" title="interface in org.apache.felix.dm.lambda.callbacks">InstanceCbDictionary</a>&nbsp;callback)</code>
+<div class="block">Sets a reference to a "callback(Dictionary)" method from an Object instance.</div>
+</td>
+</tr>
+<tr id="i12" class="altColor">
+<td class="colFirst"><code><a href="../../../../../org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html" title="interface in org.apache.felix.dm.lambda">ConfigurationDependencyBuilder</a></code></td>
+<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html#update-org.apache.felix.dm.lambda.callbacks.InstanceCbDictionaryComponent-">update</a></span>(<a href="../../../../../org/apache/felix/dm/lambda/callbacks/InstanceCbDictionaryComponent.html" title="interface in org.apache.felix.dm.lambda.callbacks">InstanceCbDictionaryComponent</a>&nbsp;callback)</code>
+<div class="block">Sets a reference to a "callback(Dictionary, Component)" method from an Object instance.</div>
+</td>
+</tr>
+<tr id="i13" class="rowColor">
+<td class="colFirst"><code><a href="../../../../../org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html" title="interface in org.apache.felix.dm.lambda">ConfigurationDependencyBuilder</a></code></td>
+<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html#update-java.lang.Object-java.lang.String-">update</a></span>(java.lang.Object&nbsp;callbackInstance,
+      java.lang.String&nbsp;updateMethod)</code>
+<div class="block">Sets a callback method to call on a given Object instance when the configuration is updated.</div>
+</td>
+</tr>
+<tr id="i14" class="altColor">
+<td class="colFirst"><code><a href="../../../../../org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html" title="interface in org.apache.felix.dm.lambda">ConfigurationDependencyBuilder</a></code></td>
+<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html#update-java.lang.String-">update</a></span>(java.lang.String&nbsp;updateMethod)</code>
+<div class="block">Sets a callback method to call on the component implementation class(es) when the configuration is updated.</div>
 </td>
 </tr>
 </table>
@@ -238,106 +365,145 @@ extends <a href="../../../../../org/apac
 <div class="block">Sets the pid for this configuration dependency.</div>
 <dl>
 <dt><span class="paramLabel">Parameters:</span></dt>
-<dd><code>pid</code> - the configuration dependendency pid.</dd>
+<dd><code>pid</code> - the configuration dependency pid.</dd>
 <dt><span class="returnLabel">Returns:</span></dt>
 <dd>this builder</dd>
 </dl>
 </li>
 </ul>
-<a name="pid-java.lang.Class-">
+<a name="propagate--">
 <!--   -->
 </a>
 <ul class="blockList">
 <li class="blockList">
-<h4>pid</h4>
-<pre><a href="../../../../../org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html" title="interface in org.apache.felix.dm.lambda">ConfigurationDependencyBuilder</a>&nbsp;pid(java.lang.Class&lt;?&gt;&nbsp;pidClass)</pre>
-<div class="block">Sets the class which fqdn represents the pid for this configuration dependency. Usually, this class can optionally be annotated with metatypes bnd annotations.</div>
+<h4>propagate</h4>
+<pre><a href="../../../../../org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html" title="interface in org.apache.felix.dm.lambda">ConfigurationDependencyBuilder</a>&nbsp;propagate()</pre>
+<div class="block">Sets propagation of the configuration to the service properties (false by default). 
+ All public configuration properties (not starting with a dot) will be propagated to the component service properties.</div>
 <dl>
-<dt><span class="paramLabel">Parameters:</span></dt>
-<dd><code>pidClass</code> - the class which fqdn represents the pid for this configuration dependency.</dd>
 <dt><span class="returnLabel">Returns:</span></dt>
 <dd>this builder</dd>
 </dl>
 </li>
 </ul>
-<a name="propagate--">
+<a name="propagate-boolean-">
 <!--   -->
 </a>
 <ul class="blockList">
 <li class="blockList">
 <h4>propagate</h4>
-<pre><a href="../../../../../org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html" title="interface in org.apache.felix.dm.lambda">ConfigurationDependencyBuilder</a>&nbsp;propagate()</pre>
-<div class="block">Sets propagation of the configuration properties to the service properties (false by default). 
- All public configuration properties (not starting with a dot) will be propagated to the component service properties.</div>
+<pre><a href="../../../../../org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html" title="interface in org.apache.felix.dm.lambda">ConfigurationDependencyBuilder</a>&nbsp;propagate(boolean&nbsp;propagate)</pre>
+<div class="block">Sets propagation of the configuration properties to the service properties (false by default).</div>
 <dl>
+<dt><span class="paramLabel">Parameters:</span></dt>
+<dd><code>propagate</code> - true if all public configuration properties (not starting with a dot) must be propagated to the component service properties (false by default)</dd>
 <dt><span class="returnLabel">Returns:</span></dt>
 <dd>this builder</dd>
 </dl>
 </li>
 </ul>
-<a name="propagate-boolean-">
+<a name="update-java.lang.String-">
 <!--   -->
 </a>
 <ul class="blockList">
 <li class="blockList">
-<h4>propagate</h4>
-<pre><a href="../../../../../org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html" title="interface in org.apache.felix.dm.lambda">ConfigurationDependencyBuilder</a>&nbsp;propagate(boolean&nbsp;propagate)</pre>
-<div class="block">Sets propagation of the configuration properties to the service properties (false by default).</div>
+<h4>update</h4>
+<pre><a href="../../../../../org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html" title="interface in org.apache.felix.dm.lambda">ConfigurationDependencyBuilder</a>&nbsp;update(java.lang.String&nbsp;updateMethod)</pre>
+<div class="block">Sets a callback method to call on the component implementation class(es) when the configuration is updated. When the configuration is lost, the callback is invoked
+ with a null dictionary. 
+ 
+ <p>The following callback signatures are supported and searched in the following order:
+ <ol>
+ <li>method(Dictionary)</li>
+ <li>method(Component, Dictionary)</li>
+ </ol></div>
 <dl>
 <dt><span class="paramLabel">Parameters:</span></dt>
-<dd><code>propagate</code> - true if all public configuration properties (not starting with a dot) must be propagated to the component service properties (false by default)</dd>
+<dd><code>updateMethod</code> - the name of the callback</dd>
 <dt><span class="returnLabel">Returns:</span></dt>
 <dd>this builder</dd>
 </dl>
 </li>
 </ul>
-<a name="needsInstance-boolean-">
+<a name="update-java.lang.Class-java.lang.String-">
 <!--   -->
 </a>
 <ul class="blockList">
 <li class="blockList">
-<h4>needsInstance</h4>
-<pre><a href="../../../../../org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html" title="interface in org.apache.felix.dm.lambda">ConfigurationDependencyBuilder</a>&nbsp;needsInstance(boolean&nbsp;needsInstance)</pre>
-<div class="block">Configures whether or not the component instance should be instantiated at the time the updated callback is invoked. 
- By default, when the callback is applied on an external object instance, the component is not instantiated, but in this case
- you can force the creation of the component instances by calling this method.</div>
+<h4>update</h4>
+<pre><a href="../../../../../org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html" title="interface in org.apache.felix.dm.lambda">ConfigurationDependencyBuilder</a>&nbsp;update(java.lang.Class&lt;?&gt;&nbsp;configType,
+                                      java.lang.String&nbsp;updateMethod)</pre>
+<div class="block">Sets a callback method to call on the component implementation class(es) when the configuration is updated. The callback is invoked with a configuration type
+ argument (null if the configuration is lost).
+ 
+ <p>The following callback signatures are supported and searched in the following order:
+ <ol>
+ <li>method(Dictionary)</li>
+ <li>method(Component, Dictionary)</li>
+ <li>method(Configuration) // same type as the one specified in the "configType" argument</li>
+ <li>method(Component, Configuration) // Configuration has the same type as the one specified in the "configType" argument</li>
+ </ol></div>
 <dl>
 <dt><span class="paramLabel">Parameters:</span></dt>
-<dd><code>needsInstance</code> - true if the component instance should be instantiated at the time the updated callback is invoked on an external object instance.</dd>
+<dd><code>configType</code> - the type of a configuration that is passed as argument to the callback</dd>
+<dd><code>updateMethod</code> - the callback to call on the component implementation class(es) when the configuration is updated.</dd>
 <dt><span class="returnLabel">Returns:</span></dt>
 <dd>this builder</dd>
 </dl>
 </li>
 </ul>
-<a name="cb-java.lang.String-">
+<a name="update-java.lang.Object-java.lang.String-">
 <!--   -->
 </a>
 <ul class="blockList">
 <li class="blockList">
-<h4>cb</h4>
-<pre><a href="../../../../../org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html" title="interface in org.apache.felix.dm.lambda">ConfigurationDependencyBuilder</a>&nbsp;cb(java.lang.String&nbsp;updateMethod)</pre>
-<div class="block">Sets a <code>callback</code> to call on the component instance(s) when the configuration is updated.</div>
+<h4>update</h4>
+<pre><a href="../../../../../org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html" title="interface in org.apache.felix.dm.lambda">ConfigurationDependencyBuilder</a>&nbsp;update(java.lang.Object&nbsp;callbackInstance,
+                                      java.lang.String&nbsp;updateMethod)</pre>
+<div class="block">Sets a callback method to call on a given Object instance when the configuration is updated.  
+ When the updated method is invoked, the Component implementation is not yet instantiated. This method
+ can be typically used by a Factory object which needs the configuration before it can create the actual 
+ component implementation instance(s).
+ 
+ When the configuration is lost, the callback is invoked with a null dictionary, and the following signatures are supported:
+ <ol>
+ <li>method(Dictionary)</li>
+ <li>method(Component, Dictionary)</li>
+ </ol></div>
 <dl>
 <dt><span class="paramLabel">Parameters:</span></dt>
-<dd><code>updateMethod</code> - the callback to call on the component instance(s) when the configuration is updated.</dd>
+<dd><code>callbackInstance</code> - the object instance on which the updatedMethod is invoked</dd>
+<dd><code>updateMethod</code> - the callback to call on the callbackInstance when the configuration is updated.</dd>
 <dt><span class="returnLabel">Returns:</span></dt>
 <dd>this builder</dd>
 </dl>
 </li>
 </ul>
-<a name="cbi-java.lang.Object-java.lang.String-">
+<a name="update-java.lang.Class-java.lang.Object-java.lang.String-">
 <!--   -->
 </a>
 <ul class="blockList">
 <li class="blockList">
-<h4>cbi</h4>
-<pre><a href="../../../../../org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html" title="interface in org.apache.felix.dm.lambda">ConfigurationDependencyBuilder</a>&nbsp;cbi(java.lang.Object&nbsp;callbackInstance,
-                                   java.lang.String&nbsp;updateMethod)</pre>
-<div class="block">Sets a <code>callback instance</code> to call on a given object instance when the configuration is updated.
- When the updated method is invoked, the Component implementation has not yet been instantiated, unless you have called
- the @link <a href="../../../../../org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html#needsInstance-boolean-"><code>needsInstance(boolean)</code></a> method with "true".</div>
+<h4>update</h4>
+<pre><a href="../../../../../org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html" title="interface in org.apache.felix.dm.lambda">ConfigurationDependencyBuilder</a>&nbsp;update(java.lang.Class&lt;?&gt;&nbsp;configType,
+                                      java.lang.Object&nbsp;callbackInstance,
+                                      java.lang.String&nbsp;updateMethod)</pre>
+<div class="block">Sets a callback method to call on a given Object instance when the configuration is updated. 
+ When the updated method is invoked, the Component implementation is not yet instantiated. This method
+ can be typically used by a Factory object which needs the configuration before it can create the actual 
+ component implementation instance(s).
+ The callback is invoked with a configuration type argument (null of the configuration is lost).
+ 
+ <p>The following callback signatures are supported and searched in the following order:
+ <ol>
+ <li>method(Dictionary)</li>
+ <li>method(Component, Dictionary)</li>
+ <li>method(Configuration) // same type as the one specified in the "configType" argument</li>
+ <li>method(Component, Configuration) // Configuration has the same type as the one specified in the "configType" argument</li>
+ </ol></div>
 <dl>
 <dt><span class="paramLabel">Parameters:</span></dt>
+<dd><code>configType</code> - the type of a configuration that is passed as argument to the callback</dd>
 <dd><code>callbackInstance</code> - the object instance on which the updatedMethod is invoked</dd>
 <dd><code>updateMethod</code> - the callback to call on the callbackInstance when the configuration is updated.</dd>
 <dt><span class="returnLabel">Returns:</span></dt>
@@ -345,75 +511,161 @@ extends <a href="../../../../../org/apac
 </dl>
 </li>
 </ul>
-<a name="cb-org.apache.felix.dm.lambda.callbacks.CbTypeDictionary-">
+<a name="update-org.apache.felix.dm.lambda.callbacks.CbDictionary-">
+<!--   -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>update</h4>
+<pre>&lt;T&gt;&nbsp;<a href="../../../../../org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html" title="interface in org.apache.felix.dm.lambda">ConfigurationDependencyBuilder</a>&nbsp;update(<a href="../../../../../org/apache/felix/dm/lambda/callbacks/CbDictionary.html" title="interface in org.apache.felix.dm.lambda.callbacks">CbDictionary</a>&lt;T&gt;&nbsp;callback)</pre>
+<div class="block">Sets a reference to a "callback(Dictionary)" method from one of the component implementation classes. 
+ The method is invoked with a Dictionary argument (which is null if the configuration is lost).</div>
+<dl>
+<dt><span class="paramLabel">Type Parameters:</span></dt>
+<dd><code>T</code> - The type of the target component implementation class on which the method is invoked</dd>
+<dt><span class="paramLabel">Parameters:</span></dt>
+<dd><code>callback</code> - a reference to a method of one of the component implementation classes.</dd>
+<dt><span class="returnLabel">Returns:</span></dt>
+<dd>this builder</dd>
+</dl>
+</li>
+</ul>
+<a name="update-org.apache.felix.dm.lambda.callbacks.CbDictionaryComponent-">
+<!--   -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>update</h4>
+<pre>&lt;T&gt;&nbsp;<a href="../../../../../org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html" title="interface in org.apache.felix.dm.lambda">ConfigurationDependencyBuilder</a>&nbsp;update(<a href="../../../../../org/apache/felix/dm/lambda/callbacks/CbDictionaryComponent.html" title="interface in org.apache.felix.dm.lambda.callbacks">CbDictionaryComponent</a>&lt;T&gt;&nbsp;callback)</pre>
+<div class="block">Sets a reference to a "callback(Dictionary, Component)" method from one of the component implementation classes. 
+ The method is invoked with Dictionary/Component arguments. When the configuration is lost, the Dictionary argument
+ is null.</div>
+<dl>
+<dt><span class="paramLabel">Type Parameters:</span></dt>
+<dd><code>T</code> - The type of the target component implementation class on which the method is invoked</dd>
+<dt><span class="paramLabel">Parameters:</span></dt>
+<dd><code>callback</code> - a reference to a method callback defined in one of the the component implementation classes.</dd>
+<dt><span class="returnLabel">Returns:</span></dt>
+<dd>this builder</dd>
+</dl>
+</li>
+</ul>
+<a name="update-java.lang.Class-org.apache.felix.dm.lambda.callbacks.CbConfiguration-">
 <!--   -->
 </a>
 <ul class="blockList">
 <li class="blockList">
-<h4>cb</h4>
-<pre>&lt;T&gt;&nbsp;<a href="../../../../../org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html" title="interface in org.apache.felix.dm.lambda">ConfigurationDependencyBuilder</a>&nbsp;cb(<a href="../../../../../org/apache/felix/dm/lambda/callbacks/CbTypeDictionary.html" title="interface in org.apache.felix.dm.lambda.callbacks">CbTypeDictionary</a>&lt;T&gt;&nbsp;callback)</pre>
-<div class="block">Sets a <code>callback</code> method reference used to invoke an update method. The method reference must point to a method from one of the component
- implementation classes, and is invoked when the configuration is updated.</div>
+<h4>update</h4>
+<pre>&lt;T,U&gt;&nbsp;<a href="../../../../../org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html" title="interface in org.apache.felix.dm.lambda">ConfigurationDependencyBuilder</a>&nbsp;update(java.lang.Class&lt;U&gt;&nbsp;configType,
+                                            <a href="../../../../../org/apache/felix/dm/lambda/callbacks/CbConfiguration.html" title="interface in org.apache.felix.dm.lambda.callbacks">CbConfiguration</a>&lt;T,U&gt;&nbsp;callback)</pre>
+<div class="block">Sets a reference to a "callback(Configuration)" method from one of the component implementation classes. 
+ The method is invoked with a configuration type argument (null if the configuration is lost).</div>
 <dl>
 <dt><span class="paramLabel">Type Parameters:</span></dt>
-<dd><code>T</code> - the type of the component implementation class on which the callback is invoked on.</dd>
+<dd><code>T</code> - The type of the target component implementation class on which the method is invoked</dd>
+<dd><code>U</code> - the type of the configuration interface accepted by the callback method.</dd>
 <dt><span class="paramLabel">Parameters:</span></dt>
+<dd><code>configType</code> - the type of a configuration that is passed as argument to the callback</dd>
 <dd><code>callback</code> - the callback method reference which must point to a method from one of the component implementation classes. The method
- takes as argument a Dictionary.</dd>
+ takes as argument an interface which will be implemented by a dynamic proxy that wraps the actual configuration properties.</dd>
 <dt><span class="returnLabel">Returns:</span></dt>
 <dd>this builder</dd>
 </dl>
 </li>
 </ul>
-<a name="cb-org.apache.felix.dm.lambda.callbacks.CbTypeComponentDictionary-">
+<a name="update-java.lang.Class-org.apache.felix.dm.lambda.callbacks.CbConfigurationComponent-">
 <!--   -->
 </a>
 <ul class="blockList">
 <li class="blockList">
-<h4>cb</h4>
-<pre>&lt;T&gt;&nbsp;<a href="../../../../../org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html" title="interface in org.apache.felix.dm.lambda">ConfigurationDependencyBuilder</a>&nbsp;cb(<a href="../../../../../org/apache/felix/dm/lambda/callbacks/CbTypeComponentDictionary.html" title="interface in org.apache.felix.dm.lambda.callbacks">CbTypeComponentDictionary</a>&lt;T&gt;&nbsp;callback)</pre>
-<div class="block">Sets the <code>callback</code> method reference used to invoke an update method. The method reference must point to a method from one of the 
- component implementation classes, and is invoked when the configuration is updated.</div>
+<h4>update</h4>
+<pre>&lt;T,U&gt;&nbsp;<a href="../../../../../org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html" title="interface in org.apache.felix.dm.lambda">ConfigurationDependencyBuilder</a>&nbsp;update(java.lang.Class&lt;U&gt;&nbsp;configType,
+                                            <a href="../../../../../org/apache/felix/dm/lambda/callbacks/CbConfigurationComponent.html" title="interface in org.apache.felix.dm.lambda.callbacks">CbConfigurationComponent</a>&lt;T,U&gt;&nbsp;callback)</pre>
+<div class="block">Sets a reference to a "callback(Configuration, Component)" method from one of the component implementation classes. 
+ The method is invoked with two args: configuration type, Component. The configuration type argument is null if the configuration is lost.</div>
 <dl>
 <dt><span class="paramLabel">Type Parameters:</span></dt>
-<dd><code>T</code> - the type of the component implementation class on which the callback is invoked on.</dd>
+<dd><code>T</code> - The type of the target component implementation class on which the method is invoked</dd>
+<dd><code>U</code> - the type of the configuration interface accepted by the callback method.</dd>
+<dt><span class="paramLabel">Parameters:</span></dt>
+<dd><code>configType</code> - the type of a configuration that is passed as argument to the callback</dd>
+<dd><code>callback</code> - the reference to a method from one of the component implementation classes. The method
+ takes as argument an interface which will be implemented by a dynamic proxy that wraps the actual configuration properties. It also
+ takes as the second argument a Component object.</dd>
+<dt><span class="returnLabel">Returns:</span></dt>
+<dd>this builder</dd>
+</dl>
+</li>
+</ul>
+<a name="update-org.apache.felix.dm.lambda.callbacks.InstanceCbDictionary-">
+<!--   -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>update</h4>
+<pre><a href="../../../../../org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html" title="interface in org.apache.felix.dm.lambda">ConfigurationDependencyBuilder</a>&nbsp;update(<a href="../../../../../org/apache/felix/dm/lambda/callbacks/InstanceCbDictionary.html" title="interface in org.apache.felix.dm.lambda.callbacks">InstanceCbDictionary</a>&nbsp;callback)</pre>
+<div class="block">Sets a reference to a "callback(Dictionary)" method from an Object instance.</div>
+<dl>
 <dt><span class="paramLabel">Parameters:</span></dt>
-<dd><code>callback</code> - the callback method reference used to invoke an update method on the component instance(s) when the configuration is updated.
- The method takes as argument a Component and a Dictionary.</dd>
+<dd><code>callback</code> - a reference to an Object instance which takes as argument a Dictionary (null if the configuration is lost).</dd>
 <dt><span class="returnLabel">Returns:</span></dt>
 <dd>this builder</dd>
 </dl>
 </li>
 </ul>
-<a name="cbi-org.apache.felix.dm.lambda.callbacks.CbDictionary-">
+<a name="update-org.apache.felix.dm.lambda.callbacks.InstanceCbDictionaryComponent-">
 <!--   -->
 </a>
 <ul class="blockList">
 <li class="blockList">
-<h4>cbi</h4>
-<pre><a href="../../../../../org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html" title="interface in org.apache.felix.dm.lambda">ConfigurationDependencyBuilder</a>&nbsp;cbi(<a href="../../../../../org/apache/felix/dm/lambda/callbacks/CbDictionary.html" title="interface in org.apache.felix.dm.lambda.callbacks">CbDictionary</a>&nbsp;updated)</pre>
-<div class="block">Sets a <code>callback instance</code> method reference used to invoke the update method. The method reference must point to an Object instance 
- method which takes as argument a Dictionary.</div>
+<h4>update</h4>
+<pre><a href="../../../../../org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html" title="interface in org.apache.felix.dm.lambda">ConfigurationDependencyBuilder</a>&nbsp;update(<a href="../../../../../org/apache/felix/dm/lambda/callbacks/InstanceCbDictionaryComponent.html" title="interface in org.apache.felix.dm.lambda.callbacks">InstanceCbDictionaryComponent</a>&nbsp;callback)</pre>
+<div class="block">Sets a reference to a "callback(Dictionary, Component)" method from an Object instance. The method accepts
+ a Dictionary and a Component object. The passed Dictionary is null in case the configuration is lost.</div>
 <dl>
 <dt><span class="paramLabel">Parameters:</span></dt>
-<dd><code>updated</code> - a method reference that points to an Object instance method which takes as argument a Dictionary.</dd>
+<dd><code>callback</code> - a reference to method from an Object instance which takes as argument a Dictionary and a Component</dd>
 <dt><span class="returnLabel">Returns:</span></dt>
 <dd>this builder</dd>
 </dl>
 </li>
 </ul>
-<a name="cbi-org.apache.felix.dm.lambda.callbacks.CbComponentDictionary-">
+<a name="update-java.lang.Class-org.apache.felix.dm.lambda.callbacks.InstanceCbConfiguration-">
+<!--   -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>update</h4>
+<pre>&lt;T&gt;&nbsp;<a href="../../../../../org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html" title="interface in org.apache.felix.dm.lambda">ConfigurationDependencyBuilder</a>&nbsp;update(java.lang.Class&lt;T&gt;&nbsp;configType,
+                                          <a href="../../../../../org/apache/felix/dm/lambda/callbacks/InstanceCbConfiguration.html" title="interface in org.apache.felix.dm.lambda.callbacks">InstanceCbConfiguration</a>&lt;T&gt;&nbsp;updated)</pre>
+<div class="block">Sets a reference to a "callback(Configuration)" method from an Object instance. The configuration type argument is null if the configuration is lost.</div>
+<dl>
+<dt><span class="paramLabel">Type Parameters:</span></dt>
+<dd><code>T</code> - the type of the configuration interface accepted by the callback method.</dd>
+<dt><span class="paramLabel">Parameters:</span></dt>
+<dd><code>configType</code> - the class of the configuration that is passed as argument to the callback</dd>
+<dd><code>updated</code> - a reference to an Object instance which takes as argument the given configuration type</dd>
+<dt><span class="returnLabel">Returns:</span></dt>
+<dd>this builder</dd>
+</dl>
+</li>
+</ul>
+<a name="update-java.lang.Class-org.apache.felix.dm.lambda.callbacks.InstanceCbConfigurationComponent-">
 <!--   -->
 </a>
 <ul class="blockListLast">
 <li class="blockList">
-<h4>cbi</h4>
-<pre><a href="../../../../../org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html" title="interface in org.apache.felix.dm.lambda">ConfigurationDependencyBuilder</a>&nbsp;cbi(<a href="../../../../../org/apache/felix/dm/lambda/callbacks/CbComponentDictionary.html" title="interface in org.apache.felix.dm.lambda.callbacks">CbComponentDictionary</a>&nbsp;updated)</pre>
-<div class="block">Sets a <code>callback instance</code> method reference used to invoke the update method. The method reference must point to an Object instance method 
- which takes as argument a Component and a Dictionary.</div>
+<h4>update</h4>
+<pre>&lt;T&gt;&nbsp;<a href="../../../../../org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html" title="interface in org.apache.felix.dm.lambda">ConfigurationDependencyBuilder</a>&nbsp;update(java.lang.Class&lt;T&gt;&nbsp;configType,
+                                          <a href="../../../../../org/apache/felix/dm/lambda/callbacks/InstanceCbConfigurationComponent.html" title="interface in org.apache.felix.dm.lambda.callbacks">InstanceCbConfigurationComponent</a>&lt;T&gt;&nbsp;updated)</pre>
+<div class="block">Sets a reference to a "callback(Configuration, Component)" method from an Object instance. The method accepts
+ a configuration type and a Component object. The configuration type argument is null if the configuration is lost.</div>
 <dl>
+<dt><span class="paramLabel">Type Parameters:</span></dt>
+<dd><code>T</code> - the type of the configuration interface accepted by the callback method.</dd>
 <dt><span class="paramLabel">Parameters:</span></dt>
-<dd><code>updated</code> - a method reference that points to an Object instance method which takes as argument a Component and a Dictionary.</dd>
+<dd><code>configType</code> - the class of the configuration that is passed as argument to the callback</dd>
+<dd><code>updated</code> - a reference to an Object instance which takes as argument a the given configuration type, and a Component object.</dd>
 <dt><span class="returnLabel">Returns:</span></dt>
 <dd>this builder</dd>
 </dl>

Modified: felix/site/trunk/content/apidocs/dependencymanager.lambda/r7/org/apache/felix/dm/lambda/DependencyBuilder.html
URL: http://svn.apache.org/viewvc/felix/site/trunk/content/apidocs/dependencymanager.lambda/r7/org/apache/felix/dm/lambda/DependencyBuilder.html?rev=1731995&r1=1731994&r2=1731995&view=diff
==============================================================================
--- felix/site/trunk/content/apidocs/dependencymanager.lambda/r7/org/apache/felix/dm/lambda/DependencyBuilder.html (original)
+++ felix/site/trunk/content/apidocs/dependencymanager.lambda/r7/org/apache/felix/dm/lambda/DependencyBuilder.html Wed Feb 24 00:11:41 2016
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_72) on Thu Feb 04 08:50:09 CET 2016 -->
+<!-- Generated by javadoc (1.8.0_74) on Wed Feb 24 01:07:32 CET 2016 -->
 <title>DependencyBuilder</title>
-<meta name="date" content="2016-02-04">
+<meta name="date" content="2016-02-24">
 <link rel="stylesheet" type="text/css" href="../../../../../stylesheet.css" title="Style">
 <script type="text/javascript" src="../../../../../script.js"></script>
 </head>

Modified: felix/site/trunk/content/apidocs/dependencymanager.lambda/r7/org/apache/felix/dm/lambda/DependencyManagerActivator.html
URL: http://svn.apache.org/viewvc/felix/site/trunk/content/apidocs/dependencymanager.lambda/r7/org/apache/felix/dm/lambda/DependencyManagerActivator.html?rev=1731995&r1=1731994&r2=1731995&view=diff
==============================================================================
--- felix/site/trunk/content/apidocs/dependencymanager.lambda/r7/org/apache/felix/dm/lambda/DependencyManagerActivator.html (original)
+++ felix/site/trunk/content/apidocs/dependencymanager.lambda/r7/org/apache/felix/dm/lambda/DependencyManagerActivator.html Wed Feb 24 00:11:41 2016
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_72) on Thu Feb 04 08:50:09 CET 2016 -->
+<!-- Generated by javadoc (1.8.0_74) on Wed Feb 24 01:07:32 CET 2016 -->
 <title>DependencyManagerActivator</title>
-<meta name="date" content="2016-02-04">
+<meta name="date" content="2016-02-24">
 <link rel="stylesheet" type="text/css" href="../../../../../stylesheet.css" title="Style">
 <script type="text/javascript" src="../../../../../script.js"></script>
 </head>
@@ -18,7 +18,7 @@
     catch(err) {
     }
 //-->
-var methods = {"i0":6,"i1":10,"i2":10,"i3":9,"i4":9,"i5":10,"i6":10,"i7":9,"i8":9,"i9":10,"i10":9,"i11":9,"i12":9,"i13":10,"i14":9,"i15":10,"i16":9,"i17":9,"i18":9,"i19":10,"i20":10,"i21":9,"i22":9,"i23":9,"i24":10,"i25":10,"i26":9,"i27":10,"i28":10};
+var methods = {"i0":10,"i1":10,"i2":9,"i3":9,"i4":10,"i5":10,"i6":9,"i7":9,"i8":10,"i9":9,"i10":9,"i11":9,"i12":10,"i13":9,"i14":10,"i15":9,"i16":9,"i17":9,"i18":10,"i19":10,"i20":9,"i21":9,"i22":9,"i23":10,"i24":10,"i25":6,"i26":9,"i27":10,"i28":10};
 var tabs = {65535:["t0","All Methods"],1:["t1","Static Methods"],2:["t2","Instance Methods"],4:["t3","Abstract Methods"],8:["t4","Concrete Methods"]};
 var altColor = "altColor";
 var rowColor = "rowColor";
@@ -124,11 +124,11 @@ implements org.osgi.framework.BundleActi
  import org.apache.felix.dm.lambda.DependencyManagerActivator;
 
  public class Activator extends DependencyManagerActivator {    
-     public void activate() throws Exception {
+     public void init(BundleContext ctx, DependencyManager dm) throws Exception {
          component(comp -&gt; comp
              .provides(Service.class, property -&gt; "value")
              .impl(ServiceImpl.class)            
-             .withSrv(LogService.class, ConfigurationAdmni.class) // both services are required and injected in class fields with compatible types.           
+             .withSvc(LogService.class, ConfigurationAdmni.class) // both services are required and injected in class fields with compatible types.           
      }
  }
  </code></pre>
@@ -139,12 +139,12 @@ implements org.osgi.framework.BundleActi
  import org.apache.felix.dm.lambda.DependencyManagerActivator;
 
  public class Activator extends DependencyManagerActivator {    
-     public void activate() throws Exception {
+     public void init(BundleContext ctx, DependencyManager dm) throws Exception {
          component(comp -&gt; comp
              .provides(Service.class, property -&gt; "value")
              .impl(ServiceImpl.class)            
-             .withSrv(LogService.class, log -&gt; log.cb("setLog"))              
-             .withSrv(ConfigurationAdmni.class, cm -&gt; cm.cb("setConfigAdmin")))                
+             .withSvc(LogService.class, svc -&gt; svc.add("setLog"))              
+             .withSvc(ConfigurationAdmni.class, svc -&gt; svc.add("setConfigAdmin")))                
      }
  }
  </code></pre>
@@ -155,12 +155,12 @@ implements org.osgi.framework.BundleActi
  import org.apache.felix.dm.lambda.DependencyManagerActivator;
 
  public class Activator extends DependencyManagerActivator {    
-     public void activate() throws Exception {
+     public void init(BundleContext ctx, DependencyManager dm) throws Exception {
          component(comp -&gt; comp
              .provides(Service.class, property -&gt; "value")
              .impl(ServiceImpl.class)            
-             .withSrv(LogService.class, log -&gt; log.cb(ServiceImpl::setLog))              
-             .withSrv(ConfigurationAdmni.class, cm -&gt; cm.cb(ServiceImpl::setConfigAdmin)))                
+             .withSvc(LogService.class, svc -&gt; svc.add(ServiceImpl::setLog))              
+             .withSvc(ConfigurationAdmni.class, svc -&gt; svc.add(ServiceImpl::setConfigAdmin)))                
      }
  }
  </code></pre></div>
@@ -200,32 +200,26 @@ implements org.osgi.framework.BundleActi
 <th class="colLast" scope="col">Method and Description</th>
 </tr>
 <tr id="i0" class="altColor">
-<td class="colFirst"><code>protected abstract void</code></td>
-<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/felix/dm/lambda/DependencyManagerActivator.html#activate--">activate</a></span>()</code>
-<div class="block">Sub classes must override this method in order to build some DM components.</div>
-</td>
-</tr>
-<tr id="i1" class="rowColor">
 <td class="colFirst"><code>protected &lt;T&gt;&nbsp;<a href="../../../../../org/apache/felix/dm/lambda/ServiceAdapterBuilder.html" title="interface in org.apache.felix.dm.lambda">ServiceAdapterBuilder</a>&lt;T&gt;</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/felix/dm/lambda/DependencyManagerActivator.html#adapter-java.lang.Class-">adapter</a></span>(java.lang.Class&lt;T&gt;&nbsp;adaptee)</code>
 <div class="block">Creates a service Adapter builder that can be used to create a DM Adapter Component.</div>
 </td>
 </tr>
-<tr id="i2" class="altColor">
+<tr id="i1" class="rowColor">
 <td class="colFirst"><code>protected &lt;T&gt;&nbsp;org.apache.felix.dm.Component</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/felix/dm/lambda/DependencyManagerActivator.html#adapter-java.lang.Class-java.util.function.Consumer-">adapter</a></span>(java.lang.Class&lt;T&gt;&nbsp;adaptee,
        java.util.function.Consumer&lt;<a href="../../../../../org/apache/felix/dm/lambda/ServiceAdapterBuilder.html" title="interface in org.apache.felix.dm.lambda">ServiceAdapterBuilder</a>&lt;T&gt;&gt;&nbsp;consumer)</code>
 <div class="block">Builds a DM Adapter Component using a Java8 style AdapterBuilder.</div>
 </td>
 </tr>
-<tr id="i3" class="rowColor">
+<tr id="i2" class="altColor">
 <td class="colFirst"><code>static &lt;T&gt;&nbsp;<a href="../../../../../org/apache/felix/dm/lambda/ServiceAdapterBuilder.html" title="interface in org.apache.felix.dm.lambda">ServiceAdapterBuilder</a>&lt;T&gt;</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/felix/dm/lambda/DependencyManagerActivator.html#adapter-org.apache.felix.dm.DependencyManager-java.lang.Class-">adapter</a></span>(org.apache.felix.dm.DependencyManager&nbsp;dm,
        java.lang.Class&lt;T&gt;&nbsp;adaptee)</code>
 <div class="block">Creates a service Adapter builder that can be used to create an Adapter Component.</div>
 </td>
 </tr>
-<tr id="i4" class="altColor">
+<tr id="i3" class="rowColor">
 <td class="colFirst"><code>static &lt;T&gt;&nbsp;org.apache.felix.dm.Component</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/felix/dm/lambda/DependencyManagerActivator.html#adapter-org.apache.felix.dm.DependencyManager-java.lang.Class-java.util.function.Consumer-">adapter</a></span>(org.apache.felix.dm.DependencyManager&nbsp;dm,
        java.lang.Class&lt;T&gt;&nbsp;adaptee,
@@ -233,27 +227,27 @@ implements org.osgi.framework.BundleActi
 <div class="block">Builds an adapter DM Component.</div>
 </td>
 </tr>
-<tr id="i5" class="rowColor">
+<tr id="i4" class="altColor">
 <td class="colFirst"><code>protected &lt;T&gt;&nbsp;<a href="../../../../../org/apache/felix/dm/lambda/ServiceAspectBuilder.html" title="interface in org.apache.felix.dm.lambda">ServiceAspectBuilder</a>&lt;T&gt;</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/felix/dm/lambda/DependencyManagerActivator.html#aspect-java.lang.Class-">aspect</a></span>(java.lang.Class&lt;T&gt;&nbsp;aspectType)</code>
 <div class="block">Creates a service Aspect builder that can be used to create a DM Aspect Component.</div>
 </td>
 </tr>
-<tr id="i6" class="altColor">
+<tr id="i5" class="rowColor">
 <td class="colFirst"><code>protected &lt;T&gt;&nbsp;org.apache.felix.dm.Component</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/felix/dm/lambda/DependencyManagerActivator.html#aspect-java.lang.Class-java.util.function.Consumer-">aspect</a></span>(java.lang.Class&lt;T&gt;&nbsp;aspect,
       java.util.function.Consumer&lt;<a href="../../../../../org/apache/felix/dm/lambda/ServiceAspectBuilder.html" title="interface in org.apache.felix.dm.lambda">ServiceAspectBuilder</a>&lt;T&gt;&gt;&nbsp;consumer)</code>
 <div class="block">Builds a DM Aspect Component using a Java8 style AspectBuilder.</div>
 </td>
 </tr>
-<tr id="i7" class="rowColor">
+<tr id="i6" class="altColor">
 <td class="colFirst"><code>static &lt;T&gt;&nbsp;<a href="../../../../../org/apache/felix/dm/lambda/ServiceAspectBuilder.html" title="interface in org.apache.felix.dm.lambda">ServiceAspectBuilder</a>&lt;T&gt;</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/felix/dm/lambda/DependencyManagerActivator.html#aspect-org.apache.felix.dm.DependencyManager-java.lang.Class-">aspect</a></span>(org.apache.felix.dm.DependencyManager&nbsp;dm,
       java.lang.Class&lt;T&gt;&nbsp;aspect)</code>
 <div class="block">Creates a service Aspect builder that can be used to create an Aspect Component.</div>
 </td>
 </tr>
-<tr id="i8" class="altColor">
+<tr id="i7" class="rowColor">
 <td class="colFirst"><code>static &lt;T&gt;&nbsp;org.apache.felix.dm.Component</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/felix/dm/lambda/DependencyManagerActivator.html#aspect-org.apache.felix.dm.DependencyManager-java.lang.Class-java.util.function.Consumer-">aspect</a></span>(org.apache.felix.dm.DependencyManager&nbsp;dm,
       java.lang.Class&lt;T&gt;&nbsp;aspect,
@@ -261,113 +255,120 @@ implements org.osgi.framework.BundleActi
 <div class="block">Builds an aspect DM Component.</div>
 </td>
 </tr>
-<tr id="i9" class="rowColor">
+<tr id="i8" class="altColor">
 <td class="colFirst"><code>protected org.apache.felix.dm.Component</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/felix/dm/lambda/DependencyManagerActivator.html#bundleAdapter-java.util.function.Consumer-">bundleAdapter</a></span>(java.util.function.Consumer&lt;<a href="../../../../../org/apache/felix/dm/lambda/BundleAdapterBuilder.html" title="interface in org.apache.felix.dm.lambda">BundleAdapterBuilder</a>&gt;&nbsp;consumer)</code>
 <div class="block">Builds a DM Bundle Adapter Component.</div>
 </td>
 </tr>
-<tr id="i10" class="altColor">
+<tr id="i9" class="rowColor">
 <td class="colFirst"><code>static <a href="../../../../../org/apache/felix/dm/lambda/BundleAdapterBuilder.html" title="interface in org.apache.felix.dm.lambda">BundleAdapterBuilder</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/felix/dm/lambda/DependencyManagerActivator.html#bundleAdapter-org.apache.felix.dm.DependencyManager-">bundleAdapter</a></span>(org.apache.felix.dm.DependencyManager&nbsp;dm)</code>
 <div class="block">Creates a bundle adapter builder that can be used to create a DM bundle adapter Component.</div>
 </td>
 </tr>
-<tr id="i11" class="rowColor">
+<tr id="i10" class="altColor">
 <td class="colFirst"><code>static org.apache.felix.dm.Component</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/felix/dm/lambda/DependencyManagerActivator.html#bundleAdapter-org.apache.felix.dm.DependencyManager-java.util.function.Consumer-">bundleAdapter</a></span>(org.apache.felix.dm.DependencyManager&nbsp;dm,
              java.util.function.Consumer&lt;<a href="../../../../../org/apache/felix/dm/lambda/BundleAdapterBuilder.html" title="interface in org.apache.felix.dm.lambda">BundleAdapterBuilder</a>&gt;&nbsp;consumer)</code>
 <div class="block">Builds a bundle adapter DM Component.</div>
 </td>
 </tr>
-<tr id="i12" class="altColor">
+<tr id="i11" class="rowColor">
 <td class="colFirst"><code>static <a href="../../../../../org/apache/felix/dm/lambda/BundleDependencyBuilder.html" title="interface in org.apache.felix.dm.lambda">BundleDependencyBuilder</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/felix/dm/lambda/DependencyManagerActivator.html#bundleDependency-org.apache.felix.dm.Component-">bundleDependency</a></span>(org.apache.felix.dm.Component&nbsp;component)</code>
 <div class="block">Creates a DM Bundle Dependency builder.</div>
 </td>
 </tr>
-<tr id="i13" class="rowColor">
+<tr id="i12" class="altColor">
 <td class="colFirst"><code>protected <a href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html" title="interface in org.apache.felix.dm.lambda">ComponentBuilder</a>&lt;?&gt;</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/felix/dm/lambda/DependencyManagerActivator.html#component--">component</a></span>()</code>
 <div class="block">Creates a Component builder that can be used to create a DM Component.</div>
 </td>
 </tr>
-<tr id="i14" class="altColor">
+<tr id="i13" class="rowColor">
 <td class="colFirst"><code>static void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/felix/dm/lambda/DependencyManagerActivator.html#component-org.apache.felix.dm.Component-java.util.function.Consumer-">component</a></span>(org.apache.felix.dm.Component&nbsp;comp,
          java.util.function.Consumer&lt;<a href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html" title="interface in org.apache.felix.dm.lambda">ComponentBuilder</a>&lt;?&gt;&gt;&nbsp;consumer)</code>
 <div class="block">Update an existing component.</div>
 </td>
 </tr>
-<tr id="i15" class="rowColor">
+<tr id="i14" class="altColor">
 <td class="colFirst"><code>protected org.apache.felix.dm.Component</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/felix/dm/lambda/DependencyManagerActivator.html#component-java.util.function.Consumer-">component</a></span>(java.util.function.Consumer&lt;<a href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html" title="interface in org.apache.felix.dm.lambda">ComponentBuilder</a>&lt;?&gt;&gt;&nbsp;consumer)</code>
 <div class="block">Builds a DM Component using a Java8 style ComponentBuilder.</div>
 </td>
 </tr>
-<tr id="i16" class="altColor">
+<tr id="i15" class="rowColor">
 <td class="colFirst"><code>static <a href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html" title="interface in org.apache.felix.dm.lambda">ComponentBuilder</a>&lt;?&gt;</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/felix/dm/lambda/DependencyManagerActivator.html#component-org.apache.felix.dm.DependencyManager-">component</a></span>(org.apache.felix.dm.DependencyManager&nbsp;dm)</code>
 <div class="block">Creates a Component builder that can be used to create a Component.</div>
 </td>
 </tr>
-<tr id="i17" class="rowColor">
+<tr id="i16" class="altColor">
 <td class="colFirst"><code>static org.apache.felix.dm.Component</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/felix/dm/lambda/DependencyManagerActivator.html#component-org.apache.felix.dm.DependencyManager-java.util.function.Consumer-">component</a></span>(org.apache.felix.dm.DependencyManager&nbsp;dm,
          java.util.function.Consumer&lt;<a href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html" title="interface in org.apache.felix.dm.lambda">ComponentBuilder</a>&lt;?&gt;&gt;&nbsp;consumer)</code>
 <div class="block">Builds a component using a lambda and a component builder</div>
 </td>
 </tr>
-<tr id="i18" class="altColor">
+<tr id="i17" class="rowColor">
 <td class="colFirst"><code>static <a href="../../../../../org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html" title="interface in org.apache.felix.dm.lambda">ConfigurationDependencyBuilder</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/felix/dm/lambda/DependencyManagerActivator.html#confDependency-org.apache.felix.dm.Component-">confDependency</a></span>(org.apache.felix.dm.Component&nbsp;component)</code>
 <div class="block">Creates a DM Configuration Dependency builder.</div>
 </td>
 </tr>
-<tr id="i19" class="rowColor">
+<tr id="i18" class="altColor">
 <td class="colFirst"><code>protected void</code></td>
-<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/felix/dm/lambda/DependencyManagerActivator.html#deactivate--">deactivate</a></span>()</code>
+<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/felix/dm/lambda/DependencyManagerActivator.html#destroy--">destroy</a></span>()</code>
 <div class="block">Sub classes may override this method that is called when the Activator is stopped.</div>
 </td>
 </tr>
-<tr id="i20" class="altColor">
+<tr id="i19" class="rowColor">
 <td class="colFirst"><code>protected org.apache.felix.dm.Component</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/felix/dm/lambda/DependencyManagerActivator.html#factoryPidAdapter-java.util.function.Consumer-">factoryPidAdapter</a></span>(java.util.function.Consumer&lt;<a href="../../../../../org/apache/felix/dm/lambda/FactoryPidAdapterBuilder.html" title="interface in org.apache.felix.dm.lambda">FactoryPidAdapterBuilder</a>&gt;&nbsp;consumer)</code>
 <div class="block">Builds a DM Factory Configuration Adapter Component using a Java8 style FactoryPidAdapterBuilder.</div>
 </td>
 </tr>
-<tr id="i21" class="rowColor">
+<tr id="i20" class="altColor">
 <td class="colFirst"><code>static <a href="../../../../../org/apache/felix/dm/lambda/FactoryPidAdapterBuilder.html" title="interface in org.apache.felix.dm.lambda">FactoryPidAdapterBuilder</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/felix/dm/lambda/DependencyManagerActivator.html#factoryPidAdapter-org.apache.felix.dm.DependencyManager-">factoryPidAdapter</a></span>(org.apache.felix.dm.DependencyManager&nbsp;dm)</code>
 <div class="block">Creates a factory pid adapter that can be used to create a factory adapter Component.</div>
 </td>
 </tr>
-<tr id="i22" class="altColor">
+<tr id="i21" class="rowColor">
 <td class="colFirst"><code>static org.apache.felix.dm.Component</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/felix/dm/lambda/DependencyManagerActivator.html#factoryPidAdapter-org.apache.felix.dm.DependencyManager-java.util.function.Consumer-">factoryPidAdapter</a></span>(org.apache.felix.dm.DependencyManager&nbsp;dm,
                  java.util.function.Consumer&lt;<a href="../../../../../org/apache/felix/dm/lambda/FactoryPidAdapterBuilder.html" title="interface in org.apache.felix.dm.lambda">FactoryPidAdapterBuilder</a>&gt;&nbsp;consumer)</code>
 <div class="block">Builds a DM factory configuration adapter.</div>
 </td>
 </tr>
-<tr id="i23" class="rowColor">
+<tr id="i22" class="altColor">
 <td class="colFirst"><code>static &lt;F&gt;&nbsp;<a href="../../../../../org/apache/felix/dm/lambda/FutureDependencyBuilder.html" title="interface in org.apache.felix.dm.lambda">FutureDependencyBuilder</a>&lt;F&gt;</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/felix/dm/lambda/DependencyManagerActivator.html#futureDependency-org.apache.felix.dm.Component-java.util.concurrent.CompletableFuture-">futureDependency</a></span>(org.apache.felix.dm.Component&nbsp;component,
                 java.util.concurrent.CompletableFuture&lt;F&gt;&nbsp;future)</code>
 <div class="block">Creates a DM CompletableFuture Dependency builder.</div>
 </td>
 </tr>
-<tr id="i24" class="altColor">
+<tr id="i23" class="rowColor">
 <td class="colFirst"><code>org.osgi.framework.BundleContext</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/felix/dm/lambda/DependencyManagerActivator.html#getBC--">getBC</a></span>()</code>
 <div class="block">Returns the bundle context that is associated with this bundle.</div>
 </td>
 </tr>
-<tr id="i25" class="rowColor">
+<tr id="i24" class="altColor">
 <td class="colFirst"><code>org.apache.felix.dm.DependencyManager</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/felix/dm/lambda/DependencyManagerActivator.html#getDM--">getDM</a></span>()</code>
 <div class="block">Returns the DependencyManager used to create/managed DM Components.</div>
 </td>
 </tr>
+<tr id="i25" class="rowColor">
+<td class="colFirst"><code>protected abstract void</code></td>
+<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/felix/dm/lambda/DependencyManagerActivator.html#init-org.osgi.framework.BundleContext-org.apache.felix.dm.DependencyManager-">init</a></span>(org.osgi.framework.BundleContext&nbsp;ctx,
+    org.apache.felix.dm.DependencyManager&nbsp;dm)</code>
+<div class="block">Sub classes must override this method in order to build some DM components.</div>
+</td>
+</tr>
 <tr id="i26" class="altColor">
 <td class="colFirst"><code>static &lt;T&gt;&nbsp;<a href="../../../../../org/apache/felix/dm/lambda/ServiceDependencyBuilder.html" title="interface in org.apache.felix.dm.lambda">ServiceDependencyBuilder</a>&lt;T&gt;</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/felix/dm/lambda/DependencyManagerActivator.html#serviceDependency-org.apache.felix.dm.Component-java.lang.Class-">serviceDependency</a></span>(org.apache.felix.dm.Component&nbsp;component,
@@ -460,29 +461,33 @@ implements org.osgi.framework.BundleActi
 </dl>
 </li>
 </ul>
-<a name="activate--">
+<a name="init-org.osgi.framework.BundleContext-org.apache.felix.dm.DependencyManager-">
 <!--   -->
 </a>
 <ul class="blockList">
 <li class="blockList">
-<h4>activate</h4>
-<pre>protected abstract&nbsp;void&nbsp;activate()
-                          throws java.lang.Exception</pre>
+<h4>init</h4>
+<pre>protected abstract&nbsp;void&nbsp;init(org.osgi.framework.BundleContext&nbsp;ctx,
+                             org.apache.felix.dm.DependencyManager&nbsp;dm)
+                      throws java.lang.Exception</pre>
 <div class="block">Sub classes must override this method in order to build some DM components.</div>
 <dl>
+<dt><span class="paramLabel">Parameters:</span></dt>
+<dd><code>ctx</code> - the context associated to the bundle</dd>
+<dd><code>dm</code> - the DependencyManager assocaited to this activator</dd>
 <dt><span class="throwsLabel">Throws:</span></dt>
 <dd><code>java.lang.Exception</code> - if the activation fails</dd>
 </dl>
 </li>
 </ul>
-<a name="deactivate--">
+<a name="destroy--">
 <!--   -->
 </a>
 <ul class="blockList">
 <li class="blockList">
-<h4>deactivate</h4>
-<pre>protected&nbsp;void&nbsp;deactivate()
-                   throws java.lang.Exception</pre>
+<h4>destroy</h4>
+<pre>protected&nbsp;void&nbsp;destroy()
+                throws java.lang.Exception</pre>
 <div class="block">Sub classes may override this method that is called when the Activator is stopped.</div>
 <dl>
 <dt><span class="throwsLabel">Throws:</span></dt>



Mime
View raw message