SFML 3.0.1
Loading...
Searching...
No Matches
Public Types | Public Member Functions | Friends | List of all members
sf::Http::Request Class Reference

HTTP request. More...

`#include <SFML/Network/Http.hpp>`

## Public Types
enum class | 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=Method::Get, const std::string &body="")
| Default constructor.
void | setField (const std::string &field, const std::string &value)
| Set the value of a field.
void | setMethod (Method method)
| Set the request method.
void | setUri (const std::string &uri)
| Set the requested URI.
void | setHttpVersion (unsigned int major, unsigned int minor)
| Set the HTTP version for the request.
void | setBody (const std::string &body)
| Set the body of the request.

## Friends
class | Http

## Detailed Description

HTTP request.

Definition at line 56 of file Http.hpp.

## Member Enumeration Documentation

## ◆ Method

enum class sf::Http::Request::Method
| strong

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 63 of file Http.hpp.

## Constructor & Destructor Documentation

## ◆ Request()

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

Default constructor.

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

Parameters

  uri | Target URI
  method | Method to use for the request
  body | Content of the request's body

## Member Function Documentation

## ◆ setBody()

void sf::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

  body | Content of the body

## ◆ setField()

void sf::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

  field | Name of the field to set
  value | Value of the field

## ◆ setHttpVersion()

void sf::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

  major | Major HTTP version number
  minor | Minor HTTP version number

## ◆ setMethod()

void sf::Http::Request::setMethod | ( | Method | method | ) |

Set the request method.

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

Parameters

  method | Method to use for the request

## ◆ setUri()

void sf::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

  uri | URI to request, relative to the host

## Friends And Related Symbol Documentation

## ◆ Http

friend class Http
| friend

Definition at line 148 of file Http.hpp.

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

- Http.hpp