QXmppStanza.h

/*
 * Copyright (C) 2008-2021 The QXmpp developers
 *
 * Authors:
 *  Manjeet Dahiya
 *  Jeremy Lainé
 *  Georg Rudoy
 *
 * Source:
 *  https://github.com/qxmpp-project/qxmpp
 *
 * This file is a part of QXmpp library.
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation; either
 * version 2.1 of the License, or (at your option) any later version.
 *
 * This library 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
 * Lesser General Public License for more details.
 *
 */
 
#ifndef QXMPPSTANZA_H
#define QXMPPSTANZA_H
 
#include <QByteArray>
#include <QSharedData>
#include <QString>
 
// forward declarations of QXmlStream* classes will not work on Mac, we need to
// include the whole header.
// See http://lists.trolltech.com/qt-interest/2008-07/thread00798-0.html
// for an explanation.
#include "QXmppElement.h"
 
#include <QXmlStreamWriter>
 
class QXmppExtendedAddressPrivate;
 
class QXMPP_EXPORT QXmppExtendedAddress
{
public:
    QXmppExtendedAddress();
    QXmppExtendedAddress(const QXmppExtendedAddress &);
    ~QXmppExtendedAddress();
 
    QXmppExtendedAddress &operator=(const QXmppExtendedAddress &);
 
    QString description() const;
    void setDescription(const QString &description);
 
    QString jid() const;
    void setJid(const QString &jid);
 
    QString type() const;
    void setType(const QString &type);
 
    bool isDelivered() const;
    void setDelivered(bool);
 
    bool isValid() const;
 
    void parse(const QDomElement &element);
    void toXml(QXmlStreamWriter *writer) const;
 
private:
    QSharedDataPointer<QXmppExtendedAddressPrivate> d;
};
 
class QXmppStanzaPrivate;
class QXmppStanzaErrorPrivate;
 
 
class QXMPP_EXPORT QXmppStanza
{
public:
    class QXMPP_EXPORT Error
    {
    public:
        enum Type {
            Cancel,    
            Continue,  
            Modify,    
            Auth,      
            Wait       
        };
 
        enum Condition {
            BadRequest,             
            Conflict,               
            FeatureNotImplemented,  
            Forbidden,              
            Gone,                   
            InternalServerError,    
            ItemNotFound,           
            JidMalformed,           
            NotAcceptable,          
            NotAllowed,             
            NotAuthorized,          
#if QXMPP_DEPRECATED_SINCE(1, 3)
            PaymentRequired Q_DECL_ENUMERATOR_DEPRECATED_X("The <payment-required/> error was removed in RFC6120"),
#endif
            RecipientUnavailable = 12,  
            Redirect,                   
            RegistrationRequired,       
            RemoteServerNotFound,       
            RemoteServerTimeout,        
            ResourceConstraint,         
            ServiceUnavailable,         
            SubscriptionRequired,       
            UndefinedCondition,         
            UnexpectedRequest,          
            PolicyViolation             
        };
 
        Error();
        Error(const Error &);
        Error(Type type, Condition cond, const QString &text = QString());
        Error(const QString &type, const QString &cond, const QString &text = QString());
        ~Error();
 
        Error &operator=(const Error &);
 
        int code() const;
        void setCode(int code);
 
        QString text() const;
        void setText(const QString &text);
 
        Condition condition() const;
        void setCondition(Condition cond);
 
        void setType(Type type);
        Type type() const;
 
        QString by() const;
        void setBy(const QString &by);
 
        QString redirectionUri() const;
        void setRedirectionUri(const QString &redirectionUri);
 
        // XEP-0363: HTTP File Upload
        bool fileTooLarge() const;
        void setFileTooLarge(bool);
 
        qint64 maxFileSize() const;
        void setMaxFileSize(qint64);
 
        QDateTime retryDate() const;
        void setRetryDate(const QDateTime &);
 
        void parse(const QDomElement &element);
        void toXml(QXmlStreamWriter *writer) const;
 
    private:
        QSharedDataPointer<QXmppStanzaErrorPrivate> d;
    };
 
    QXmppStanza(const QString &from = QString(), const QString &to = QString());
    QXmppStanza(const QXmppStanza &other);
    virtual ~QXmppStanza();
 
    QXmppStanza &operator=(const QXmppStanza &other);
 
    QString to() const;
    void setTo(const QString &);
 
    QString from() const;
    void setFrom(const QString &);
 
    QString id() const;
    void setId(const QString &);
 
    QString lang() const;
    void setLang(const QString &);
 
    QXmppStanza::Error error() const;
    void setError(const QXmppStanza::Error &error);
 
    QXmppElementList extensions() const;
    void setExtensions(const QXmppElementList &elements);
 
    QList<QXmppExtendedAddress> extendedAddresses() const;
    void setExtendedAddresses(const QList<QXmppExtendedAddress> &extendedAddresses);
 
    virtual bool isXmppStanza() const;
 
    virtual void parse(const QDomElement &element);
    virtual void toXml(QXmlStreamWriter *writer) const = 0;
 
protected:
    void extensionsToXml(QXmlStreamWriter *writer) const;
    void generateAndSetNextId();
 
private:
    QSharedDataPointer<QXmppStanzaPrivate> d;
    static uint s_uniqeIdNo;
};
 
Q_DECLARE_METATYPE(QXmppStanza::Error::Type);
Q_DECLARE_METATYPE(QXmppStanza::Error::Condition);
 
#endif  // QXMPPSTANZA_H