Blame PipeResponse.h

Packit a4aae4
Packit a4aae4
// -*- mode: c++; c-basic-offset:4 -*-
Packit a4aae4
Packit a4aae4
// This file is part of libdap, A C++ implementation of the OPeNDAP Data
Packit a4aae4
// Access Protocol.
Packit a4aae4
Packit a4aae4
// Copyright (c) 2002,2003 OPeNDAP, Inc.
Packit a4aae4
// Author: James Gallagher <jgallagher@opendap.org>
Packit a4aae4
//
Packit a4aae4
// This library is free software; you can redistribute it and/or
Packit a4aae4
// modify it under the terms of the GNU Lesser General Public
Packit a4aae4
// License as published by the Free Software Foundation; either
Packit a4aae4
// version 2.1 of the License, or (at your option) any later version.
Packit a4aae4
//
Packit a4aae4
// This library is distributed in the hope that it will be useful,
Packit a4aae4
// but WITHOUT ANY WARRANTY; without even the implied warranty of
Packit a4aae4
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
Packit a4aae4
// Lesser General Public License for more details.
Packit a4aae4
//
Packit a4aae4
// You should have received a copy of the GNU Lesser General Public
Packit a4aae4
// License along with this library; if not, write to the Free Software
Packit a4aae4
// Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
Packit a4aae4
//
Packit a4aae4
// You can contact OPeNDAP, Inc. at PO Box 112, Saunderstown, RI. 02874-0112.
Packit a4aae4
Packit a4aae4
#ifndef pipe_response_h
Packit a4aae4
#define pipe_response_h
Packit a4aae4
Packit a4aae4
#include <cstdio>
Packit a4aae4
Packit a4aae4
#ifndef response_h
Packit a4aae4
#include "Response.h"
Packit a4aae4
#endif
Packit a4aae4
Packit a4aae4
#ifndef _debug_h
Packit a4aae4
#include "debug.h"
Packit a4aae4
#endif
Packit a4aae4
Packit a4aae4
using namespace std;
Packit a4aae4
Packit a4aae4
namespace libdap
Packit a4aae4
{
Packit a4aae4
Packit a4aae4
/** @brief Encapsulate a response.
Packit a4aae4
    This class provides special treatment for 'stream pipes.' It arranges
Packit a4aae4
    to close them using pclose() instead of fclose(). */
Packit a4aae4
class PipeResponse: public Response
Packit a4aae4
{
Packit a4aae4
private:
Packit a4aae4
    FILE *d_pstream;
Packit a4aae4
Packit a4aae4
protected:
Packit a4aae4
Packit a4aae4
public:
Packit a4aae4
    /** @brief Initialize with a stream returned by popen().
Packit a4aae4
      
Packit a4aae4
        Create an instance initialized to a stream returned by
Packit a4aae4
	popen(). By default get_type() and get_version() return
Packit a4aae4
	default values of unknown_type and "dods/0.0", respectively.
Packit a4aae4
	Note that this class closes the stream.
Packit a4aae4
        
Packit a4aae4
        @note Since Unix provides no easy way to differentiate between a 
Packit a4aae4
        FILE* returned by fopen() or popen(), you're on your own here. Make
Packit a4aae4
        sure you use the correct type of FILE Pointer. 
Packit a4aae4
        
Packit a4aae4
        @see Response
Packit a4aae4
        
Packit a4aae4
        @param s Pointer to a pipe stream returned by popen().
Packit a4aae4
        */
Packit a4aae4
    PipeResponse(FILE *s) : Response(0), d_pstream(s)
Packit a4aae4
    {}
Packit a4aae4
Packit a4aae4
    /** Close the stream. */
Packit a4aae4
    virtual ~PipeResponse()
Packit a4aae4
    {
Packit a4aae4
        if (d_pstream)
Packit a4aae4
            pclose(d_pstream);
Packit a4aae4
    }
Packit a4aae4
Packit a4aae4
    virtual FILE *get_stream() const
Packit a4aae4
    {
Packit a4aae4
        return d_pstream;
Packit a4aae4
    }
Packit a4aae4
    virtual void set_stream(FILE *s)
Packit a4aae4
    {
Packit a4aae4
        d_pstream = s;
Packit a4aae4
    }
Packit a4aae4
};
Packit a4aae4
Packit a4aae4
} // namespace libdap
Packit a4aae4
Packit a4aae4
#endif // pipe_response_h