/usr/include/libdap/HTTPConnect.h is in libdap-dev 3.12.0-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 | // -*- mode: c++; c-basic-offset:4 -*-
// This file is part of libdap, A C++ implementation of the OPeNDAP Data
// Access Protocol.
// Copyright (c) 2002,2003 OPeNDAP, Inc.
// Author: James Gallagher <jgallagher@opendap.org>
//
// This library 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 2.1 of the License, or (at your option) any later version.
//
// This library 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 this library; if not, write to the Free Software
// Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
//
// You can contact OPeNDAP, Inc. at PO Box 112, Saunderstown, RI. 02874-0112.
#ifndef _httpconnect_h
#define _httpconnect_h
#include <string>
#include <curl/curl.h>
//No longer used in CURL - pwest April 09, 2012
//#include <curl/types.h>
#include <curl/easy.h>
#ifndef _rc_reader_h_
#include "RCReader.h"
#endif
#ifndef _object_type_h
#include "ObjectType.h"
#endif
#ifndef _http_cache_h
#include "HTTPCache.h"
#endif
#ifndef http_response_h
#include "HTTPResponse.h"
#endif
#ifndef _util_h
#include "util.h"
#endif
using std::string;
using std::vector;
namespace libdap
{
extern int www_trace;
extern int dods_keep_temps;
/** Use the CURL library to dereference a HTTP URL. Scan the response for
headers used by the DAP 2.0 and extract their values. The body of the
response is made available by a FILE pointer.
@todo Change the way this class returns information so that the headers
and the stream (aka FILE pointer) are returned using an object. Design
this object so that its destructor closes the stream (this will prevent
resource leaks). It will also obviate the need for the (now broken)
is_response_present() predicate.
@author jhrg */
class HTTPConnect
{
private:
CURL *d_curl;
RCReader *d_rcr;
HTTPCache *d_http_cache;
char d_error_buffer[CURL_ERROR_SIZE]; // A human-readable message.
bool d_accept_deflate;
string d_username; // extracted from URL
string d_password; // extracted from URL
string d_upstring; // used to pass info into curl
string d_cookie_jar;
vector<string> d_request_headers; // Request headers
int d_dap_client_protocol_major;
int d_dap_client_protocol_minor;
void www_lib_init();
long read_url(const string &url, FILE *stream, vector<string> *resp_hdrs,
const vector<string> *headers = 0);
// string get_temp_file(FILE *&stream) throw(InternalErr);
HTTPResponse *plain_fetch_url(const string &url);
HTTPResponse *caching_fetch_url(const string &url);
bool url_uses_proxy_for(const string &url) throw();
bool url_uses_no_proxy_for(const string &url) throw();
void extract_auth_info(string &url);
friend size_t save_raw_http_header(void *ptr, size_t size, size_t nmemb,
void *http_connect);
friend class HTTPConnectTest;
friend class ParseHeader;
protected:
/** @name Suppress default methods
These methods are not supported and are implemented here as protected
methods to suppress the C++-supplied default versions (which will
break this object). */
//@{
HTTPConnect() {
throw InternalErr(__FILE__, __LINE__, "Unimplemented method");
}
HTTPConnect(const HTTPConnect &) {
throw InternalErr(__FILE__, __LINE__, "Unimplemented method");
}
HTTPConnect &operator=(const HTTPConnect &) {
throw InternalErr(__FILE__, __LINE__, "Unimplemented assignment");
}
//@}
public:
HTTPConnect(RCReader *rcr);
virtual ~HTTPConnect();
void set_credentials(const string &u, const string &p);
void set_accept_deflate(bool defalte);
void set_xdap_protocol(int major, int minor);
/** Set the cookie jar. This function sets the name of a file used to store
cookies returned by servers. This will help with things like single
sign on systems.
@param cookie_jar The pathname to the file that stores cookies. If this
is the empty string saving cookies is disabled. */
void set_cookie_jar(const string &cookie_jar)
{
d_cookie_jar = cookie_jar;
}
/** Set the state of the HTTP cache. By default, the HTTP cache is
enabled or disabled using the value of the \c USE_CACHE property in
the \c .dodsrc file. Use this method to set the state from within a
program.
@param enabled True to use the cache, False to disable. */
void set_cache_enabled(bool enabled)
{
if (d_http_cache)
d_http_cache->set_cache_enabled(enabled);
}
/** Return the current state of the HTTP cache. */
bool is_cache_enabled()
{
return (d_http_cache) ? d_http_cache->is_cache_enabled() : false;
}
HTTPResponse *fetch_url(const string &url);
};
} // namespace libdap
#endif // _httpconnect_h
|