mirror of https://github.com/BOINC/boinc.git
93 lines
3.0 KiB
C
93 lines
3.0 KiB
C
// This file is part of BOINC.
|
|
// http://boinc.berkeley.edu
|
|
// Copyright (C) 2008 University of California
|
|
//
|
|
// BOINC is free software; you can redistribute it and/or modify it
|
|
// under the terms of the GNU Lesser General Public License
|
|
// as published by the Free Software Foundation,
|
|
// either version 3 of the License, or (at your option) any later version.
|
|
//
|
|
// BOINC 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 Lesser General Public License for more details.
|
|
//
|
|
// You should have received a copy of the GNU Lesser General Public License
|
|
// along with BOINC. If not, see <http://www.gnu.org/licenses/>.
|
|
|
|
#ifndef _GUI_HTTP_
|
|
#define _GUI_HTTP_
|
|
|
|
// A high-level interface for client-initiated HTTP requests.
|
|
|
|
// GUI_HTTP represents a "channel" for doing a sequence of HTTP ops,
|
|
// possibly to different servers.
|
|
// There's no queuing:
|
|
// if you call do_rpc() while an op is in progress, you get an error.
|
|
// You must call poll() periodically to make things work.
|
|
//
|
|
// GUI_HTTP_OP is base class for various types of ops.
|
|
// Each instance has a pointer to a particular GUI_HTTP.
|
|
// When the op is completed or failed, its handle_reply() is called
|
|
//
|
|
// The set of GUI_HTTPs:
|
|
// - one for each GUI RPC connection
|
|
// GUI_HTTP_OPs that use this channel:
|
|
// GUI_RPC_CONN::get_project_config_op
|
|
// GUI_RPC_CONN::lookup_account_op
|
|
// GUI_RPC_CONN::create_account_op
|
|
//
|
|
// - one for the client itself
|
|
// GUI_HTTP_OPs that use this channel:
|
|
// CLIENT_STATE::lookup_website_op
|
|
// CLIENT_STATE::get_current_version
|
|
// CLIENT_STATE::get_project_list
|
|
// CLIENT_STATE::acct_mgr_op
|
|
// These are all "best effort": if an op is requested while
|
|
// another is in progress, it's OK; it will be retried later.
|
|
//
|
|
// - for each project:
|
|
// a vector of TRICKLE_UP_OPs for that project's alternative trickle URLs.
|
|
// Each one has a pointer to a dynamically allocated GUI_HTTP.
|
|
|
|
#include "http_curl.h"
|
|
|
|
#define GUI_HTTP_STATE_IDLE 0
|
|
#define GUI_HTTP_STATE_BUSY 1
|
|
|
|
struct GUI_HTTP {
|
|
int gui_http_state;
|
|
struct GUI_HTTP_OP* gui_http_op;
|
|
HTTP_OP http_op;
|
|
|
|
GUI_HTTP(): gui_http_state(GUI_HTTP_STATE_IDLE) {}
|
|
int do_rpc(
|
|
GUI_HTTP_OP*, const char* url, const char* output_file,
|
|
bool is_background
|
|
);
|
|
int do_rpc_post(
|
|
GUI_HTTP_OP*, char* url,
|
|
const char* input_file, const char* output_file,
|
|
bool is_background
|
|
);
|
|
int do_rpc_post_str(GUI_HTTP_OP*, char* url, char* req, int len);
|
|
bool poll();
|
|
inline bool is_busy() {
|
|
return (gui_http_state == GUI_HTTP_STATE_BUSY);
|
|
}
|
|
};
|
|
|
|
// GUI_HTTP_OP is base class for various types of ops.
|
|
// its gui_http field says what channel to use
|
|
// Derived classes override handle_reply() to handle completion,
|
|
// and provide a do_rpc() function to initiate requests.
|
|
|
|
struct GUI_HTTP_OP {
|
|
GUI_HTTP* gui_http;
|
|
virtual void handle_reply(int) {}
|
|
GUI_HTTP_OP(){}
|
|
virtual ~GUI_HTTP_OP(){}
|
|
};
|
|
|
|
#endif
|