/usr/include/libdap/Response.h is in libdap-dev 3.18.2-2+deb9u1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 | // -*- 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
|