DODSFilter.h

 
// -*- 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.
 
// (c) COPYRIGHT URI/MIT 1997-1999
// Please first read the full copyright statement in the file COPYRIGHT_URI.
//
// Authors:
// jhrg,jimg James Gallagher <jgallagher@gso.uri.edu>
 
#ifndef _dodsfilter_h
#define _dodsfilter_h
 
#include <string>
 
#ifndef _das_h
#include "DAS.h"
#endif
 
#ifndef _dds_h
#include "DDS.h"
#endif
 
#ifndef constraint_evaluator_h
#include "ConstraintEvaluator.h"
#endif
 
namespace libdap {

 
class DODSFilter {
public:
    enum Response {
        Unknown_Response,
        DAS_Response,
        DDS_Response,
        DataDDS_Response,
        DDX_Response,
        DataDDX_Response,
        BLOB_Response,
        Version_Response
    };
 
protected:
    bool d_comp;        // True if the output should be compressed.
    bool d_bad_options; // True if the options (argc,argv) are bad.
    bool d_conditional_request;
 
    string d_program_name; // Name of the filter program
    string d_dataset;      // Name of the dataset/database
    string d_dap2ce;       // DAP2 Constraint expression
    string d_cgi_ver;      // Version of CGI script (caller)
    string d_anc_dir;      // Look here for ancillary files
    string d_anc_file;     // Use this for ancillary file name
    string d_cache_dir;    // Use this for cache files
    string d_url;          // URL minus CE.
 
    Response d_response; // enum name of the response to generate
    string d_action;     // string name of the response to generate
 
    int d_timeout; // Server timeout after N seconds
 
    time_t d_anc_das_lmt;       // Last modified time of the anc. DAS.
    time_t d_anc_dds_lmt;       // Last modified time of the anc. DDS.
    time_t d_if_modified_since; // Time from a conditional request.
 
    void initialize();
    void initialize(int argc, char *argv[]);
 
    virtual int process_options(int argc, char *argv[]);
 
public:
    DODSFilter() { initialize(); }
    DODSFilter(int argc, char *argv[]) throw(Error);
 
    virtual ~DODSFilter();
 
    virtual bool is_conditional() const;
 
    virtual string get_cgi_version() const;
    virtual void set_cgi_version(string version);
 
    virtual string get_ce() const;
    virtual void set_ce(string _ce);
 
    virtual string get_dataset_name() const;
    virtual void set_dataset_name(const string _dataset);
 
    virtual string get_URL() const;
    virtual void set_URL(const string &url);
 
    virtual string get_dataset_version() const;
 
    virtual Response get_response() const;
    virtual string get_action() const;
    virtual void set_response(const string &r);
 
    virtual time_t get_dataset_last_modified_time() const;
 
    virtual time_t get_das_last_modified_time(const string &anc_location = "") const;
 
    virtual time_t get_dds_last_modified_time(const string &anc_location = "") const;
 
    virtual time_t get_data_last_modified_time(const string &anc_location = "") const;
 
    virtual time_t get_request_if_modified_since() const;
 
    virtual string get_cache_dir() const;
 
    void set_timeout(int timeout = 0);
 
    int get_timeout() const;
 
    virtual void establish_timeout(ostream &stream) const;
 
    virtual void print_usage() const;
 
    virtual void send_version_info() const;
 
    virtual void send_das(DAS &das, const string &anc_location = "", bool with_mime_headers = true) const;
    virtual void send_das(ostream &out, DAS &das, const string &anc_location = "", bool with_mime_headers = true) const;
 
    virtual void send_dds(DDS &dds, ConstraintEvaluator &eval, bool constrained = false,
                          const string &anc_location = "", bool with_mime_headers = true) const;
    virtual void send_dds(ostream &out, DDS &dds, ConstraintEvaluator &eval, bool constrained = false,
                          const string &anc_location = "", bool with_mime_headers = true) const;
    // deprecated
    virtual void functional_constraint(BaseType &var, DDS &dds, ConstraintEvaluator &eval, ostream &out) const;
 
    virtual void dataset_constraint(DDS &dds, ConstraintEvaluator &eval, ostream &out, bool ce_eval = true) const;
    virtual void dataset_constraint_ddx(DDS &dds, ConstraintEvaluator &eval, ostream &out, const string &boundary,
                                        const string &start, bool ce_eval = true) const;
 
    virtual void send_data(DDS &dds, ConstraintEvaluator &eval, ostream &data_stream, const string &anc_location = "",
                           bool with_mime_headers = true) const;
    virtual void send_ddx(DDS &dds, ConstraintEvaluator &eval, ostream &out, bool with_mime_headers = true) const;
    virtual void send_data_ddx(DDS &dds, ConstraintEvaluator &eval, ostream &data_stream, const string &start,
                               const string &boundary, const string &anc_location = "",
                               bool with_mime_headers = true) const;
 
    virtual void establish_timeout(FILE *stream) const;
    virtual void send_das(FILE *out, DAS &das, const string &anc_location = "", bool with_mime_headers = true) const;
    virtual void send_dds(FILE *out, DDS &dds, ConstraintEvaluator &eval, bool constrained = false,
                          const string &anc_location = "", bool with_mime_headers = true) const;
    // deprecated
    virtual void functional_constraint(BaseType &var, DDS &dds, ConstraintEvaluator &eval, FILE *out) const;
 
    virtual void dataset_constraint(DDS &dds, ConstraintEvaluator &eval, FILE *out, bool ce_eval = true) const;
    virtual void send_data(DDS &dds, ConstraintEvaluator &eval, FILE *data_stream, const string &anc_location = "",
                           bool with_mime_headers = true) const;
    virtual void send_ddx(DDS &dds, ConstraintEvaluator &eval, FILE *out, bool with_mime_headers = true) const;
};
 
} // namespace libdap
 
#endif // _dodsfilter_h