Modified:
websites/staging/felix/trunk/content/apidocs/dependencymanager.lambda/r7/org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html
==============================================================================
---
websites/staging/felix/trunk/content/apidocs/dependencymanager.lambda/r7/org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html
(original)
+++
websites/staging/felix/trunk/content/apidocs/dependencymanager.lambda/r7/org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html
Wed Feb 24 00:19:46 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><org.apache.felix.dm.ConfigurationDependency></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" => "a", "arr.1" => "b", "arr.2" => "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" => "{key1.value1, key2.value2}"</code></pre>
+
+ and a dictionary with <p>
+
+ <pre><code> "map.key1" => "value1", "map2.key2" =>
"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 -> comp
.impl(ServiceImpl.class)
- .withConf(conf ->
conf.pid(ServiceConsumer.class).cb(ServiceImpl::modified)));
+ .withCnf(conf -> 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 -> comp
+ .impl(ServiceImpl.class)
+ .withCnf(conf ->
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 -> 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 -> comp.impl(ServiceImpl.class).withCnf(conf ->
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><T> <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><T> 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 pid)</code>
+<div class="block">Sets the pid for this configuration dependency.</div>
</td>
</tr>
<tr id="i1" class="rowColor">
-<td class="colFirst"><code><T> <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><T> 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 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 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> updated)</code>
-<div class="block">Sets a <code>callback instance</code> method reference used
to invoke the update method.</div>
+<td class="colFirst"><code><T> <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><T> 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> updated)</code>
-<div class="block">Sets a <code>callback instance</code> method reference used
to invoke the update method.</div>
+<td class="colFirst"><code><T> <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><T> 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 callbackInstance,
- java.lang.String 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<?> configType,
+ java.lang.Object callbackInstance,
+ java.lang.String 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 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<?> configType,
+ java.lang.String 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<?> pidClass)</code>
-<div class="block">Sets the class which fqdn represents the pid for this
configuration dependency.</div>
+<td class="colFirst"><code><T> <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<T> configType,
+ <a
href="../../../../../org/apache/felix/dm/lambda/callbacks/InstanceCbConfiguration.html"
title="interface in
org.apache.felix.dm.lambda.callbacks">InstanceCbConfiguration</a><T> 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 pid)</code>
-<div class="block">Sets the pid for this configuration dependency.</div>
+<td class="colFirst"><code><T> <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<T> configType,
+ <a
href="../../../../../org/apache/felix/dm/lambda/callbacks/InstanceCbConfigurationComponent.html"
title="interface in
org.apache.felix.dm.lambda.callbacks">InstanceCbConfigurationComponent</a><T> 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><T,U> <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<U> configType,
+ <a
href="../../../../../org/apache/felix/dm/lambda/callbacks/CbConfiguration.html"
title="interface in
org.apache.felix.dm.lambda.callbacks">CbConfiguration</a><T,U> 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><T,U> <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<U> configType,
+ <a
href="../../../../../org/apache/felix/dm/lambda/callbacks/CbConfigurationComponent.html"
title="interface in
org.apache.felix.dm.lambda.callbacks">CbConfigurationComponent</a><T,U> 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 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> 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> 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 callbackInstance,
+ java.lang.String 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 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> pid(java.lang.Class<?> 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> 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> 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> propagate(boolean 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> propagate(boolean 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> update(java.lang.String 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> needsInstance(boolean 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> update(java.lang.Class<?> configType,
+ java.lang.String 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> cb(java.lang.String 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> update(java.lang.Object callbackInstance,
+ java.lang.String 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> cbi(java.lang.Object callbackInstance,
- java.lang.String 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> update(java.lang.Class<?> configType,
+ java.lang.Object callbackInstance,
+ java.lang.String 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><T> <a
href="../../../../../org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html"
title="interface in
org.apache.felix.dm.lambda">ConfigurationDependencyBuilder</a> update(<a
href="../../../../../org/apache/felix/dm/lambda/callbacks/CbDictionary.html"
title="interface in
org.apache.felix.dm.lambda.callbacks">CbDictionary</a><T> 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><T> <a
href="../../../../../org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html"
title="interface in
org.apache.felix.dm.lambda">ConfigurationDependencyBuilder</a> update(<a
href="../../../../../org/apache/felix/dm/lambda/callbacks/CbDictionaryComponent.html"
title="interface in
org.apache.felix.dm.lambda.callbacks">CbDictionaryComponent</a><T> 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><T> <a
href="../../../../../org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html"
title="interface in
org.apache.felix.dm.lambda">ConfigurationDependencyBuilder</a> cb(<a
href="../../../../../org/apache/felix/dm/lambda/callbacks/CbTypeDictionary.html"
title="interface in
org.apache.felix.dm.lambda.callbacks">CbTypeDictionary</a><T> 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><T,U> <a
href="../../../../../org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html"
title="interface in
org.apache.felix.dm.lambda">ConfigurationDependencyBuilder</a> update(java.lang.Class<U> configType,
+ <a
href="../../../../../org/apache/felix/dm/lambda/callbacks/CbConfiguration.html"
title="interface in
org.apache.felix.dm.lambda.callbacks">CbConfiguration</a><T,U> 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><T> <a
href="../../../../../org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html"
title="interface in
org.apache.felix.dm.lambda">ConfigurationDependencyBuilder</a> cb(<a
href="../../../../../org/apache/felix/dm/lambda/callbacks/CbTypeComponentDictionary.html"
title="interface in
org.apache.felix.dm.lambda.callbacks">CbTypeComponentDictionary</a><T> 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><T,U> <a
href="../../../../../org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html"
title="interface in
org.apache.felix.dm.lambda">ConfigurationDependencyBuilder</a> update(java.lang.Class<U> configType,
+ <a
href="../../../../../org/apache/felix/dm/lambda/callbacks/CbConfigurationComponent.html"
title="interface in
org.apache.felix.dm.lambda.callbacks">CbConfigurationComponent</a><T,U> 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> update(<a
href="../../../../../org/apache/felix/dm/lambda/callbacks/InstanceCbDictionary.html"
title="interface in
org.apache.felix.dm.lambda.callbacks">InstanceCbDictionary</a> 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> cbi(<a
href="../../../../../org/apache/felix/dm/lambda/callbacks/CbDictionary.html"
title="interface in
org.apache.felix.dm.lambda.callbacks">CbDictionary</a> 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> update(<a
href="../../../../../org/apache/felix/dm/lambda/callbacks/InstanceCbDictionaryComponent.html"
title="interface in
org.apache.felix.dm.lambda.callbacks">InstanceCbDictionaryComponent</a> 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><T> <a
href="../../../../../org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html"
title="interface in
org.apache.felix.dm.lambda">ConfigurationDependencyBuilder</a> update(java.lang.Class<T> configType,
+ <a
href="../../../../../org/apache/felix/dm/lambda/callbacks/InstanceCbConfiguration.html"
title="interface in
org.apache.felix.dm.lambda.callbacks">InstanceCbConfiguration</a><T> 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> cbi(<a
href="../../../../../org/apache/felix/dm/lambda/callbacks/CbComponentDictionary.html"
title="interface in
org.apache.felix.dm.lambda.callbacks">CbComponentDictionary</a> 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><T> <a
href="../../../../../org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html"
title="interface in
org.apache.felix.dm.lambda">ConfigurationDependencyBuilder</a> update(java.lang.Class<T> configType,
+ <a
href="../../../../../org/apache/felix/dm/lambda/callbacks/InstanceCbConfigurationComponent.html"
title="interface in
org.apache.felix.dm.lambda.callbacks">InstanceCbConfigurationComponent</a><T> 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:
websites/staging/felix/trunk/content/apidocs/dependencymanager.lambda/r7/org/apache/felix/dm/lambda/DependencyBuilder.html
==============================================================================
---
websites/staging/felix/trunk/content/apidocs/dependencymanager.lambda/r7/org/apache/felix/dm/lambda/DependencyBuilder.html
(original)
+++
websites/staging/felix/trunk/content/apidocs/dependencymanager.lambda/r7/org/apache/felix/dm/lambda/DependencyBuilder.html
Wed Feb 24 00:19:46 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:
websites/staging/felix/trunk/content/apidocs/dependencymanager.lambda/r7/org/apache/felix/dm/lambda/DependencyManagerActivator.html
==============================================================================
---
websites/staging/felix/trunk/content/apidocs/dependencymanager.lambda/r7/org/apache/felix/dm/lambda/DependencyManagerActivator.html
(original)
+++
websites/staging/felix/trunk/content/apidocs/dependencymanager.lambda/r7/org/apache/felix/dm/lambda/DependencyManagerActivator.html
Wed Feb 24 00:19:46 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 -> comp
.provides(Service.class, property -> "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 -> comp
.provides(Service.class, property -> "value")
.impl(ServiceImpl.class)
- .withSrv(LogService.class, log -> log.cb("setLog"))
- .withSrv(ConfigurationAdmni.class, cm ->
cm.cb("setConfigAdmin")))
+ .withSvc(LogService.class, svc -> svc.add("setLog"))
+ .withSvc(ConfigurationAdmni.class, svc ->
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 -> comp
.provides(Service.class, property -> "value")
.impl(ServiceImpl.class)
- .withSrv(LogService.class, log -> log.cb(ServiceImpl::setLog))
- .withSrv(ConfigurationAdmni.class, cm ->
cm.cb(ServiceImpl::setConfigAdmin)))
+ .withSvc(LogService.class, svc ->
svc.add(ServiceImpl::setLog))
+ .withSvc(ConfigurationAdmni.class, svc ->
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 <T> <a
href="../../../../../org/apache/felix/dm/lambda/ServiceAdapterBuilder.html"
title="interface in
org.apache.felix.dm.lambda">ServiceAdapterBuilder</a><T></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<T> 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
<T> 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<T> adaptee,
java.util.function.Consumer<<a
href="../../../../../org/apache/felix/dm/lambda/ServiceAdapterBuilder.html"
title="interface in
org.apache.felix.dm.lambda">ServiceAdapterBuilder</a><T>> 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 <T> <a
href="../../../../../org/apache/felix/dm/lambda/ServiceAdapterBuilder.html"
title="interface in
org.apache.felix.dm.lambda">ServiceAdapterBuilder</a><T></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 dm,
java.lang.Class<T> 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
<T> 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 dm,
java.lang.Class<T> 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 <T> <a
href="../../../../../org/apache/felix/dm/lambda/ServiceAspectBuilder.html"
title="interface in
org.apache.felix.dm.lambda">ServiceAspectBuilder</a><T></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<T> 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
<T> 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<T> aspect,
java.util.function.Consumer<<a
href="../../../../../org/apache/felix/dm/lambda/ServiceAspectBuilder.html"
title="interface in
org.apache.felix.dm.lambda">ServiceAspectBuilder</a><T>> 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 <T> <a
href="../../../../../org/apache/felix/dm/lambda/ServiceAspectBuilder.html"
title="interface in
org.apache.felix.dm.lambda">ServiceAspectBuilder</a><T></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 dm,
java.lang.Class<T> 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
<T> 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 dm,
java.lang.Class<T> 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<<a
href="../../../../../org/apache/felix/dm/lambda/BundleAdapterBuilder.html"
title="interface in
org.apache.felix.dm.lambda">BundleAdapterBuilder</a>> 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 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 dm,
java.util.function.Consumer<<a
href="../../../../../org/apache/felix/dm/lambda/BundleAdapterBuilder.html"
title="interface in
org.apache.felix.dm.lambda">BundleAdapterBuilder</a>> 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 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><?></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 comp,
java.util.function.Consumer<<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html"
title="interface in
org.apache.felix.dm.lambda">ComponentBuilder</a><?>> 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<<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html"
title="interface in
org.apache.felix.dm.lambda">ComponentBuilder</a><?>> 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><?></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 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 dm,
java.util.function.Consumer<<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html"
title="interface in
org.apache.felix.dm.lambda">ComponentBuilder</a><?>> 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 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<<a
href="../../../../../org/apache/felix/dm/lambda/FactoryPidAdapterBuilder.html"
title="interface in
org.apache.felix.dm.lambda">FactoryPidAdapterBuilder</a>> 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 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 dm,
java.util.function.Consumer<<a
href="../../../../../org/apache/felix/dm/lambda/FactoryPidAdapterBuilder.html"
title="interface in
org.apache.felix.dm.lambda">FactoryPidAdapterBuilder</a>> 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 <F> <a
href="../../../../../org/apache/felix/dm/lambda/FutureDependencyBuilder.html"
title="interface in
org.apache.felix.dm.lambda">FutureDependencyBuilder</a><F></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 component,
java.util.concurrent.CompletableFuture<F> 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 ctx,
+ org.apache.felix.dm.DependencyManager 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 <T> <a
href="../../../../../org/apache/felix/dm/lambda/ServiceDependencyBuilder.html"
title="interface in
org.apache.felix.dm.lambda">ServiceDependencyBuilder</a><T></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 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 void activate()
- throws java.lang.Exception</pre>
+<h4>init</h4>
+<pre>protected
abstract void init(org.osgi.framework.BundleContext ctx,
+ org.apache.felix.dm.DependencyManager 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 void deactivate()
- throws java.lang.Exception</pre>
+<h4>destroy</h4>
+<pre>protected void 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>
