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/Constants>
00035
00036 #include <QSet>
00037
00038 namespace Telepathy
00039 {
00040 namespace Client
00041 {
00042
00043 class PendingConnection;
00044 class PendingReady;
00045 class PendingStringList;
00046 class ProtocolParameter;
00047 class ProtocolInfo;
00048
00049 typedef QList<ProtocolParameter*> ProtocolParameterList;
00050 typedef QList<ProtocolInfo*> ProtocolInfoList;
00051
00052 class ProtocolParameter
00053 {
00054 public:
00055 ProtocolParameter(const QString &name,
00056 const QDBusSignature &dbusSignature,
00057 QVariant defaultValue,
00058 Telepathy::ConnMgrParamFlag flags);
00059 ~ProtocolParameter();
00060
00061 QString name() const { return mName; }
00062 QDBusSignature dbusSignature() const { return mDBusSignature; }
00063 QVariant::Type type() const { return mType; }
00064 QVariant defaultValue() const { return mDefaultValue; }
00065
00066 bool isRequired() const;
00067 bool isSecret() const;
00068 bool requiredForRegistration() const;
00069
00070 bool operator==(const ProtocolParameter &other) const;
00071 bool operator==(const QString &name) const;
00072
00073 private:
00074 Q_DISABLE_COPY(ProtocolParameter);
00075
00076 struct Private;
00077 friend struct Private;
00078 Private *mPriv;
00079 QString mName;
00080 QDBusSignature mDBusSignature;
00081 QVariant::Type mType;
00082 QVariant mDefaultValue;
00083 Telepathy::ConnMgrParamFlag mFlags;
00084 };
00085
00086
00087 class ProtocolInfo
00088 {
00089 public:
00090 ~ProtocolInfo();
00091
00092 QString cmName() const { return mCmName; }
00093
00094 QString name() const { return mName; }
00095
00096 const ProtocolParameterList ¶meters() const;
00097 bool hasParameter(const QString &name) const;
00098
00099 bool canRegister() const;
00100
00101 private:
00102 Q_DISABLE_COPY(ProtocolInfo);
00103
00104 ProtocolInfo(const QString &cmName, const QString &name);
00105
00106 void addParameter(const ParamSpec &spec);
00107
00108 class Private;
00109 friend class Private;
00110 friend class ConnectionManager;
00111 Private *mPriv;
00112 QString mCmName;
00113 QString mName;
00114 };
00115
00116
00117 class ConnectionManager : public StatelessDBusProxy,
00118 private OptionalInterfaceFactory<ConnectionManager>
00119 {
00120 Q_OBJECT
00121
00122 public:
00123 enum Feature {
00124 FeatureCore = 0,
00125 _Padding = 0xFFFFFFFF
00126 };
00127 Q_DECLARE_FLAGS(Features, Feature)
00128
00129 ConnectionManager(const QString &name, QObject *parent = 0);
00130 ConnectionManager(const QDBusConnection &bus,
00131 const QString &name, QObject *parent = 0);
00132
00133 virtual ~ConnectionManager();
00134
00135 QString name() const;
00136
00137 QStringList interfaces() const;
00138
00139 QStringList supportedProtocols() const;
00140 const ProtocolInfoList &protocols() const;
00141
00142 PendingConnection *requestConnection(const QString &protocol,
00143 const QVariantMap ¶meters);
00144
00145 inline DBus::PropertiesInterface *propertiesInterface() const
00146 {
00147 return OptionalInterfaceFactory<ConnectionManager>::interface<DBus::PropertiesInterface>();
00148 }
00149
00150 bool isReady(const QSet<uint> &features = QSet<uint>()) const;
00151
00152 PendingReady *becomeReady(const QSet<uint> &requestedFeatures = QSet<uint>());
00153
00154 QSet<uint> requestedFeatures() const;
00155 QSet<uint> actualFeatures() const;
00156 QSet<uint> missingFeatures() const;
00157
00158 static PendingStringList *listNames(const QDBusConnection &bus = QDBusConnection::sessionBus());
00159
00160 protected:
00161 ConnectionManagerInterface *baseInterface() const;
00162
00163 private Q_SLOTS:
00164 void gotMainProperties(QDBusPendingCallWatcher *);
00165 void gotProtocols(QDBusPendingCallWatcher *);
00166 void gotParameters(QDBusPendingCallWatcher *);
00167
00168 private:
00169 Q_DISABLE_COPY(ConnectionManager);
00170
00171 struct Private;
00172 friend struct Private;
00173 friend class PendingConnection;
00174 Private *mPriv;
00175 };
00176
00177 }
00178 }
00179
00180 #endif