blob: e09df068033e79ce7344e46b2096c5c908d37558 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
|
/***************************************************************************
* kexidbparser.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_KEXIDBPARSER_H
#define KROSS_KEXIDB_KEXIDBPARSER_H
#include <tqstring.h>
#include <api/object.h>
#include <api/list.h>
#include <api/class.h>
#include <kexidb/drivermanager.h>
#include <kexidb/parser/parser.h>
namespace Kross { namespace KexiDB {
// Forward declaration.
class KexiDBConnection;
class KexiDBTableSchema;
class KexiDBQuerySchema;
/**
* The KexiDBParser could be used to parse SQL-statements.
*
* Example (in Python) ;
* @code
* # First we need a parser object.
* parser = connection.parser()
* # Parse a SQL-statement.
* parser.parse("SELECT * from table1")
* # The operation could be e.g. SELECT or INSERT.
* if parser.operation() == 'Error':
* raise parser.errorMsg()
* # Print some feedback.
* print "Successfully parsed the SQL-statement %s" % parser.statement()
* @endcode
*/
class KexiDBParser : public Kross::Api::Class<KexiDBParser>
{
public:
KexiDBParser(KexiDBConnection* connection, ::KexiDB::Parser* parser);
virtual ~KexiDBParser();
virtual const TQString getClassName() const;
private:
/** Clears previous results and runs the parser on the SQL statement passed as an argument. */
bool parse(const TQString& sql);
/** Clears parsing results. */
void clear();
/** Returns the resulting operation. */
const TQString operation();
/** Returns the KexiDBTableSchema object on a CREATE TABLE operation. */
KexiDBTableSchema* table();
/** Returns the KexiDBQuerySchema object on a SELECT operation. */
KexiDBQuerySchema* query();
/** Returns the KexiDBConnection object pointing to the used database connection. */
KexiDBConnection* connection();
/** Returns the SQL query statement. */
const TQString statement();
/** Returns the type string of the last error. */
const TQString errorType();
/** Returns the message of the last error. */
const TQString errorMsg();
/** Returns the position where the last error occurred. */
int errorAt();
private:
KexiDBConnection* m_connection;
::KexiDB::Parser* m_parser;
};
}}
#endif
|
