kexidbconnection.h

/***************************************************************************
 * kexidbconnection.h
 * This file is part of the KDE project
 * copyright (C)2004-2005 by Sebastian Sauer (mail@dipe.org)
 *
 * This program is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Library 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
 * Library General Public License for more details.
 * You should have received a copy of the GNU Library General Public License
 * along with this program; see the file COPYING.  If not, write to
 * the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
 * Boston, MA 02110-1301, USA.
 ***************************************************************************/
 
#ifndef KROSS_KEXIDB_KEXIDBCONNECTION_H
#define KROSS_KEXIDB_KEXIDBCONNECTION_H
 
#include <tqstring.h>
#include <ksharedptr.h>
 
#include <api/object.h>
#include <api/variant.h>
#include <api/list.h>
#include <api/class.h>
 
//#include <kexidb/driver.h>
#include <kexidb/connection.h>
 
namespace Kross { namespace KexiDB {
 
    // Forward declarations.
    class KexiDBDriver;
    class KexiDBConnectionData;
    class KexiDBCursor;
    class KexiDBTableSchema;
    class KexiDBQuerySchema;
    class KexiDBTransaction;
    class KexiDBParser;
 
    class KexiDBConnection : public Kross::Api::Class<KexiDBConnection>
    {
        public:
            KexiDBConnection(::KexiDB::Connection* connection, KexiDBDriver* driver = 0, KexiDBConnectionData* connectiondata = 0);
            virtual ~KexiDBConnection();
            virtual const TQString getClassName() const;
 
        private:
 
            bool hadError() const;
            const TQString lastError() const;
 
            KexiDBConnectionData* data();
            KexiDBDriver* driver();
 
            bool connect();
            bool isConnected();
            bool disconnect();
 
            bool isReadOnly() const;
 
            bool databaseExists(const TQString& dbname);
            const TQString currentDatabase() const;
            const TQStringList databaseNames() const;
            bool isDatabaseUsed() const;
            bool useDatabase(const TQString& dbname);
            bool closeDatabase();
 
            const TQStringList allTableNames() const;
            const TQStringList tableNames() const;
            const TQStringList queryNames() const;
 
            KexiDBCursor* executeQueryString(const TQString& sqlquery);
            KexiDBCursor* executeQuerySchema(KexiDBQuerySchema* queryschema);
 
//TODO replace following method with a proxymethod.
            Kross::Api::Object::Ptr insertRecord(Kross::Api::List::Ptr);
 
            bool createDatabase(const TQString& dbname);
            bool dropDatabase(const TQString& dbname);
 
            bool createTable(KexiDBTableSchema* tableschema);
            bool dropTable(const TQString& tablename);
            bool alterTable(KexiDBTableSchema* fromschema, KexiDBTableSchema* toschema);
            bool alterTableName(KexiDBTableSchema* tableschema, const TQString& newtablename);
 
            KexiDBTableSchema* tableSchema(const TQString& tablename) const;
            bool isEmptyTable(KexiDBTableSchema* tableschema) const;
            KexiDBQuerySchema* querySchema(const TQString& queryname) const;
 
            bool autoCommit() const;
            bool setAutoCommit(bool enabled);
 
            KexiDBTransaction* beginTransaction();
            bool commitTransaction(KexiDBTransaction* transaction);
            bool rollbackTransaction(KexiDBTransaction* transaction);
            KexiDBTransaction* defaultTransaction();
            void setDefaultTransaction(KexiDBTransaction* transaction);
 
            Kross::Api::List* transactions();
 
            KexiDBParser* parser();
 
        private:
            ::KexiDB::Connection* connection() const;
            ::KexiDB::Connection* m_connection;
 
            TDESharedPtr<KexiDBConnectionData> m_connectiondata;
            TDESharedPtr<KexiDBDriver> m_driver;
 
            void initialize();
 
    };
 
}}
 
#endif