|
Server : Apache/2.2.17 (Unix) mod_ssl/2.2.17 OpenSSL/0.9.8e-fips-rhel5 DAV/2 PHP/5.2.17 System : Linux localhost 2.6.18-419.el5 #1 SMP Fri Feb 24 22:47:42 UTC 2017 x86_64 User : nobody ( 99) PHP Version : 5.2.17 Disable Function : NONE Directory : /usr/share/gtk-doc/html/bonobo-activation/ |
Upload File : |
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<title>Bonobo Activation tutorial</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.69.1">
<link rel="start" href="index.html" title="Bonobo Activation API Reference Manual">
<link rel="up" href="index.html" title="Bonobo Activation API Reference Manual">
<link rel="prev" href="index.html" title="Bonobo Activation API Reference Manual">
<link rel="next" href="checklist.html" title="Checklist">
<meta name="generator" content="GTK-Doc V1.7 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
<link rel="chapter" href="tutorial.html" title="Bonobo Activation tutorial">
<link rel="chapter" href="configuring.html" title="Configuring Bonobo Activation">
<link rel="chapter" href="architecture.html" title="Bonobo Activation Architecture">
<link rel="chapter" href="query-langage.html" title="Bonobo Activation Query Langage">
<link rel="chapter" href="server-xml-reference.html" title=".server file format reference">
<link rel="chapter" href="migrating.html" title="Migrating from gnorba to Bonobo-activation">
<link rel="chapter" href="api-reference.html" title="API Reference">
<link rel="article" href="lgpl.html" title="GNU Lesser General Public License">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle">
<td><a accesskey="p" href="index.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
<td> </td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
<th width="100%" align="center">Bonobo Activation API Reference Manual</th>
<td><a accesskey="n" href="checklist.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
</tr></table>
<div class="chapter" lang="en">
<div class="titlepage"><div><div><h2 class="title">
<a name="tutorial"></a>Bonobo Activation tutorial</h2></div></div></div>
<div class="toc"><dl>
<dt><span class="sect1"><a href="tutorial.html#id2957996">What is Bonobo Activation ?</a></span></dt>
<dd><dl>
<dt><span class="sect2"><a href="tutorial.html#id2927325">The need for a replacement</a></span></dt>
<dt><span class="sect2"><a href="tutorial.html#id2922266">Getting started</a></span></dt>
</dl></dd>
<dt><span class="sect1"><a href="checklist.html">Checklist</a></span></dt>
<dd><dl><dt><span class="sect2"><a href="checklist.html#id2966976">The non-local case</a></span></dt></dl></dd>
</dl></div>
<div class="sect1" lang="en">
<div class="titlepage"><div><div><h2 class="title" style="clear: both">
<a name="id2957996"></a>What is Bonobo Activation ?</h2></div></div></div>
<p>
Bonobo Activation (originally named OAF) was designed as a replacement for the limited libgnorba library used
in older GNOME released. bonobo-activation is responsible on GNOME 2.x systems for
the activation of CORBA objects. bonobo-activation allows you to browse the available
CORBA servers on your system (running or not). It keeps track of the running
servers so that if you ask for a server which is already running, you will not
start it again but will reuse the already running one.
</p>
<div class="sect2" lang="en">
<div class="titlepage"><div><div><h3 class="title">
<a name="id2927325"></a>The need for a replacement</h3></div></div></div>
<p>
Gnorba works well in a limited number of cases and suffers of a
number of design issues. More specifically:
</p>
<div class="itemizedlist"><ul type="disc">
<li><p>
It cannot handle the non-local case gracefully. ie: you cannot start
a remote CORBA server with bonobo-activation.
</p></li>
<li><p>
It uses <span class="emphasis"><em>evil</em></span> hacks to keep track of the system's CosNaming
service making it unusable on systems where an X server is not running.
(for details, read bonobo-activation code ;-)
</p></li>
<li><p>
bonobo-activation allows you to only request specific servers by their name: you cannot ask
for a server which provides a specific service. You have to ask for a server which
you know provides a specific service.
</p></li>
</ul></div>
<p>
</p>
<p>
Bonobo Activation was designed to address these issues. The remote issue is completely solved
by the Bonobo Activation daemon (see <a href="architecture.html" title="Bonobo Activation Architecture"><i>Bonobo Activation Architecture</i></a>), the evil hacks regarding X are
part of our past and the grand <span class="emphasis"><em>OAF query langage</em></span> (see
<a href="query-langage.html" title="Bonobo Activation Query Langage"><i>Bonobo Activation Query Langage</i></a>) gives you the ability to perform arbitrary queries
on the database of CORBA servers.
</p>
<p>
Basically, Bonobo Activation keeps track of all the CORBA servers installed on your machine and
can track any other machine's CORBA servers provided you set up Bonobo Activation correctly and
allows you to perform queries on the properties of these servers.
The following very simple example will make things rather clear:
</p>
<pre class="programlisting">
CORBA_Object o = bonobo_activation_activate ("repo_ids.has ('IDL:GNOME/Graph/Layout:1.0')",
NULL, 0, NULL, &ev);
</pre>
<p>
This will ask for a component which supports the GNOME/Graph/Layout:1.0 interface.
You can also do much more complicated things. Bonobo Activation will find one whcih matches the
query and will take all the necessary measures required to get the server running
(if it is a shared library progam, it will load the relevant library in memory.
If you need a Factory, it will launch the factory and request the factory to create
the relevant object).
</p>
</div>
<div class="sect2" lang="en">
<div class="titlepage"><div><div><h3 class="title">
<a name="id2922266"></a>Getting started</h3></div></div></div>
<p>
Here follows a very simple-stupid example of what you can do with Bonobo Activation.
The complete API description of bonobo activation, the Bonobo Activation query langage reference and the
<code class="filename">.server</code> file format reference are included in this
document and are recommended readings. Reading <a href="architecture.html" title="Bonobo Activation Architecture"><i>Bonobo Activation Architecture</i></a> is
also a good idea.
</p>
</div>
</div>
</div>
</body>
</html>