You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@felix.apache.org by bu...@apache.org on 2015/03/04 11:57:55 UTC
svn commit: r942250 - in /websites/staging/felix/trunk/content: ./
documentation/subprojects/apache-felix-dependency-manager-4/tutorials/leveraging-the-shell.html
Author: buildbot
Date: Wed Mar 4 10:57:55 2015
New Revision: 942250
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-4/tutorials/leveraging-the-shell.html
Propchange: websites/staging/felix/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Wed Mar 4 10:57:55 2015
@@ -1 +1 @@
-1663931
+1663932
Modified: websites/staging/felix/trunk/content/documentation/subprojects/apache-felix-dependency-manager-4/tutorials/leveraging-the-shell.html
==============================================================================
--- websites/staging/felix/trunk/content/documentation/subprojects/apache-felix-dependency-manager-4/tutorials/leveraging-the-shell.html (original)
+++ websites/staging/felix/trunk/content/documentation/subprojects/apache-felix-dependency-manager-4/tutorials/leveraging-the-shell.html Wed Mar 4 10:57:55 2015
@@ -95,31 +95,42 @@
<p><strong>List all dependency manager components</strong></p>
<p><code>dm</code></p>
<p>Sample output</p>
-<p><code>[9] dm.demo
- [6] dm.demo.Probe(type=radiation) unregistered
- dm.demo.Sensor service required unavailable
- [7] dm.demo.Probe(type=humidity) registered
- [9] dm.demo.impl.Dashboard unregistered
- dm.demo.Probe (type=temperature) service required available
- dm.demo.Probe (type=radiation) service required unavailable
- dm.demo.Probe (type=humidity) service required available
- dm.demo.Probe (type=pressure) service required available
- [5] dm.demo.Probe(type=temperature) registered
- [8] dm.demo.Probe(type=pressure) registered</code>
-All components are listed including the dependencies and the availability of these dependencies. The top level element is the bundle and below are the components registered with that bundle's bundle context. The lowest level is that of the component's dependencies. </p>
-<p><code>[bundleid] bundle
- [component id] component interfaces (service properties)
- dependency <availability></code></p>
-<p>The following flags can be used to tailor the output.</p>
-<p><code>compact, cp</code> shortens package names and dependencies and therefore gives a more compressed output.</p>
-<p><code>nodeps, nd</code> omits the dependencies from the output.</p>
-<p><code>notavail, na</code> filters out all components that are registered wich results in the output only containing those components that are in the unregistered state due to one or more unsatisfied required dependencies. This is the command option most used when using the dependency manager shell commands.</p>
+<div class="codehilite"><pre><span class="p">[</span>9<span class="p">]</span> <span class="n">dm</span><span class="p">.</span><span class="n">demo</span>
+ <span class="p">[</span>6<span class="p">]</span> <span class="n">dm</span><span class="p">.</span><span class="n">demo</span><span class="p">.</span><span class="n">Probe</span><span class="p">(</span><span class="n">type</span><span class="p">=</span><span class="n">radiation</span><span class="p">)</span> <span class="n">unregistered</span>
+ <span class="n">dm</span><span class="p">.</span><span class="n">demo</span><span class="p">.</span><span class="n">Sensor</span> <span class="n">service</span> <span class="n">required</span> <span class="n">unavailable</span>
+ <span class="p">[</span>7<span class="p">]</span> <span class="n">dm</span><span class="p">.</span><span class="n">demo</span><span class="p">.</span><span class="n">Probe</span><span class="p">(</span><span class="n">type</span><span class="p">=</span><span class="n">humidity</span><span class="p">)</span> <span class="n">registered</span>
+ <span class="p">[</span>9<span class="p">]</span> <span class="n">dm</span><span class="p">.</span><span class="n">demo</span><span class="p">.</span><span class="n">impl</span><span class="p">.</span><span class="n">Dashboard</span> <span class="n">unregistered</span>
+ <span class="n">dm</span><span class="p">.</span><span class="n">demo</span><span class="p">.</span><span class="n">Probe</span> <span class="p">(</span><span class="n">type</span><span class="p">=</span><span class="n">temperature</span><span class="p">)</span> <span class="n">service</span> <span class="n">required</span> <span class="n">available</span>
+ <span class="n">dm</span><span class="p">.</span><span class="n">demo</span><span class="p">.</span><span class="n">Probe</span> <span class="p">(</span><span class="n">type</span><span class="p">=</span><span class="n">radiation</span><span class="p">)</span> <span class="n">service</span> <span class="n">required</span> <span class="n">unavailable</span>
+ <span class="n">dm</span><span class="p">.</span><span class="n">demo</span><span class="p">.</span><span class="n">Probe</span> <span class="p">(</span><span class="n">type</span><span class="p">=</span><span class="n">humidity</span><span class="p">)</span> <span class="n">service</span> <span class="n">required</span> <span class="n">available</span>
+ <span class="n">dm</span><span class="p">.</span><span class="n">demo</span><span class="p">.</span><span class="n">Probe</span> <span class="p">(</span><span class="n">type</span><span class="p">=</span><span class="n">pressure</span><span class="p">)</span> <span class="n">service</span> <span class="n">required</span> <span class="n">available</span>
+ <span class="p">[</span>5<span class="p">]</span> <span class="n">dm</span><span class="p">.</span><span class="n">demo</span><span class="p">.</span><span class="n">Probe</span><span class="p">(</span><span class="n">type</span><span class="p">=</span><span class="n">temperature</span><span class="p">)</span> <span class="n">registered</span>
+ <span class="p">[</span>8<span class="p">]</span> <span class="n">dm</span><span class="p">.</span><span class="n">demo</span><span class="p">.</span><span class="n">Probe</span><span class="p">(</span><span class="n">type</span><span class="p">=</span><span class="n">pressure</span><span class="p">)</span> <span class="n">registered</span>
+</pre></div>
+
+
+<p>All components are listed including the dependencies and the availability of these dependencies. The top level element is the bundle and below are the components registered with that bundle's bundle context. The lowest level is that of the component's dependencies. </p>
+<div class="codehilite"><pre><span class="p">[</span><span class="n">bundleid</span><span class="p">]</span> <span class="n">bundle</span>
+ <span class="p">[</span><span class="n">component</span> <span class="n">id</span><span class="p">]</span> <span class="n">component</span> <span class="n">interfaces</span> <span class="p">(</span><span class="n">service</span> <span class="k">properties</span><span class="p">)</span>
+ <span class="n">dependency</span> <span class="o"><</span><span class="n">availability</span><span class="o">></span>
+</pre></div>
+
+
+<p>The following flags can be used to tailor the output:</p>
+<ul>
+<li><code>compact, cp</code> shortens package names and dependencies and therefore gives a more compressed output.</li>
+<li><code>nodeps, nd</code> omits the dependencies from the output.</li>
+<li><code>notavail, na</code> filters out all components that are registered wich results in the output only containing those components that are in the unregistered state due to one or more unsatisfied required dependencies. This is the command option most used when using the dependency manager shell commands.</li>
+</ul>
<p>Sample output for <code>dm na</code>:</p>
-<p><code>[9] dm.demo
- [14] dm.demo.impl.Dashboard unregistered
- dm.demo.Probe (type=radiation) service required unavailable
- [11] dm.demo.Probe(type=radiation) unregistered
- dm.demo.Sensor service required unavailable</code></p>
+<div class="codehilite"><pre><span class="p">[</span>9<span class="p">]</span> <span class="n">dm</span><span class="p">.</span><span class="n">demo</span>
+ <span class="p">[</span>14<span class="p">]</span> <span class="n">dm</span><span class="p">.</span><span class="n">demo</span><span class="p">.</span><span class="n">impl</span><span class="p">.</span><span class="n">Dashboard</span> <span class="n">unregistered</span>
+ <span class="n">dm</span><span class="p">.</span><span class="n">demo</span><span class="p">.</span><span class="n">Probe</span> <span class="p">(</span><span class="n">type</span><span class="p">=</span><span class="n">radiation</span><span class="p">)</span> <span class="n">service</span> <span class="n">required</span> <span class="n">unavailable</span>
+ <span class="p">[</span>11<span class="p">]</span> <span class="n">dm</span><span class="p">.</span><span class="n">demo</span><span class="p">.</span><span class="n">Probe</span><span class="p">(</span><span class="n">type</span><span class="p">=</span><span class="n">radiation</span><span class="p">)</span> <span class="n">unregistered</span>
+ <span class="n">dm</span><span class="p">.</span><span class="n">demo</span><span class="p">.</span><span class="n">Sensor</span> <span class="n">service</span> <span class="n">required</span> <span class="n">unavailable</span>
+</pre></div>
+
+
<p>The flags can be used in conjunction with the other command options.</p>
<p><strong>Find all components for a given classname</strong></p>
<p><code>dm c .*ProbeImpl</code></p>
@@ -130,15 +141,16 @@ All components are listed including the
<p><strong>Find out why components are not registered</strong></p>
<p><code>dm wtf</code></p>
<p>Sample output</p>
-<p>```
-2 missing dependencies found.</p>
-<hr />
-<p>The following service(s) are missing:
+<div class="codehilite"><pre><span class="gh">2 missing dependencies found.</span>
+<span class="gh">-----------------------------</span>
+The following service(s) are missing:
* dm.demo.Sensor is not found in the service registry
-```</p>
+</pre></div>
+
+
<p>wtf gives the root cause for components not being registered and therefore their services not being available. In a typical application components have dependencies on services implemented by components that have dependencies on services etcetera. This transitivity means that an entire chain of components could be unregistered due to a (few) root dependencies not being satisified. wtf is about discovering those dependencies.</p>
<div class="timestamp" style="margin-top: 30px; font-size: 80%; text-align: right;">
- Rev. 1663931 by marrs on Wed, 4 Mar 2015 10:55:52 +0000
+ Rev. 1663932 by marrs on Wed, 4 Mar 2015 10:57:41 +0000
</div>
<div class="trademarkFooter">
Apache Felix, Felix, Apache, the Apache feather logo, and the Apache Felix project