| Home · All Classes · All Namespaces · Modules · Functions · Files

# dbus-proxy-factory.h

    00001 /*
    00002  * This file is part of TelepathyQt4
    00003  *
    00004  * Copyright (C) 2010 Collabora Ltd. <http://www.collabora.co.uk/>
    00005  * Copyright (C) 2010 Nokia Corporation
    00006  *
    00007  * This library is free software; you can redistribute it and/or
    00008  * modify it under the terms of the GNU Lesser General Public
    00009  * License as published by the Free Software Foundation; either
    00010  * version 2.1 of the License, or (at your option) any later version.
    00011  *
    00012  * This library is distributed in the hope that it will be useful,
    00013  * but WITHOUT ANY WARRANTY; without even the implied warranty of
    00014  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
    00015  * Lesser General Public License for more details.
    00016  *
    00017  * You should have received a copy of the GNU Lesser General Public
    00018  * License along with this library; if not, write to the Free Software
    00019  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
    00020  */
    00021
    00022 #ifndef _TelepathyQt4_dbus_proxy_factory_h_HEADER_GUARD_
    00023 #define _TelepathyQt4_dbus_proxy_factory_h_HEADER_GUARD_
    00024
    00025 #ifndef IN_TELEPATHY_QT4_HEADER
    00026 #error IN_TELEPATHY_QT4_HEADER
    00027 #endif
    00028
    00029 #include <TelepathyQt4/Global>
    00030 #include <TelepathyQt4/SharedPtr>
    00031 #include <TelepathyQt4/Types>
    00032
    00033 // For Q_DISABLE_COPY
    00034 #include <QtGlobal>
    00035
    00036 #include <QString>
    00037
    00038 class QDBusConnection;
    00039
    00040 namespace Tp
    00041 {
    00042
    00043 class Features;
    00044 class PendingReady;
    00045 class PendingOperation;
    00046
    00047 class TELEPATHY_QT4_EXPORT DBusProxyFactory : public RefCounted
    00048 {
    00049     Q_DISABLE_COPY(DBusProxyFactory)
    00050
    00051 public:
    00052     virtual ~DBusProxyFactory();
    00053
    00054     const QDBusConnection &dbusConnection() const;
    00055
    00056 protected:
    00057     DBusProxyFactory(const QDBusConnection &bus);
    00058
    00059     // API/ABI break TODO: Make DBusProxy be a RefCounted so this can be SharedPtr<DBusProxy>
    00060     // If we don't want DBusProxy itself be a RefCounted, let's add RefCountedDBusProxy or something
    00061     // as an intermediate subclass?
    00062     SharedPtr<RefCounted> cachedProxy(const QString &busName, const QString &objectPath) const;
    00063
    00064     PendingReady *nowHaveProxy(const SharedPtr<RefCounted> &proxy) const;
    00065
    00066     // I don't want this to be non-pure virtual, because I want ALL subclasses to have to think
    00067     // about whether or not they need to uniquefy the name or not. If a subclass doesn't implement
    00068     // this while it should, matching with the cache for future requests and invalidation breaks.
    00069     virtual QString finalBusNameFrom(const QString &uniqueOrWellKnown) const = 0;
    00070
    00071     virtual PendingOperation *initialPrepare(const SharedPtr<RefCounted> &proxy) const;
    00072     virtual PendingOperation *readyPrepare(const SharedPtr<RefCounted> &proxy) const;
    00073
    00074     virtual Features featuresFor(const SharedPtr<RefCounted> &proxy) const = 0;
    00075
    00076 private:
    00077     class Cache;
    00078
    00079     struct Private;
    00080     friend struct Private;
    00081     Private *mPriv;
    00082 };
    00083
    00084 } // Tp
    00085
    00086 #endif