Connection.h

Go to the documentation of this file.
00001 // Connection.h
00002 
00003 // This file is part of bes, A C++ back-end server implementation framework
00004 // for the OPeNDAP Data Access Protocol.
00005 
00006 // Copyright (c) 2004-2009 University Corporation for Atmospheric Research
00007 // Author: Patrick West <pwest@ucar.edu> and Jose Garcia <jgarcia@ucar.edu>
00008 //
00009 // This library is free software; you can redistribute it and/or
00010 // modify it under the terms of the GNU Lesser General Public
00011 // License as published by the Free Software Foundation; either
00012 // version 2.1 of the License, or (at your option) any later version.
00013 // 
00014 // This library is distributed in the hope that it will be useful,
00015 // but WITHOUT ANY WARRANTY; without even the implied warranty of
00016 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
00017 // Lesser General Public License for more details.
00018 // 
00019 // You should have received a copy of the GNU Lesser General Public
00020 // License along with this library; if not, write to the Free Software
00021 // Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
00022 //
00023 // You can contact University Corporation for Atmospheric Research at
00024 // 3080 Center Green Drive, Boulder, CO 80301
00025  
00026 // (c) COPYRIGHT University Corporation for Atmospheric Research 2004-2005
00027 // Please read the full copyright statement in the file COPYRIGHT_UCAR.
00028 //
00029 // Authors:
00030 //      pwest       Patrick West <pwest@ucar.edu>
00031 //      jgarcia     Jose Garcia <jgarcia@ucar.edu>
00032 
00033 #ifndef Connection_h
00034 #define Connection_h 1
00035 
00036 #include <iostream>
00037 #include <string>
00038 #include <map>
00039 
00040 using std::ostream ;
00041 using std::string ;
00042 using std::map ;
00043 
00044 #include "BESObj.h"
00045 #include "Socket.h"
00046 
00047 class Connection : public BESObj
00048 {
00049 protected:
00050     Socket                      *_mySock ;
00051     ostream                     *_out ;
00052     bool                        _brokenPipe ;
00053 
00054                                 Connection()
00055                                     : _mySock( 0 ),
00056                                       _out( 0 ),
00057                                       _brokenPipe( false ) {}
00058 
00059     virtual void                send( const string &buffer ) = 0 ;
00060     virtual void                sendChunk( const string &buffer,
00061                                            map<string,string> &extensions ) = 0 ;
00062 public:
00063     virtual                     ~Connection() {}
00064 
00065     virtual void                initConnection() = 0 ;
00066     virtual void                closeConnection() = 0 ;
00067 
00068     virtual string              exit() = 0 ;
00069 
00070     virtual void                send( const string &buffer,
00071                                       map<string,string> &extensions ) = 0 ;
00072     virtual void                sendExtensions( map<string,string> &extensions ) = 0 ;
00073     virtual void                sendExit() = 0 ;
00074     virtual bool                receive( map<string,string> &extensions,
00075                                          ostream *strm = 0 ) = 0 ;
00076 
00077     virtual Socket *            getSocket()
00078                                 {
00079                                     return _mySock ;
00080                                 }
00081 
00082     virtual bool                isConnected()
00083                                 {
00084                                     if( _mySock )
00085                                         return _mySock->isConnected() ;
00086                                     return false ;
00087                                 }
00088 
00089     virtual void                setOutputStream( ostream *strm )
00090                                 {
00091                                     _out = strm ;
00092                                 }
00093     virtual ostream *           getOutputStream()
00094                                 {
00095                                     return _out ;
00096                                 }
00097 
00098     virtual void                brokenPipe()
00099                                 {
00100                                     _brokenPipe = true ;
00101                                 }
00102 
00103     virtual unsigned int        getRecvChunkSize() = 0 ;
00104     virtual unsigned int        getSendChunkSize() = 0 ;
00105 
00106     virtual void                dump( ostream &strm ) const ;
00107 } ;
00108 
00109 #endif // Connection_h
00110 
Generated by  doxygen 1.6.2-20100208