libdap++  Updated for version 3.13.3
Todo List
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

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::Constructor::is_linear ()
Change the name to is_flattenable or something like that. 05/16/03 jhrg
Class libdap::D4Dimensions
What about storing constraint information too? Maybe we do need two classes - one for defs and one for 'refs'
Class libdap::D4Maps
Is this class needed?
Class libdap::DAP4StreamMarshaller
Add to configure a test for Apple's Common Crypto (man CC_MD5_Init) and use that if present. ...drop in replacement for SSL MD5 functions. Why Apple did this is a mystery.
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...
Class libdap::Grid

Move, in some sense, the d_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?
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).
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