File: //usr/share/gtk-doc/html/bonobo-activation/async-activation.html
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<title>Async Activation</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="architecture.html" title="Bonobo Activation Architecture">
<link rel="prev" href="server-arch.html" title="Server architecture">
<link rel="next" href="query-langage.html" title="Bonobo Activation Query Langage">
<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="server-arch.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
<td><a accesskey="u" href="architecture.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></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="query-langage.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
</tr></table>
<div class="sect1" lang="en">
<div class="titlepage"><div><div><h2 class="title" style="clear: both">
<a name="async-activation"></a>Async Activation</h2></div></div></div>
<p>
Bonobo Activation also has a set of asynchronous activation interfaces so that you do not need to block
on activation calls. The CORBA level is pretty simple: the activation context has a set of
<code class="function">_async</code> calls: <code class="function">OAF_ACtivationContext_activate_async</code>
and <code class="function">OAF_ACtivationContext_activate_from_id_async</code>. Both of those calls
take an OAFActivationCallback CORBA object as parameter. This object, which is supposed to
be implemented by client applications (it is actually implemented in liboaf) will receive
CORBA calls when the activation is finished:
</p>
<pre class="programlisting">
module OAF {
interface ActivationCallback {
oneway void report_activation_failed (in string reason);
oneway void report_activation_succeeded (in ActivationResult result);
};
};
</pre>
<p>
</p>
<p>
Of course, libbonobo-activation provides comvenient wrappers for those CORBA functions. Those are named
<code class="function">bonobo_activation_activate_async</code> and
<code class="function">bonobo_activation_activate_from_id_async</code>.
</p>
</div>
</body>
</html>