libdap++  Updated for version 3.11.7
Todo List
Member DAPCache3::purge_file (const string &file)
This is a new feature; add to BESCache3
Member libdap::Array::Array (const string &n, BaseType *v)
Force the Array::add_var() method to be used to add v. This version of add_var() calls Vector::add_var().
Member libdap::Array::Array (const string &n, const string &d, BaseType *v)
Force the Array::add_var() method to be used to add v. This version of add_var() calls Vector::add_var().
Class libdap::AttrTable

Look at refactoring this by splitting it into three classes. Move the struct entry into its own calls (maybe called Attribute?), make AttrTable a child of that class and then make aliases a separate class, also a child of Attribute. Look at the design of the Java code.

A problem with this class is that Attr_iter objects cannot be dereferenced to return attributes. Instead they must be passed to methods which require that you have access to the AttrTable object into which they point.03/09/04 jhrg

Class libdap::BaseType
We really need a better way to get values out of these types, esp. the Float32, Int16, ..., types. In most cases we know the type, so a type specific method (one that requires a downcast to use) is OK. For example, Byte might have a method dods_byte Byte::value(). Sure you have to downcast from BaseType to Byte in order to use it, but you have to figure out you have a Byte to use Byte::buf2val() anyway, so what's the big deal? Having a method that returns the value would simplify code that reads from data sets to extract meta data (like lat/lon corner points, et c.).
Member libdap::BaseType::add_var (BaseType *bt, Part part=nil)
We should get rid of the Part parameter and adopt the convention that the first variable is the Array and all subsequent ones are Maps (when dealing with a Grid, the only time Part matters). This would enable several methods to migrate from Structure, Sequence and Grid to Constructor.
Member libdap::BaseType::set_read_p (bool state)
Look at making synthesized variables easier to implement and at making them more integrated into the overall CE evaluation process. Maybe the code that computes the synthesized var's value should be in the that variable's read() method? This might provide a way to get rid of the awkward 'projection functions' by replacing them with real children of BaseType. It would also provide a way to clean up the way the synthesized_p prop intrudes on the read_p prop.
Member libdap::ConstraintEvaluator::eval_function_clauses (DataDDS &dds)
Change this so that the new variables are inserted into the original DDS object - this will allow constraints that mix simple projections with function calls. The function is responsible for setting the new variable's read_p property and this 'evaluator' sets the send_p property. The original variables would have to be removed from the original DDS for this to work or the names of the new variables would have to not clash with the original variables' names.
Member libdap::Constructor::is_linear ()
Change the name to is_flattenable or something like that. 05/16/03 jhrg
Member libdap::DDS::mark (const string &name, bool state)

This should throw an exception on error!!!

These methods that use the btp_stack to keep track of the path from the top of a dataset to a particular variable can be rewritten to use the parent field instead.

All the methods that use names to identify variables should have counterparts that take BaseType pointers.

These methods that use the btp_stack to keep track of the path from the top of a dataset to a particular variable can be rewritten to use the parent field instead.

All the methods that use names to identify variables should have counterparts that take BaseType pointers.

Class libdap::DODSFilter

Add a test to make sure that the required arguments are given.

We need to rethink the ancillary file/directory stuff. I don't think it's ever been used...

Member libdap::DODSFilter::DODSFilter ()
Add methods to provide a way to set all of the parameters this class contains. They can currently only be set using the argc/argv command line parameters.
Member libdap::DODSFilter::establish_timeout (FILE *stream) const
When the alarm handler is called, two CRLF pairs are dumped to the stream and then an Error object is sent. No attempt is made to write the 'correct' MIME headers for an Error object. Instead, a savvy client will know that when an exception is thrown during a deserialize operation, it should scan ahead in the input stream for an Error object. Add this, or a sensible variant once libdap++ supports reliable error delivery. Dumb clients will never get the Error object...
Member libdap::function_grid (int argc, BaseType *argv[], DDS &, BaseType **btpp)
In order to be used by geogrid() , this code may have to be modified so that the maps and array are not re-read by the serialize() method. It might also be a good idea to change from the '?grid(SST,"10<time<20")' syntax in a URL to '?SST&grid(SST,"10<time<20")' even though it's more verbose in the URL, it would make the function a true 'selection operator' and allow several grids to be returned with selections in one request.
Member libdap::GeoConstraint::reorder_data_longitude_axis (Array &a, Array::Dim_iter lon_dim)
Fix this code so that it works with latitude as the rightmost map
Class libdap::Grid

Move, in some sense, the _map_vars up to Constructor. Look at using Constructor's _var field for these.

Along the same lines as the previous item, consider removing the Part enum and adopting the convention that the first variable added is the array and any subsequent variables are maps.

Class libdap::HTTPCache

Update documentation: get_cache_response() now also serves as is_url_in_cache() and is_url_valid() should only be called after a locked cached response is accessed using get_cahced_response(). These lock the cache for reading. The methods cache_response() and update_response() lock an entry for writing.

Check that the lock-for-write and lock-for-read work together since it's possible that an entry in use might have a stream of readers and never free the 'read-lock' thus blocking a writer.

Class libdap::HTTPConnect
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.
Class libdap::HTTPResponse
Maybe refactor so that the header parsing code is hear and not in HTTPConnect?
Member libdap::prune_spaces (const string &name)
Is this still needed? This function may predate the switch from libwww to libcurl and the latter may not need to have spaces removed.
Parameters
nameThe URL to process
Returns
Returns a new string object that contains the pruned URL.
Class libdap::Response
If the code that parses the MIME headers was moved from Connect and HTTPConnect to this class and its children, it would be easier to build a FileConnect class (or maybe the specifics of the connection type could be held in the Response object and HTTPConnect and the to be written FileConnect would not be needed).
Member libdap::ResponseBuilder::establish_timeout (ostream &stream) const
When the alarm handler is called, two CRLF pairs are dumped to the stream and then an Error object is sent. No attempt is made to write the 'correct' MIME headers for an Error object. Instead, a savvy client will know that when an exception is thrown during a deserialize operation, it should scan ahead in the input stream for an Error object. Add this, or a sensible variant once libdap++ supports reliable error delivery. Dumb clients will never get the Error object...
Member libdap::ResponseBuilder::read_data_from_cache (FILE *data, DDS *fdds)
Maybe move this code into libdap as a general 'get it from disk' method. Use that code in libdapclient.
Member libdap::ResponseBuilder::send_das (ostream &out, DDS &dds, ConstraintEvaluator &eval, bool constrained=false, bool with_mime_headers=true)
Test me! Modify the BES to use this code!!
Member libdap::ResponseBuilder::send_data_ddx (ostream &data_stream, DDS &dds, ConstraintEvaluator &eval, const string &start, const string &boundary, bool with_mime_headers=true)
I am broken WRT the other code here for sending data and DDS responses
Member libdap::ResponseBuilder::send_ddx (ostream &out, DDS &dds, ConstraintEvaluator &eval, bool with_mime_headers=true)
I am broken WRT the other code here for sending data and DDS responses
Class libdap::Sequence

Refactor along with Structure moving methods up into Constructor.

Add an isEmpty() method which returns true if the Sequence is empty. This should work before and after calling deserialize().

Member libdap::Sequence::read_row (int row, DDS &dds, ConstraintEvaluator &eval, bool ce_eval=true)
This code ignores the main reason for nesting the sequences, that if the outer Sequence's current instance fails the CE, there's no need to look at the values of the inner Sequence. But in the code that calls this method (serialize() and intern_data()) the CE is not evaluated until the inner-most Sequence (i.e., the leaf Sequence) is read. That means that each instance of the inner Sequence is read and the CE evaluated for each of those reads. To fix this, and the overall problem of complexity here, we need to re-think Sequences and how they behave. 11/13/2007 jhrg
Class libdap::Structure
Refactor with Sequence moving methods up into Constructor.
Member libdap::Structure::val2buf (void *val, bool reuse=false)
Make this throw an exception
Returns
Returns the size of the structure.