http_request Class

Article
12/06/2014

Represents an HTTP request.

Warning

This topic contains information for the C++ REST SDK 1.0 (codename "Casablanca"). If you are using a later version from the Codeplex Casablanca web page, then use the local documentation at https://casablanca.codeplex.com/documentation.

class http_request;

Members

Public Constructors

Name	Description
http_request::http_request Constructor	Overloaded. Constructs a new HTTP request with the given request method.
http_request::~http_request Destructor	Destructor frees any held resources.

Public Methods

Name	Description
http_request::body Method	Produces a stream which the caller may use to retrieve data from an incoming request.
http_request::content_ready Method	Signals the user (client) when all the data for this request message has been received.
http_request::extract_json Method	Extracts the body of the request message into a json value, checking that the content type is application\json. A body can only be extracted once because in some cases an optimization is made where the data is 'moved' out.
http_request::extract_string Method	Extract the body of the request message as a string value, checking that the content type is a MIME text type. A body can only be extracted once because in some cases an optimization is made where the data is 'moved' out.
http_request::extract_vector Method	Extract the body of the response message into a vector of bytes. Extracting a vector can be done on
http_request::get_response Method	Gets a task representing the response that will eventually be sent.
http_request::headers Method	Overloaded. Gets a reference to the headers of the response message.
http_request::method Method	Get the method (GET/PUT/POST/DELETE) of the request message.
http_request::relative_uri Method	Gets a reference the URI path, query, and fragment part of this request message. This will be appended to the base URI specified at construction of the http_client.
http_request::reply Method	Overloaded. Asynchronously responses to this HTTP request.
http_request::request_uri Method	Get the underling URI of the request message.
http_request::set_body Method	Overloaded. Sets the body of the message to a textual string and set the "Content-Type" header. Assumes the character encoding of the string is the OS's default code page and will perform appropriate conversions to UTF-8.
http_request::set_method Method	Get the method (GET/PUT/POST/DELETE) of the request message.
http_request::set_request_uri Method	Set the underling URI of the request message.
http_request::set_response_stream Method	Defines a stream that will be relied on to hold the body of the HTTP response message that results from the request.
http_request::to_string Method	Generates a string representation of the message, including the body when possible.

Public Operators

Name	Description
http_request::operator= Operator	Assignment operator.

Requirements

Header: http_msg.h

Namespace: web::http

http_request Class

Members

Public Constructors

Public Methods

Public Operators

Requirements

See Also

Reference

Additional resources