<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>Pyrolite - client library for Java and .NET — Pyro 4.21 documentation</title>
<link rel="stylesheet" href="_static/default.css" type="text/css" />
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT: '',
VERSION: '4.21',
COLLAPSE_INDEX: false,
FILE_SUFFIX: '.html',
HAS_SOURCE: true
};
</script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/underscore.js"></script>
<script type="text/javascript" src="_static/doctools.js"></script>
<link rel="top" title="Pyro 4.21 documentation" href="index.html" />
<link rel="next" title="Change Log" href="changelog.html" />
<link rel="prev" title="Running on alternative Python implementations" href="alternative.html" />
</head>
<body>
<div class="related">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="genindex.html" title="General Index"
accesskey="I">index</a></li>
<li class="right" >
<a href="changelog.html" title="Change Log"
accesskey="N">next</a> |</li>
<li class="right" >
<a href="alternative.html" title="Running on alternative Python implementations"
accesskey="P">previous</a> |</li>
<li><a href="index.html">Pyro 4.21 documentation</a> »</li>
</ul>
</div>
<div class="document">
<div class="documentwrapper">
<div class="bodywrapper">
<div class="body">
<div class="section" id="pyrolite-client-library-for-java-and-net">
<h1>Pyrolite - client library for Java and .NET<a class="headerlink" href="#pyrolite-client-library-for-java-and-net" title="Permalink to this headline">ΒΆ</a></h1>
<p>This library allows your Java or .NET program to interface very easily with
the Python world. It uses the Pyro protocol to call methods on remote
objects. It also supports convenient access to a Pyro Flame server including the remote
interactive console.</p>
<p>Pyrolite is a tiny library (~50Kb) that implements a part of the client side Pyro library,
hence its name ‘lite’... Because Pyrolite has no dependencies,
it is a much lighter way to use Pyro from Java/.NET than a solution with
jython+pyro or IronPython+pyro would provide.
So if you don’t need Pyro’s full feature set, and don’t require your
Java/.NET code to host Pyro objects itself, Pyrolite may be
a good choice to connect java or .NET and python.</p>
<p>Pyrolite contains an almost complete implementation of Python’s <tt class="xref py py-mod docutils literal"><span class="pre">pickle</span></tt> protocol
(with fairly intelligent mapping of datatypes between Python and Java/.NET),
and a small part of Pyro’s client network protocol and proxy logic.</p>
<div class="admonition note">
<p class="first admonition-title">Note</p>
<p class="last">Pyrolite is quite new and should be considered rather experimental.
It does contain a large amount of unit tests to validate its behavior,
but “be careful”.</p>
</div>
<p>Get it from here: <a class="reference external" href="http://irmen.home.xs4all.nl/pyrolite/">http://irmen.home.xs4all.nl/pyrolite/</a></p>
<p>Readme: <a class="reference external" href="http://irmen.home.xs4all.nl/pyrolite/README.txt">http://irmen.home.xs4all.nl/pyrolite/README.txt</a></p>
<p>License (same as Pyro): <a class="reference external" href="http://irmen.home.xs4all.nl/pyrolite/LICENSE">http://irmen.home.xs4all.nl/pyrolite/LICENSE</a></p>
<p>Source is on Github: <a class="reference external" href="https://github.com/irmen/Pyrolite">https://github.com/irmen/Pyrolite</a></p>
<p>Small code example in Java:</p>
<div class="highlight-java"><div class="highlight"><pre><span class="kn">import</span> <span class="nn">net.razorvine.pyro.*</span><span class="o">;</span>
<span class="n">NameServerProxy</span> <span class="n">ns</span> <span class="o">=</span> <span class="n">NameServerProxy</span><span class="o">.</span><span class="na">locateNS</span><span class="o">(</span><span class="kc">null</span><span class="o">);</span>
<span class="n">PyroProxy</span> <span class="n">remoteobject</span> <span class="o">=</span> <span class="k">new</span> <span class="n">PyroProxy</span><span class="o">(</span><span class="n">ns</span><span class="o">.</span><span class="na">lookup</span><span class="o">(</span><span class="s">"Your.Pyro.Object"</span><span class="o">));</span>
<span class="n">Object</span> <span class="n">result</span> <span class="o">=</span> <span class="n">remoteobject</span><span class="o">.</span><span class="na">call</span><span class="o">(</span><span class="s">"pythonmethod"</span><span class="o">,</span> <span class="mi">42</span><span class="o">,</span> <span class="s">"hello"</span><span class="o">,</span> <span class="k">new</span> <span class="kt">int</span><span class="o">[]{</span><span class="mi">1</span><span class="o">,</span><span class="mi">2</span><span class="o">,</span><span class="mi">3</span><span class="o">});</span>
<span class="n">String</span> <span class="n">message</span> <span class="o">=</span> <span class="o">(</span><span class="n">String</span><span class="o">)</span><span class="n">result</span><span class="o">;</span> <span class="c1">// cast to the type that 'pythonmethod' returns</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">"result message="</span><span class="o">+</span><span class="n">message</span><span class="o">);</span>
<span class="n">remoteobject</span><span class="o">.</span><span class="na">close</span><span class="o">();</span>
<span class="n">ns</span><span class="o">.</span><span class="na">close</span><span class="o">();</span>
</pre></div>
</div>
<p>The same example in C#:</p>
<div class="highlight-csharp"><div class="highlight"><pre><span class="k">using</span> <span class="nn">Razorvine.Pyro</span><span class="p">;</span>
<span class="n">using</span><span class="p">(</span> <span class="n">NameServerProxy</span> <span class="n">ns</span> <span class="p">=</span> <span class="n">NameServerProxy</span><span class="p">.</span><span class="n">locateNS</span><span class="p">(</span><span class="k">null</span><span class="p">)</span> <span class="p">)</span>
<span class="p">{</span>
<span class="n">using</span><span class="p">(</span> <span class="n">PyroProxy</span> <span class="n">something</span> <span class="p">=</span> <span class="k">new</span> <span class="n">PyroProxy</span><span class="p">(</span><span class="n">ns</span><span class="p">.</span><span class="n">lookup</span><span class="p">(</span><span class="s">"Your.Pyro.Object"</span><span class="p">))</span> <span class="p">)</span>
<span class="p">{</span>
<span class="kt">object</span> <span class="n">result</span> <span class="p">=</span> <span class="n">something</span><span class="p">.</span><span class="n">call</span><span class="p">(</span><span class="s">"pythonmethod"</span><span class="p">,</span> <span class="m">42</span><span class="p">,</span> <span class="s">"hello"</span><span class="p">,</span> <span class="k">new</span> <span class="kt">int</span><span class="p">[]{</span><span class="m">1</span><span class="p">,</span><span class="m">2</span><span class="p">,</span><span class="m">3</span><span class="p">});</span>
<span class="kt">string</span> <span class="n">message</span> <span class="p">=</span> <span class="p">(</span><span class="kt">string</span><span class="p">)</span><span class="n">result</span><span class="p">;</span> <span class="c1">// cast to the type that 'pythonmethod' returns</span>
<span class="n">Console</span><span class="p">.</span><span class="n">WriteLine</span><span class="p">(</span><span class="s">"result message="</span><span class="p">+</span><span class="n">message</span><span class="p">);</span>
<span class="p">}</span>
<span class="p">}</span>
</pre></div>
</div>
<p>You can also use Pyro Flame rather conveniently because of some wrapper classes:</p>
<div class="highlight-java"><div class="highlight"><pre><span class="n">PyroProxy</span> <span class="n">flame</span> <span class="o">=</span> <span class="k">new</span> <span class="n">PyroProxy</span><span class="o">(</span><span class="n">hostname</span><span class="o">,</span> <span class="n">port</span><span class="o">,</span> <span class="s">"Pyro.Flame"</span><span class="o">);</span>
<span class="n">FlameModule</span> <span class="n">r_module</span> <span class="o">=</span> <span class="o">(</span><span class="n">FlameModule</span><span class="o">)</span> <span class="n">flame</span><span class="o">.</span><span class="na">call</span><span class="o">(</span><span class="s">"module"</span><span class="o">,</span> <span class="s">"socket"</span><span class="o">);</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">"hostname="</span> <span class="o">+</span> <span class="n">r_module</span><span class="o">.</span><span class="na">call</span><span class="o">(</span><span class="s">"gethostname"</span><span class="o">));</span>
<span class="n">FlameRemoteConsole</span> <span class="n">console</span> <span class="o">=</span> <span class="o">(</span><span class="n">FlameRemoteConsole</span><span class="o">)</span> <span class="n">flame</span><span class="o">.</span><span class="na">call</span><span class="o">(</span><span class="s">"console"</span><span class="o">);</span>
<span class="n">console</span><span class="o">.</span><span class="na">interact</span><span class="o">();</span>
<span class="n">console</span><span class="o">.</span><span class="na">close</span><span class="o">();</span>
</pre></div>
</div>
</div>
</div>
</div>
</div>
<div class="sphinxsidebar">
<div class="sphinxsidebarwrapper">
<p class="logo"><a href="index.html">
<img class="logo" src="_static/pyro.png" alt="Logo"/>
</a></p>
<h4>Previous topic</h4>
<p class="topless"><a href="alternative.html"
title="previous chapter">Running on alternative Python implementations</a></p>
<h4>Next topic</h4>
<p class="topless"><a href="changelog.html"
title="next chapter">Change Log</a></p>
<div id="searchbox" style="display: none">
<h3>Quick search</h3>
<form class="search" action="search.html" method="get">
<input type="text" name="q" />
<input type="submit" value="Go" />
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
<p class="searchtip" style="font-size: 90%">
Enter search terms or a module, class or function name.
</p>
</div>
<script type="text/javascript">$('#searchbox').show(0);</script>
</div>
</div>
<div class="clearer"></div>
</div>
<div class="related">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="genindex.html" title="General Index"
>index</a></li>
<li class="right" >
<a href="changelog.html" title="Change Log"
>next</a> |</li>
<li class="right" >
<a href="alternative.html" title="Running on alternative Python implementations"
>previous</a> |</li>
<li><a href="index.html">Pyro 4.21 documentation</a> »</li>
</ul>
</div>
<div class="footer">
© Copyright Irmen de Jong.
Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.1.3.
</div>
</body>
</html>
