00001
00002
00003
00004
00005
00006
00007
00008
00009
00010
00011
00012
00013
00014
00015
00016
00017
00018
00019
00020
00021
00022 #ifndef _TelepathyQt4_cli_connection_manager_h_HEADER_GUARD_
00023 #define _TelepathyQt4_cli_connection_manager_h_HEADER_GUARD_
00024
00025 #ifndef IN_TELEPATHY_QT4_HEADER
00026 #error IN_TELEPATHY_QT4_HEADER
00027 #endif
00028
00029 #include <TelepathyQt4/_gen/cli-connection-manager.h>
00030
00031 #include <TelepathyQt4/Client/DBus>
00032 #include <TelepathyQt4/Client/DBusProxy>
00033 #include <TelepathyQt4/Client/OptionalInterfaceFactory>
00034 #include <TelepathyQt4/Client/ReadinessHelper>
00035 #include <TelepathyQt4/Client/ReadyObject>
00036 #include <TelepathyQt4/Constants>
00037
00038 #include <QExplicitlySharedDataPointer>
00039 #include <QSet>
00040 #include <QSharedData>
00041
00042 namespace Telepathy
00043 {
00044 namespace Client
00045 {
00046
00047 class PendingConnection;
00048 class PendingReady;
00049 class PendingStringList;
00050 class ProtocolParameter;
00051 class ProtocolInfo;
00052
00053 typedef QList<ProtocolParameter*> ProtocolParameterList;
00054 typedef QList<ProtocolInfo*> ProtocolInfoList;
00055
00056 class ProtocolParameter
00057 {
00058 public:
00059 ProtocolParameter(const QString &name,
00060 const QDBusSignature &dbusSignature,
00061 QVariant defaultValue,
00062 Telepathy::ConnMgrParamFlag flags);
00063 ~ProtocolParameter();
00064
00065 QString name() const { return mName; }
00066 QDBusSignature dbusSignature() const { return mDBusSignature; }
00067 QVariant::Type type() const { return mType; }
00068 QVariant defaultValue() const { return mDefaultValue; }
00069
00070 bool isRequired() const;
00071 bool isSecret() const;
00072 bool requiredForRegistration() const;
00073
00074 bool operator==(const ProtocolParameter &other) const;
00075 bool operator==(const QString &name) const;
00076
00077 private:
00078 Q_DISABLE_COPY(ProtocolParameter);
00079
00080 struct Private;
00081 friend struct Private;
00082 Private *mPriv;
00083 QString mName;
00084 QDBusSignature mDBusSignature;
00085 QVariant::Type mType;
00086 QVariant mDefaultValue;
00087 Telepathy::ConnMgrParamFlag mFlags;
00088 };
00089
00090
00091 class ProtocolInfo
00092 {
00093 public:
00094 ~ProtocolInfo();
00095
00096 QString cmName() const { return mCmName; }
00097
00098 QString name() const { return mName; }
00099
00100 const ProtocolParameterList ¶meters() const;
00101 bool hasParameter(const QString &name) const;
00102
00103 bool canRegister() const;
00104
00105 private:
00106 Q_DISABLE_COPY(ProtocolInfo);
00107
00108 ProtocolInfo(const QString &cmName, const QString &name);
00109
00110 void addParameter(const ParamSpec &spec);
00111
00112 class Private;
00113 friend class Private;
00114 friend class ConnectionManager;
00115 Private *mPriv;
00116 QString mCmName;
00117 QString mName;
00118 };
00119
00120
00121 class ConnectionManager : public StatelessDBusProxy,
00122 private OptionalInterfaceFactory<ConnectionManager>,
00123 public ReadyObject,
00124 public QSharedData
00125 {
00126 Q_OBJECT
00127
00128 public:
00129 static const Feature FeatureCore;
00130
00131 ConnectionManager(const QString &name, QObject *parent = 0);
00132 ConnectionManager(const QDBusConnection &bus,
00133 const QString &name, QObject *parent = 0);
00134
00135 virtual ~ConnectionManager();
00136
00137 QString name() const;
00138
00139 QStringList interfaces() const;
00140
00141 QStringList supportedProtocols() const;
00142 const ProtocolInfoList &protocols() const;
00143
00144 PendingConnection *requestConnection(const QString &protocol,
00145 const QVariantMap ¶meters);
00146
00147 inline DBus::PropertiesInterface *propertiesInterface() const
00148 {
00149 return OptionalInterfaceFactory<ConnectionManager>::interface<DBus::PropertiesInterface>();
00150 }
00151
00152 static PendingStringList *listNames(const QDBusConnection &bus = QDBusConnection::sessionBus());
00153
00154 protected:
00155 ConnectionManagerInterface *baseInterface() const;
00156
00157 private Q_SLOTS:
00158 void gotMainProperties(QDBusPendingCallWatcher *);
00159 void gotProtocols(QDBusPendingCallWatcher *);
00160 void gotParameters(QDBusPendingCallWatcher *);
00161
00162 private:
00163 Q_DISABLE_COPY(ConnectionManager);
00164
00165 struct Private;
00166 friend struct Private;
00167 friend class PendingConnection;
00168 Private *mPriv;
00169 };
00170
00171 typedef QExplicitlySharedDataPointer<ConnectionManager> ConnectionManagerPtr;
00172
00173 }
00174 }
00175
00176 #endif