---

data_source.hh

/*
*  Name:      data_source.hh
*  Author:    Rafael Jesus Alcantara Perez
*  Summary:   Definition of a general query class
*  Date:      $Date: 2003/10/06 13:21:35 $
*  Revision:  $Revision: 1.1 $
*
*  Copyright (C) 2001-2002  Rafael Jesus Alcantara Perez <rafa@dedalo-ing.com>
*
*  This program is free software; you can redistribute it and/or modify
*  it under the terms of the GNU General Public License as published by
*  the Free Software Foundation; either version 2 of the License, or
*  (at your option) any later version.
*
*  This program 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 General Public License for more details.
*
*  You should have received a copy of the GNU General Public License
*  along with this program; if not, write to the Free Software
*  Foundation, Inc., 59 Temple Place, Suite 330, Boston,
*  MA 02111-1307, USA.
*/
#ifndef _UESQL_DATA_SOURCE__
#define _UESQL_DATA_SOURCE__

#include <cstdlib>
#include <mpcl/text/string.hh>


namespace uesqlc
{

  template <typename TInstance, typename TSize = std::size_t>
  class IDataSource
  {

    public:

      typedef
        TSize
        size_type;


    public:

      //
      //  C O N S T R U C T O R S
      //

      virtual void closeCursor (const mpcl::text::TString& rkyCURSOR_NAME) = 0;

      virtual size_type declareCursor (const mpcl::text::TString& rkyCURSOR_NAME) = 0;

      virtual void fetchNext ( const mpcl::text::TString& rkyCURSOR_NAME ,
                               TInstance&                 rtINSTANCE     ) = 0;

      virtual void fetchAbsolute ( const mpcl::text::TString& rkyCURSOR_NAME ,
                                   TInstance&                 rtINSTANCE     ,
                                   size_type                  zINDEX         ) = 0;

      virtual void openCursor (const mpcl::text::TString& rkyCURSOR_NAME) = 0;

      virtual void setErrorException (void) = 0;

  };  // class IDataSource

}  // namespace uesqlc


#endif  // not _UESQL_DATA_SOURCE__

---