1
0
cuberite-2a/src/HTTP/MultipartParser.h

80 lines
2.1 KiB
C
Raw Normal View History

// MultipartParser.h
// Declares the cMultipartParser class that parses messages in "multipart/*" encoding into the separate parts
#pragma once
#include "EnvelopeParser.h"
class cMultipartParser :
protected cEnvelopeParser::cCallbacks
{
public:
class cCallbacks
{
public:
// Force a virtual destructor in descendants:
virtual ~cCallbacks() {}
2016-02-05 16:45:45 -05:00
/** Called when a new part starts */
virtual void OnPartStart(void) = 0;
2016-02-05 16:45:45 -05:00
/** Called when a complete header line is received for a part */
virtual void OnPartHeader(const AString & a_Key, const AString & a_Value) = 0;
2016-02-05 16:45:45 -05:00
/** Called when body for a part is received */
virtual void OnPartData(const char * a_Data, size_t a_Size) = 0;
2016-02-05 16:45:45 -05:00
/** Called when the current part ends */
virtual void OnPartEnd(void) = 0;
} ;
2016-02-05 16:45:45 -05:00
/** Creates the parser, expects to find the boundary in a_ContentType */
cMultipartParser(const AString & a_ContentType, cCallbacks & a_Callbacks);
2016-02-05 16:45:45 -05:00
/** Parses more incoming data */
void Parse(const char * a_Data, size_t a_Size);
2016-02-05 16:45:45 -05:00
protected:
/** The callbacks to call for various parsing events */
cCallbacks & m_Callbacks;
2016-02-05 16:45:45 -05:00
/** True if the data parsed so far is valid; if false, further parsing is skipped */
bool m_IsValid;
2016-02-05 16:45:45 -05:00
/** Parser for each part's envelope */
cEnvelopeParser m_EnvelopeParser;
2016-02-05 16:45:45 -05:00
/** Buffer for the incoming data until it is parsed */
AString m_IncomingData;
2016-02-05 16:45:45 -05:00
/** The boundary, excluding both the initial "--" and the terminating CRLF */
AString m_Boundary;
2016-02-05 16:45:45 -05:00
/** Set to true if some data for the current part has already been signalized to m_Callbacks. Used for proper CRLF inserting. */
bool m_HasHadData;
2016-02-05 16:45:45 -05:00
/** Parse one line of incoming data. The CRLF has already been stripped from a_Data / a_Size */
void ParseLine(const char * a_Data, size_t a_Size);
2016-02-05 16:45:45 -05:00
/** Parse one line of incoming data in the headers section of a part. The CRLF has already been stripped from a_Data / a_Size */
void ParseHeaderLine(const char * a_Data, size_t a_Size);
2016-02-05 16:45:45 -05:00
// cEnvelopeParser overrides:
virtual void OnHeaderLine(const AString & a_Key, const AString & a_Value) override;
} ;