qmimetypeparser_p.h

Go to the documentation of this file.

// Copyright (C) 2016 The Qt Company Ltd.
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR LGPL-3.0-only OR GPL-2.0-only OR GPL-3.0-only
// Qt-Security score:significant reason:default
 
#ifndef QMIMETYPEPARSER_P_H
#define QMIMETYPEPARSER_P_H
 
//
//  W A R N I N G
//  -------------
//
// This file is not part of the Qt API.  It exists purely as an
// implementation detail.  This header file may change from version to
// version without notice, or even be removed.
//
// We mean it.
//
 
#include <QtCore/qtconfigmacros.h>
 
QT_REQUIRE_CONFIG(mimetype);
 
#include "qmimemagicrule_p.h"
#include "qmimeprovider_p.h"
 
QT_BEGIN_NAMESPACE
 
class QMimeTypeXMLData
{
public:
    void clear();
 
    void addGlobPattern(const QString &pattern);
 
    bool hasGlobDeleteAll = false; // true if the mimetype has a glob-deleteall tag
    QString name;
    QMimeTypePrivate::LocaleHash localeComments;
    QString genericIconName; // TODO move to a struct that's specific to the XML provider
    QString iconName; // TODO move to a struct that's specific to the XML provider
    QStringList globPatterns;
};
 
class QIODevice;
 
class QMimeTypeParserBase
{
    Q_DISABLE_COPY_MOVE(QMimeTypeParserBase)
 
public:
    explicit QMimeTypeParserBase(QMimeMagicRule::RegexRules regexRules) : m_regexRules(regexRules) {}
    virtual ~QMimeTypeParserBase();
 
    bool parse(QIODevice *dev, const QString &fileName, QString *errorMessage);
 
    static bool parseNumber(QStringView n, int *target, QString *errorMessage);
 
protected:
    virtual bool process(const QMimeTypeXMLData &t, QString *errorMessage) = 0;
    virtual bool process(const QMimeGlobPattern &t, QString *errorMessage) = 0;
    virtual void processParent(const QString &child, const QString &parent) = 0;
    virtual void processAlias(const QString &alias, const QString &name) = 0;
    virtual void processMagicMatcher(const QMimeMagicRuleMatcher &matcher) = 0;
 
private:
    enum ParseState {
        ParseBeginning,
        ParseMimeInfo,
        ParseMimeType,
        ParseComment,
        ParseGenericIcon,
        ParseIcon,
        ParseGlobPattern,
        ParseGlobDeleteAll,
        ParseSubClass,
        ParseAlias,
        ParseMagic,
        ParseMagicMatchRule,
        ParseOtherMimeTypeSubTag,
        ParseError
    };
 
    static ParseState nextState(ParseState currentState, QStringView startElement);
 
    const QMimeMagicRule::RegexRules m_regexRules;
};
 
 
class QMimeTypeParser : public QMimeTypeParserBase
{
public:
    QMimeTypeParser(QMimeXMLProvider &provider, QMimeMagicRule::RegexRules regexRules)
        : QMimeTypeParserBase(regexRules), m_provider(provider)
    {
    }
    ~QMimeTypeParser() override;
 
protected:
    inline bool process(const QMimeTypeXMLData &t, QString *) override
    { m_provider.addMimeType(t); return true; }
 
    inline bool process(const QMimeGlobPattern &glob, QString *) override
    { m_provider.addGlobPattern(glob); return true; }
 
    inline void processParent(const QString &child, const QString &parent) override
    { m_provider.addParent(child, parent); }
 
    inline void processAlias(const QString &alias, const QString &name) override
    { m_provider.addAlias(alias, name); }
 
    inline void processMagicMatcher(const QMimeMagicRuleMatcher &matcher) override
    { m_provider.addMagicMatcher(matcher); }
 
private:
    QMimeXMLProvider &m_provider;
};
 
QT_END_NAMESPACE
 
#endif // MIMETYPEPARSER_P_H