HTTP client library. More...

#include "gate/net/gate_net_api.h"
#include "gate/net/httptypes.h"
#include "gate/streams.h"

Macros
#define	GATE_HTTPCLIENT_FLAG_SECURE 0x0001
#define	GATE_HTTPCLIENT_FLAG_DISABLE_VERIFICATION 0x0002
#define	GATE_HTTPCLIENT_FLAG_NATIVE_IMPL 0x4000

Functions
GATE_NET_API gate_result_t	gate_httpclient_create (gate_httpclient_t client, gate_string_t const server, gate_uint16_t port, gate_enumint_t flags)
	Initialize a new HTTP client object.
GATE_NET_API gate_result_t	gate_httpclient_send_request (gate_httpclient_t client, gate_http_request_t request, gate_http_response_t *response)
	Sends a HTTP request and receives the response from the HTTP server.
GATE_NET_API gate_result_t	gate_httpclient_release (gate_httpclient_t *client)
	Releases all resources acquired by the HTTP client object.

Detailed Description

HTTP client library.

Macro Definition Documentation

#define GATE_HTTPCLIENT_FLAG_SECURE 0x0001

enable HTTPS connection

#define GATE_HTTPCLIENT_FLAG_DISABLE_VERIFICATION 0x0002

disable certificate verification

#define GATE_HTTPCLIENT_FLAG_NATIVE_IMPL 0x4000

uses a native TCP socket implementation

GATE_NET_API gate_result_t gate_httpclient_create	(	gate_httpclient_t *	client,
		gate_string_t const *	server,
		gate_uint16_t	port,
		gate_enumint_t	flags )

Initialize a new HTTP client object.

Parameters

[out]	client	Pointer to object to be initialized
[in]	server	Address (IP or hostname) of HTTP server to be connected
[in]	port	Server port to be used for connection
[in]	flags	combination of GATE_HTTPCLIENT_FLAG_* values

GATE_NET_API gate_result_t gate_httpclient_send_request	(	gate_httpclient_t *	client,
		gate_http_request_t *	request,
		gate_http_response_t *	response )

Sends a HTTP request and receives the response from the HTTP server.

Parameters

[in]	client	Pointer to initialized HTTP client object
[in]	request	Pointer to prepared HTTP request context object
[out]	response	Pointer to HTTP response object to be initialized with data from the received HTTP response

GATE_NET_API gate_result_t gate_httpclient_release ( gate_httpclient_t * client )

Releases all resources acquired by the HTTP client object.

Parameters

[in] client Pointer to HTTP client object