<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>libdap++: libdap::HTTPConnect Class Reference</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="navtree.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="navtree.js"></script>
<script type="text/javascript" src="resize.js"></script>
<script type="text/javascript">
$(document).ready(initResizable);
</script>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<!-- Generated by Doxygen 1.7.3 -->
<div id="top">
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
<tbody>
<tr style="height: 56px;">
<td style="padding-left: 0.5em;">
<div id="projectname">libdap++ <span id="projectnumber">Updated for version 3.8.2</span></div>
</td>
</tr>
</tbody>
</table>
</div>
<div id="navrow1" class="tabs">
<ul class="tablist">
<li><a href="index.html"><span>Main Page</span></a></li>
<li><a href="pages.html"><span>Related Pages</span></a></li>
<li><a href="namespaces.html"><span>Namespaces</span></a></li>
<li class="current"><a href="annotated.html"><span>Classes</span></a></li>
<li><a href="files.html"><span>Files</span></a></li>
</ul>
</div>
<div id="navrow2" class="tabs2">
<ul class="tablist">
<li><a href="annotated.html"><span>Class List</span></a></li>
<li><a href="classes.html"><span>Class Index</span></a></li>
<li><a href="inherits.html"><span>Class Hierarchy</span></a></li>
<li><a href="functions.html"><span>Class Members</span></a></li>
</ul>
</div>
</div>
<div id="side-nav" class="ui-resizable side-nav-resizable">
<div id="nav-tree">
<div id="nav-tree-contents">
</div>
</div>
<div id="splitbar" style="-moz-user-select:none;"
class="ui-resizable-handle">
</div>
</div>
<script type="text/javascript">
initNavTree('classlibdap_1_1HTTPConnect.html','');
</script>
<div id="doc-content">
<div class="header">
<div class="summary">
<a href="#pub-methods">Public Member Functions</a> |
<a href="#friends">Friends</a> </div>
<div class="headertitle">
<h1>libdap::HTTPConnect Class Reference</h1> </div>
</div>
<div class="contents">
<!-- doxytag: class="libdap::HTTPConnect" -->
<p><code>#include <<a class="el" href="HTTPConnect_8h_source.html">HTTPConnect.h</a>></code></p>
<div class="dynheader">
Collaboration diagram for libdap::HTTPConnect:</div>
<div class="dyncontent">
<div class="center"><img src="classlibdap_1_1HTTPConnect__coll__graph.png" border="0" usemap="#libdap_1_1HTTPConnect_coll__map" alt="Collaboration graph"/></div>
<map name="libdap_1_1HTTPConnect_coll__map" id="libdap_1_1HTTPConnect_coll__map">
<area shape="rect" id="node2" href="classlibdap_1_1RCReader.html" title="{libdap::RCReader\n|- _dods_always_validate\l- _dods_cache_max\l- _dods_cached_obj\l- _dods_default_expires\l- _dods_deflate\l- _dods_ign_expires\l- _dods_no_proxy_for_port\l- _dods_proxy_for\l- _dods_proxy_for_proxy_host_url\l- _dods_proxy_for_regexp\l- _dods_proxy_for_regexp_flags\l- _dods_proxy_server_host_url\l- _dods_use_cache\l- d_ais_database\l- d_cache_root\l- d_cookie_jar\l- d_dods_no_proxy_for\l- d_dods_no_proxy_for_host\l- d_dods_no_proxy_for_protocol\l- d_dods_proxy_server_host\l- d_dods_proxy_server_port\l- d_dods_proxy_server_protocol\l- d_dods_proxy_server_userpw\l- d_rc_file_path\l- d_validate_ssl\l- _instance\l|+ get_ais_database()\l+ get_always_validate()\l+ get_cookie_jar()\l+ get_default_expires()\l+ get_deflate()\l+ get_dods_cache_root()\l+ get_ignore_expires()\l+ get_max_cache_size()\l+ get_max_cached_obj()\l+ get_no_proxy_for_host()\l+ get_no_proxy_for_port()\l+ get_no_proxy_for_protocol()\l+ get_proxy_for_proxy_host_url()\l+ get_proxy_for_regexp()\l+ get_proxy_for_regexp_flags()\l+ get_proxy_server_host()\l+ get_proxy_server_host_url()\l+ get_proxy_server_port()\l+ get_proxy_server_protocol()\l+ get_proxy_server_userpw()\l+ get_use_cache()\l+ get_validate_ssl()\l+ is_no_proxy_for_used()\l+ is_proxy_for_used()\l+ set_ais_database()\l+ set_always_validate()\l+ set_default_expires()\l+ set_deflate()\l+ set_ignore_expires()\l+ set_max_cache_size()\l+ set_max_cached_obj()\l+ set_no_proxy_for_host()\l+ set_no_proxy_for_port()\l+ set_no_proxy_for_protocol()\l+ set_proxy_for_proxy_host_url()\l+ set_proxy_for_regexp()\l+ set_proxy_for_regexp_flags()\l+ set_proxy_server_host()\l+ set_proxy_server_host_url()\l+ set_proxy_server_port()\l+ set_proxy_server_protocol()\l+ set_proxy_server_userpw()\l+ set_use_cache()\l+ set_validate_ssl()\l+ instance()\l- check_env_var()\l- check_string()\l- RCReader()\l- read_rc_file()\l- write_rc_file()\l- ~RCReader()\l- delete_instance()\l- initialize_instance()\l}" alt="" coords="462,1107,803,2314"/><area shape="rect" id="node13" href="classlibdap_1_1HTTPCache.html" title="{libdap::HTTPCache\n|- d_always_validate\l- d_cache_control\l- d_cache_disconnected\l- d_cache_enabled\l- d_cache_mutex\l- d_cache_protected\l- d_cache_root\l- d_default_expiration\l- d_expire_ignored\l- d_folder_size\l- d_gc_buffer\l- d_http_cache_table\l- d_locked_open_file\l- d_max_age\l- d_max_entry_size\l- d_max_stale\l- d_min_fresh\l- d_open_files\l- d_total_size\l- _instance\l|+ cache_response()\l+ get_cached_response()\l+ get_cached_response()\l+ get_cached_response()\l+ get_conditional_request_headers()\l+ is_url_valid()\l+ lock_cache_interface()\l+ purge_cache()\l+ release_cached_response()\l+ unlock_cache_interface()\l+ update_response()\l+ ~HTTPCache()\l+ instance()\l- get_single_user_lock()\l- HTTPCache()\l- HTTPCache()\l- HTTPCache()\l- is_url_in_cache()\l- open_body()\l- operator=()\l- read_metadata()\l- release_single_user_lock()\l- write_body()\l- write_metadata()\l- stopGC()\l- startGC()\l- perform_garbage_collection()\l- too_big_gc()\l- expired_gc()\l- hits_gc()\l- delete_instance()\l* stopGC()\l* startGC()\l* perform_garbage_collection()\l* too_big_gc()\l* expired_gc()\l* hits_gc()\l* set_cache_root()\l* create_cache_root()\l* get_cache_root()\l* set_cache_enabled()\l* is_cache_enabled()\l* set_cache_disconnected()\l* get_cache_disconnected()\l* set_expire_ignored()\l* is_expire_ignored()\l* set_max_size()\l* get_max_size()\l* set_max_entry_size()\l* get_max_entry_size()\l* set_default_expiration()\l* get_default_expiration()\l* set_always_validate()\l* get_always_validate()\l* set_cache_control()\l* get_cache_control()\l}" alt="" coords="1603,1129,1974,2292"/><area shape="rect" id="node15" href="classlibdap_1_1HTTPCacheTable.html" title="{libdap::HTTPCacheTable\n|- d_block_size\l- d_cache_index\l- d_cache_root\l- d_cache_table\l- d_current_size\l- d_locked_entries\l- d_new_entries\l|+ bind_entry_to_data()\l+ create_hash_directory()\l+ create_location()\l+ delete_by_hits()\l+ delete_by_size()\l+ delete_expired_entries()\l+ HTTPCacheTable()\l+ is_locked_read_responses()\l+ uncouple_entry_from_data()\l+ ~HTTPCacheTable()\l+ get_current_size()\l+ set_current_size()\l+ get_block_size()\l+ set_block_size()\l+ get_new_entries()\l+ increment_new_entries()\l+ get_cache_root()\l+ set_cache_root()\l+ cache_index_delete()\l+ cache_index_read()\l+ cache_index_parse_line()\l+ cache_index_write()\l- get_cache_table()\l- HTTPCacheTable()\l- HTTPCacheTable()\l- operator=()\l* cache_index_delete()\l* cache_index_read()\l* cache_index_parse_line()\l* cache_index_write()\l* get_locked_entry_from_cache_table()\l* delete_all_entries()\l* add_entry_to_cache_table()\l* remove_cache_entry()\l* remove_entry_from_cache_table()\l* get_locked_entry_from_cache_table()\l* get_write_locked_entry_from_cache_table()\l* calculate_time()\l* parse_headers()\l* get_current_size()\l* set_current_size()\l* get_block_size()\l* set_block_size()\l* get_new_entries()\l* increment_new_entries()\l* get_cache_root()\l* set_cache_root()\l}" alt="" coords="2386,160,2836,1000"/></map>
<center><span class="legend">[<a target="top" href="graph_legend.html">legend</a>]</span></center></div>
<p><a href="classlibdap_1_1HTTPConnect-members.html">List of all members.</a></p>
<table class="memberdecls">
<tr><td colspan="2"><h2><a name="pub-methods"></a>
Public Member Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="classlibdap_1_1HTTPResponse.html">HTTPResponse</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="classlibdap_1_1HTTPConnect.html#a5e3558838e245a96c9392b33ef4ba298">fetch_url</a> (const string &url)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classlibdap_1_1HTTPConnect.html#a58ba19401da6dc272f77ef709ba09230">HTTPConnect</a> (<a class="el" href="classlibdap_1_1RCReader.html">RCReader</a> *rcr)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classlibdap_1_1HTTPConnect.html#a1e9a7b25527264a342dbe9c2aff59f2f">is_cache_enabled</a> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classlibdap_1_1HTTPConnect.html#a01d67a5afa18a84ef744b8f222094260">set_accept_deflate</a> (bool defalte)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classlibdap_1_1HTTPConnect.html#aaf200f19c2a64adc4b17887372dcc595">set_cache_enabled</a> (bool enabled)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classlibdap_1_1HTTPConnect.html#ac6641c75c291e2908be9caade2eb5547">set_cookie_jar</a> (const string &cookie_jar)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classlibdap_1_1HTTPConnect.html#a84190d0d80154943ee997c4982a7c96a">set_credentials</a> (const string &u, const string &p)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classlibdap_1_1HTTPConnect.html#ac232e85c5d2448c66c1a24f62dcbf89a">set_xdap_protocol</a> (int major, int minor)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual </td><td class="memItemRight" valign="bottom"><a class="el" href="classlibdap_1_1HTTPConnect.html#adaecf86117db43a3d4d78971d897252e">~HTTPConnect</a> ()</td></tr>
<tr><td colspan="2"><h2><a name="pro-methods"></a>
Protected Member Functions</h2></td></tr>
<tr><td colspan="2"><div class="groupHeader">Suppress default methods</div></td></tr>
<tr><td colspan="2"><div class="groupText"><p>These methods are not supported and are implemented here as protected methods to suppress the C++-supplied default versions (which will break this object). </p>
</div></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classlibdap_1_1HTTPConnect.html#a6648957e9aa38739b953e61241fdb162">HTTPConnect</a> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classlibdap_1_1HTTPConnect.html#a510d3277f37839b275aca7f26a82d082">HTTPConnect</a> (const <a class="el" href="classlibdap_1_1HTTPConnect.html">HTTPConnect</a> &)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="classlibdap_1_1HTTPConnect.html">HTTPConnect</a> & </td><td class="memItemRight" valign="bottom"><a class="el" href="classlibdap_1_1HTTPConnect.html#aad5c634ebb6237e8449e76d83abde372">operator=</a> (const <a class="el" href="classlibdap_1_1HTTPConnect.html">HTTPConnect</a> &)</td></tr>
<tr><td colspan="2"><h2><a name="friends"></a>
Friends</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">class </td><td class="memItemRight" valign="bottom"><a class="el" href="classlibdap_1_1HTTPConnect.html#a9aed79b4a282abc0feb24f3e28234f13">HTTPConnectTest</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">class </td><td class="memItemRight" valign="bottom"><a class="el" href="classlibdap_1_1HTTPConnect.html#a6cf7d84a8b4cb42b8503948b6c5973cc">ParseHeader</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">size_t </td><td class="memItemRight" valign="bottom"><a class="el" href="classlibdap_1_1HTTPConnect.html#af4392e8b4c78632ef10da4542127388a">save_raw_http_header</a> (void *ptr, size_t size, size_t nmemb, void *http_connect)</td></tr>
</table>
<hr/><a name="_details"></a><h2>Detailed Description</h2>
<div class="textblock"><p>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.</p>
<dl class="todo"><dt><b><a class="el" href="todo.html#_todo000026">Todo:</a></b></dt><dd>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.</dd></dl>
<dl class="author"><dt><b>Author:</b></dt><dd>jhrg </dd></dl>
<p>Definition at line <a class="el" href="HTTPConnect_8h_source.html#l00077">77</a> of file <a class="el" href="HTTPConnect_8h_source.html">HTTPConnect.h</a>.</p>
</div><hr/><h2>Constructor & Destructor Documentation</h2>
<a class="anchor" id="a6648957e9aa38739b953e61241fdb162"></a><!-- doxytag: member="libdap::HTTPConnect::HTTPConnect" ref="a6648957e9aa38739b953e61241fdb162" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">libdap::HTTPConnect::HTTPConnect </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td><code> [inline, protected]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Definition at line <a class="el" href="HTTPConnect_8h_source.html#l00122">122</a> of file <a class="el" href="HTTPConnect_8h_source.html">HTTPConnect.h</a>.</p>
</div>
</div>
<a class="anchor" id="a510d3277f37839b275aca7f26a82d082"></a><!-- doxytag: member="libdap::HTTPConnect::HTTPConnect" ref="a510d3277f37839b275aca7f26a82d082" args="(const HTTPConnect &)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">libdap::HTTPConnect::HTTPConnect </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classlibdap_1_1HTTPConnect.html">HTTPConnect</a> & </td>
<td class="paramname"></td><td>)</td>
<td><code> [inline, protected]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Definition at line <a class="el" href="HTTPConnect_8h_source.html#l00125">125</a> of file <a class="el" href="HTTPConnect_8h_source.html">HTTPConnect.h</a>.</p>
</div>
</div>
<a class="anchor" id="a58ba19401da6dc272f77ef709ba09230"></a><!-- doxytag: member="libdap::HTTPConnect::HTTPConnect" ref="a58ba19401da6dc272f77ef709ba09230" args="(RCReader *rcr)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">libdap::HTTPConnect::HTTPConnect </td>
<td>(</td>
<td class="paramtype"><a class="el" href="classlibdap_1_1RCReader.html">RCReader</a> * </td>
<td class="paramname"><em>rcr</em></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Build a virtual connection to a remote data source that will be accessed using HTTP.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">rcr</td><td>A pointer to the <a class="el" href="classlibdap_1_1RCReader.html">RCReader</a> object which holds configuration file information to be used by this virtual connection. </td></tr>
</table>
</dd>
</dl>
<p>Definition at line <a class="el" href="HTTPConnect_8cc_source.html#l00501">501</a> of file <a class="el" href="HTTPConnect_8cc_source.html">HTTPConnect.cc</a>.</p>
<p>References <a class="el" href="config_8h_source.html#l00023">CNAME</a>, <a class="el" href="config_8h_source.html#l00031">CVER</a>, <a class="el" href="debug_8h_source.html#l00073">DBG2</a>, <a class="el" href="RCReader_8h_source.html#l00159">libdap::RCReader::get_always_validate()</a>, <a class="el" href="RCReader_8h_source.html#l00258">libdap::RCReader::get_cookie_jar()</a>, <a class="el" href="RCReader_8h_source.html#l00155">libdap::RCReader::get_default_expires()</a>, <a class="el" href="RCReader_8h_source.html#l00168">libdap::RCReader::get_deflate()</a>, <a class="el" href="RCReader_8h_source.html#l00135">libdap::RCReader::get_dods_cache_root()</a>, <a class="el" href="RCReader_8h_source.html#l00151">libdap::RCReader::get_ignore_expires()</a>, <a class="el" href="RCReader_8h_source.html#l00143">libdap::RCReader::get_max_cache_size()</a>, <a class="el" href="RCReader_8h_source.html#l00147">libdap::RCReader::get_max_cached_obj()</a>, <a class="el" href="RCReader_8h_source.html#l00139">libdap::RCReader::get_use_cache()</a>, <a class="el" href="HTTPCache_8cc_source.html#l00154">libdap::HTTPCache::instance()</a>, <a class="el" href="HTTPCache_8cc_source.html#l00836">libdap::HTTPCache::set_always_validate()</a>, <a class="el" href="HTTPCache_8cc_source.html#l00628">libdap::HTTPCache::set_cache_enabled()</a>, <a class="el" href="HTTPCache_8cc_source.html#l00814">libdap::HTTPCache::set_default_expiration()</a>, <a class="el" href="HTTPCache_8cc_source.html#l00684">libdap::HTTPCache::set_expire_ignored()</a>, <a class="el" href="HTTPCache_8cc_source.html#l00767">libdap::HTTPCache::set_max_entry_size()</a>, and <a class="el" href="HTTPCache_8cc_source.html#l00718">libdap::HTTPCache::set_max_size()</a>.</p>
<p><div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
<div class="center"><img src="classlibdap_1_1HTTPConnect_a58ba19401da6dc272f77ef709ba09230_cgraph.png" border="0" usemap="#classlibdap_1_1HTTPConnect_a58ba19401da6dc272f77ef709ba09230_cgraph" alt=""/></div>
<map name="classlibdap_1_1HTTPConnect_a58ba19401da6dc272f77ef709ba09230_cgraph" id="classlibdap_1_1HTTPConnect_a58ba19401da6dc272f77ef709ba09230_cgraph">
<area shape="rect" id="node3" href="classlibdap_1_1RCReader.html#a16222cbd4ec583f4b62122dcfcf175fa" title="libdap::RCReader::get_always_validate" alt="" coords="417,5,809,32"/><area shape="rect" id="node5" href="classlibdap_1_1RCReader.html#a662e1484608cf19a967b70ebbe6fe063" title="libdap::RCReader::get_cookie_jar" alt="" coords="443,56,784,83"/><area shape="rect" id="node7" href="classlibdap_1_1RCReader.html#ae51b9a6ba6b54635349a2dfcdaf3b474" title="libdap::RCReader::get_default_expires" alt="" coords="417,107,809,133"/><area shape="rect" id="node9" href="classlibdap_1_1RCReader.html#a6c64406b9a53bbe06f5542a986e9caed" title="libdap::RCReader::get_deflate" alt="" coords="457,157,769,184"/><area shape="rect" id="node11" href="classlibdap_1_1RCReader.html#a8b63a09b1d00135163c00a5c5288d3d6" title="libdap::RCReader::get_dods_cache_root" alt="" coords="417,208,809,235"/><area shape="rect" id="node13" href="classlibdap_1_1RCReader.html#aa2515bdbabaf37c977fee4e024cad121" title="libdap::RCReader::get_ignore_expires" alt="" coords="423,259,804,285"/><area shape="rect" id="node15" href="classlibdap_1_1RCReader.html#ab01eb92581f21762ef94bf7cb28e0259" title="libdap::RCReader::get_max_cache_size" alt="" coords="423,309,804,336"/><area shape="rect" id="node17" href="classlibdap_1_1RCReader.html#a32343bff585e8b2b55b29542193fea72" title="libdap::RCReader::get_max_cached_obj" alt="" coords="423,360,804,387"/><area shape="rect" id="node19" href="classlibdap_1_1RCReader.html#a0a199d1eff493d8d6a1afeaecbb96a8f" title="libdap::RCReader::get_use_cache" alt="" coords="448,411,779,437"/><area shape="rect" id="node21" href="classlibdap_1_1HTTPCache.html#a152bdc19fdec15758d9c1a3a029d6900" title="libdap::HTTPCache::instance" alt="" coords="468,461,759,488"/><area shape="rect" id="node23" href="classlibdap_1_1HTTPCache.html#aa9a13a18ec837e891e81823a4d30da47" title="libdap::HTTPCache::set_always_validate" alt="" coords="412,512,815,539"/><area shape="rect" id="node25" href="classlibdap_1_1HTTPCache.html#a71aa835c2b38bc0e891f40b5a77c53ce" title="libdap::HTTPCache::set_cache_enabled" alt="" coords="423,563,804,589"/><area shape="rect" id="node31" href="classlibdap_1_1HTTPCache.html#a1ca5c8c205241f62596e283943906386" title="libdap::HTTPCache::set_default_expiration" alt="" coords="397,613,829,640"/><area shape="rect" id="node35" href="classlibdap_1_1HTTPCache.html#a1a8c5f13e82c3038e97eca9979ebd39c" title="libdap::HTTPCache::set_expire_ignored" alt="" coords="417,664,809,691"/><area shape="rect" id="node39" href="classlibdap_1_1HTTPCache.html#a92cc5b035dc08ae2704924002144fa29" title="libdap::HTTPCache::set_max_entry_size" alt="" coords="417,715,809,741"/><area shape="rect" id="node45" href="classlibdap_1_1HTTPCache.html#ab2447c27c88ebb29511379ede8ac5b6f" title="libdap::HTTPCache::set_max_size" alt="" coords="448,765,779,792"/><area shape="rect" id="node27" href="classlibdap_1_1HTTPCache.html#a71ed87540113c4403a33bb436d3f8b9c" title="libdap::HTTPCache::lock_cache_interface" alt="" coords="888,689,1299,716"/><area shape="rect" id="node29" href="classlibdap_1_1HTTPCache.html#a5b6a28e17912e87389260f7695fdf876" title="libdap::HTTPCache::unlock_cache_interface" alt="" coords="877,639,1309,665"/><area shape="rect" id="node41" href="classlibdap_1_1HTTPCacheTable.html#a7cd5a3a24fd0cd41ac0d9a3192075e9c" title="libdap::HTTPCacheTable::cache_index_write" alt="" coords="877,740,1309,767"/></map>
</div>
</p>
</div>
</div>
<a class="anchor" id="adaecf86117db43a3d4d78971d897252e"></a><!-- doxytag: member="libdap::HTTPConnect::~HTTPConnect" ref="adaecf86117db43a3d4d78971d897252e" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">libdap::HTTPConnect::~HTTPConnect </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td><code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Definition at line <a class="el" href="HTTPConnect_8cc_source.html#l00545">545</a> of file <a class="el" href="HTTPConnect_8cc_source.html">HTTPConnect.cc</a>.</p>
<p>References <a class="el" href="debug_8h_source.html#l00073">DBG2</a>.</p>
</div>
</div>
<hr/><h2>Member Function Documentation</h2>
<a class="anchor" id="a5e3558838e245a96c9392b33ef4ba298"></a><!-- doxytag: member="libdap::HTTPConnect::fetch_url" ref="a5e3558838e245a96c9392b33ef4ba298" args="(const string &url)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classlibdap_1_1HTTPResponse.html">HTTPResponse</a> * libdap::HTTPConnect::fetch_url </td>
<td>(</td>
<td class="paramtype">const string & </td>
<td class="paramname"><em>url</em></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Dereference a URL. This method dereferences a URL and stores the result (i.e., it formulates an HTTP request and processes the HTTP server's response). After this method is successfully called, the value of is_response_present() will be true and the methods get_response_headers(), type() and server_version() may be called.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">url</td><td>The URL to dereference. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>A pointer to the stream. </dd></dl>
<dl><dt><b>Exceptions:</b></dt><dd>
<table class="exception">
<tr><td class="paramname"><a class="el" href="classlibdap_1_1Error.html" title="A class for error processing.">Error</a></td><td>Thrown if the URL could not be dereferenced. </td></tr>
<tr><td class="paramname"><a class="el" href="classlibdap_1_1InternalErr.html" title="A class for software fault reporting.">InternalErr</a></td><td>Thrown if a temporary file to hold the response could not be opened. </td></tr>
</table>
</dd>
</dl>
<p>Definition at line <a class="el" href="HTTPConnect_8cc_source.html#l00567">567</a> of file <a class="el" href="HTTPConnect_8cc_source.html">HTTPConnect.cc</a>.</p>
<p>References <a class="el" href="HTTPResponse_8h_source.html#l00122">libdap::HTTPResponse::get_headers()</a>, <a class="el" href="Response_8h_source.html#l00111">libdap::Response::get_status()</a>, <a class="el" href="HTTPCache_8cc_source.html#l00640">libdap::HTTPCache::is_cache_enabled()</a>, <a class="el" href="HTTPConnect_8h_source.html#l00114">ParseHeader</a>, <a class="el" href="Response_8h_source.html#l00151">libdap::Response::set_protocol()</a>, <a class="el" href="Response_8h_source.html#l00143">libdap::Response::set_type()</a>, and <a class="el" href="Response_8h_source.html#l00147">libdap::Response::set_version()</a>.</p>
<p>Referenced by <a class="el" href="getdap_8cc_source.html#l00154">main()</a>, <a class="el" href="Connect_8cc_source.html#l00369">libdap::Connect::request_das()</a>, <a class="el" href="Connect_8cc_source.html#l00432">libdap::Connect::request_das_url()</a>, <a class="el" href="Connect_8cc_source.html#l00780">libdap::Connect::request_data()</a>, <a class="el" href="Connect_8cc_source.html#l00852">libdap::Connect::request_data_ddx()</a>, <a class="el" href="Connect_8cc_source.html#l00886">libdap::Connect::request_data_ddx_url()</a>, <a class="el" href="Connect_8cc_source.html#l00831">libdap::Connect::request_data_url()</a>, <a class="el" href="Connect_8cc_source.html#l00495">libdap::Connect::request_dds()</a>, <a class="el" href="Connect_8cc_source.html#l00573">libdap::Connect::request_dds_url()</a>, <a class="el" href="Connect_8cc_source.html#l00633">libdap::Connect::request_ddx()</a>, <a class="el" href="Connect_8cc_source.html#l00706">libdap::Connect::request_ddx_url()</a>, <a class="el" href="Connect_8cc_source.html#l00338">libdap::Connect::request_protocol()</a>, and <a class="el" href="Connect_8cc_source.html#l00303">libdap::Connect::request_version()</a>.</p>
<p><div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
<div class="center"><img src="classlibdap_1_1HTTPConnect_a5e3558838e245a96c9392b33ef4ba298_cgraph.png" border="0" usemap="#classlibdap_1_1HTTPConnect_a5e3558838e245a96c9392b33ef4ba298_cgraph" alt=""/></div>
<map name="classlibdap_1_1HTTPConnect_a5e3558838e245a96c9392b33ef4ba298_cgraph" id="classlibdap_1_1HTTPConnect_a5e3558838e245a96c9392b33ef4ba298_cgraph">
<area shape="rect" id="node3" href="classlibdap_1_1HTTPResponse.html#a049aad48922776e0e3d66ab843a2a4db" title="libdap::HTTPResponse::get_headers" alt="" coords="387,5,739,32"/><area shape="rect" id="node5" href="classlibdap_1_1Response.html#a17cd38845849694a82f943c90919ea35" title="libdap::Response::get_status" alt="" coords="412,56,713,83"/><area shape="rect" id="node7" href="classlibdap_1_1HTTPCache.html#a4492276bc732605cef02a146a657811f" title="libdap::HTTPCache::is_cache_enabled" alt="" coords="377,107,748,133"/><area shape="rect" id="node9" href="classlibdap_1_1Response.html#af077130cb39ac3c370776d490e81720b" title="libdap::Response::set_protocol" alt="" coords="401,157,724,184"/><area shape="rect" id="node11" href="classlibdap_1_1Response.html#a7a7807d0a45dd1f6111987f054956e24" title="libdap::Response::set_type" alt="" coords="421,208,704,235"/><area shape="rect" id="node13" href="classlibdap_1_1Response.html#a041d867c1ce5302a2033a8065c6d52a9" title="libdap::Response::set_version" alt="" coords="407,259,719,285"/></map>
</div>
</p>
</div>
</div>
<a class="anchor" id="a1e9a7b25527264a342dbe9c2aff59f2f"></a><!-- doxytag: member="libdap::HTTPConnect::is_cache_enabled" ref="a1e9a7b25527264a342dbe9c2aff59f2f" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool libdap::HTTPConnect::is_cache_enabled </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td><code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Return the current state of the HTTP cache. </p>
<p>Definition at line <a class="el" href="HTTPConnect_8h_source.html#l00165">165</a> of file <a class="el" href="HTTPConnect_8h_source.html">HTTPConnect.h</a>.</p>
<p>References <a class="el" href="HTTPCache_8cc_source.html#l00640">libdap::HTTPCache::is_cache_enabled()</a>.</p>
<p>Referenced by <a class="el" href="Connect_8cc_source.html#l01097">libdap::Connect::is_cache_enabled()</a>.</p>
<p><div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
<div class="center"><img src="classlibdap_1_1HTTPConnect_a1e9a7b25527264a342dbe9c2aff59f2f_cgraph.png" border="0" usemap="#classlibdap_1_1HTTPConnect_a1e9a7b25527264a342dbe9c2aff59f2f_cgraph" alt=""/></div>
<map name="classlibdap_1_1HTTPConnect_a1e9a7b25527264a342dbe9c2aff59f2f_cgraph" id="classlibdap_1_1HTTPConnect_a1e9a7b25527264a342dbe9c2aff59f2f_cgraph">
<area shape="rect" id="node3" href="classlibdap_1_1HTTPCache.html#a4492276bc732605cef02a146a657811f" title="libdap::HTTPCache::is_cache_enabled" alt="" coords="447,5,817,32"/></map>
</div>
</p>
</div>
</div>
<a class="anchor" id="aad5c634ebb6237e8449e76d83abde372"></a><!-- doxytag: member="libdap::HTTPConnect::operator=" ref="aad5c634ebb6237e8449e76d83abde372" args="(const HTTPConnect &)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classlibdap_1_1HTTPConnect.html">HTTPConnect</a>& libdap::HTTPConnect::operator= </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classlibdap_1_1HTTPConnect.html">HTTPConnect</a> & </td>
<td class="paramname"></td><td>)</td>
<td><code> [inline, protected]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Definition at line <a class="el" href="HTTPConnect_8h_source.html#l00128">128</a> of file <a class="el" href="HTTPConnect_8h_source.html">HTTPConnect.h</a>.</p>
</div>
</div>
<a class="anchor" id="a01d67a5afa18a84ef744b8f222094260"></a><!-- doxytag: member="libdap::HTTPConnect::set_accept_deflate" ref="a01d67a5afa18a84ef744b8f222094260" args="(bool defalte)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void libdap::HTTPConnect::set_accept_deflate </td>
<td>(</td>
<td class="paramtype">bool </td>
<td class="paramname"><em>deflate</em></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Set the <em>accept deflate</em> property. If true, the DAP client announces to a server that it can accept responses compressed using the <code>deflate</code> algorithm. This property is automatically set using a value from the <code>.dodsrc</code> configuration file. This method provides a way to override that behavior.</p>
<dl class="note"><dt><b>Note:</b></dt><dd>If the configuration file is not present or does not include a value for this property, it is set to <code>false</code>.</dd></dl>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">deflate</td><td>True sets the <em>accept deflate</em> property, False clears it. </td></tr>
</table>
</dd>
</dl>
<p>Definition at line <a class="el" href="HTTPConnect_8cc_source.html#l00895">895</a> of file <a class="el" href="HTTPConnect_8cc_source.html">HTTPConnect.cc</a>.</p>
<p>References <a class="el" href="debug_8h_source.html#l00058">DBG</a>, and <a class="el" href="EncodingType_8h_source.html#l00050">libdap::deflate</a>.</p>
<p>Referenced by <a class="el" href="getdap_8cc_source.html#l00154">main()</a>, and <a class="el" href="Connect_8cc_source.html#l01068">libdap::Connect::set_accept_deflate()</a>.</p>
</div>
</div>
<a class="anchor" id="aaf200f19c2a64adc4b17887372dcc595"></a><!-- doxytag: member="libdap::HTTPConnect::set_cache_enabled" ref="aaf200f19c2a64adc4b17887372dcc595" args="(bool enabled)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void libdap::HTTPConnect::set_cache_enabled </td>
<td>(</td>
<td class="paramtype">bool </td>
<td class="paramname"><em>enabled</em></td><td>)</td>
<td><code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Set the state of the HTTP cache. By default, the HTTP cache is enabled or disabled using the value of the <code>USE_CACHE</code> property in the <code></code>.dodsrc file. Use this method to set the state from within a program. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">enabled</td><td>True to use the cache, False to disable. </td></tr>
</table>
</dd>
</dl>
<p>Definition at line <a class="el" href="HTTPConnect_8h_source.html#l00158">158</a> of file <a class="el" href="HTTPConnect_8h_source.html">HTTPConnect.h</a>.</p>
<p>References <a class="el" href="HTTPCache_8cc_source.html#l00628">libdap::HTTPCache::set_cache_enabled()</a>.</p>
<p>Referenced by <a class="el" href="Connect_8cc_source.html#l01090">libdap::Connect::set_cache_enabled()</a>.</p>
<p><div class="dynheader">
Here is the call graph for this function:</div>
<div class="dyncontent">
<div class="center"><img src="classlibdap_1_1HTTPConnect_aaf200f19c2a64adc4b17887372dcc595_cgraph.png" border="0" usemap="#classlibdap_1_1HTTPConnect_aaf200f19c2a64adc4b17887372dcc595_cgraph" alt=""/></div>
<map name="classlibdap_1_1HTTPConnect_aaf200f19c2a64adc4b17887372dcc595_cgraph" id="classlibdap_1_1HTTPConnect_aaf200f19c2a64adc4b17887372dcc595_cgraph">
<area shape="rect" id="node3" href="classlibdap_1_1HTTPCache.html#a71aa835c2b38bc0e891f40b5a77c53ce" title="libdap::HTTPCache::set_cache_enabled" alt="" coords="457,31,839,57"/><area shape="rect" id="node5" href="classlibdap_1_1HTTPCache.html#a71ed87540113c4403a33bb436d3f8b9c" title="libdap::HTTPCache::lock_cache_interface" alt="" coords="899,5,1309,32"/><area shape="rect" id="node7" href="classlibdap_1_1HTTPCache.html#a5b6a28e17912e87389260f7695fdf876" title="libdap::HTTPCache::unlock_cache_interface" alt="" coords="888,56,1320,83"/></map>
</div>
</p>
</div>
</div>
<a class="anchor" id="ac6641c75c291e2908be9caade2eb5547"></a><!-- doxytag: member="libdap::HTTPConnect::set_cookie_jar" ref="ac6641c75c291e2908be9caade2eb5547" args="(const string &cookie_jar)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void libdap::HTTPConnect::set_cookie_jar </td>
<td>(</td>
<td class="paramtype">const string & </td>
<td class="paramname"><em>cookie_jar</em></td><td>)</td>
<td><code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>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.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">cookie_jar</td><td>The pathname to the file that stores cookies. If this is the empty string saving cookies is disabled. </td></tr>
</table>
</dd>
</dl>
<p>Definition at line <a class="el" href="HTTPConnect_8h_source.html#l00148">148</a> of file <a class="el" href="HTTPConnect_8h_source.html">HTTPConnect.h</a>.</p>
</div>
</div>
<a class="anchor" id="a84190d0d80154943ee997c4982a7c96a"></a><!-- doxytag: member="libdap::HTTPConnect::set_credentials" ref="a84190d0d80154943ee997c4982a7c96a" args="(const string &u, const string &p)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void libdap::HTTPConnect::set_credentials </td>
<td>(</td>
<td class="paramtype">const string & </td>
<td class="paramname"><em>u</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const string & </td>
<td class="paramname"><em>p</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Set the credentials for responding to challenges while dereferencing URLs. Alternatively, these can be embedded in the URL. This method provides a way for clients of <a class="el" href="classlibdap_1_1HTTPConnect.html">HTTPConnect</a> to get credentials from users (say using a pop up dialog) and to not hack the URL to pass that information to libcurl. Note that the 'credentials in the URL' scheme <em>is</em> part of the URL standard.</p>
<p>This method does nothing if <code>u</code>, the username, is empty.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">u</td><td>The username. </td></tr>
<tr><td class="paramname">p</td><td>The password. </td></tr>
</table>
</dd>
</dl>
<dl><dt><b>Exceptions:</b></dt><dd>
<table class="exception">
<tr><td class="paramname"><a class="el" href="classlibdap_1_1InternalErr.html" title="A class for software fault reporting.">InternalErr</a></td><td>The credentials could not be registered with libcurl. </td></tr>
</table>
</dd>
</dl>
<dl class="see"><dt><b>See also:</b></dt><dd>extract_auth_info() </dd></dl>
<p>Definition at line <a class="el" href="HTTPConnect_8cc_source.html#l00969">969</a> of file <a class="el" href="HTTPConnect_8cc_source.html">HTTPConnect.cc</a>.</p>
<p>Referenced by <a class="el" href="Connect_8cc_source.html#l01058">libdap::Connect::set_credentials()</a>.</p>
</div>
</div>
<a class="anchor" id="ac232e85c5d2448c66c1a24f62dcbf89a"></a><!-- doxytag: member="libdap::HTTPConnect::set_xdap_protocol" ref="ac232e85c5d2448c66c1a24f62dcbf89a" args="(int major, int minor)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void libdap::HTTPConnect::set_xdap_protocol </td>
<td>(</td>
<td class="paramtype">int </td>
<td class="paramname"><em>major</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>minor</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Set the <em>xdap_accept</em> property/HTTP-header. This sets the value of the DAP which the client advertises to servers that it understands. The information (client protocol major and minor versions) are recorded in the instance and the information is sent to servers using the XDAP-Accept HTTP request header.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">major</td><td>The dap client major protocol version </td></tr>
<tr><td class="paramname">minor</td><td>The dap client minor protocol version </td></tr>
</table>
</dd>
</dl>
<p>Definition at line <a class="el" href="HTTPConnect_8cc_source.html#l00932">932</a> of file <a class="el" href="HTTPConnect_8cc_source.html">HTTPConnect.cc</a>.</p>
<p>References <a class="el" href="debug_8h_source.html#l00058">DBG</a>.</p>
<p>Referenced by <a class="el" href="Connect_8cc_source.html#l01080">libdap::Connect::set_xdap_protocol()</a>.</p>
</div>
</div>
<hr/><h2>Friends And Related Function Documentation</h2>
<a class="anchor" id="a9aed79b4a282abc0feb24f3e28234f13"></a><!-- doxytag: member="libdap::HTTPConnect::HTTPConnectTest" ref="a9aed79b4a282abc0feb24f3e28234f13" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">friend class HTTPConnectTest<code> [friend]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Definition at line <a class="el" href="HTTPConnect_8h_source.html#l00113">113</a> of file <a class="el" href="HTTPConnect_8h_source.html">HTTPConnect.h</a>.</p>
</div>
</div>
<a class="anchor" id="a6cf7d84a8b4cb42b8503948b6c5973cc"></a><!-- doxytag: member="libdap::HTTPConnect::ParseHeader" ref="a6cf7d84a8b4cb42b8503948b6c5973cc" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">friend class ParseHeader<code> [friend]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Definition at line <a class="el" href="HTTPConnect_8h_source.html#l00114">114</a> of file <a class="el" href="HTTPConnect_8h_source.html">HTTPConnect.h</a>.</p>
<p>Referenced by <a class="el" href="HTTPConnect_8cc_source.html#l00567">fetch_url()</a>.</p>
</div>
</div>
<a class="anchor" id="af4392e8b4c78632ef10da4542127388a"></a><!-- doxytag: member="libdap::HTTPConnect::save_raw_http_header" ref="af4392e8b4c78632ef10da4542127388a" args="(void *ptr, size_t size, size_t nmemb, void *http_connect)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">size_t save_raw_http_header </td>
<td>(</td>
<td class="paramtype">void * </td>
<td class="paramname"><em>ptr</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">size_t </td>
<td class="paramname"><em>size</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">size_t </td>
<td class="paramname"><em>nmemb</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">void * </td>
<td class="paramname"><em>http_connect</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td><code> [friend]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
</div>
</div>
<hr/>The documentation for this class was generated from the following files:<ul>
<li><a class="el" href="HTTPConnect_8h_source.html">HTTPConnect.h</a></li>
<li><a class="el" href="HTTPConnect_8cc_source.html">HTTPConnect.cc</a></li>
</ul>
</div>
</div>
<div id="nav-path" class="navpath">
<ul>
<li class="navelem"><a class="el" href="namespacelibdap.html">libdap</a> </li>
<li class="navelem"><a class="el" href="classlibdap_1_1HTTPConnect.html">HTTPConnect</a> </li>
<li class="footer">Generated on Tue Feb 8 2011 for libdap++ by 
<a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.7.3 </li>
</ul>
</div>
</body>
</html>
