// -*- 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.

#ifndef response_h

#define response_h

#include <cstdio>

#include <string>

//#include <iostream>

#include <fstream>

#include "ObjectType.h"

#include "debug.h"

namespace libdap

{

/** Encapsulate a response. Instead of directly returning the FILE pointer

    from which a response is read, return an instance of this object. For a

    simple system where all that needs to be done to free the stream and its

    associated resources, this is overkill. However, some streams may require

    complex operations to free their resources once the client is done with

    the stream. Those classes should return a subclass of Response

    which has those operations built into the destructor.

    @todo 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 Response

{

private:

    /// The data stream

    FILE *d_stream;

    std::fstream *d_cpp_stream;

    /// Response object type

    ObjectType d_type;

    /// Server version

    std::string d_version;

    /// The DAP server's protocol

    std::string d_protocol;

    /// The HTTP response code

    int d_status;

protected:

    /** @name Suppressed default methods */

    //@{

    Response(const Response &);

    Response &operator=(const Response &);

    //@}

public:

    Response() : d_stream(0), d_cpp_stream(0), d_type(unknown_type),  d_version("dods/0.0"), d_protocol("2.0"),

		d_status(0)

	{ }

    /** Initialize with a stream. Create an instance initialized to a stream.

	by default get_type() and get_version() return default values of

	unknown_type and "dods/0.0", respectively. Specializations (see

	HTTPResponse and HTTPConnect) may fill these fields in with other

	values.

        @param s Read data from this stream.

        @param status The HTTP response status code.*/

    Response(FILE *s, int status = 0) : d_stream(s), d_cpp_stream(0), d_type(unknown_type),

            d_version("dods/0.0"), d_protocol("2.0"), d_status(status) { }

    Response(std::fstream *s, int status = 0) : d_stream(0), d_cpp_stream(s), d_type(unknown_type),

            d_version("dods/0.0"), d_protocol("2.0"), d_status(status) { }

    /** Close the stream. */

    virtual ~Response()

    {

        if (d_stream)

            fclose(d_stream);

        if (d_cpp_stream)

        	d_cpp_stream->close();

    }

    /** @name getters */

    //@{

    virtual int get_status() const {  return d_status; }

    virtual FILE *get_stream() const { return d_stream; }

    virtual std::istream *get_cpp_stream() const { return d_cpp_stream; }

    virtual ObjectType get_type() const { return d_type; }

    virtual std::string get_version() const { return d_version; }

    virtual std::string get_protocol() const { return d_protocol; }

    //@}

    /** @name setters */

    //@{

    virtual void set_status(int s) { d_status = s; }

    virtual void set_stream(FILE *s) { d_stream = s; }

    virtual void set_cpp_stream(std::istream *s) { d_cpp_stream = dynamic_cast<std::fstream*>(s); }

    virtual void set_type(ObjectType o) { d_type = o; }

    virtual void set_version(const std::string &v) { d_version = v; }

    virtual void set_protocol(const std::string &p) { d_protocol = p; }

    //@}

};

} // namespace libdap

#endif // response_h