You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
tdebindings/xparts/doc/xparts.html

294 lines
14 KiB

<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML//EN">
<html>
<head>
<title>XParts - Extending KParts</title>
</head>
<body>
<center>
<h1>XParts - Extending KParts</h1>
<small>Matthias Ettrich, Simon Hausmann, Lars Knoll</small>
</center>
<p>This article briefly describe the concepts, architecture and
reasoning behind the XParts technology. The purpose of XParts is
to extend KParts over language, toolkit, process and machine
bounderies. XParts makes it possible to write KDE components with
almost any toolkit or language an author prefers or to turn
existing applications into KDE components quite easily.
<p>In addition, XParts is also an important glueing technology to
make KParts available in other component based systems or to
utilize non-KPart components transparently as KParts.
<h4>Classic KParts</h4>
<p>In order to understand, what is extending about XParts, first a
brief overview on how KParts work.
<img src="tdeparts.png">
<p>Imagine an application - for example the integrated file manager
"Konqueror" - wants to utilize a component that handles the
"text/html" mimetype. It therefore asks the trader of the TDEIO
subsystem whether such a service is available and where. The
trader uses the system configuration cache to localize an
appropriate service that fits with the user's preferences. The
system configuration cache is a service type database
constructed from the desktop files of a KDE setup. In the case
of "text/html", the trader will very like return KDE's builtin
HTML viewer dubbed KHtml. This viewer is is most certainly
available as a KPart component. The application will then - via
KLibLoader and KLibFactory - load the shared library object that
implements the component and create a KPart instance. The
LibLoader keeps track of any objects created in the loaded
library and will automatically unload it after all objects have
been deleted.
<p>If the application does not only want to display HTML, but
act as a full featured browser, the plain KPart interface is not
sufficient. If the user clicks on a link, for example, the HTML
component has to request a new URL. This kind of interaction is
defined in the BrowserExtension interface. An application can
query the KParts for additonal interfaces and get handles to
them in case those are available. In the example case of KHtml,
the BrowserExtension interface is exported. In the case of a
text editor component, it's very likely that the TextEditor
interface is available.
<h4>In-process components</h4>
<p>The beauty of KParts is its simplicity. It's a clean and
flexible in-process approach with all its advantages:
<ul>
<li> lightweight - components share the same application
context and all its allocated resources.
<li> synchronious - calls are predictable, there are no
timeouts to wait for and no events to process in an uncertain
amount of time.
<li> stable - neither race conditions nor rare exceptions
can occur
<li> extremely powerful - there are virtually no
limitations to how a component API can look like (including
passing pointers) or what a plugin can do with an application.
</ul>
<p>Those advantages are unvaluable for a lightweight and tightly
integrated office suite like KOffice. However, there are no silver
bullets and most certainly there are drawbacks when the system is
used in settings with different requirements.
<p>Take the fourth item, it's comprehensive power while
maintaining simplicity. This was one of the main requirements of
the KOffice team, and it alone almost determines an in-process
approach with dynamically loadable shared objects. In a generic
browser like Konqueror, the requirements for integrated components
are not as high as with an office suite. In an office suite,
different components operate on one single document, whereas in a
browser, the components basically provide different views for
given Urls. To illustrate this issue, imagine how far the web
came with such primitive and inflexible component technology like
Netscape plugins. They did most of what people wanted to do with
browser plugins, though, and so became a huge success.
<h4>Out-of-process components</h4>
<p>To sum this up: for multi-view applications like a generic
browser, there's no technical argument why out-of-process
components could not be sufficient. So let's look closer at the
specific advantages of such a solution.
<ul>
<li>With out-of-process components, it's much easier to provide
applications as components that do not support being loaded
dynamically as shared library objects. Typical examples are
programs written in interpreted languages. With a pure in-process
model, one would have to be able to load the interpreter as
embedded language.
<li>If a component handles the event loop differently from the
embedding application, an complete event loop merger is
required. This glueing code can be tricky and might not work well
in all cases. It's much easier for out-of-process components to
provide full toolkit independence.
<li> components of the same type could share one process
context. Not sure where this is actually useful, but it has most
certainly some technical beauty attached to it.
</ul>
<p>Let's pick a concrete example. Imagine that you - for whatever
reason - want to offer the Mozilla rendering engine (gecko) as
KPart, so that users have an an alternative to KDE's builtin
rendering engine KHtml.
<p>The first step of such a project is to find out, whether
Mozilla already is available as a reusable component that could
form the basis of a KDE integration. And in fact, it is. A small
library called GtkMozEmbed makes it possible to load the entire
Mozilla as a single Gtk widget, i.e. the rendering engine gecko,
the networking protocol implementations, the javascript
interpreter and whatever else Mozilla.org comes up with. The
MozEmbed library works pretty similar to KParts. Once
instantiated, it dynamically loads all libraries required by
Mozilla. As an interesting side note, all Unix filemanager
projects that utilize Mozilla (for example the Nautilus
filemanager) use this library to embed mozilla. This means you are
in good company using a stock MozEmbed library, as you don't have
to maintain this code but somebody else will do it for you.
<p>Now that we have a dynamically loaded Gtk widget, how do we
turn that into a KPart? Quite straight forward. There is a
TQGtkWidget extension available for Qt, that lets you use Gtk
widgets in your Qt applications. You simply create a TQGtkWidget
with a pointer to the Gtk widget you get from MozEmbed and insert
that into your KPart. Then you do a few trivial reimplementations
of the virtual functions of the BrowserExtension interface that
map to the corresponding functions of Mozilla and you are
done. The result is a fully functional Konqueror that uses Mozilla
as backend - or rather a fully functional Mozilla that uses
Konqueror as graphical user interface, however you want to look at
it.
<h4>Trouble ahead</h4>
<p> While the skedged solution works, there are some unmentioned
and ugly details. First of all, Mozilla uses the event loop of
glib, while Konqueror uses Qt. Unfortunatly, mixing both event
loops is not possible with the current release of glib, unless one
want to end up with an application that constantly requires some
CPU to run, even when being idle. While this seems to be ok for
today's Java virtual machines, it's not acceptable by KDE's
quality standards. Until glib 2.0 is released, you need to patch
glib in order to make the TQGtkWidget work properly. No big deal
for most Linux users, still a hassle. And keep in mind that glib
is a fairly open system. If the component was written in some
other toolkit, it might be possible that glueing code is
impossible to get right, without wasting at least a bit of CPU.
<p>The second problem is Mozilla's size. It's by no means an
ordinary component. In fact, it's a magnitude larger than the
Konqueror framework. And since Mozilla and Konqueror do not share
the same graphics toolkit, the toolkit's size has to be added to
that. It seems odd to load and unload such a huge amount of code -
and it can to lead to all kind of problems when trying to unload
it again.
<p>To make things worse, Mozilla wasn't even released as final
version yet. While it is already quite usable, it's stability is
still far from being production quality. This doesn't matter too
much for a standalone browser, but can really hurt with a
component. A standalone browser usually is supposed to display one
web page. If it crashes, this page is gone, so the user simply
tries again. With a generic browser like Konqueror, there is not
just one component active at a time, but several. There might be
some directory views, an embedded console, another toplevel window
window, an imaged preview and much more. A crashing Mozilla would
take all those component with it - and leave the user with only
half of its prior desktop.
<p>Imagine that some users define Mozilla to be the primary
component to handle text/html in Konqueror. After some testing, all
works well and they continue using it. A couple of days later, they
might have forgotten the configuration change they did. Whenever
they now hit a web page where Mozilla crashes, they will blame
Konqueror. This we don't want. No code is perfect, but if a crash
occurs in our code, at least it's our crash. That means, we can fix
it and we can provide newer versions.
<p>Thus, from a maintainance and support point of you, it is not
acceptable for KDE to run code inprocess that is not actually
maintained or controlled by the team, at least not in the default
setup.
<h4>Out-of-process components</h4>
<p>For the given reasons, it makes a lot of sense to extend KParts
over process bounderies. In addition, we also win a high degree of
toolkit and language independency.
<p>To make this work, we have to identify the streamable parts of
the KParts interface and offer them via some kind of middleware.
<p>We chose KDE's native desktop middleware, the desktop
communication protocol (DCOP) to establish the communication. In
addition to the fact that DCOP was explicitely designed for these
kind of tasks, there are some more benefits:
<ul>
<li> DCOP runs already on the desktop, i.e. there are no additonal costs
in terms of resource consumption.
<li> Does not put any limitations onto the interfaces as long as
data types are streamable
<li> Server architecture makes it easy and robust to detect
crashes on either side.
</ul>
There are several DCOP implementations available. The reference
implementation is the one using C++ and Qt that is used in KDE
applications. For Mozilla, we would choose a plain ANSI-C
implementation that uses glib.
<p>The following picture shows the interface structure:
<p> <img src="xparts.png">
<p>The main thing that differs from KParts is the
<em>XPartHost</em> interface that is responsible for embedding a
part. The missing link now is a standard KPart component that
implements the <em>XPartHost</em> interface. Via this
<b>KXPartHost</b> component, it is possible to use any XPart
transparently as KPart without changing a single line of code:
<p>
<img src="kxparthost.png">
<p>On the other side of the fence, we need an implementation of
the <em>XPartManager</em> interface and can serve us with
<em>XPart</em> interfaces. We provide this through the
relatively highlevel and generic classes GtkXPartManger and
GtkXPart, as shown in the next picture:
<p>
<img src="gtkxpart.png">
<p> The GtkXPart is a standard Gtk widget that can have a MozEmbed
widget as child widget. The only code that is necessary to write
is the code used to connect the <em>BrowserExtension</em>
interface to the corresponding functions of Mozilla.
<h4>External KParts</h4>
<p>The same technique can now be used to utilize standard KPart
components in an out-of-process fashion via the XPart system. All
we need is a KXPartManager that wraps standard KParts in
KXParts. The KXParts then export the <em>XPart</em> interface. The
complete structure is shown in the next picture:
<p><img src="kxpart.png">
<h4>Conclusion</h4> <p> Although the implementation of the
external mozilla part is more a proof of concept than a finished
xpart, we have shown a clean way to realize out of process
components on top of KParts. It could also be shown that this
approach is both language and toolkit independent.
<p>To accomplish this task, not a <em>single</em> line of code
in konqueror had to be changed. All we did was providing yet
another independent KPart component.
<p>By writing a small wrapper it is possible to embed any kind of
visual component. In addition, we can provide generic wrappers for
any kind of visual component model, as long as those models are
powerful enough to describe their interfaces and GUI requirements
at runtime. This includes KParts (eg. KOffice components), Bonobo
components (like the Nautilus MP3 viewer) and Uno components
provided by OpenOffice (formerly known as StarOffice).
<hr>
<address><a href="mailto:ettrich@kde.org">Matthias Ettrich</a></address>
<address><a href="mailto:hausmann@kde.org">Simon Hausmann</a></address>
<address><a href="mailto:knoll@kde.org">Lars Knoll</a></address>
<!-- Created: Tue Oct 17 18:08:25 CEST 2000 -->
<!-- hhmts start -->
Last modified: Tue Apr 3 20:39:13 CEST 2001
<!-- hhmts end -->
</body>
</html>