You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
66 lines
2.1 KiB
C
66 lines
2.1 KiB
C
2 years ago
|
/*
|
||
|
* This file is part of OpenTTD.
|
||
|
* OpenTTD is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, version 2.
|
||
|
* OpenTTD is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
|
||
|
* See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with OpenTTD. If not, see <http://www.gnu.org/licenses/>.
|
||
|
*/
|
||
|
|
||
|
/**
|
||
|
* @file http.h Basic functions to send and receive HTTP packets.
|
||
|
*/
|
||
|
|
||
|
#ifndef NETWORK_CORE_HTTP_H
|
||
|
#define NETWORK_CORE_HTTP_H
|
||
|
|
||
|
#include "tcp.h"
|
||
|
|
||
|
/** Callback for when the HTTP handler has something to tell us. */
|
||
|
struct HTTPCallback {
|
||
|
/**
|
||
|
* An error has occurred and the connection has been closed.
|
||
|
* @note HTTP socket handler is closed/freed.
|
||
|
*/
|
||
|
virtual void OnFailure() = 0;
|
||
|
|
||
|
/**
|
||
|
* We're receiving data.
|
||
|
* @param data the received data, nullptr when all data has been received.
|
||
|
* @param length the amount of received data, 0 when all data has been received.
|
||
|
* @note When nullptr is sent the HTTP socket handler is closed/freed.
|
||
|
*/
|
||
|
virtual void OnReceiveData(const char *data, size_t length) = 0;
|
||
|
|
||
|
/** Silentium */
|
||
|
virtual ~HTTPCallback() {}
|
||
|
};
|
||
|
|
||
|
/** Base socket handler for HTTP traffic. */
|
||
|
class NetworkHTTPSocketHandler {
|
||
|
public:
|
||
|
/**
|
||
|
* Connect to the given URI.
|
||
|
*
|
||
|
* @param uri the URI to connect to (https://.../..).
|
||
|
* @param callback the callback to send data back on.
|
||
|
* @param data optionally, the data we want to send. When set, this will be a POST request, otherwise a GET request.
|
||
|
*/
|
||
|
static void Connect(const std::string &uri, HTTPCallback *callback, const char *data = nullptr);
|
||
|
|
||
|
/**
|
||
|
* Do the receiving for all HTTP connections.
|
||
|
*/
|
||
|
static void HTTPReceive();
|
||
|
};
|
||
|
|
||
|
/**
|
||
|
* Initialize the HTTP socket handler.
|
||
|
*/
|
||
|
void NetworkHTTPInitialize();
|
||
|
|
||
|
/**
|
||
|
* Uninitialize the HTTP socket handler.
|
||
|
*/
|
||
|
void NetworkHTTPUninitialize();
|
||
|
|
||
|
#endif /* NETWORK_CORE_HTTP_H */
|