httppostbodyreader.hpp

/* Copyright (c) 2014, The Nuria Project
 * This software is provided 'as-is', without any express or implied
 * warranty. In no event will the authors be held liable for any damages
 * arising from the use of this software.
 * Permission is granted to anyone to use this software for any purpose,
 * including commercial applications, and to alter it and redistribute it
 * freely, subject to the following restrictions:
 *    1. The origin of this software must not be misrepresented; you must not
 *       claim that you wrote the original software. If you use this software
 *       in a product, an acknowledgment in the product documentation would be
 *       appreciated but is not required.
 *    2. Altered source versions must be plainly marked as such, and must not be
 *       misrepresented as being the original software.
 *    3. This notice may not be removed or altered from any source
 *       distribution.
 */

#ifndef NURIA_HTTPPOSTBODYREADER_HPP
#define NURIA_HTTPPOSTBODYREADER_HPP

#include "network_global.hpp"
#include <QStringList>
#include <QObject>

class QIODevice;

namespace Nuria {

class NURIA_NETWORK_EXPORT HttpPostBodyReader : public QObject {
    Q_OBJECT
public:
    
    explicit HttpPostBodyReader (QObject *parent = 0);
    
    ~HttpPostBodyReader ();
    
    virtual bool isComplete () const = 0;
    
    virtual bool hasFailed () const = 0;
    
    virtual bool hasField (const QString &field) const;
    
    virtual QStringList fieldNames () const = 0;
    
    virtual QString fieldMimeType (const QString &field) const = 0;
    
    virtual qint64 fieldLength (const QString &field) const = 0;
    
    virtual qint64 fieldBytesTransferred (const QString &field) const = 0;
    
    virtual bool isFieldComplete (const QString &field) const;
    
    virtual QByteArray fieldValue (const QString &field);
    
    virtual QIODevice *fieldStream (const QString &field) = 0;
    
signals:
    
    void fieldFound (const QString &fieldName);
    
    void fieldCompleted (const QString &fieldName);
    
    void completed (bool success);
    
};

}

#endif // NURIA_HTTPPOSTBODYREADER_HPP