ApiDocManager.h

Go to the documentation of this file.

/*
    This file is part of Rocs.
    Copyright 2013  Andreas Cord-Landwehr <cola@uni-paderborn.de>

    This program is free software; you can redistribute it and/or
    modify it under the terms of the GNU General Public License as
    published by the Free Software Foundation; either version 2 of
    the License, or (at your option) any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program.  If not, see <http://www.gnu.org/licenses/>.
*/

#ifndef APIDOCMANAGER_H
#define APIDOCMANAGER_H

#include <QObject>
#include <QMap>
#include <QHash>

class ObjectDocumentation;
class KUrl;
class QDomDocument;
class QFile;
class QXmlSchema;

class ApiDocManager : public QObject
{
    Q_OBJECT

public:
    explicit ApiDocManager(QObject *parent = 0);

    void loadLocalData();

    QList<ObjectDocumentation *> objectApiList() const;

    ObjectDocumentation * objectApi(int index) const;

    QString objectApiDocument(const QString &identifier);

    QString apiOverviewDocument() const;

    bool loadObjectApi(const KUrl &path);

signals:
    void objectApiAdded();
    void objectApiAboutToBeAdded(ObjectDocumentation*,int);
    void objectApiRemoved();
    void objectApiAboutToBeRemoved(int,int);

private:
    QXmlSchema loadXmlSchema(const QString &schemeName) const;

    QDomDocument loadDomDocument(const KUrl &path, const QXmlSchema &schema) const;

    QList<ObjectDocumentation *> _objectApiList;
    QHash<QString, QString> _objectApiDocuments;
    QList<QString> _objectApiCache; // list of all objects available
};

#endif // APIDOCMANAGER_H