source: trunk/doc/src/frameworks-technologies/dbus-adaptors.qdoc@ 561

Last change on this file since 561 was 561, checked in by Dmitry A. Kuminov, 15 years ago

trunk: Merged in qt 4.6.1 sources.

  • Property svn:eol-style set to native
File size: 20.7 KB
Line 
1/****************************************************************************
2**
3** Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies).
4** All rights reserved.
5** Contact: Nokia Corporation ([email protected])
6**
7** This file is part of the documentation of the Qt Toolkit.
8**
9** $QT_BEGIN_LICENSE:LGPL$
10** Commercial Usage
11** Licensees holding valid Qt Commercial licenses may use this file in
12** accordance with the Qt Commercial License Agreement provided with the
13** Software or, alternatively, in accordance with the terms contained in
14** a written agreement between you and Nokia.
15**
16** GNU Lesser General Public License Usage
17** Alternatively, this file may be used under the terms of the GNU Lesser
18** General Public License version 2.1 as published by the Free Software
19** Foundation and appearing in the file LICENSE.LGPL included in the
20** packaging of this file. Please review the following information to
21** ensure the GNU Lesser General Public License version 2.1 requirements
22** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
23**
24** In addition, as a special exception, Nokia gives you certain additional
25** rights. These rights are described in the Nokia Qt LGPL Exception
26** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
27**
28** GNU General Public License Usage
29** Alternatively, this file may be used under the terms of the GNU
30** General Public License version 3.0 as published by the Free Software
31** Foundation and appearing in the file LICENSE.GPL included in the
32** packaging of this file. Please review the following information to
33** ensure the GNU General Public License version 3.0 requirements will be
34** met: http://www.gnu.org/copyleft/gpl.html.
35**
36** If you have questions regarding the use of this file, please contact
37** Nokia at [email protected].
38** $QT_END_LICENSE$
39**
40****************************************************************************/
41
42/*!
43 \page usingadaptors.html
44 \title Using QtDBus Adaptors
45
46 \ingroup best-practices
47
48 Adaptors are special classes that are attached to any QObject-derived class
49 and provide the interface to the external world using D-Bus. Adaptors are
50 intended to be lightweight classes whose main purpose is to relay calls to
51 and from the real object, possibly validating or converting the input from
52 the external world and, thus, protecting the real object.
53
54 Unlike multiple inheritance, adaptors can be added at any time to any object
55 (but not removed), which allows for greater flexibility when exporting
56 existing classes. Another advantage of adaptors is to provide similar but not
57 identical functionality in methods of the same name in different interfaces,
58 a case which can be quite common when adding a new version of a standard
59 interface to an object.
60
61 In order to use an adaptor, one must create a class which inherits
62 QDBusAbstractAdaptor. Since that is a standard QObject-derived class, the
63 Q_OBJECT macro must appear in the declaration and the source file must be