Modified:
websites/staging/felix/trunk/content/apidocs/dependencymanager.lambda/r7/org/apache/felix/dm/lambda/FactoryPidAdapterBuilder.html
==============================================================================
---
websites/staging/felix/trunk/content/apidocs/dependencymanager.lambda/r7/org/apache/felix/dm/lambda/FactoryPidAdapterBuilder.html
(original)
+++
websites/staging/felix/trunk/content/apidocs/dependencymanager.lambda/r7/org/apache/felix/dm/lambda/FactoryPidAdapterBuilder.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>FactoryPidAdapterBuilder</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};
+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";
@@ -106,21 +106,49 @@ var activeTableTab = "activeTableTab";
<br>
<pre>public interface <span
class="typeNameLabel">FactoryPidAdapterBuilder</span>
extends <a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html"
title="interface in org.apache.felix.dm.lambda">ComponentBuilder</a><<a
href="../../../../../org/apache/felix/dm/lambda/FactoryPidAdapterBuilder.html"
title="interface in
org.apache.felix.dm.lambda">FactoryPidAdapterBuilder</a>></pre>
-<div class="block">Builds a Dependency Manager Factory Configuration Adapter
Component. For each new Config Admin factory configuration matching the
factoryPid,
+<div class="block">Builds a Dependency Manager Factory Configuration Adapter
Component. <p> For each new Config Admin factory configuration matching a given
factory pid,
an adapter will be created based on the adapter implementation class. The
adapter will be registered with the specified interface,
and with the specified adapter service properties. Depending on the propagate
parameter, every public factory configuration properties
- (which don't start with ".") will be propagated along with the adapter
service properties.
+ (which don't start with ".") will be propagated along with the adapter
service properties.
- <p> Example that defines a factory configuration adapter service for the
"foo.bar" factory pid:
+ This builded supports type safe configuration types. For a given factory
configuration, you can specify an interface of your choice,
+ and DM will implement it using a dynamic proxy that converts interface
methods to lookups in the actual factory configuration dictionary.
+ For more information about configuration types, please refer to <a
href="../../../../../org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html"
title="interface in
org.apache.felix.dm.lambda"><code>ConfigurationDependencyBuilder</code></a>.
+
+ <p> Example that defines a factory configuration adapter service for the
"foo.bar" factory pid. For each factory pid instance,
+ an instance of the DictionaryImpl component will be created.
<pre> <code>
public class Activator extends DependencyManagerActivator {
- public void activate() throws Exception {
+ public void init(BundleContext ctx, DependencyManager dm) throws
Exception {
factoryPidAdapter(adapter -> adapter
.impl(DictionaryImpl.class)
- .factoryPid("foo.bar").cb(ServiceImpl::updated)
+ .factoryPid("foo.bar")
+ .update(ServiceImpl::updated)
.propagate()
- .withSrv(LogService.class, log -> log.optional()));
+ .withSvc(LogService.class, log -> log.optional()));
+ }
+ }
+ </code></pre>
+
+ <p> Example that defines a factory configuration adapter using a user defined
configuration type
+ (the pid is by default assumed to match the fqdn of the configuration type):
+
+ <pre> <code>
+
+ public interface DictionaryConfiguration {
+ public String getLanguage();
+ public List<String> getWords();
+ }
+
+ public class Activator extends DependencyManagerActivator {
+ public void init(BundleContext ctx, DependencyManager dm) throws
Exception {
+ factoryPidAdapter(adapter -> adapter
+ .impl(DictionaryImpl.class)
+ .factoryPid("foo.bar")
+ .update(DictionaryConfiguration.class, ServiceImpl::updated)
+ .propagate()
+ .withSvc(LogService.class, log -> log.optional()));
}
}
</code></pre></div>
@@ -143,64 +171,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><U> <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/FactoryPidAdapterBuilder.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><U> callback)</code>
-<div class="block">Specifies a callback method reference that will be called
on one of the component classes when the configuration is injected</div>
+<td class="colFirst"><code><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/FactoryPidAdapterBuilder.html#factoryPid-java.lang.String-">factoryPid</a></span>(java.lang.String pid)</code>
+<div class="block">Specifies the factory pid used by the adapter.</div>
</td>
</tr>
<tr id="i1" class="rowColor">
-<td class="colFirst"><code><U> <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/FactoryPidAdapterBuilder.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><U> callback)</code>
-<div class="block">Specifies a callback method reference that will be called
on one of the component classes when the configuration is injected.</div>
+<td class="colFirst"><code><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/FactoryPidAdapterBuilder.html#propagate--">propagate</a></span>()</code>
+<div class="block">Specifies if the public properties (not starting with a
dot) should be propagated to the adapter service properties (false by
default).</div>
</td>
</tr>
<tr id="i2" class="altColor">
<td class="colFirst"><code><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/FactoryPidAdapterBuilder.html#cb-java.lang.Object-java.lang.String-">cb</a></span>(java.lang.Object callbackInstance,
- java.lang.String updateMethod)</code>
-<div class="block">Specifies a callback instance method that will be called on
a given object instance when the configuration is injected</div>
+<td class="colLast"><code><span class="memberNameLink"><a
href="../../../../../org/apache/felix/dm/lambda/FactoryPidAdapterBuilder.html#propagate-boolean-">propagate</a></span>(boolean propagate)</code>
+<div class="block">Specifies if the public properties (not starting with a
dot) should be propagated to the adapter service properties (false by
default).</div>
</td>
</tr>
<tr id="i3" class="rowColor">
-<td class="colFirst"><code><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/FactoryPidAdapterBuilder.html#cb-java.lang.String-">cb</a></span>(java.lang.String updateMethod)</code>
-<div class="block">Specifies a callback method that will be called on the
component instances when the configuration is injected</div>
+<td class="colFirst"><code><T> <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/FactoryPidAdapterBuilder.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">Specifies a method reference that will be called on one of
the component classes when the configuration is injected.</div>
</td>
</tr>
<tr id="i4" class="altColor">
-<td class="colFirst"><code><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/FactoryPidAdapterBuilder.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> callback)</code>
-<div class="block">Specifies a callback instance method reference that will be
called on a given object instance when the configuration is injected.</div>
+<td class="colFirst"><code><T> <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/FactoryPidAdapterBuilder.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">Specifies a method reference that will be called on one of
the component classes when the configuration is injected</div>
</td>
</tr>
<tr id="i5" class="rowColor">
<td class="colFirst"><code><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/FactoryPidAdapterBuilder.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> callback)</code>
-<div class="block">Specifies a callback instance method reference that will be
called on a given object instance when the configuration is injected</div>
+<td class="colLast"><code><span class="memberNameLink"><a
href="../../../../../org/apache/felix/dm/lambda/FactoryPidAdapterBuilder.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">Specifies a callback instance method that will be called on
a given object instance when the configuration is injected.</div>
</td>
</tr>
<tr id="i6" class="altColor">
<td class="colFirst"><code><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/FactoryPidAdapterBuilder.html#factoryPid-java.lang.Class-">factoryPid</a></span>(java.lang.Class<?> pidClass)</code>
-<div class="block">Specifies a class name which fqdn represents the factory
pid.</div>
+<td class="colLast"><code><span class="memberNameLink"><a
href="../../../../../org/apache/felix/dm/lambda/FactoryPidAdapterBuilder.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 when the configuration is updated.</div>
</td>
</tr>
<tr id="i7" class="rowColor">
-<td class="colFirst"><code><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/FactoryPidAdapterBuilder.html#factoryPid-java.lang.String-">factoryPid</a></span>(java.lang.String pid)</code>
-<div class="block">Specifies the factory pid used by the adapter.</div>
+<td class="colFirst"><code><T> <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/FactoryPidAdapterBuilder.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> callback)</code>
+<div class="block">Specifies a method reference that will be called on a given
object instance when the configuration is injected.</div>
</td>
</tr>
<tr id="i8" class="altColor">
-<td class="colFirst"><code><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/FactoryPidAdapterBuilder.html#propagate--">propagate</a></span>()</code>
-<div class="block">Specifies if the public properties (not starting with a
dot) should be propagated in the adapter service properties (false by
default).</div>
+<td class="colFirst"><code><T> <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/FactoryPidAdapterBuilder.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> callback)</code>
+<div class="block">Specifies a method reference that will be called on a given
object instance when the configuration is injected.</div>
</td>
</tr>
<tr id="i9" class="rowColor">
+<td class="colFirst"><code><T,U> <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/FactoryPidAdapterBuilder.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">Specifies a method reference that will be called on one of
the component classes when the configuration is injected.</div>
+</td>
+</tr>
+<tr id="i10" class="altColor">
+<td class="colFirst"><code><T,U> <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/FactoryPidAdapterBuilder.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">Specifies a method reference that will be called on one of
the component classes when the configuration is injected.</div>
+</td>
+</tr>
+<tr id="i11" class="rowColor">
<td class="colFirst"><code><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/FactoryPidAdapterBuilder.html#propagate-boolean-">propagate</a></span>(boolean propagate)</code>
-<div class="block">Specifies if the public properties (not starting with a
dot) should be propagated in the adapter service properties (false by
default).</div>
+<td class="colLast"><code><span class="memberNameLink"><a
href="../../../../../org/apache/felix/dm/lambda/FactoryPidAdapterBuilder.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">Specifies a method reference that will be called on a given
object instance when the configuration is injected</div>
+</td>
+</tr>
+<tr id="i12" class="altColor">
+<td class="colFirst"><code><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/FactoryPidAdapterBuilder.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">Specifies a method reference that will be called on a given
object instance when the configuration is injected.</div>
+</td>
+</tr>
+<tr id="i13" class="rowColor">
+<td class="colFirst"><code><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/FactoryPidAdapterBuilder.html#update-java.lang.Object-java.lang.String-">update</a></span>(java.lang.Object callbackInstance,
+ java.lang.String updateMethod)</code>
+<div class="block">Specifies a callback instance method that will be called on
a given object instance when the configuration is injected.</div>
+</td>
+</tr>
+<tr id="i14" class="altColor">
+<td class="colFirst"><code><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/FactoryPidAdapterBuilder.html#update-java.lang.String-">update</a></span>(java.lang.String updateMethod)</code>
+<div class="block">Specifies a callback method that will be called on the
component implementation when the configuration is injected.</div>
</td>
</tr>
</table>
@@ -209,7 +274,7 @@ extends <a href="../../../../../org/apac
<!-- -->
</a>
<h3>Methods inherited from interface org.apache.felix.dm.lambda.<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html"
title="interface in org.apache.felix.dm.lambda">ComponentBuilder</a></h3>
-<code><a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#autoAdd-boolean-">autoAdd</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#autoConfig-java.lang.Class-boolean-">autoConfig</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#autoConfig-java.lang.Class-java.lang.String-">autoConfig</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#build--">build</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#composition-java.lang.Object-java.lang.String-">composition</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#composition-java.lang.String-">composition</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#composition-java.util.function.Supplier-">composition</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#debug-java.lang.String-">debug</a>,
<a href="../../../../../org/apach
e/felix/dm/lambda/ComponentBuilder.html#destroy-org.apache.felix.dm.lambda.callbacks.CbConsumer-">destroy</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#destroy-org.apache.felix.dm.lambda.callbacks.CbTypeComponent-">destroy</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#destroy-java.lang.Object-java.lang.String-">destroy</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#destroy-java.lang.String-">destroy</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#destroyInstance-org.apache.felix.dm.lambda.callbacks.CbComponent-">destroyInstance</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#destroyInstance-java.lang.Runnable-">destroyInstance</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#factory-java.lang.Object-java.lang.String-">factory</a>,
<a href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html
#factory-java.util.function.Supplier-">factory</a>, <a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#factory-java.util.function.Supplier-java.util.function.Supplier-">factory</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#factory-java.util.function.Supplier-java.util.function.Function-java.util.function.Function-">factory</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#factory-java.util.function.Supplier-java.util.function.Function-">factory</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#impl-java.lang.Object-">impl</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#init-org.apache.felix.dm.lambda.callbacks.CbConsumer-">init</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#init-org.apache.felix.dm.lambda.callbacks.CbTypeComponent-">init</a>,
<a href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#
init-java.lang.Object-java.lang.String-">init</a>, <a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#init-java.lang.String-">init</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#initInstance-org.apache.felix.dm.lambda.callbacks.CbComponent-">initInstance</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#initInstance-java.lang.Runnable-">initInstance</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#properties-java.util.Dictionary-">properties</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#properties-org.apache.felix.dm.lambda.FluentProperty...-">properties</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#properties-java.lang.String-java.lang.Object-java.lang.Object...-">properties</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#provides-java.lang.Class-">provides</a>,
<a href="../../../.
./../org/apache/felix/dm/lambda/ComponentBuilder.html#provides-java.lang.Class:A-">provides</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#provides-java.lang.Class:A-java.util.Dictionary-">provides</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#provides-java.lang.Class:A-org.apache.felix.dm.lambda.FluentProperty...-">provides</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#provides-java.lang.Class:A-java.lang.String-java.lang.Object-java.lang.Object...-">provides</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#provides-java.lang.Class-java.util.Dictionary-">provides</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#provides-java.lang.Class-org.apache.felix.dm.lambda.FluentProperty...-">provides</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#provides-java.lang.Class-java.lang.String-java.lang.Object-java.l
ang.Object...-">provides</a>, <a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#provides-java.lang.String-">provides</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#provides-java.lang.String:A-">provides</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#provides-java.lang.String:A-java.util.Dictionary-">provides</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#provides-java.lang.String:A-org.apache.felix.dm.lambda.FluentProperty...-">provides</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#provides-java.lang.String:A-java.lang.String-java.lang.Object-java.lang.Object...-">provides</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#provides-java.lang.String-java.util.Dictionary-">provides</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#provides-java.lang.String-org.apache.felix.dm.lambda.Fl
uentProperty...-">provides</a>, <a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#provides-java.lang.String-java.lang.String-java.lang.Object-java.lang.Object...-">provides</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#start-org.apache.felix.dm.lambda.callbacks.CbConsumer-">start</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#start-org.apache.felix.dm.lambda.callbacks.CbTypeComponent-">start</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#start-java.lang.Object-java.lang.String-">start</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#start-java.lang.String-">start</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#startInstance-org.apache.felix.dm.lambda.callbacks.CbComponent-">startInstance</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#startInstance-java.lang.Runnable-">startInstan
ce</a>, <a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#stop-org.apache.felix.dm.lambda.callbacks.CbConsumer-">stop</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#stop-org.apache.felix.dm.lambda.callbacks.CbTypeComponent-">stop</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#stop-java.lang.Object-java.lang.String-">stop</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#stop-java.lang.String-">stop</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#stopInstance-org.apache.felix.dm.lambda.callbacks.CbComponent-">stopInstance</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#stopInstance-java.lang.Runnable-">stopInstance</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#withBundle-java.util.function.Consumer-">withBundle</a>,
<a href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder
.html#withCnf-java.lang.Class...-">withCnf</a>, <a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#withCnf-java.util.function.Consumer-">withCnf</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#withCnf-java.lang.String...-">withCnf</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#withFuture-java.util.concurrent.CompletableFuture-java.util.function.Consumer-">withFuture</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#withSrv-java.lang.Class...-">withSrv</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#withSrv-java.lang.Class-java.lang.String-">withSrv</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#withSrv-java.lang.Class-java.util.function.Consumer-">withSrv</a></code></li>
+<code><a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#autoAdd-boolean-">autoAdd</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#autoConfig-java.lang.Class-boolean-">autoConfig</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#autoConfig-java.lang.Class-java.lang.String-">autoConfig</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#build--">build</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#composition-java.lang.Object-java.lang.String-">composition</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#composition-java.lang.String-">composition</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#composition-java.util.function.Supplier-">composition</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#debug-java.lang.String-">debug</a>,
<a href="../../../../../org/apach
e/felix/dm/lambda/ComponentBuilder.html#destroy-org.apache.felix.dm.lambda.callbacks.Cb-">destroy</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#destroy-org.apache.felix.dm.lambda.callbacks.CbComponent-">destroy</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#destroy-java.lang.String-">destroy</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#destroyInstance-org.apache.felix.dm.lambda.callbacks.InstanceCb-">destroyInstance</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#destroyInstance-org.apache.felix.dm.lambda.callbacks.InstanceCbComponent-">destroyInstance</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#factory-java.lang.Object-java.lang.String-">factory</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#factory-java.util.function.Supplier-">factory</a>,
<a href="../../../../../org/apache/felix/dm/lambda/Co
mponentBuilder.html#factory-java.util.function.Supplier-java.util.function.Supplier-">factory</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#factory-java.util.function.Supplier-java.util.function.Function-java.util.function.Function-">factory</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#factory-java.util.function.Supplier-java.util.function.Function-">factory</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#impl-java.lang.Object-">impl</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#init-org.apache.felix.dm.lambda.callbacks.Cb-">init</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#init-org.apache.felix.dm.lambda.callbacks.CbComponent-">init</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#init-java.lang.String-">init</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#initInstan
ce-org.apache.felix.dm.lambda.callbacks.InstanceCb-">initInstance</a>, <a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#initInstance-org.apache.felix.dm.lambda.callbacks.InstanceCbComponent-">initInstance</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#lifecycleCallbackInstance-java.lang.Object-">lifecycleCallbackInstance</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#properties-java.util.Dictionary-">properties</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#properties-org.apache.felix.dm.lambda.FluentProperty...-">properties</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#properties-java.lang.String-java.lang.Object-java.lang.Object...-">properties</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#provides-java.lang.Class-">provides</a>,
<a href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#p
rovides-java.lang.Class:A-">provides</a>, <a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#provides-java.lang.Class:A-java.util.Dictionary-">provides</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#provides-java.lang.Class:A-org.apache.felix.dm.lambda.FluentProperty...-">provides</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#provides-java.lang.Class:A-java.lang.String-java.lang.Object-java.lang.Object...-">provides</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#provides-java.lang.Class-java.util.Dictionary-">provides</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#provides-java.lang.Class-org.apache.felix.dm.lambda.FluentProperty...-">provides</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#provides-java.lang.Class-java.lang.String-java.lang.Object-java.lang.Object...-">provides</a>,
<a href="../../../../../o
rg/apache/felix/dm/lambda/ComponentBuilder.html#provides-java.lang.String-">provides</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#provides-java.lang.String:A-">provides</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#provides-java.lang.String:A-java.util.Dictionary-">provides</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#provides-java.lang.String:A-org.apache.felix.dm.lambda.FluentProperty...-">provides</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#provides-java.lang.String:A-java.lang.String-java.lang.Object-java.lang.Object...-">provides</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#provides-java.lang.String-java.util.Dictionary-">provides</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#provides-java.lang.String-org.apache.felix.dm.lambda.FluentProperty...-">provides</a>,
<a href="../../../../..
/org/apache/felix/dm/lambda/ComponentBuilder.html#provides-java.lang.String-java.lang.String-java.lang.Object-java.lang.Object...-">provides</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#start-org.apache.felix.dm.lambda.callbacks.Cb-">start</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#start-org.apache.felix.dm.lambda.callbacks.CbComponent-">start</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#start-java.lang.String-">start</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#startInstance-org.apache.felix.dm.lambda.callbacks.InstanceCb-">startInstance</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#startInstance-org.apache.felix.dm.lambda.callbacks.InstanceCbComponent-">startInstance</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#stop-org.apache.felix.dm.lambda.callbacks.Cb-">stop</a>,
<a href="../../../
../../org/apache/felix/dm/lambda/ComponentBuilder.html#stop-org.apache.felix.dm.lambda.callbacks.CbComponent-">stop</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#stop-java.lang.String-">stop</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#stopInstance-org.apache.felix.dm.lambda.callbacks.InstanceCb-">stopInstance</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#stopInstance-org.apache.felix.dm.lambda.callbacks.InstanceCbComponent-">stopInstance</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#withBundle-java.util.function.Consumer-">withBundle</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#withCnf-java.util.function.Consumer-">withCnf</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#withCnf-java.lang.String...-">withCnf</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#withFutur
e-java.util.concurrent.CompletableFuture-java.util.function.Consumer-">withFuture</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#withSvc-java.lang.Class...-">withSvc</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#withSvc-java.lang.Class-java.lang.String-">withSvc</a>,
<a
href="../../../../../org/apache/felix/dm/lambda/ComponentBuilder.html#withSvc-java.lang.Class-java.util.function.Consumer-">withSvc</a></code></li>
</ul>
</li>
</ul>
@@ -241,83 +306,94 @@ extends <a href="../../../../../org/apac
</dl>
</li>
</ul>
-<a name="factoryPid-java.lang.Class-">
+<a name="propagate--">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
-<h4>factoryPid</h4>
-<pre><a
href="../../../../../org/apache/felix/dm/lambda/FactoryPidAdapterBuilder.html"
title="interface in
org.apache.felix.dm.lambda">FactoryPidAdapterBuilder</a> factoryPid(java.lang.Class<?> pidClass)</pre>
-<div class="block">Specifies a class name which fqdn represents the factory
pid. Usually, this class can optionally be annotated with metatypes bnd
annotations.</div>
+<h4>propagate</h4>
+<pre><a
href="../../../../../org/apache/felix/dm/lambda/FactoryPidAdapterBuilder.html"
title="interface in
org.apache.felix.dm.lambda">FactoryPidAdapterBuilder</a> propagate()</pre>
+<div class="block">Specifies if the public properties (not starting with a
dot) should be propagated to the adapter service properties (false by
default).</div>
<dl>
-<dt><span class="paramLabel">Parameters:</span></dt>
-<dd><code>pidClass</code> - the class that acts as the factory pid</dd>
<dt><span class="returnLabel">Returns:</span></dt>
-<dd>this builder</dd>
+<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/FactoryPidAdapterBuilder.html"
title="interface in
org.apache.felix.dm.lambda">FactoryPidAdapterBuilder</a> propagate()</pre>
-<div class="block">Specifies if the public properties (not starting with a
dot) should be propagated in the adapter service properties (false by
default).</div>
+<pre><a
href="../../../../../org/apache/felix/dm/lambda/FactoryPidAdapterBuilder.html"
title="interface in
org.apache.felix.dm.lambda">FactoryPidAdapterBuilder</a> propagate(boolean propagate)</pre>
+<div class="block">Specifies if the public properties (not starting with a
dot) should be propagated to the adapter service properties (false by
default).</div>
<dl>
+<dt><span class="paramLabel">Parameters:</span></dt>
+<dd><code>propagate</code> - true if the public properties should be
propagated to the adapter 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/FactoryPidAdapterBuilder.html"
title="interface in
org.apache.felix.dm.lambda">FactoryPidAdapterBuilder</a> propagate(boolean propagate)</pre>
-<div class="block">Specifies if the public properties (not starting with a
dot) should be propagated in the adapter service properties (false by
default).</div>
+<h4>update</h4>
+<pre><a
href="../../../../../org/apache/felix/dm/lambda/FactoryPidAdapterBuilder.html"
title="interface in
org.apache.felix.dm.lambda">FactoryPidAdapterBuilder</a> update(java.lang.String updateMethod)</pre>
+<div class="block">Specifies a callback method that will be called on the
component implementation when the configuration is injected.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
-<dd><code>propagate</code> - true if the public properties should be
propagated in the adapter service properties (false by default).</dd>
+<dd><code>updateMethod</code> - the method to call on the component
implementation when the configuration is available ("updated" by default).
+
+ <p>The following method signatures are supported:
+ <ol>
+ <li> method(Dictionary properties)
+ <li> method(Component component, Dictionary properties)
+ </ol></dd>
<dt><span class="returnLabel">Returns:</span></dt>
-<dd>this builder.</dd>
+<dd>this builder</dd>
</dl>
</li>
</ul>
-<a name="cb-java.lang.String-">
+<a name="update-java.lang.Class-java.lang.String-">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
-<h4>cb</h4>
-<pre><a
href="../../../../../org/apache/felix/dm/lambda/FactoryPidAdapterBuilder.html"
title="interface in
org.apache.felix.dm.lambda">FactoryPidAdapterBuilder</a> cb(java.lang.String updateMethod)</pre>
-<div class="block">Specifies a callback method that will be called on the
component instances when the configuration is injected</div>
+<h4>update</h4>
+<pre><a
href="../../../../../org/apache/felix/dm/lambda/FactoryPidAdapterBuilder.html"
title="interface in
org.apache.felix.dm.lambda">FactoryPidAdapterBuilder</a> update(java.lang.Class<?> configType,
+ java.lang.String updateMethod)</pre>
+<div class="block">Sets a callback method to call on the component
implementation when the configuration is updated.
+ The callback is invoked with a configuration type argument.
+
+ <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>updateMethod</code> - the method to call on the component instances
when the configuration is available ("updated" by default).
- The following method signatures are supported:
-
- <pre> <code>
- method(Dictionary properties)
- method(Component component, Dictionary properties)
- </code></pre></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 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.Object-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/FactoryPidAdapterBuilder.html"
title="interface in
org.apache.felix.dm.lambda">FactoryPidAdapterBuilder</a> cb(java.lang.Object callbackInstance,
- java.lang.String updateMethod)</pre>
-<div class="block">Specifies a callback instance method that will be called on
a given object instance when the configuration is injected</div>
+<h4>update</h4>
+<pre><a
href="../../../../../org/apache/felix/dm/lambda/FactoryPidAdapterBuilder.html"
title="interface in
org.apache.felix.dm.lambda">FactoryPidAdapterBuilder</a> update(java.lang.Object callbackInstance,
+ java.lang.String updateMethod)</pre>
+<div class="block">Specifies a callback instance method that will be called on
a given object instance when the configuration is injected.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>updateMethod</code> - the method to call on the given object
instance when the configuration is available ("updated" by default).
@@ -333,17 +409,48 @@ extends <a href="../../../../../org/apac
</dl>
</li>
</ul>
-<a name="cb-org.apache.felix.dm.lambda.callbacks.CbTypeDictionary-">
+<a name="update-java.lang.Class-java.lang.Object-java.lang.String-">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
-<h4>cb</h4>
-<pre><U> <a
href="../../../../../org/apache/felix/dm/lambda/FactoryPidAdapterBuilder.html"
title="interface in
org.apache.felix.dm.lambda">FactoryPidAdapterBuilder</a> cb(<a
href="../../../../../org/apache/felix/dm/lambda/callbacks/CbTypeDictionary.html"
title="interface in
org.apache.felix.dm.lambda.callbacks">CbTypeDictionary</a><U> callback)</pre>
-<div class="block">Specifies a callback method reference that will be called
on one of the component classes when the configuration is injected.</div>
+<h4>update</h4>
+<pre><a
href="../../../../../org/apache/felix/dm/lambda/FactoryPidAdapterBuilder.html"
title="interface in
org.apache.felix.dm.lambda">FactoryPidAdapterBuilder</a> update(java.lang.Class<?> configType,
+ java.lang.Object callbackInstance,
+ java.lang.String updateMethod)</pre>
+<div class="block">Specifies a callback instance method that will be called on
a given object instance when the configuration is injected.
+ The callback is invoked with a configuration type argument.
+
+ <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 updated
callback will be invoked.</dd>
+<dd><code>updateMethod</code> - the method to call on the given object
instance when the configuration is available. The callback is invoked
+ with a configuration type argument (matching the configType you have
specified.</dd>
+<dt><span class="returnLabel">Returns:</span></dt>
+<dd>this builder</dd>
+</dl>
+</li>
+</ul>
+<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/FactoryPidAdapterBuilder.html"
title="interface in
org.apache.felix.dm.lambda">FactoryPidAdapterBuilder</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">Specifies a method reference that will be called on one of
the component classes when the configuration is injected.
+ The callback is invoked with a Dictionary argument.</div>
<dl>
<dt><span class="paramLabel">Type Parameters:</span></dt>
-<dd><code>U</code> - the type of the component implementation class on which
the callback is invoked on.</dd>
+<dd><code>T</code> - the type of the component implementation class on which
the callback is invoked on.</dd>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>callback</code> - the method to call on one of the component classes
when the configuration is available.</dd>
<dt><span class="returnLabel">Returns:</span></dt>
@@ -351,32 +458,76 @@ extends <a href="../../../../../org/apac
</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.CbConfiguration-">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
-<h4>cb</h4>
-<pre><U> <a
href="../../../../../org/apache/felix/dm/lambda/FactoryPidAdapterBuilder.html"
title="interface in
org.apache.felix.dm.lambda">FactoryPidAdapterBuilder</a> cb(<a
href="../../../../../org/apache/felix/dm/lambda/callbacks/CbTypeComponentDictionary.html"
title="interface in
org.apache.felix.dm.lambda.callbacks">CbTypeComponentDictionary</a><U> callback)</pre>
-<div class="block">Specifies a callback method reference that will be called
on one of the component classes when the configuration is injected</div>
+<h4>update</h4>
+<pre><T,U> <a
href="../../../../../org/apache/felix/dm/lambda/FactoryPidAdapterBuilder.html"
title="interface in
org.apache.felix.dm.lambda">FactoryPidAdapterBuilder</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">Specifies a method reference that will be called on one of
the component classes when the configuration is injected.
+ The callback is invoked with a configuration type argument.</div>
<dl>
<dt><span class="paramLabel">Type Parameters:</span></dt>
-<dd><code>U</code> - the type of the component implementation class on which
the callback is invoked on.</dd>
+<dd><code>T</code> - the type of the component implementation class on which
the callback is invoked on.</dd>
+<dd><code>U</code> - the configuration type accepted by the callback
method.</dd>
<dt><span class="paramLabel">Parameters:</span></dt>
-<dd><code>callback</code> - the reference to a method on one of the component
classes. The method may takes as parameter a Component and a Dictionary.</dd>
+<dd><code>configType</code> - the type of a configuration that is passed as
argument to the callback</dd>
+<dd><code>callback</code> - the method to call on one of the component classes
when the configuration is available.</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.CbDictionaryComponent-">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
-<h4>cbi</h4>
-<pre><a
href="../../../../../org/apache/felix/dm/lambda/FactoryPidAdapterBuilder.html"
title="interface in
org.apache.felix.dm.lambda">FactoryPidAdapterBuilder</a> cbi(<a
href="../../../../../org/apache/felix/dm/lambda/callbacks/CbDictionary.html"
title="interface in
org.apache.felix.dm.lambda.callbacks">CbDictionary</a> callback)</pre>
-<div class="block">Specifies a callback instance method reference that will be
called on a given object instance when the configuration is injected</div>
+<h4>update</h4>
+<pre><T> <a
href="../../../../../org/apache/felix/dm/lambda/FactoryPidAdapterBuilder.html"
title="interface in
org.apache.felix.dm.lambda">FactoryPidAdapterBuilder</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">Specifies a method reference that will be called on one of
the component classes when the configuration is injected</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>
+<dt><span class="paramLabel">Parameters:</span></dt>
+<dd><code>callback</code> - the reference to a method on one of the component
classes. The method may takes as arguments a Dictionary and a Component.</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.CbConfigurationComponent-">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>update</h4>
+<pre><T,U> <a
href="../../../../../org/apache/felix/dm/lambda/FactoryPidAdapterBuilder.html"
title="interface in
org.apache.felix.dm.lambda">FactoryPidAdapterBuilder</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">Specifies a method reference that will be called on one of
the component classes when the configuration is injected.
+ The callback is invoked with the following arguments: a configuration type,
and a Component object.</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>U</code> - the configuration type 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 on one of the component
classes. The method may takes as arguments a configuration type and a
Component.</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/FactoryPidAdapterBuilder.html"
title="interface in
org.apache.felix.dm.lambda">FactoryPidAdapterBuilder</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">Specifies a method reference that will be called on a given
object instance when the configuration is injected</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>callback</code> - the method to call on a given object instance when
the configuration is available. The callback takes as argument a
@@ -386,18 +537,61 @@ extends <a href="../../../../../org/apac
</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="blockListLast">
+<ul class="blockList">
+<li class="blockList">
+<h4>update</h4>
+<pre><T> <a
href="../../../../../org/apache/felix/dm/lambda/FactoryPidAdapterBuilder.html"
title="interface in
org.apache.felix.dm.lambda">FactoryPidAdapterBuilder</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> callback)</pre>
+<div class="block">Specifies a method reference that will be called on a given
object instance when the configuration is injected.
+ The callback is invoked with a type-safe configuration type argument.</div>
+<dl>
+<dt><span class="paramLabel">Type Parameters:</span></dt>
+<dd><code>T</code> - the configuration type 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 method to call on a given object instance when
the configuration is available. The callback takes as argument a
+ a configuration type parameter.</dd>
+<dt><span class="returnLabel">Returns:</span></dt>
+<dd>this builder</dd>
+</dl>
+</li>
+</ul>
+<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/FactoryPidAdapterBuilder.html"
title="interface in
org.apache.felix.dm.lambda">FactoryPidAdapterBuilder</a> cbi(<a
href="../../../../../org/apache/felix/dm/lambda/callbacks/CbComponentDictionary.html"
title="interface in
org.apache.felix.dm.lambda.callbacks">CbComponentDictionary</a> callback)</pre>
-<div class="block">Specifies a callback instance method reference that will be
called on a given object instance when the configuration is injected.</div>
+<h4>update</h4>
+<pre><a
href="../../../../../org/apache/felix/dm/lambda/FactoryPidAdapterBuilder.html"
title="interface in
org.apache.felix.dm.lambda">FactoryPidAdapterBuilder</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">Specifies a method reference that will be called on a given
object instance when the configuration is injected.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>callback</code> - the method to call on a given object instance when
the configuration is available. The callback takes as argument a
- Dictionary parameter.</dd>
+ Dictionary, and a Component parameter.</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>update</h4>
+<pre><T> <a
href="../../../../../org/apache/felix/dm/lambda/FactoryPidAdapterBuilder.html"
title="interface in
org.apache.felix.dm.lambda">FactoryPidAdapterBuilder</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> callback)</pre>
+<div class="block">Specifies a method reference that will be called on a given
object instance when the configuration is injected.</div>
+<dl>
+<dt><span class="paramLabel">Type Parameters:</span></dt>
+<dd><code>T</code> - the configuration type 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 method to call on a given object instance when
the configuration is available. The callback takes as arguments a
+ configuration type, and a Component parameter.</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/FluentProperty.html
==============================================================================
---
websites/staging/felix/trunk/content/apidocs/dependencymanager.lambda/r7/org/apache/felix/dm/lambda/FluentProperty.html
(original)
+++
websites/staging/felix/trunk/content/apidocs/dependencymanager.lambda/r7/org/apache/felix/dm/lambda/FluentProperty.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:10 CET 2016 -->
+<!-- Generated by javadoc (1.8.0_74) on Wed Feb 24 01:07:32 CET 2016 -->
<title>FluentProperty</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>
@@ -113,11 +113,11 @@ public interface <span class="typeNameLa
extends <a
href="../../../../../org/apache/felix/dm/lambda/callbacks/SerializableLambda.html"
title="interface in
org.apache.felix.dm.lambda.callbacks">SerializableLambda</a></pre>
<div class="block">Lambda allowing to define fluent service properties.
Property names are deduces from the lambda parameter name.
- <p> Example of a component which provides fluent properties ("foo=bar";
"foo2=Integer(123)):
+ <p> Example of a component which provides fluent properties {"foo"="bar";
"foo2"=Integer(123)}:
<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(MyComponentImpl.class).provides(MyService.class, foo->"bar", foo2
-> 123));
}
}
