Public Types | Public Member Functions | Friends | List of all members
cpp3ds::Http::Request Class Reference

Define a HTTP request. More...

#include <Http.hpp>

Public Types

enum  Method {
  Get,
  Post,
  Head,
  Put,
  Delete
}
 Enumerate the available HTTP methods for a request. More...
 

Public Member Functions

 Request (const std::string &uri="/", Method method=Get, const std::string &body="")
 Default constructor. More...
 
void setField (const std::string &field, const std::string &value)
 Set the value of a field. More...
 
void setMethod (Method method)
 Set the request method. More...
 
void setUri (const std::string &uri)
 Set the requested URI. More...
 
void setHttpVersion (unsigned int major, unsigned int minor)
 Set the HTTP version for the request. More...
 
void setBody (const std::string &body)
 Set the body of the request. More...
 

Friends

class Http
 

Detailed Description

Define a HTTP request.

Definition at line 53 of file Http.hpp.

Member Enumeration Documentation

Enumerate the available HTTP methods for a request.

Enumerator
Get 

Request in get mode, standard method to retrieve a page.

Post 

Request in post mode, usually to send data to a page.

Head 

Request a page's header only.

Put 

Request in put mode, useful for a REST API.

Delete 

Request in delete mode, useful for a REST API.

Definition at line 61 of file Http.hpp.

Constructor & Destructor Documentation

cpp3ds::Http::Request::Request ( const std::string &  uri = "/",
Method  method = Get,
const std::string &  body = "" 
)

Default constructor.

This constructor creates a GET request, with the root URI ("/") and an empty body.

Parameters
uriTarget URI
methodMethod to use for the request
bodyContent of the request's body

Member Function Documentation

void cpp3ds::Http::Request::setBody ( const std::string &  body)

Set the body of the request.

The body of a request is optional and only makes sense for POST requests. It is ignored for all other methods. The body is empty by default.

Parameters
bodyContent of the body
void cpp3ds::Http::Request::setField ( const std::string &  field,
const std::string &  value 
)

Set the value of a field.

The field is created if it doesn't exist. The name of the field is case-insensitive. By default, a request doesn't contain any field (but the mandatory fields are added later by the HTTP client when sending the request).

Parameters
fieldName of the field to set
valueValue of the field
void cpp3ds::Http::Request::setHttpVersion ( unsigned int  major,
unsigned int  minor 
)

Set the HTTP version for the request.

The HTTP version is 1.0 by default.

Parameters
majorMajor HTTP version number
minorMinor HTTP version number
void cpp3ds::Http::Request::setMethod ( Method  method)

Set the request method.

See the Method enumeration for a complete list of all the availale methods. The method is Http::Request::Get by default.

Parameters
methodMethod to use for the request
void cpp3ds::Http::Request::setUri ( const std::string &  uri)

Set the requested URI.

The URI is the resource (usually a web page or a file) that you want to get or post. The URI is "/" (the root page) by default.

Parameters
uriURI to request, relative to the host

The documentation for this class was generated from the following file: