1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
|
// 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 BOINC_GUI_HTTP_H
#define BOINC_GUI_HTTP_H
// 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), gui_http_op(NULL) {}
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(): gui_http(NULL) {}
virtual ~GUI_HTTP_OP(){}
};
#endif
|
