first version of the zeroconf lib

allows browsing (detection) of services using dns-sd, i.e. DNS Service Discovery, or Bonjour see http://www.zeroconf.org/ The exposed interface is reentrant and threadsafe Change-Id: I957d69696aa3c8ad625e074389b649b00b9153cf Reviewed-on: http://codereview.qt-project.org/5410 Reviewed-by: Fawzi Mohamed <fawzi.mohamed@nokia.com> Sanity-Review: Qt Sanity Bot <qt_sanity_bot@ovi.com>
2011-09-22 20:48:00 +02:00
parent 3fb9321bd8
commit f25f1858f0
17 changed files with 7905 additions and 1 deletions
--- a/src/libs/zeroconf/servicebrowser.h
+++ b/src/libs/zeroconf/servicebrowser.h
@@ -0,0 +1,141 @@
+/**************************************************************************
+**
+** This file is part of Qt Creator
+**
+** Copyright (c) 2011 Nokia Corporation and/or its subsidiary(-ies).
+**
+** Contact: Nokia Corporation (info@qt.nokia.com)
+**
+**
+** GNU Lesser General Public License Usage
+**
+** This file may be used under the terms of the GNU Lesser General Public
+** License version 2.1 as published by the Free Software Foundation and
+** appearing in the file LICENSE.LGPL included in the packaging of this file.
+** Please review the following information to ensure the GNU Lesser General
+** Public License version 2.1 requirements will be met:
+** http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
+**
+** In addition, as a special exception, Nokia gives you certain additional
+** rights. These rights are described in the Nokia Qt LGPL Exception
+** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
+**
+** Other Usage
+**
+** Alternatively, this file may be used in accordance with the terms and
+** conditions contained in a signed written agreement between you and Nokia.
+**
+** If you have questions regarding the use of this file, please contact
+** Nokia at info@qt.nokia.com.
+**
+**************************************************************************/
+
+#ifndef SERVICEBROWSER_H
+#define SERVICEBROWSER_H
+
+#include "zeroconf_global.h"
+
+#include <QtCore/QHash>
+#include <QtCore/QObject>
+#include <QtCore/QSharedPointer>
+#include <QtCore/QStringList>
+class QHostInfo;
+
+namespace ZeroConf {
+
+namespace Internal {
+class ServiceGatherer;
+class MainConnection;
+class ServiceBrowserPrivate;
+}
+
+typedef QSharedPointer<Internal::MainConnection> MainConnectionPtr;
+
+typedef QHash<QString, QString> ServiceTxtRecord;
+
+class ZEROCONFSHARED_EXPORT Service : public QObject
+{
+    Q_OBJECT
+    friend class Internal::ServiceGatherer;
+
+public:
+    typedef QSharedPointer<const Service> ConstPtr;
+    typedef QSharedPointer<Service> Ptr;
+
+    Service(const Service &o);
+    Service(QObject *parent = 0);
+    ~Service();
+
+    bool outdated() const { return m_outdated; }
+
+    QString name() const { return m_name; }
+    QString type() const { return m_type; }
+    QString domain() const { return m_domain; }
+    QString fullName() const { return m_fullName; }
+    QString port() const { return m_port; }
+    const ServiceTxtRecord &txtRecord() const { return m_txtRecord; }
+    const QHostInfo *host() const { return m_host; }
+    int interfaceNr() const { return m_interfaceNr; }
+
+    bool invalidate() { bool res = m_outdated; m_outdated = true; return res; }
+private:
+    QString m_name;
+    QString m_type;
+    QString m_domain;
+    QString m_fullName;
+    QString m_port;
+    ServiceTxtRecord m_txtRecord;
+    QHostInfo *m_host;
+    int m_interfaceNr;
+    bool m_outdated;
+};
+
+QDebug operator<<(QDebug dbg, const Service &service);
+
+class ZEROCONFSHARED_EXPORT ServiceBrowser : public QObject
+{
+    Q_OBJECT
+    friend class Internal::ServiceBrowserPrivate;
+public:
+    ServiceBrowser(const QString &serviceType, const QString &domain = QLatin1String("local."), bool adressesRequired = true, QObject *parent = 0);
+    // this is here to avoid to instantiate a partially defined type (MainConnectionPtr)
+    ServiceBrowser(const QString &serviceType, const QString &domain, bool adressesRequired, QObject *parent, MainConnectionPtr mainConnection);
+    ServiceBrowser(const QString &serviceType, MainConnectionPtr mainConnection);
+    ~ServiceBrowser();
+
+    MainConnectionPtr mainConnection();
+
+    bool startBrowsing(qint32 interfaceIndex = 0);
+    void stopBrowsing();
+    bool isBrowsing() const;
+    bool didFail() const;
+
+    const QString& serviceType() const;
+    const QString& domain() const;
+
+    bool adressesAutoResolved() const;
+    bool adressesRequired() const;
+
+    QList<Service::ConstPtr> services() const;
+    void reconfirmService(Service::ConstPtr service);
+signals:
+    void serviceChanged(Service::ConstPtr oldService, Service::ConstPtr newService, ServiceBrowser *browser);
+    void serviceAdded(Service::ConstPtr service, ServiceBrowser *browser);
+    void serviceRemoved(Service::ConstPtr service, ServiceBrowser *browser);
+    void servicesUpdated(ServiceBrowser *browser);
+    void hadError(QStringList errorMsgs, bool completeFailure);
+private:
+    Internal::ServiceBrowserPrivate *d;
+};
+
+enum LibUsage {
+    UseNativeOnly = 1,
+    UseEmbeddedOnly,
+    UseNativeOrEmbedded
+};
+
+void initLib(LibUsage usage, const QString &libName, const QString & daemonPaths);
+
+}
+
+#endif // SERVICEBROWSER_H