You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@thrift.apache.org by bu...@apache.org on 2014/03/22 18:44:08 UTC
svn commit: r902903 [1/14] - in /websites/staging/thrift/trunk/content: ./
tutorial/
Author: buildbot
Date: Sat Mar 22 17:44:08 2014
New Revision: 902903
Log:
Staging update by buildbot for thrift
Modified:
websites/staging/thrift/trunk/content/ (props changed)
websites/staging/thrift/trunk/content/index.html
websites/staging/thrift/trunk/content/tutorial/as3.html
websites/staging/thrift/trunk/content/tutorial/cpp.html
websites/staging/thrift/trunk/content/tutorial/csharp.html
websites/staging/thrift/trunk/content/tutorial/d.html
websites/staging/thrift/trunk/content/tutorial/delphi.html
websites/staging/thrift/trunk/content/tutorial/go.html
websites/staging/thrift/trunk/content/tutorial/hs.html
websites/staging/thrift/trunk/content/tutorial/java.html
websites/staging/thrift/trunk/content/tutorial/nodejs.html
websites/staging/thrift/trunk/content/tutorial/ocaml.html
websites/staging/thrift/trunk/content/tutorial/perl.html
websites/staging/thrift/trunk/content/tutorial/php.html
websites/staging/thrift/trunk/content/tutorial/py.html
websites/staging/thrift/trunk/content/tutorial/rb.html
Propchange: websites/staging/thrift/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Sat Mar 22 17:44:08 2014
@@ -1 +1 @@
-1580268
+1580269
Modified: websites/staging/thrift/trunk/content/index.html
==============================================================================
--- websites/staging/thrift/trunk/content/index.html (original)
+++ websites/staging/thrift/trunk/content/index.html Sat Mar 22 17:44:08 2014
@@ -139,68 +139,68 @@
</ul>
<div class="tab-content">
<div class="tab-pane active" id="1">
-<div class="codehilite"><pre>service Calculator extends shared.SharedService {
+ :::text
+ service Calculator extends shared.SharedService {
- /**
- * A method definition looks like C code. It has a return type, arguments,
- * and optionally a list of exceptions that it may throw. Note that argument
- * lists and exception lists are specified using the exact same syntax as
- * field lists in struct or exception definitions.
- */
-
- void ping(),
-
- i32 add(1:i32 num1, 2:i32 num2),
-
- i32 calculate(1:i32 logid, 2:Work w) throws (1:InvalidOperation ouch),
-
- /**
- * This method has a oneway modifier. That means the client only makes
- * a request and does not listen for any response at all. Oneway methods
- * must be void.
- */
- oneway void zip()
+ /**
+ * A method definition looks like C code. It has a return type, arguments,
+ * and optionally a list of exceptions that it may throw. Note that argument
+ * lists and exception lists are specified using the exact same syntax as
+ * field lists in struct or exception definitions.
+ */
+
+ void ping(),
+
+ i32 add(1:i32 num1, 2:i32 num2),
+
+ i32 calculate(1:i32 logid, 2:Work w) throws (1:InvalidOperation ouch),
+
+ /**
+ * This method has a oneway modifier. That means the client only makes
+ * a request and does not listen for any response at all. Oneway methods
+ * must be void.
+ */
+ oneway void zip()
-}
-</pre></div>
+ }
</div>
<div class="tab-pane" id="2">
-<div class="codehilite"><pre> <span class="c"># Make socket</span>
- <span class="n">transport</span> <span class="o">=</span> <span class="n">TSocket</span><span class="o">.</span><span class="n">TSocket</span><span class="p">(</span><span class="s">'localhost'</span><span class="p">,</span> <span class="mi">9090</span><span class="p">)</span>
+ :::python
+ # Make socket
+ transport = TSocket.TSocket('localhost', 9090)
- <span class="c"># Buffering is critical. Raw sockets are very slow</span>
- <span class="n">transport</span> <span class="o">=</span> <span class="n">TTransport</span><span class="o">.</span><span class="n">TBufferedTransport</span><span class="p">(</span><span class="n">transport</span><span class="p">)</span>
+ # Buffering is critical. Raw sockets are very slow
+ transport = TTransport.TBufferedTransport(transport)
- <span class="c"># Wrap in a protocol</span>
- <span class="n">protocol</span> <span class="o">=</span> <span class="n">TBinaryProtocol</span><span class="o">.</span><span class="n">TBinaryProtocol</span><span class="p">(</span><span class="n">transport</span><span class="p">)</span>
+ # Wrap in a protocol
+ protocol = TBinaryProtocol.TBinaryProtocol(transport)
- <span class="c"># Create a client to use the protocol encoder</span>
- <span class="n">client</span> <span class="o">=</span> <span class="n">Calculator</span><span class="o">.</span><span class="n">Client</span><span class="p">(</span><span class="n">protocol</span><span class="p">)</span>
+ # Create a client to use the protocol encoder
+ client = Calculator.Client(protocol)
- <span class="c"># Connect!</span>
- <span class="n">transport</span><span class="o">.</span><span class="n">open</span><span class="p">()</span>
+ # Connect!
+ transport.open()
- <span class="n">client</span><span class="o">.</span><span class="n">ping</span><span class="p">()</span>
- <span class="k">print</span> <span class="s">'ping()'</span>
+ client.ping()
+ print 'ping()'
- <span class="nb">sum</span> <span class="o">=</span> <span class="n">client</span><span class="o">.</span><span class="n">add</span><span class="p">(</span><span class="mi">1</span><span class="p">,</span><span class="mi">1</span><span class="p">)</span>
- <span class="k">print</span> <span class="s">'1+1=</span><span class="si">%d</span><span class="s">'</span> <span class="o">%</span> <span class="p">(</span><span class="nb">sum</span><span class="p">)</span>
-</pre></div>
+ sum = client.add(1,1)
+ print '1+1=%d' % (sum)
</div>
<div class="tab-pane" id="3">
-<div class="codehilite"><pre> <span class="k">try</span> <span class="o">{</span>
- <span class="n">TServerTransport</span> <span class="n">serverTransport</span> <span class="o">=</span> <span class="k">new</span> <span class="n">TServerSocket</span><span class="o">(</span><span class="mi">9090</span><span class="o">);</span>
- <span class="n">TServer</span> <span class="n">server</span> <span class="o">=</span> <span class="k">new</span> <span class="n">TSimpleServer</span><span class="o">(</span><span class="k">new</span> <span class="n">Args</span><span class="o">(</span><span class="n">serverTransport</span><span class="o">).</span><span class="na">processor</span><span class="o">(</span><span class="n">processor</span><span class="o">));</span>
-
- <span class="c1">// Use this for a multithreaded server</span>
- <span class="c1">// TServer server = new TThreadPoolServer(new TThreadPoolServer.Args(serverTransport).processor(processor));</span>
-
- <span class="n">System</span><span class="o">.</span><span class="na">out</span><span class="o">.</span><span class="na">println</span><span class="o">(</span><span class="s">"Starting the simple server..."</span><span class="o">);</span>
- <span class="n">server</span><span class="o">.</span><span class="na">serve</span><span class="o">();</span>
- <span class="o">}</span> <span class="k">catch</span> <span class="o">(</span><span class="n">Exception</span> <span class="n">e</span><span class="o">)</span> <span class="o">{</span>
- <span class="n">e</span><span class="o">.</span><span class="na">printStackTrace</span><span class="o">();</span>
- <span class="o">}</span>
-</pre></div>
+ :::java
+ try {
+ TServerTransport serverTransport = new TServerSocket(9090);
+ TServer server = new TSimpleServer(new Args(serverTransport).processor(processor));
+
+ // Use this for a multithreaded server
+ // TServer server = new TThreadPoolServer(new TThreadPoolServer.Args(serverTransport).processor(processor));
+
+ System.out.println("Starting the simple server...");
+ server.serve();
+ } catch (Exception e) {
+ e.printStackTrace();
+ }
</div>
</div>
</div>
Modified: websites/staging/thrift/trunk/content/tutorial/as3.html
==============================================================================
--- websites/staging/thrift/trunk/content/tutorial/as3.html (original)
+++ websites/staging/thrift/trunk/content/tutorial/as3.html Sat Mar 22 17:44:08 2014
@@ -88,14 +88,17 @@
<h3 id="prerequisites">Prerequisites</h3>
<h3 id="client">Client</h3>
<p>To initialize client you can use code similar to:</p>
-<p><div class="codehilite"><pre> <span class="kd">private</span> <span class="n">function</span> <span class="nf">initConnection</span><span class="o">():</span><span class="kt">void</span> <span class="o">{</span>
- <span class="n">mTransport</span> <span class="o">=</span> <span class="k">new</span> <span class="n">TSocket</span><span class="o">(</span><span class="s">"127.0.0.1"</span><span class="o">,</span> <span class="mi">9090</span><span class="o">);</span> <span class="c1">// we connect to server</span>
- <span class="n">mTransport</span><span class="o">.</span><span class="na">open</span><span class="o">();</span>
- <span class="c1">// initialize protocol:</span>
- <span class="n">var</span> <span class="nl">protocol:</span><span class="n">TProtocol</span> <span class="o">=</span> <span class="k">new</span> <span class="n">TBinaryProtocol</span><span class="o">(</span><span class="n">mTransport</span><span class="o">,</span> <span class="kc">false</span><span class="o">,</span> <span class="kc">false</span><span class="o">);</span>
- <span class="n">mCalculatorClient</span> <span class="o">=</span> <span class="k">new</span> <span class="n">CalculatorImpl</span><span class="o">(</span><span class="n">protocol</span><span class="o">);</span> <span class="c1">// finally, we create calculator client instance</span>
- <span class="o">}</span>
-</pre></div></p>
+<div class="codehilite"><pre> <span class="p">:::</span><span class="n">java</span>
+ <span class="n">private</span> <span class="k">function</span> <span class="n">initConnection</span><span class="p">():</span><span class="n">void</span> <span class="p">{</span>
+ <span class="n">mTransport</span> <span class="p">=</span> <span class="n">new</span> <span class="n">TSocket</span><span class="p">(</span><span class="o">&</span><span class="n">quot</span><span class="p">;</span>127<span class="p">.</span>0<span class="p">.</span>0<span class="p">.</span>1<span class="o">&</span><span class="n">quot</span><span class="p">;,</span> 9090<span class="p">);</span> <span class="o">//</span> <span class="n">we</span> <span class="n">connect</span> <span class="n">to</span> <span class="n">server</span>
+ <span class="n">mTransport</span><span class="p">.</span><span class="n">open</span><span class="p">();</span>
+ <span class="o">//</span> <span class="n">initialize</span> <span class="n">protocol</span><span class="p">:</span>
+ <span class="n">var</span> <span class="n">protocol</span><span class="p">:</span><span class="n">TProtocol</span> <span class="p">=</span> <span class="n">new</span> <span class="n">TBinaryProtocol</span><span class="p">(</span><span class="n">mTransport</span><span class="p">,</span> <span class="n">false</span><span class="p">,</span> <span class="n">false</span><span class="p">);</span>
+ <span class="n">mCalculatorClient</span> <span class="p">=</span> <span class="n">new</span> <span class="n">CalculatorImpl</span><span class="p">(</span><span class="n">protocol</span><span class="p">);</span> <span class="o">//</span> <span class="n">finally</span><span class="p">,</span> <span class="n">we</span> <span class="n">create</span> <span class="n">calculator</span> <span class="n">client</span> <span class="n">instance</span>
+ <span class="p">}</span>
+</pre></div>
+
+
<h3 id="server">Server</h3>
<p>The example client above can be tested against a java tutorial server.</p>
<h3 id="additional-information">Additional Information</h3>
@@ -110,10 +113,13 @@ which some flash movies can connect to t
Also, you can find a simple python/perl server script to serve this file there. For same host, you can serve
crossdomain.xml from any port. So, you can start your RPC servers on ports 9090 and 9091, and serve polisy file from
port 9092. To tell flash about this, you can use code from tutorial file:</p>
-<p><div class="codehilite"><pre> <span class="kd">private</span> <span class="n">function</span> <span class="nf">initSecurity</span><span class="o">():</span><span class="kt">void</span> <span class="o">{</span>
- <span class="n">Security</span><span class="o">.</span><span class="na">loadPolicyFile</span><span class="o">(</span><span class="s">"xmlsocket://127.0.0.1:9092"</span><span class="o">);</span>
- <span class="o">}</span>
-</pre></div></p>
+<div class="codehilite"><pre> <span class="p">:::</span><span class="n">java</span>
+ <span class="n">private</span> <span class="k">function</span> <span class="n">initSecurity</span><span class="p">():</span><span class="n">void</span> <span class="p">{</span>
+ <span class="n">Security</span><span class="p">.</span><span class="n">loadPolicyFile</span><span class="p">(</span><span class="o">&</span><span class="n">quot</span><span class="p">;</span><span class="n">xmlsocket</span><span class="p">:</span><span class="o">//</span>127<span class="p">.</span>0<span class="p">.</span>0<span class="p">.</span>1<span class="p">:</span>9092<span class="o">&</span><span class="n">quot</span><span class="p">;);</span>
+ <span class="p">}</span>
+</pre></div>
+
+
<p>Example of crossdomain file, to allow connect to ports 9090 and 9091 from any server:</p>
<pre><code>
<?xml version="1.0"?>