Holds information about the link from a DODS client to a dataset.
Connect objects are used as containers for information pertaining to the connection a user program makes to a dataset. The dataset may be either local (for example, a file on the user's own computer) or a remote dataset. In the latter case a DODS URL will be used to reference the dataset, instead of a filename. Connect contains methods which can be used to read the DODS DAS and DDS objects from the remote dataset as well as reading data. The class understands in a rudimentary way how DODS constraint expressions are formed and how to manage them. Connect also provides additional services such as automatic decompression of compressed data, transmission progress reports and error processing. Refer to the Gui and Error classes for more information about these features. See the DODSFilter class for information on servers that compress data. The Connect class must be specialized for each different. client-library. Connect is only used on the client-side of a DODS client-server connection. The Connect class contains a linked list of #constraint# objects. These are simple C structures containing a constraint expression and a DDS object. The DDS object contains data received from the server, and the accompanying constraint expression was a part of the data request. To support multiple connections to a single DODS server, you can use either one Connect object with many entries in the #constraint# list, or multiple Connect objects.
Connect(const Connect ©_from)
bool get_www_errors_to_stderr()
void set_www_errors_to_stderr(bool state)
string get_accept_types()
void set_accept_types(const string &types)
bool fetch_url(string &url, bool async = false)
async - If true, the read operation will proceed
asynchronously. In other words, the function may return before
the read is complete.
FILE* output()
XDR* source()
bool is_local()
string URL(bool CE = true)
string CE()
ObjectType type()
EncodingType encoding()
string server_version()
DAS& das()
DDS& dds()
Error& error()
Gui* gui()
bool request_das(bool gui = false, const string &ext = "das")
ext - The extension to append to the URL to retrieve the
dataset DAS. This parameter is included for compatibility with
future versions of the DODS software. It currently defaults to
the only possible working value, ``das''. bool request_dds(bool gui = false, const string &ext = "dds")
ext - The extension to append to the URL to retrieve the
dataset DDS. This parameter is included for compatibility with
future versions of the DODS software. It currently defaults to
the only possible working value, ``dds''. DDS* request_data(string expr, bool gui = false, bool async = false, const string &ext = "dods")
gui - If this is TRUE, use the DODS client GUI. See the
Gui class for a description of this feature.
async - If this is TRUE, this function reads data
asynchronously, returning before the read completes. Synchronous
reads are the default, and the only possible action as of DODS
version 2.15.
ext - The extension to append to the URL to retrieve the
dataset data. This parameter is included for compatibility with
future versions of the DODS software. It currently defaults to
the only possible working value, ``dods''.
Gui DDS* read_data(FILE *data_source, bool gui = false, bool async = false)
async - If this is TRUE, this function reads data
asynchronously, returning before the read completes. Synchronous
reads are the default, and the only possible action as of DODS
version 2.15.
ext - The extension to append to the URL to retrieve the
dataset data. This parameter is included for compatibility with
future versions of the DODS software. It currently defaults to
the only possible working value, ``dods''.
Gui
alphabetic index hierarchy of classes
generated by doc++