HTTPFormParser.h

Go to the documentation of this file.

 
// HTTPFormParser.h
 
// Declares the cHTTPFormParser class representing a parser for forms sent over HTTP
 
 
 
 
#pragma once
 
#include "MultipartParser.h"
 
 
 
 
 
// fwd:
class cHTTPIncomingRequest;
 
 
 
 
 
class cHTTPFormParser :
    public std::map<AString, AString>,
    public cMultipartParser::cCallbacks
{
public:
    enum eKind
    {
        fpkURL,             
        fpkFormUrlEncoded,  
        fpkMultipart,       
    } ;
 
    class cCallbacks
    {
    public:
        // Force a virtual destructor in descendants:
        virtual ~cCallbacks() {}
 
        virtual void OnFileStart(cHTTPFormParser & a_Parser, const AString & a_FileName) = 0;
 
        virtual void OnFileData(cHTTPFormParser & a_Parser, const char * a_Data, size_t a_Size) = 0;
 
        virtual void OnFileEnd(cHTTPFormParser & a_Parser) = 0;
    } ;
 
 
    cHTTPFormParser(const cHTTPIncomingRequest & a_Request, cCallbacks & a_Callbacks);
 
    cHTTPFormParser(eKind a_Kind, const char * a_Data, size_t a_Size, cCallbacks & a_Callbacks);
 
    void Parse(const char * a_Data, size_t a_Size);
 
    bool Finish(void);
 
    static bool HasFormData(const cHTTPIncomingRequest & a_Request);
 
protected:
 
    cCallbacks & m_Callbacks;
 
    eKind m_Kind;
 
    AString m_IncomingData;
 
    bool m_IsValid;
 
    std::unique_ptr<cMultipartParser> m_MultipartParser;
 
    AString m_CurrentPartName;
 
    bool m_IsCurrentPartFile;
 
    AString m_CurrentPartFileName;
 
    bool m_FileHasBeenAnnounced;
 
 
    void BeginMultipart(const cHTTPIncomingRequest & a_Request);
 
    void ParseFormUrlEncoded(void);
 
    // cMultipartParser::cCallbacks overrides:
    virtual void OnPartStart (void) override;
    virtual void OnPartHeader(const AString & a_Key, const AString & a_Value) override;
    virtual void OnPartData  (const char * a_Data, size_t a_Size) override;
    virtual void OnPartEnd   (void) override;
} ;