Files
MaxScale/server/core/maxscale/httprequest.hh
Markus Mäkelä d242203279 MXS-1220: Use libmicrohttpd for the HTTP handling
The HTTP side of the REST API is better handled with an actual
library. The libmicrohttpd library provides a convenient way of handling
the HTTP traffic between the clients and MaxScale.
2017-05-04 09:12:15 +03:00

178 lines
4.0 KiB
C++

#pragma once
/*
* Copyright (c) 2016 MariaDB Corporation Ab
*
* Use of this software is governed by the Business Source License included
* in the LICENSE.TXT file and at www.mariadb.com/bsl11.
*
* Change Date: 2019-07-01
*
* On the date above, in accordance with the Business Source License, use
* of this software will be governed by version 2 or later of the General
* Public License.
*/
#include <maxscale/cppdefs.hh>
#include <deque>
#include <map>
#include <string>
#include <tr1/memory>
#include <cstdint>
#include <microhttpd.h>
#include <maxscale/jansson.hh>
#include <maxscale/utils.hh>
#include "http.hh"
using std::shared_ptr;
using std::string;
using std::map;
using std::deque;
using mxs::Closer;
class HttpRequest;
/** Typedef for managed pointer */
typedef std::shared_ptr<HttpRequest> SHttpRequest;
static int value_iterator(void *cls,
enum MHD_ValueKind kind,
const char *key,
const char *value)
{
std::pair<string, string>* cmp = (std::pair<string, string>*)cls;
if (cmp->first == key)
{
cmp->second = value;
return MHD_NO;
}
return MHD_YES;
}
class HttpRequest
{
public:
/**
* @brief Parse a request
*
* @param request Request to parse
*
* @return Parsed statement or NULL if request is not valid
*/
HttpRequest(struct MHD_Connection *connection, string url, string method, json_t* data);
~HttpRequest();
/**
* @brief Return request verb type
*
* @return One of the HTTP verb values
*/
const string& get_verb() const
{
return m_verb;
}
/**
* @brief Get header value
*
* @param header Header to get
*
* @return Header value or empty string if the header was not found
*/
string get_header(const string header) const
{
std::pair<string, string> p;
p.first = header;
MHD_get_connection_values(m_connection, MHD_HEADER_KIND,
value_iterator, &p);
return p.second;
}
/**
* @brief Get option value
*
* @param header Option to get
*
* @return Option value or empty string if the option was not found
*/
string get_option(const string option) const
{
std::pair<string, string> p;
p.first = option;
MHD_get_connection_values(m_connection, MHD_GET_ARGUMENT_KIND,
value_iterator, &p);
return p.second;
}
/**
* @brief Return request body
*
* @return Request body or empty string if no body is defined
*/
const string& get_json_str() const
{
return m_json_string;
}
/**
* @brief Return raw JSON body
*
* @return Raw JSON body or NULL if no body is defined
*/
const json_t* get_json() const
{
return m_json.get();
}
/**
* @brief Get complete request URI
*
* @return The complete request URI
*/
const string& get_uri() const
{
return m_resource;
}
/**
* @brief Get URI part
*
* @param idx Zero indexed part number in URI
*
* @return The request URI part or empty string if no part was found
*/
const string uri_part(uint32_t idx) const
{
return m_resource_parts.size() > idx ? m_resource_parts[idx] : "";
}
/**
* @brief Return how many parts are in the URI
*
* @return Number of URI parts
*/
size_t uri_part_count() const
{
return m_resource_parts.size();
}
private:
map<string, string> m_options; /**< Request options */
Closer<json_t*> m_json; /**< Request body */
string m_json_string; /**< String version of @c m_json */
string m_resource; /**< Requested resource */
deque<string> m_resource_parts; /**< @c m_resource split into parts */
string m_verb; /**< Request method */
struct MHD_Connection* m_connection;
};