You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@ode.apache.org by bu...@apache.org on 2012/12/28 12:29:15 UTC
svn commit: r844092 [3/3] - /websites/staging/ode/trunk/content/
Modified: websites/staging/ode/trunk/content/sendsoap-command.html
==============================================================================
--- websites/staging/ode/trunk/content/sendsoap-command.html (original)
+++ websites/staging/ode/trunk/content/sendsoap-command.html Fri Dec 28 11:29:14 2012
@@ -90,16 +90,16 @@
<span class="n">sendsoap</span> <span class="o">-</span><span class="n">h</span><span class="p">{</span><span class="n">noformat</span><span class="p">}</span>
<span class="n">h2</span><span class="o">.</span> <span class="n">Description</span>
-<span class="n">The</span> <span class="p">{{</span><span class="n">sendsoap</span><span class="p">}}</span> <span class="n">command</span> <span class="n">uses</span> <span class="n">a</span> <span class="n">lightweight</span> <span class="n">HTTP</span> <span class="n">client</span> <span class="n">to</span> <span class="nb">send</span> <span class="n">SOAP</span> <span class="n">messages</span> <span class="n">via</span> <span class="n">POST</span> <span class="n">using</span> <span class="n">either</span> <span class="n">a</span> <span class="n">file</span> <span class="ow">or</span> <span class="n">standard</span> <span class="n">in</span> <span class="n">as</span> <span class="n">the</span> <span class="n">source</span> <span class="k">for</span> <span class="n">the</span> <span class="n">message</span><span class="o">.</span> <span class="n">The</span> <span class="n">command</span> <span class="n">is</span> <span class="n">useful</span> <span class="k">for</span> <s
pan class="n">testing</span> <span class="n">HTTP</span> <span class="n">endpoints</span> <span class="n">in</span> <span class="n">PXE</span> <span class="ow">or</span> <span class="n">external</span> <span class="n">HTTP</span> <span class="n">services</span> <span class="n">that</span> <span class="n">PXE</span> <span class="n">will</span> <span class="n">interact</span> <span class="n">with</span><span class="p">,</span> <span class="n">as</span> <span class="p">{{</span><span class="n">sendsoap</span><span class="p">}}</span> <span class="n">uses</span> <span class="n">the</span> <span class="n">same</span> <span class="n">client</span> <span class="n">as</span> <span class="n">the</span> <span class="p">[</span><span class="n">HTTP</span><span class="o">-</span><span class="n">SOAP</span> <span class="n">Protocol</span> <span class="n">Adapter</span><span class="p">]</span><span class="o">.</span>
+<span class="n">The</span> <span class="sb">`sendsoap`</span> <span class="n">command</span> <span class="n">uses</span> <span class="n">a</span> <span class="n">lightweight</span> <span class="n">HTTP</span> <span class="n">client</span> <span class="n">to</span> <span class="nb">send</span> <span class="n">SOAP</span> <span class="n">messages</span> <span class="n">via</span> <span class="n">POST</span> <span class="n">using</span> <span class="n">either</span> <span class="n">a</span> <span class="n">file</span> <span class="ow">or</span> <span class="n">standard</span> <span class="n">in</span> <span class="n">as</span> <span class="n">the</span> <span class="n">source</span> <span class="k">for</span> <span class="n">the</span> <span class="n">message</span><span class="o">.</span> <span class="n">The</span> <span class="n">command</span> <span class="n">is</span> <span class="n">useful</span> <span class="k">for</span> <span class="n">testing</span> <span class="n">HT
TP</span> <span class="n">endpoints</span> <span class="n">in</span> <span class="n">PXE</span> <span class="ow">or</span> <span class="n">external</span> <span class="n">HTTP</span> <span class="n">services</span> <span class="n">that</span> <span class="n">PXE</span> <span class="n">will</span> <span class="n">interact</span> <span class="n">with</span><span class="p">,</span> <span class="n">as</span> <span class="sb">`sendsoap`</span> <span class="n">uses</span> <span class="n">the</span> <span class="n">same</span> <span class="n">client</span> <span class="n">as</span> <span class="n">the</span> <span class="p">[</span><span class="n">HTTP</span><span class="o">-</span><span class="n">SOAP</span> <span class="n">Protocol</span> <span class="n">Adapter</span><span class="p">]</span><span class="o">.</span>
<span class="n">h2</span><span class="o">.</span> <span class="n">Options</span>
<span class="o">||</span><span class="n">Option</span><span class="o">/</span><span class="n">Argument</span><span class="o">||</span><span class="n">Effect</span><span class="o">||</span>
-<span class="o">|</span><span class="p">{{</span><span class="n">url</span><span class="p">}}</span><span class="o">|</span><span class="n">the</span> <span class="n">HTTP</span> <span class="n">URL</span> <span class="n">to</span> <span class="n">post</span> <span class="n">the</span> <span class="n">message</span> <span class="n">to</span><span class="o">.|</span>
-<span class="o">|</span><span class="p">{{</span><span class="n">file</span><span class="p">}}</span><span class="o">|</span><span class="n">a</span> <span class="n">file</span> <span class="n">containing</span> <span class="n">the</span> <span class="n">message</span> <span class="n">to</span> <span class="n">post</span><span class="o">.|</span>
-<span class="o">|</span><span class="p">{{</span><span class="o">-</span><span class="p">}}</span><span class="o">|</span><span class="nb">read</span> <span class="n">the</span> <span class="n">message</span> <span class="n">data</span> <span class="n">from</span> <span class="n">standard</span> <span class="n">in</span> <span class="n">instead</span> <span class="n">of</span> <span class="n">a</span> <span class="n">file</span><span class="o">.|</span>
-<span class="o">|</span><span class="p">{{</span><span class="o">-</span><span class="n">o</span> <span class="n">file</span><span class="p">}}</span><span class="o">|</span><span class="n">sets</span> <span class="n">a</span> <span class="n">file</span> <span class="n">to</span> <span class="nb">write</span> <span class="n">the</span> <span class="n">output</span> <span class="n">to</span><span class="p">;</span> <span class="n">otherwise</span><span class="p">,</span> <span class="n">output</span> <span class="n">is</span> <span class="n">sent</span> <span class="n">to</span> <span class="n">the</span> <span class="n">console</span><span class="o">.|</span>
-<span class="o">|</span><span class="p">{{</span><span class="o">-</span><span class="sx">q\|-v\</span><span class="o">|-</span><span class="n">vv</span><span class="p">}}</span><span class="o">|</span><span class="n">adjust</span> <span class="n">the</span> <span class="n">verbosity</span> <span class="n">of</span> <span class="n">logging</span> <span class="n">output</span><span class="o">.</span> <span class="n">See</span> <span class="p">[</span><span class="n">Loging</span> <span class="ow">and</span> <span class="n">Output</span> <span class="k">for</span> <span class="n">Commandline</span> <span class="n">Tools</span><span class="p">]</span><span class="o">.|</span>
-<span class="o">|</span><span class="p">{{</span><span class="o">-</span><span class="n">h</span><span class="p">}}</span><span class="o">|</span><span class="n">prints</span> <span class="n">a</span> <span class="n">synopsis</span> <span class="n">to</span> <span class="n">the</span> <span class="n">console</span> <span class="ow">and</span> <span class="n">exits</span><span class="o">.|</span>
+<span class="o">|</span><span class="sb">`url`</span><span class="o">|</span><span class="n">the</span> <span class="n">HTTP</span> <span class="n">URL</span> <span class="n">to</span> <span class="n">post</span> <span class="n">the</span> <span class="n">message</span> <span class="n">to</span><span class="o">.|</span>
+<span class="o">|</span><span class="sb">`file`</span><span class="o">|</span><span class="n">a</span> <span class="n">file</span> <span class="n">containing</span> <span class="n">the</span> <span class="n">message</span> <span class="n">to</span> <span class="n">post</span><span class="o">.|</span>
+<span class="o">|</span><span class="sb">`-`</span><span class="o">|</span><span class="nb">read</span> <span class="n">the</span> <span class="n">message</span> <span class="n">data</span> <span class="n">from</span> <span class="n">standard</span> <span class="n">in</span> <span class="n">instead</span> <span class="n">of</span> <span class="n">a</span> <span class="n">file</span><span class="o">.|</span>
+<span class="o">|</span><span class="sb">`-o file`</span><span class="o">|</span><span class="n">sets</span> <span class="n">a</span> <span class="n">file</span> <span class="n">to</span> <span class="nb">write</span> <span class="n">the</span> <span class="n">output</span> <span class="n">to</span><span class="p">;</span> <span class="n">otherwise</span><span class="p">,</span> <span class="n">output</span> <span class="n">is</span> <span class="n">sent</span> <span class="n">to</span> <span class="n">the</span> <span class="n">console</span><span class="o">.|</span>
+<span class="o">|</span><span class="sb">`-q\|-v\|-vv`</span><span class="o">|</span><span class="n">adjust</span> <span class="n">the</span> <span class="n">verbosity</span> <span class="n">of</span> <span class="n">logging</span> <span class="n">output</span><span class="o">.</span> <span class="n">See</span> <span class="p">[</span><span class="n">Loging</span> <span class="ow">and</span> <span class="n">Output</span> <span class="k">for</span> <span class="n">Commandline</span> <span class="n">Tools</span><span class="p">]</span><span class="o">.|</span>
+<span class="o">|</span><span class="sb">`-h`</span><span class="o">|</span><span class="n">prints</span> <span class="n">a</span> <span class="n">synopsis</span> <span class="n">to</span> <span class="n">the</span> <span class="n">console</span> <span class="ow">and</span> <span class="n">exits</span><span class="o">.|</span>
</pre></div>
</div>
</div>
Modified: websites/staging/ode/trunk/content/urlalias-command.html
==============================================================================
--- websites/staging/ode/trunk/content/urlalias-command.html (original)
+++ websites/staging/ode/trunk/content/urlalias-command.html Fri Dec 28 11:29:14 2012
@@ -92,21 +92,21 @@
<span class="n">urlalias</span> <span class="o">-</span><span class="n">h</span><span class="p">{</span><span class="n">noformat</span><span class="p">}</span>
<span class="n">h2</span><span class="o">.</span> <span class="n">Description</span>
-<span class="n">The</span> <span class="p">{{</span><span class="n">urlalias</span><span class="p">}}</span> <span class="n">command</span> <span class="n">is</span> <span class="n">used</span> <span class="n">to</span> <span class="n">maintain</span> <span class="n">a</span> <span class="n">mapping</span> <span class="n">between</span> <span class="n">aliases</span> <span class="ow">and</span> <span class="n">URLs</span> <span class="n">used</span> <span class="n">by</span> <span class="n">other</span> <span class="p">[</span><span class="n">Commandline</span> <span class="n">Tools</span><span class="p">]</span> <span class="ow">and</span> <span class="p">[</span><span class="n">Ant</span> <span class="n">Tasks</span><span class="p">]</span><span class="o">.</span>
+<span class="n">The</span> <span class="sb">`urlalias`</span> <span class="n">command</span> <span class="n">is</span> <span class="n">used</span> <span class="n">to</span> <span class="n">maintain</span> <span class="n">a</span> <span class="n">mapping</span> <span class="n">between</span> <span class="n">aliases</span> <span class="ow">and</span> <span class="n">URLs</span> <span class="n">used</span> <span class="n">by</span> <span class="n">other</span> <span class="p">[</span><span class="n">Commandline</span> <span class="n">Tools</span><span class="p">]</span> <span class="ow">and</span> <span class="p">[</span><span class="n">Ant</span> <span class="n">Tasks</span><span class="p">]</span><span class="o">.</span>
-<span class="n">The</span> <span class="n">list</span> <span class="n">of</span> <span class="n">aliases</span> <span class="n">is</span> <span class="n">stored</span> <span class="n">in</span> <span class="n">a</span> <span class="n">file</span> <span class="n">named</span> <span class="p">{{</span><span class="o">.</span><span class="n">pxe</span><span class="o">.</span><span class="n">aliases</span><span class="p">}}</span> <span class="n">in</span> <span class="n">the</span> <span class="n">user</span><span class="err">'</span><span class="n">s</span> <span class="n">home</span> <span class="n">directory</span><span class="o">.</span>
+<span class="n">The</span> <span class="n">list</span> <span class="n">of</span> <span class="n">aliases</span> <span class="n">is</span> <span class="n">stored</span> <span class="n">in</span> <span class="n">a</span> <span class="n">file</span> <span class="n">named</span> <span class="sb">`.pxe.aliases`</span> <span class="n">in</span> <span class="n">the</span> <span class="n">user</span><span class="err">'</span><span class="n">s</span> <span class="n">home</span> <span class="n">directory</span><span class="o">.</span>
<span class="p">{</span><span class="n">info:title</span><span class="o">=</span><span class="n">Be</span> <span class="n">sure</span> <span class="n">to</span> <span class="n">properly</span> <span class="n">escape</span> <span class="n">URLs</span> <span class="n">on</span> <span class="n">the</span> <span class="n">commandline</span><span class="o">.</span><span class="p">}</span><span class="n">The</span> <span class="n">commandline</span> <span class="n">shells</span> <span class="k">for</span> <span class="n">different</span> <span class="n">operating</span> <span class="n">systems</span> <span class="n">may</span> <span class="n">interpret</span> <span class="n">colons</span><span class="p">,</span> <span class="n">question</span> <span class="n">marks</span><span class="p">,</span> <span class="ow">and</span> <span class="n">other</span> <span class="n">symbols</span> <span class="n">as</span> <span class="n">part</span> <span class="n">of</span> <span class="n">the<
/span> <span class="n">command</span> <span class="n">instead</span> <span class="n">of</span> <span class="n">part</span> <span class="n">of</span> <span class="n">the</span> <span class="n">argument</span><span class="p">,</span> <span class="n">so</span> <span class="n">be</span> <span class="n">sure</span> <span class="n">to</span> <span class="n">properly</span> <span class="n">quote</span> <span class="ow">or</span> <span class="n">escape</span> <span class="n">any</span> <span class="n">URLs</span> <span class="n">passed</span> <span class="n">as</span> <span class="n">arguments</span><span class="o">.</span><span class="p">{</span><span class="n">info</span><span class="p">}</span>
<span class="n">h3</span><span class="o">.</span> <span class="n">Magic</span> <span class="n">Aliases</span>
<span class="n">Other</span> <span class="n">commands</span> <span class="n">recognize</span> <span class="n">the</span> <span class="n">following</span> <span class="s">"magic"</span> <span class="n">aliases:</span>
-<span class="o">*</span> <span class="n">The</span> <span class="p">{{</span><span class="n">jmx</span><span class="o">-</span><span class="n">default</span><span class="p">}}</span> <span class="n">alias</span> <span class="n">supplies</span> <span class="n">the</span> <span class="n">default</span> <span class="n">value</span> <span class="n">of</span> <span class="n">the</span> <span class="n">JMX</span> <span class="n">service</span> <span class="n">URL</span> <span class="k">for</span> <span class="n">the</span> <span class="nb">system</span> <span class="n">management</span> <span class="n">commands</span><span class="p">;</span> <span class="n">see</span> <span class="p">[{{</span><span class="n">pxe</span><span class="o">-</span><span class="n">deploy</span><span class="p">}}</span><span class="o">|</span><span class="n">pxe</span><span class="o">-</span><span class="n">deploy</span> <span class="n">Command</span><span class="p">],</span> <span class="p">[{{</span><s
pan class="n">pxe</span><span class="o">-</span><span class="n">undeploy</span><span class="p">}}</span><span class="o">|</span><span class="n">pxe</span><span class="o">-</span><span class="n">undeploy</span> <span class="n">Command</span><span class="p">],</span> <span class="p">[{{</span><span class="n">pxe</span><span class="o">-</span><span class="n">status</span><span class="p">}}</span><span class="o">|</span><span class="n">pxe</span><span class="o">-</span><span class="n">status</span> <span class="n">Command</span><span class="p">],</span> <span class="p">[{{</span><span class="n">pxe</span><span class="o">-</span><span class="n">activate</span><span class="p">}}</span><span class="o">|</span><span class="n">pxe</span><span class="o">-</span><span class="n">activate</span> <span class="n">Command</span><span class="p">],</span> <span class="ow">or</span> <span class="p">[{{</span><span class="n">pxe</span><span class="o">-</span><span class="n">deactivate</span><sp
an class="p">}}</span><span class="o">|</span><span class="n">pxe</span><span class="o">-</span><span class="n">deactivate</span> <span class="n">Command</span><span class="p">]</span><span class="o">.</span>
+<span class="o">*</span> <span class="n">The</span> <span class="sb">`jmx-default`</span> <span class="n">alias</span> <span class="n">supplies</span> <span class="n">the</span> <span class="n">default</span> <span class="n">value</span> <span class="n">of</span> <span class="n">the</span> <span class="n">JMX</span> <span class="n">service</span> <span class="n">URL</span> <span class="k">for</span> <span class="n">the</span> <span class="nb">system</span> <span class="n">management</span> <span class="n">commands</span><span class="p">;</span> <span class="n">see</span> <span class="p">[</span><span class="sb">`pxe-deploy`</span><span class="o">|</span><span class="n">pxe</span><span class="o">-</span><span class="n">deploy</span> <span class="n">Command</span><span class="p">],</span> <span class="p">[</span><span class="sb">`pxe-undeploy`</span><span class="o">|</span><span class="n">pxe</span><span class="o">-</span><span class="n">undeploy</span> <span class="n">Command
</span><span class="p">],</span> <span class="p">[</span><span class="sb">`pxe-status`</span><span class="o">|</span><span class="n">pxe</span><span class="o">-</span><span class="n">status</span> <span class="n">Command</span><span class="p">],</span> <span class="p">[</span><span class="sb">`pxe-activate`</span><span class="o">|</span><span class="n">pxe</span><span class="o">-</span><span class="n">activate</span> <span class="n">Command</span><span class="p">],</span> <span class="ow">or</span> <span class="p">[</span><span class="sb">`pxe-deactivate`</span><span class="o">|</span><span class="n">pxe</span><span class="o">-</span><span class="n">deactivate</span> <span class="n">Command</span><span class="p">]</span><span class="o">.</span>
<span class="n">h2</span><span class="o">.</span> <span class="n">Options</span>
<span class="o">||</span><span class="n">Option</span><span class="o">/</span><span class="n">Argument</span><span class="o">||</span><span class="n">Effect</span><span class="o">||</span>
-<span class="o">|</span><span class="p">{{</span><span class="o">-</span><span class="n">v</span><span class="o">\|-</span><span class="n">vv</span><span class="p">}}</span><span class="o">|</span><span class="n">adjust</span> <span class="n">the</span> <span class="n">verbosity</span> <span class="n">of</span> <span class="n">logging</span> <span class="n">output</span><span class="o">.</span> <span class="n">See</span> <span class="p">[</span><span class="n">Loging</span> <span class="ow">and</span> <span class="n">Output</span> <span class="k">for</span> <span class="n">Commandline</span> <span class="n">Tools</span><span class="p">]</span><span class="o">.|</span>
-<span class="o">|</span><span class="p">{{</span><span class="o">-</span><span class="n">h</span><span class="p">}}</span><span class="o">|</span><span class="n">prints</span> <span class="n">a</span> <span class="n">synopsis</span> <span class="n">to</span> <span class="n">the</span> <span class="n">console</span> <span class="ow">and</span> <span class="n">exits</span><span class="o">.|</span>
+<span class="o">|</span><span class="sb">`-v\|-vv`</span><span class="o">|</span><span class="n">adjust</span> <span class="n">the</span> <span class="n">verbosity</span> <span class="n">of</span> <span class="n">logging</span> <span class="n">output</span><span class="o">.</span> <span class="n">See</span> <span class="p">[</span><span class="n">Loging</span> <span class="ow">and</span> <span class="n">Output</span> <span class="k">for</span> <span class="n">Commandline</span> <span class="n">Tools</span><span class="p">]</span><span class="o">.|</span>
+<span class="o">|</span><span class="sb">`-h`</span><span class="o">|</span><span class="n">prints</span> <span class="n">a</span> <span class="n">synopsis</span> <span class="n">to</span> <span class="n">the</span> <span class="n">console</span> <span class="ow">and</span> <span class="n">exits</span><span class="o">.|</span>
</pre></div>
</div>
</div>
Modified: websites/staging/ode/trunk/content/wsdl-11-extensions-for-rest.html
==============================================================================
--- websites/staging/ode/trunk/content/wsdl-11-extensions-for-rest.html (original)
+++ websites/staging/ode/trunk/content/wsdl-11-extensions-for-rest.html Fri Dec 28 11:29:14 2012
@@ -113,7 +113,7 @@ Let's assume that such a resource accept
According to the WSDL 1.1 specification, the verb describing the HTTP method has to be at [the binding level](http://www.w3.org/TR/wsdl#A4.3). Which implies that the same HTTP method is used by all operations of a given port type. But RESTful web services leverage HTTP methods as a uniform interface to describe operation on resources. So for instance, if you want to use the following HTTP operations -- GET, POST, PUT, DELETE -- for a given resource, four different bindings would be required. And consequently four port types and four ports. Quite verbose and unusable, isn't it?
So, this extension is to push down the HTTP verb at the operation level. And if an operation does not have its own verb, then the verb defined at the binding level will be used.
- This extension is declared in the namespace: {{http://www.apache.org/ode/type/extension/http}}
+ This extension is declared in the namespace: `http://www.apache.org/ode/type/extension/http`
Please note that ODE supports GET, POST, PUT, DELETE only.
{code:xml}
@@ -137,7 +137,7 @@ Let's assume that such a resource accept
A RESTful service exposed a set of resources, each of them being accessible through a uniform interface: HTTP methods for a web service. So we need a way to define four operations (at most) for a single resource.
- Moreover it's very likely that the resource URI actually describes a set of resources. For instance, the set of posts contained in our imaginary blog: {{http://blog.org/post/\{post_id\}}}.
+ Moreover it's very likely that the resource URI actually describes a set of resources. For instance, the set of posts contained in our imaginary blog: `http://blog.org/post/\{post_id\`}.
HTTP binding offers the [http:operation | http://www.w3.org/TR/wsdl#_http:operation] element to set the path of an operation. While the service address is set in the [http:address](http://www.w3.org/TR/wsdl#_http:address) of the [wsdl:port](http://www.w3.org/TR/wsdl#_ports) element.
So one could imagine splitting the URL this way:
@@ -278,7 +278,7 @@ Let's assume that such a resource accept
|503_SERVICE_UNAVAILABLE|
|504_GATEWAY_TIMEOUT|
- {info:title=Useful Information}Note that 3xx errors should be pretty rare since by default the first hundred redirections are followed. You can tweak this value by setting the property {{http.protocol.max-redirects}} in the [enpoint-configuration.properties|Endpoint Configuration] of your process.{info}
+ {info:title=Useful Information}Note that 3xx errors should be pretty rare since by default the first hundred redirections are followed. You can tweak this value by setting the property `http.protocol.max-redirects` in the [enpoint-configuration.properties|Endpoint Configuration] of your process.{info}
Here what ODE does, if the status code is one of those listed in the next table (500, 501, etc):
# check that the operation has at least one fault in its abstract part, and one fault binding