/****************************************************************************+
−
**+
−
** Copyright (C) 2010 Nokia Corporation and/or its subsidiary(-ies).+
−
** All rights reserved.+
−
** Contact: Nokia Corporation (qt-info@nokia.com)+
−
**+
−
** This file is part of the QtDBus module of the Qt Toolkit.+
−
**+
−
** $QT_BEGIN_LICENSE:LGPL$+
−
** No Commercial Usage+
−
** This file contains pre-release code and may not be distributed.+
−
** You may use this file in accordance with the terms and conditions+
−
** contained in the Technology Preview License Agreement accompanying+
−
** this package.+
−
**+
−
** GNU Lesser General Public License Usage+
−
** Alternatively, 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.+
−
**+
−
** If you have questions regarding the use of this file, please contact+
−
** Nokia at qt-info@nokia.com.+
−
**+
−
**+
−
**+
−
**+
−
**+
−
**+
−
**+
−
**+
−
** $QT_END_LICENSE$+
−
**+
−
****************************************************************************/+
−
+
−
#ifndef QDBUSINTROSPECTION_H+
−
#define QDBUSINTROSPECTION_H+
−
+
−
//+
−
//  W A R N I N G+
−
//  -------------+
−
//+
−
// This file is not part of the Qt API.  It exists for the convenience+
−
// of the QLibrary class.  This header file may change from+
−
// version to version without notice, or even be removed.+
−
//+
−
// We mean it.+
−
//+
−
+
−
#include <QtCore/qstring.h>+
−
#include <QtCore/qlist.h>+
−
#include <QtCore/qstringlist.h>+
−
#include <QtCore/qmap.h>+
−
#include <QtCore/qpair.h>+
−
#include <QtCore/qshareddata.h>+
−
#include <qdbusmacros.h>+
−
+
−
QT_BEGIN_NAMESPACE+
−
+
−
class QDBUS_EXPORT QDBusIntrospection+
−
{+
−
public:+
−
    // forward declarations+
−
    struct Argument;+
−
    struct Method;+
−
    struct Signal;+
−
    struct Property;+
−
    struct Interface;+
−
    struct Object;+
−
    struct ObjectTree;+
−
+
−
    // typedefs+
−
    typedef QMap<QString, QString> Annotations;+
−
    typedef QList<Argument> Arguments;+
−
    typedef QMultiMap<QString, Method> Methods;+
−
    typedef QMultiMap<QString, Signal> Signals;+
−
    typedef QMap<QString, Property> Properties;+
−
    typedef QMap<QString, QSharedDataPointer<Interface> > Interfaces;+
−
    typedef QMap<QString, QSharedDataPointer<ObjectTree> > Objects;+
−
+
−
public:+
−
    // the structs+
−
+
−
    struct Argument+
−
    {+
−
        QString type;+
−
        QString name;+
−
+
−
        inline bool operator==(const Argument& other) const+
−
        { return name == other.name && type == other.type; }+
−
    };+
−
    +
−
    struct Method+
−
    {+
−
        QString name;+
−
        Arguments inputArgs;+
−
        Arguments outputArgs;+
−
        Annotations annotations;+
−
+
−
        inline bool operator==(const Method& other) const+
−
        { return name == other.name && annotations == other.annotations &&+
−
                inputArgs == other.inputArgs && outputArgs == other.outputArgs; }+
−
    };+
−
+
−
    struct Signal+
−
    {+
−
        QString name;+
−
        Arguments outputArgs;+
−
        Annotations annotations;+
−
+
−
        inline bool operator==(const Signal& other) const+
−
        { return name == other.name && annotations == other.annotations &&+
−
                outputArgs == other.outputArgs; }+
−
    };+
−
+
−
    struct Property+
−
    {+
−
        enum Access { Read, Write, ReadWrite };+
−
        QString name;+
−
        QString type;+
−
        Access access;+
−
        Annotations annotations;+
−
+
−
        inline bool operator==(const Property& other) const+
−
        { return access == other.access && name == other.name &&+
−
                annotations == other.annotations && type == other.type; }+
−
    };+
−
+
−
    struct Interface: public QSharedData+
−
    {+
−
        QString name;+
−
        QString introspection;+
−
+
−
        Annotations annotations;+
−
        Methods methods;+
−
        Signals signals_;+
−
        Properties properties;+
−
+
−
        inline bool operator==(const Interface &other) const+
−
        { return !name.isEmpty() && name == other.name; }+
−
    };+
−
+
−
    struct Object: public QSharedData+
−
    {+
−
        QString service;+
−
        QString path;+
−
        QString introspection;+
−
+
−
        QStringList interfaces;+
−
        QStringList childObjects;+
−
    };+
−
+
−
    struct ObjectTree: public Object+
−
    {+
−
        Interfaces interfaceData;+
−
        Objects childObjectData;+
−
    };+
−
+
−
public:+
−
    static Interface parseInterface(const QString &xml);+
−
    static Interfaces parseInterfaces(const QString &xml);+
−
    static Object parseObject(const QString &xml, const QString &service = QString(),+
−
                              const QString &path = QString());+
−
    static ObjectTree parseObjectTree(const QString &xml,+
−
                                      const QString &service,+
−
                                      const QString &path);+
−
+
−
private:+
−
    QDBusIntrospection();+
−
};+
−
+
−
QT_END_NAMESPACE+
−
+
−
#endif+
−