/**
* Release PostProcessor resources.
*
* @param pp post processor context to destroy
* @return MHD_YES if processing completed nicely,
* MHD_NO if there were spurious characters / formatting
* problems; it is common to ignore the return
* value of this function
*/
int
MHD_destroy_post_processor (struct MHD_PostProcessor *pp)
{
int ret;
if (NULL == pp)
return MHD_YES;
if (PP_ProcessValue == pp->state)
{
/* key without terminated value left at the end of the
buffer; fake receiving a termination character to
ensure it is also processed */
post_process_urlencoded (pp, "\n", 1);
}
/* These internal strings need cleaning up since
the post-processing may have been interrupted
at any stage */
if ((pp->xbuf_pos > 0) ||
( (pp->state != PP_Done) &&
(pp->state != PP_ExpectNewLine)))
ret = MHD_NO;
else
ret = MHD_YES;
pp->have = NE_none;
free_unmarked (pp);
if (pp->nested_boundary != NULL)
free (pp->nested_boundary);
free (pp);
return ret;
}
/**
* Parse and process POST data. Call this function when POST data is
* available (usually during an #MHD_AccessHandlerCallback) with the
* "upload_data" and "upload_data_size". Whenever possible, this will
* then cause calls to the #MHD_PostDataIterator.
*
* @param pp the post processor
* @param post_data @a post_data_len bytes of POST data
* @param post_data_len length of @a post_data
* @return #MHD_YES on success, #MHD_NO on error
* (out-of-memory, iterator aborted, parse error)
* @ingroup request
*/
int
MHD_post_process (struct MHD_PostProcessor *pp,
const char *post_data, size_t post_data_len)
{
if (0 == post_data_len)
return MHD_YES;
if (NULL == pp)
return MHD_NO;
if (MHD_str_equal_caseless_n_ (MHD_HTTP_POST_ENCODING_FORM_URLENCODED, pp->encoding,
strlen(MHD_HTTP_POST_ENCODING_FORM_URLENCODED)))
return post_process_urlencoded (pp, post_data, post_data_len);
if (MHD_str_equal_caseless_n_ (MHD_HTTP_POST_ENCODING_MULTIPART_FORMDATA, pp->encoding,
strlen (MHD_HTTP_POST_ENCODING_MULTIPART_FORMDATA)))
return post_process_multipart (pp, post_data, post_data_len);
/* this should never be reached */
return MHD_NO;
}
/**
* Parse and process POST data.
* Call this function when POST data is available
* (usually during an MHD_AccessHandlerCallback)
* with the upload_data and upload_data_size.
* Whenever possible, this will then cause calls
* to the MHD_IncrementalKeyValueIterator.
*
* @param pp the post processor
* @param post_data post_data_len bytes of POST data
* @param post_data_len length of post_data
* @return MHD_YES on success, MHD_NO on error
* (out-of-memory, iterator aborted, parse error)
*/
int
MHD_post_process (struct MHD_PostProcessor *pp,
const char *post_data, unsigned int post_data_len)
{
if (post_data_len == 0)
return MHD_YES;
if (pp == NULL)
return MHD_NO;
if (0 == strcasecmp (MHD_HTTP_POST_ENCODING_FORM_URLENCODED, pp->encoding))
return post_process_urlencoded (pp, post_data, post_data_len);
if (0 ==
strncasecmp (MHD_HTTP_POST_ENCODING_MULTIPART_FORMDATA, pp->encoding,
strlen (MHD_HTTP_POST_ENCODING_MULTIPART_FORMDATA)))
return post_process_multipart (pp, post_data, post_data_len);
/* this should never be reached */
return MHD_NO;
}
