1// Copyright (C) 2016 The Qt Company Ltd.
2// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR LGPL-3.0-only OR GPL-2.0-only OR GPL-3.0-only
3
4#ifndef QDBUSABSTRACTINTERFACE_H
5#define QDBUSABSTRACTINTERFACE_H
6
7#include <QtDBus/qtdbusglobal.h>
8#include <QtCore/qstring.h>
9#include <QtCore/qvariant.h>
10#include <QtCore/qlist.h>
11#include <QtCore/qobject.h>
12
13#include <QtDBus/qdbusmessage.h>
14#include <QtDBus/qdbusextratypes.h>
15#include <QtDBus/qdbusconnection.h>
16#include <QtDBus/qdbuspendingcall.h>
17
18#ifdef interface
19#undef interface
20#endif
21
22#ifndef QT_NO_DBUS
23
24QT_BEGIN_NAMESPACE
25
26
27class QDBusError;
28class QDBusPendingCall;
29
30class QDBusAbstractInterfacePrivate;
31
32class Q_DBUS_EXPORT QDBusAbstractInterfaceBase: public QObject
33{
34public:
35 int qt_metacall(QMetaObject::Call, int, void**) override;
36protected:
37 QDBusAbstractInterfaceBase(QDBusAbstractInterfacePrivate &dd, QObject *parent);
38private:
39 Q_DECLARE_PRIVATE(QDBusAbstractInterface)
40};
41
42class Q_DBUS_EXPORT QDBusAbstractInterface:
43#ifdef Q_QDOC
44 public QObject
45#else
46 public QDBusAbstractInterfaceBase
47#endif
48{
49 Q_OBJECT
50
51public:
52 virtual ~QDBusAbstractInterface();
53 bool isValid() const;
54
55 QDBusConnection connection() const;
56
57 QString service() const;
58 QString path() const;
59 QString interface() const;
60
61 QDBusError lastError() const;
62
63 void setTimeout(int timeout);
64 int timeout() const;
65
66 void setInteractiveAuthorizationAllowed(bool enable);
67 bool isInteractiveAuthorizationAllowed() const;
68
69 QDBusMessage call(const QString &method)
70 {
71 return doCall(mode: QDBus::AutoDetect, method, args: nullptr, numArgs: 0);
72 }
73
74 template <typename...Args>
75 QDBusMessage call(const QString &method, Args &&...args)
76 {
77 const QVariant variants[] = { QVariant(std::forward<Args>(args))... };
78 return doCall(mode: QDBus::AutoDetect, method, args: variants, numArgs: sizeof...(args));
79 }
80
81 QDBusMessage call(QDBus::CallMode mode, const QString &method)
82 {
83 return doCall(mode, method, args: nullptr, numArgs: 0);
84 }
85
86 template <typename...Args>
87 QDBusMessage call(QDBus::CallMode mode, const QString &method, Args &&...args)
88 {
89 const QVariant variants[] = { QVariant(std::forward<Args>(args))... };
90 return doCall(mode, method, args: variants, numArgs: sizeof...(args));
91 }
92
93 QDBusMessage callWithArgumentList(QDBus::CallMode mode,
94 const QString &method,
95 const QList<QVariant> &args);
96
97 bool callWithCallback(const QString &method,
98 const QList<QVariant> &args,
99 QObject *receiver, const char *member, const char *errorSlot);
100 bool callWithCallback(const QString &method,
101 const QList<QVariant> &args,
102 QObject *receiver, const char *member);
103
104 QDBusPendingCall asyncCall(const QString &method)
105 {
106 return doAsyncCall(method, args: nullptr, numArgs: 0);
107 }
108
109 template <typename...Args>
110 QDBusPendingCall asyncCall(const QString &method, Args&&...args)
111 {
112 const QVariant variants[] = { QVariant(std::forward<Args>(args))... };
113 return doAsyncCall(method, args: variants, numArgs: sizeof...(args));
114 }
115
116 QDBusPendingCall asyncCallWithArgumentList(const QString &method,
117 const QList<QVariant> &args);
118
119protected:
120 QDBusAbstractInterface(const QString &service, const QString &path, const char *interface,
121 const QDBusConnection &connection, QObject *parent);
122 QDBusAbstractInterface(QDBusAbstractInterfacePrivate &, QObject *parent);
123
124 void connectNotify(const QMetaMethod &signal) override;
125 void disconnectNotify(const QMetaMethod &signal) override;
126 QVariant internalPropGet(const char *propname) const;
127 void internalPropSet(const char *propname, const QVariant &value);
128 QDBusMessage internalConstCall(QDBus::CallMode mode,
129 const QString &method,
130 const QList<QVariant> &args = QList<QVariant>()) const;
131
132private:
133 QDBusMessage doCall(QDBus::CallMode mode, const QString &method, const QVariant *args, size_t numArgs);
134 QDBusPendingCall doAsyncCall(const QString &method, const QVariant *args, size_t numArgs);
135
136private:
137 Q_DECLARE_PRIVATE(QDBusAbstractInterface)
138 Q_PRIVATE_SLOT(d_func(), void _q_serviceOwnerChanged(QString,QString,QString))
139};
140
141QT_END_NAMESPACE
142
143#endif // QT_NO_DBUS
144#endif
145

source code of qtbase/src/dbus/qdbusabstractinterface.h