Modified: felix/site/trunk/content/apidocs/dependencymanager.lambda/r7/org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html URL: http://svn.apache.org/viewvc/felix/site/trunk/content/apidocs/dependencymanager.lambda/r7/org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html?rev=1731995&r1=1731994&r2=1731995&view=diff ============================================================================== --- felix/site/trunk/content/apidocs/dependencymanager.lambda/r7/org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html (original) +++ felix/site/trunk/content/apidocs/dependencymanager.lambda/r7/org/apache/felix/dm/lambda/ConfigurationDependencyBuilder.html Wed Feb 24 00:11:41 2016 @@ -2,9 +2,9 @@ <!-- NewPage --> <html lang="en"> <head> -<!-- Generated by javadoc (1.8.0_72) on Thu Feb 04 08:50:09 CET 2016 --> +<!-- Generated by javadoc (1.8.0_74) on Wed Feb 24 01:07:32 CET 2016 --> <title>ConfigurationDependencyBuilder</title> -<meta name="date" content="2016-02-04"> +<meta name="date" content="2016-02-24"> <link rel="stylesheet" type="text/css" href="../../../../../stylesheet.css" title="Style"> <script type="text/javascript" src="../../../../../script.js"></script> </head> @@ -18,7 +18,7 @@ catch(err) { } //--> -var methods = {"i0":6,"i1":6,"i2":6,"i3":6,"i4":6,"i5":6,"i6":6,"i7":6,"i8":6,"i9":6,"i10":6}; +var methods = {"i0":6,"i1":6,"i2":6,"i3":6,"i4":6,"i5":6,"i6":6,"i7":6,"i8":6,"i9":6,"i10":6,"i11":6,"i12":6,"i13":6,"i14":6}; var tabs = {65535:["t0","All Methods"],2:["t2","Instance Methods"],4:["t3","Abstract Methods"]}; var altColor = "altColor"; var rowColor = "rowColor"; @@ -107,17 +107,113 @@ var activeTableTab = "activeTableTab"; <pre>public interface <span class="typeNameLabel">ConfigurationDependencyBuilder</span> extends <a href="../../../../../org/apache/felix/dm/lambda/DependencyBuilder.html" title="interface in org.apache.felix.dm.lambda">DependencyBuilder</a><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: felix/site/trunk/content/apidocs/dependencymanager.lambda/r7/org/apache/felix/dm/lambda/DependencyBuilder.html URL: http://svn.apache.org/viewvc/felix/site/trunk/content/apidocs/dependencymanager.lambda/r7/org/apache/felix/dm/lambda/DependencyBuilder.html?rev=1731995&r1=1731994&r2=1731995&view=diff ============================================================================== --- felix/site/trunk/content/apidocs/dependencymanager.lambda/r7/org/apache/felix/dm/lambda/DependencyBuilder.html (original) +++ felix/site/trunk/content/apidocs/dependencymanager.lambda/r7/org/apache/felix/dm/lambda/DependencyBuilder.html Wed Feb 24 00:11:41 2016 @@ -2,9 +2,9 @@ <!-- NewPage --> <html lang="en"> <head> -<!-- Generated by javadoc (1.8.0_72) on Thu Feb 04 08:50:09 CET 2016 --> +<!-- Generated by javadoc (1.8.0_74) on Wed Feb 24 01:07:32 CET 2016 --> <title>DependencyBuilder</title> -<meta name="date" content="2016-02-04"> +<meta name="date" content="2016-02-24"> <link rel="stylesheet" type="text/css" href="../../../../../stylesheet.css" title="Style"> <script type="text/javascript" src="../../../../../script.js"></script> </head> Modified: felix/site/trunk/content/apidocs/dependencymanager.lambda/r7/org/apache/felix/dm/lambda/DependencyManagerActivator.html URL: http://svn.apache.org/viewvc/felix/site/trunk/content/apidocs/dependencymanager.lambda/r7/org/apache/felix/dm/lambda/DependencyManagerActivator.html?rev=1731995&r1=1731994&r2=1731995&view=diff ============================================================================== --- felix/site/trunk/content/apidocs/dependencymanager.lambda/r7/org/apache/felix/dm/lambda/DependencyManagerActivator.html (original) +++ felix/site/trunk/content/apidocs/dependencymanager.lambda/r7/org/apache/felix/dm/lambda/DependencyManagerActivator.html Wed Feb 24 00:11:41 2016 @@ -2,9 +2,9 @@ <!-- NewPage --> <html lang="en"> <head> -<!-- Generated by javadoc (1.8.0_72) on Thu Feb 04 08:50:09 CET 2016 --> +<!-- Generated by javadoc (1.8.0_74) on Wed Feb 24 01:07:32 CET 2016 --> <title>DependencyManagerActivator</title> -<meta name="date" content="2016-02-04"> +<meta name="date" content="2016-02-24"> <link rel="stylesheet" type="text/css" href="../../../../../stylesheet.css" title="Style"> <script type="text/javascript" src="../../../../../script.js"></script> </head> @@ -18,7 +18,7 @@ catch(err) { } //--> -var methods = {"i0":6,"i1":10,"i2":10,"i3":9,"i4":9,"i5":10,"i6":10,"i7":9,"i8":9,"i9":10,"i10":9,"i11":9,"i12":9,"i13":10,"i14":9,"i15":10,"i16":9,"i17":9,"i18":9,"i19":10,"i20":10,"i21":9,"i22":9,"i23":9,"i24":10,"i25":10,"i26":9,"i27":10,"i28":10}; +var methods = {"i0":10,"i1":10,"i2":9,"i3":9,"i4":10,"i5":10,"i6":9,"i7":9,"i8":10,"i9":9,"i10":9,"i11":9,"i12":10,"i13":9,"i14":10,"i15":9,"i16":9,"i17":9,"i18":10,"i19":10,"i20":9,"i21":9,"i22":9,"i23":10,"i24":10,"i25":6,"i26":9,"i27":10,"i28":10}; var tabs = {65535:["t0","All Methods"],1:["t1","Static Methods"],2:["t2","Instance Methods"],4:["t3","Abstract Methods"],8:["t4","Concrete Methods"]}; var altColor = "altColor"; var rowColor = "rowColor"; @@ -124,11 +124,11 @@ implements org.osgi.framework.BundleActi import org.apache.felix.dm.lambda.DependencyManagerActivator; public class Activator extends DependencyManagerActivator { - public void activate() throws Exception { + public void init(BundleContext ctx, DependencyManager dm) throws Exception { component(comp -> 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>
