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 2018/10/02 13:28:48 UTC
svn commit: r1036031 - in /websites/staging/felix/trunk/content: ./
documentation/subprojects/apache-felix-gogo/rfc-147-overview.html
Author: buildbot
Date: Tue Oct 2 13:28:48 2018
New Revision: 1036031
Log:
Staging update by buildbot for felix
Modified:
websites/staging/felix/trunk/content/ (props changed)
websites/staging/felix/trunk/content/documentation/subprojects/apache-felix-gogo/rfc-147-overview.html
Propchange: websites/staging/felix/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Tue Oct 2 13:28:48 2018
@@ -1 +1 @@
-1842574
+1842619
Modified: websites/staging/felix/trunk/content/documentation/subprojects/apache-felix-gogo/rfc-147-overview.html
==============================================================================
--- websites/staging/felix/trunk/content/documentation/subprojects/apache-felix-gogo/rfc-147-overview.html (original)
+++ websites/staging/felix/trunk/content/documentation/subprojects/apache-felix-gogo/rfc-147-overview.html Tue Oct 2 13:28:48 2018
@@ -94,11 +94,11 @@ h2:hover > .headerlink, h3:hover > .head
<ul>
<li><a href="#standard-way-to-implement-and-run-commands-for-any-osgi-42-framework">Standard way to implement and run commands for any OSGi 4.2 framework</a><ul>
<li><a href="#commands-can-have-any-signature">Commands can have any signature</a></li>
-<li><a href="#easy-to-use-interactively-no-unnecessary-syntax">Easy to use interactively - no unnecessary syntax.</a></li>
-<li><a href="#lists-maps-pipes-and-closures">Lists, maps, pipes and closures.</a></li>
-<li><a href="#leverages-existing-java-capabilities-via-reflection">Leverages existing Java capabilities, via reflection.</a></li>
-<li><a href="#easy-to-implement-and-test-commands-without-needing-osgi">Easy to implement and test commands without needing OSGi.</a></li>
-<li><a href="#normal-commands-can-provide-control-primitives">Normal commands can provide control primitives.</a></li>
+<li><a href="#easy-to-use-interactively-no-unnecessary-syntax">Easy to use interactively - no unnecessary syntax</a></li>
+<li><a href="#lists-maps-pipes-and-closures">Lists, maps, pipes and closures</a></li>
+<li><a href="#leverages-existing-java-capabilities-via-reflection">Leverages existing Java capabilities, via reflection</a></li>
+<li><a href="#easy-to-implement-and-test-commands-without-needing-osgi">Easy to implement and test commands without needing OSGi</a></li>
+<li><a href="#normal-commands-can-provide-control-primitives">Normal commands can provide control primitives</a></li>
</ul>
</li>
</ul>
@@ -135,7 +135,7 @@ h2:hover > .headerlink, h3:hover > .head
</pre></div>
-<h3 id="easy-to-use-interactively-no-unnecessary-syntax">Easy to use interactively - no unnecessary syntax.<a class="headerlink" href="#easy-to-use-interactively-no-unnecessary-syntax" title="Permanent link">¶</a></h3>
+<h3 id="easy-to-use-interactively-no-unnecessary-syntax">Easy to use interactively - no unnecessary syntax<a class="headerlink" href="#easy-to-use-interactively-no-unnecessary-syntax" title="Permanent link">¶</a></h3>
<ul>
<li>
<p>basic commands</p>
@@ -163,7 +163,7 @@ h2:hover > .headerlink, h3:hover > .head
</li>
</ul>
-<h3 id="lists-maps-pipes-and-closures">Lists, maps, pipes and closures.<a class="headerlink" href="#lists-maps-pipes-and-closures" title="Permanent link">¶</a></h3>
+<h3 id="lists-maps-pipes-and-closures">Lists, maps, pipes and closures<a class="headerlink" href="#lists-maps-pipes-and-closures" title="Permanent link">¶</a></h3>
<ul>
<li>
<p>lists - <code>[]</code></p>
@@ -206,7 +206,7 @@ h2:hover > .headerlink, h3:hover > .head
</li>
</ul>
-<h3 id="leverages-existing-java-capabilities-via-reflection">Leverages existing Java capabilities, via reflection.<a class="headerlink" href="#leverages-existing-java-capabilities-via-reflection" title="Permanent link">¶</a></h3>
+<h3 id="leverages-existing-java-capabilities-via-reflection">Leverages existing Java capabilities, via reflection<a class="headerlink" href="#leverages-existing-java-capabilities-via-reflection" title="Permanent link">¶</a></h3>
<ul>
<li>
<p>exception handling - console shows summary, but full context available</p>
@@ -241,7 +241,7 @@ h2:hover > .headerlink, h3:hover > .head
</li>
</ul>
-<h3 id="easy-to-implement-and-test-commands-without-needing-osgi">Easy to implement and test commands without needing OSGi.<a class="headerlink" href="#easy-to-implement-and-test-commands-without-needing-osgi" title="Permanent link">¶</a></h3>
+<h3 id="easy-to-implement-and-test-commands-without-needing-osgi">Easy to implement and test commands without needing OSGi<a class="headerlink" href="#easy-to-implement-and-test-commands-without-needing-osgi" title="Permanent link">¶</a></h3>
<p>Command implementations don't need to reference any OSGi interfaces. They can use <code>System.in</code>, <code>System.out</code> and <code>System.err</code>, just as you would in a trivial Java application. The <code>ThreadIO</code> service transparently manages the singleton <code>System.out</code> etc, so that each thread sees the appropriate stream:</p>
<div class="codehilite"><pre><span class="kd">public</span> <span class="kt">void</span> <span class="nf">cat</span><span class="o">(</span><span class="n">String</span><span class="o">[]</span> <span class="n">args</span><span class="o">)</span> <span class="kd">throws</span> <span class="n">Exception</span> <span class="o">{</span>
<span class="k">for</span> <span class="o">(</span><span class="n">String</span> <span class="n">arg</span> <span class="o">:</span> <span class="n">args</span><span class="o">)</span> <span class="o">{</span>
@@ -251,16 +251,17 @@ h2:hover > .headerlink, h3:hover > .head
</pre></div>
-<h3 id="normal-commands-can-provide-control-primitives">Normal commands can provide control primitives.<a class="headerlink" href="#normal-commands-can-provide-control-primitives" title="Permanent link">¶</a></h3>
+<h3 id="normal-commands-can-provide-control-primitives">Normal commands can provide control primitives<a class="headerlink" href="#normal-commands-can-provide-control-primitives" title="Permanent link">¶</a></h3>
<div class="codehilite"><pre><span class="kd">public</span> <span class="kt">void</span> <span class="nf">each</span><span class="o">(</span><span class="n">CommandSession</span> <span class="n">session</span><span class="o">,</span> <span class="n">Collection</span><span class="o"><</span><span class="n">Object</span><span class="o">></span> <span class="n">list</span><span class="o">,</span> <span class="n">Function</span> <span class="n">closure</span><span class="o">)</span> <span class="kd">throws</span> <span class="n">Exception</span> <span class="o">{</span>
<span class="k">for</span> <span class="o">(</span><span class="n">Object</span> <span class="n">x</span> <span class="o">:</span> <span class="n">list</span><span class="o">)</span> <span class="o">{</span>
<span class="n">closure</span><span class="o">.</span><span class="na">execute</span><span class="o">(</span><span class="n">session</span><span class="o">,</span> <span class="kc">null</span><span class="o">);</span>
<span class="o">}</span>
<span class="o">}</span>
+</pre></div>
-<span class="o">:::</span><span class="n">shell</span>
-<span class="n">g</span><span class="o">!</span> <span class="n">each</span> <span class="o">[</span><span class="n">Jan</span> <span class="n">Feb</span> <span class="n">Mar</span><span class="o">]</span> <span class="o">{</span> <span class="n">echo</span> <span class="n">$it</span> <span class="o">|</span> <span class="n">grep</span> <span class="o">.</span> <span class="o">}</span>
+<p>then</p>
+<div class="codehilite"><pre><span class="n">g</span>! <span class="n">each</span> <span class="p">[</span><span class="n">Jan</span> <span class="n">Feb</span> <span class="n">Mar</span><span class="p">]</span> <span class="p">{</span> <span class="n">echo</span> $<span class="n">it</span> <span class="o">|</span> <span class="n">grep</span> <span class="p">.</span> <span class="p">}</span>
<span class="n">Jan</span>
<span class="n">Feb</span>
<span class="n">Mar</span>
@@ -270,7 +271,7 @@ h2:hover > .headerlink, h3:hover > .head
<p><strong>Note:</strong> The default <em>echo</em> command <em>returns</em> a String and does not write to System.out. Also, by default, the console prints the results of each command, so <em>echo</em> appears to behave as you would expect.
However, the console does not see the <em>each</em> closure above, so the result of echo would not be seen. This is why it is piped into <em>grep</em>, as the <em>result</em> of the command as well as its output is written to a pipeline.</p>
<div class="timestamp" style="margin-top: 30px; font-size: 80%; text-align: right;">
- Rev. 1842574 by rotty3000 on Mon, 1 Oct 2018 23:27:07 +0000
+ Rev. 1842619 by rotty3000 on Tue, 2 Oct 2018 13:27:49 +0000
</div>
<div class="trademarkFooter">
Apache Felix, Felix, Apache, the Apache feather logo, and the Apache Felix project