Author: buildbot
Date: Tue Oct 9 14:22:25 2018
New Revision: 1036199
Log:
Staging update by buildbot for felix
Modified:
websites/staging/felix/trunk/content/ (props changed)
websites/staging/felix/trunk/content/documentation/subprojects/apache-felix-dependency-manager/reference/dm-annotations.html
Propchange: websites/staging/felix/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Tue Oct 9 14:22:25 2018
@@ -1 +1 @@
-1843282
+1843289
Modified:
websites/staging/felix/trunk/content/documentation/subprojects/apache-felix-dependency-manager/reference/dm-annotations.html
==============================================================================
---
websites/staging/felix/trunk/content/documentation/subprojects/apache-felix-dependency-manager/reference/dm-annotations.html
(original)
+++
websites/staging/felix/trunk/content/documentation/subprojects/apache-felix-dependency-manager/reference/dm-annotations.html
Tue Oct 9 14:22:25 2018
@@ -96,7 +96,7 @@ h2:hover > .headerlink, h3:hover > .head
<li><a href="#component">Component</a></li>
<li><a href="#aspect-component">Aspect component</a></li>
<li><a href="#adapter-component">Adapter component</a></li>
-<li><a href="#bundle-adapter-service">Bundle adapter service</a></li>
+<li><a href="#bundle-adapter-component">Bundle adapter component</a></li>
</ul>
</li>
<li><a href="#component-lifecycle">Component lifecycle</a><ul>
@@ -429,7 +429,7 @@ found from the registry. </p>
<p>The AdapterImpl class adapts the AdapteeService to the AdapterService.
The AdapterService will also have the following service property: p1=v1, p2=v2
:</p>
-<h2 id="bundle-adapter-service">Bundle adapter service<a class="headerlink"
href="#bundle-adapter-service" title="Permanent link">¶</a></h2>
+<h2 id="bundle-adapter-component">Bundle adapter component<a
class="headerlink" href="#bundle-adapter-component" title="Permanent
link">¶</a></h2>
<p>Bundle adapters are similar to Adapter Components, but instead of adapting
a service, they adapt a bundle
with a certain set of states (STARTED|INSTALLED|...), and provide a service on
top of it.</p>
<p>You can define a bundle adapter service using the @BundleAdapterService
annotation (see
@@ -473,7 +473,7 @@ includes the invocation of the following
<p><a
href="http://felix.apache.org/apidocs/dependencymanager.annotations/r12/org/apache/felix/dm/annotation/api/Init.html";>@Init</a>:
this callback is invoked after all required dependencies have been injected.
In this method, you can
yet add more dynamic dependencies using the DM API, or you can possibly
configure other dependencies filter and required flags
-(see ## Dynamic Dependency Configuration).</p>
+(see <a href="## Dynamic dependency configuration">Dynamic dependency
configuration</a>).</p>
</li>
<li>
<p><a
href="http://felix.apache.org/apidocs/dependencymanager.annotations/r12/org/apache/felix/dm/annotation/api/Start.html";>@Start</a>:
@@ -620,7 +620,7 @@ full control of when your component is <
<span class="cm"> * This is the DHTService, which registers a DHTElement
asynchronously.</span>
<span class="cm"> */</span>
<span class="kd">public</span> <span class="kd">interface</span> <span
class="nc">DHTService</span> <span class="o">{</span>
- <span class="kt">void</span> <span class="nf">insert</span><span
class="o">();</span> <span class="c1">// will callback element.inserted()
later, once registered into the DHT.</span>
+ <span class="kt">void</span> <span class="nf">insert</span><span
class="o">(</span><span class="n">DHTElement</span> <span
class="n">element</span><span class="o">);</span> <span class="c1">// will
callback element.inserted() later, once registered into the DHT.</span>
<span class="o">}</span>
</pre></div>
@@ -632,7 +632,7 @@ full control of when your component is <
<span class="n">DHTService</span> <span class="n">m_dht</span><span
class="o">;</span>
<span class="nd">@LifecycleController</span>
- <span class="n">Runnable</span> <span class="n">m_registered</span><span
class="o">;</span> <span class="c1">// will fire component startup, once
invoked.</span>
+ <span class="n">Runnable</span> <span class="n">m_start</span><span
class="o">;</span> <span class="c1">// will fire component startup, once
invoked.</span>
<span class="nd">@Init</span>
<span class="kt">void</span> <span class="nf">init</span><span
class="o">()</span> <span class="o">{</span>
@@ -643,7 +643,7 @@ full control of when your component is <
<span class="c1">// We are inserted into the DHT: we can now trigger
our component startup.</span>
<span class="c1">// We just invoke the runnable injected by our
@LifecycleController annotation, which will trigger our</span>
<span class="c1">// service publication (we'll be called in our
@Start method before)</span>
- <span class="n">m_registered</span><span class="o">.</span><span
class="na">run</span><span class="o">();</span>
+ <span class="n">m_start</span><span class="o">.</span><span
class="na">run</span><span class="o">();</span>
<span class="o">}</span>
<span class="nd">@Start</span>
@@ -662,11 +662,11 @@ full control of when your component is <
<span class="n">DHTService</span> <span class="n">m_dht</span><span
class="o">;</span>
<span class="nd">@LifecycleController</span>
- <span class="n">Runnable</span> <span class="n">m_registered</span><span
class="o">;</span> <span class="c1">// will fire component startup, once
invoked.</span>
+ <span class="n">Runnable</span> <span class="n">m_start</span><span
class="o">;</span> <span class="c1">// will fire component startup, once
invoked.</span>
<span class="nd">@Init</span>
<span class="kt">void</span> <span class="nf">init</span><span
class="o">()</span> <span class="o">{</span>
- <span class="n">m_dht</span><span class="o">.</span><span
class="na">insert</span><span class="o">(</span><span
class="nl">m_registered:</span><span class="o">:</span><span
class="n">run</span><span class="o">);</span> <span class="c1">// asynchronous,
will callback m_registered.run() once registered into the DHT</span>
+ <span class="n">m_dht</span><span class="o">.</span><span
class="na">insert</span><span class="o">(</span><span
class="nl">m_start:</span><span class="o">:</span><span
class="n">run</span><span class="o">);</span> <span class="c1">// asynchronous,
will callback m_registered.run() once registered into the DHT</span>
<span class="o">}</span>
<span class="nd">@Start</span>
@@ -885,7 +885,7 @@ In this case, you need to use the <code>
<h3 id="service-dependency-properties-propagation">Service dependency
properties propagation<a class="headerlink"
href="#service-dependency-properties-propagation" title="Permanent
link">¶</a></h3>
<p>It is possible to propagate the dependency service properties, using the
ServiceDependency.propagate attribute.
-When the service dependency properties are propagate, they will be appended to
the component service properties,
+When the service dependency properties are propagated, they will be appended
to the component service properties,
but won't override them (the component service properties takes precedence
over the propagated service dependencies).</p>
<p>Example:</p>
<div class="codehilite"><pre><span class="nd">@Component</span>
@@ -1176,7 +1176,7 @@ the Map, using the "<em>filter</em>" and
<p>So, after the init method returns, the map will be used to configure the
dependency named "foo", which will then be evaluated.
-And once the dependency is available, then your @Start callback will be
invoked.</p>
+And once the dependency is available, then it will be injected and your
@Start callback will be invoked.</p>
<p>Usage example of a dynamic dependency:</p>
<p>In this sample, the "PersistenceImpl" component dynamically configures the
"storage"
dependency from the "init" method. The dependency "required" flag and filter
string are derived
@@ -1265,7 +1265,9 @@ but this time, the dependency on the Sto
<p>Same example as above, but this time the dependency is added from the init
method using the
Dependency Manager Lambda API:</p>
-<div class="codehilite"><pre><span class="nd">@Component</span>
+<div class="codehilite"><pre><span class="kn">import</span> <span
class="nn">static</span> <span class="n">org</span><span
class="o">.</span><span class="na">apache</span><span class="o">.</span><span
class="na">felix</span><span class="o">.</span><span class="na">dm</span><span
class="o">.</span><span class="na">lambda</span><span class="o">.</span><span
class="na">DependencyManagerActivator</span><span class="o">.</span><span
class="na">component</span><span class="o">;</span>
+
+<span class="nd">@Component</span>
<span class="kd">public</span> <span class="kd">class</span> <span
class="nc">PersistenceImpl</span> <span class="kd">implements</span> <span
class="n">Persistence</span> <span class="o">{</span>
<span class="c1">// Injected before init.</span>
<span class="nd">@ConfigurationDependency</span>
@@ -1651,7 +1653,7 @@ in the following, the service properties
<span class="o">}</span>
</pre></div>
<div class="timestamp" style="margin-top: 30px; font-size: 80%;
text-align: right;">
- Rev. 1843274 by pderop on Tue, 9 Oct 2018 13:36:23 +0000
+ Rev. 1843289 by pderop on Tue, 9 Oct 2018 14:22:04 +0000
</div>
<div class="trademarkFooter">
Apache Felix, Felix, Apache, the Apache feather logo, and the Apache
Felix project
