00001 // BESInterface.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,2005 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 Atmostpheric 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 BESInterface_h_ 00034 #define BESInterface_h_ 1 00035 00036 #include <list> 00037 00038 using std::list ; 00039 00040 #include "BESDataHandlerInterface.h" 00041 00042 #include "BESObj.h" 00043 00044 class BESException ; 00045 class BESTransmitter ; 00046 00047 typedef bool (*p_bes_init)( BESDataHandlerInterface &dhi ) ; 00048 typedef void (*p_bes_end)( BESDataHandlerInterface &dhi ) ; 00049 00123 class BESInterface : public BESObj 00124 { 00125 private: 00126 typedef list< p_bes_init >::const_iterator init_citer ; 00127 typedef list< p_bes_init >::iterator init_iter ; 00128 static list< p_bes_init > _init_list ; 00129 00130 typedef list< p_bes_end >::const_iterator end_citer ; 00131 typedef list< p_bes_end >::iterator end_iter ; 00132 static list< p_bes_end > _end_list ; 00133 protected: 00134 BESDataHandlerInterface _dhi ; 00135 BESTransmitter *_transmitter ; 00136 00137 virtual int exception_manager( BESException &e ) ; 00138 virtual void initialize() ; 00139 virtual void validate_data_request() ; 00140 virtual void build_data_request_plan() ; 00141 virtual void execute_data_request_plan() ; 00142 virtual void invoke_aggregation() ; 00143 virtual void transmit_data() ; 00144 virtual void log_status() ; 00145 virtual void report_request() ; 00146 virtual void end_request() ; 00147 virtual void clean() ; 00148 00149 BESInterface() ; 00150 virtual ~BESInterface() ; 00151 public: 00152 virtual int execute_request() ; 00153 00154 virtual void dump( ostream &strm ) const ; 00155 00156 static void add_init_callback( p_bes_init init ) ; 00157 static void add_end_callback( p_bes_end end ) ; 00158 } ; 00159 00160 #endif // BESInterface_h_ 00161