vtkSQLiteQuery Class Reference

#include <vtkSQLiteQuery.h>

Inheritance diagram for vtkSQLiteQuery:

Inheritance graph
[legend]
Collaboration diagram for vtkSQLiteQuery:

Collaboration graph
[legend]

List of all members.


Detailed Description

vtkSQLQuery implementation for SQLite databases

This is an implementation of vtkSQLQuery for SQLite databases. See the documentation for vtkSQLQuery for information about what the methods do.

Bug:
Sometimes Execute() will return false (meaning an error) but GetLastErrorText() winds up null. I am not certain why this is happening.
Thanks:
Thanks to Andrew Wilson from Sandia National Laboratories for implementing this class.
See also:
vtkSQLDatabase vtkSQLQuery vtkSQLiteDatabase

Definition at line 53 of file vtkSQLiteQuery.h.


Public Types

typedef vtkSQLQuery Superclass

Public Member Functions

virtual const char * GetClassName ()
virtual int IsA (const char *type)
void PrintSelf (ostream &os, vtkIndent indent)
bool SetQuery (const char *query)
bool Execute ()
int GetNumberOfFields ()
const char * GetFieldName (int i)
int GetFieldType (int i)
bool NextRow ()
bool HasError ()
const char * GetLastErrorText ()
bool BindParameter (int index, int value)
bool BindParameter (int index, unsigned long value)
bool BindParameter (int index, long value)
bool BindParameter (int index, vtkTypeUInt64 value)
bool BindParameter (int index, vtkTypeInt64 value)
bool BindParameter (int index, float value)
bool BindParameter (int index, double value)
bool BindParameter (int index, const vtkStdString &string)
bool BindParameter (int index, vtkVariant value)
bool BeginTransaction ()
bool RollbackTransaction ()
bool CommitTransaction ()
vtkVariant DataValue (vtkIdType c)
bool BindParameter (int index, unsigned char value)
bool BindParameter (int index, signed char value)
bool BindParameter (int index, unsigned short value)
bool BindParameter (int index, short value)
bool BindParameter (int index, unsigned int value)
bool BindParameter (int index, const char *stringValue)
bool BindParameter (int index, const char *stringValue, size_t length)
bool BindParameter (int index, const void *data, size_t length)
bool ClearParameterBindings ()

Static Public Member Functions

static int IsTypeOf (const char *type)
static vtkSQLiteQuerySafeDownCast (vtkObject *o)
static vtkSQLiteQueryNew ()

Protected Member Functions

 vtkSQLiteQuery ()
 ~vtkSQLiteQuery ()
virtual void SetLastErrorText (const char *)

Friends

class vtkSQLiteDatabase

Member Typedef Documentation

Reimplemented from vtkSQLQuery.

Definition at line 60 of file vtkSQLiteQuery.h.


Constructor & Destructor Documentation

vtkSQLiteQuery::vtkSQLiteQuery (  )  [protected]

vtkSQLiteQuery::~vtkSQLiteQuery (  )  [protected]


Member Function Documentation

virtual const char* vtkSQLiteQuery::GetClassName (  )  [virtual]

Reimplemented from vtkSQLQuery.

static int vtkSQLiteQuery::IsTypeOf ( const char *  name  )  [static]

Return 1 if this class type is the same type of (or a subclass of) the named class. Returns 0 otherwise. This method works in combination with vtkTypeMacro found in vtkSetGet.h.

Reimplemented from vtkSQLQuery.

virtual int vtkSQLiteQuery::IsA ( const char *  name  )  [virtual]

Return 1 if this class is the same type of (or a subclass of) the named class. Returns 0 otherwise. This method works in combination with vtkTypeMacro found in vtkSetGet.h.

Reimplemented from vtkSQLQuery.

static vtkSQLiteQuery* vtkSQLiteQuery::SafeDownCast ( vtkObject o  )  [static]

Reimplemented from vtkSQLQuery.

void vtkSQLiteQuery::PrintSelf ( ostream &  os,
vtkIndent  indent 
) [virtual]

Methods invoked by print to print information about the object including superclasses. Typically not called by the user (use Print() instead) but used in the hierarchical print process to combine the output of several classes.

Reimplemented from vtkSQLQuery.

static vtkSQLiteQuery* vtkSQLiteQuery::New (  )  [static]

Create an object with Debug turned off, modified time initialized to zero, and reference counting on.

Reimplemented from vtkObject.

bool vtkSQLiteQuery::SetQuery ( const char *  query  )  [virtual]

Set the SQL query string. This must be performed before Execute() or BindParameter() can be called.

Reimplemented from vtkSQLQuery.

bool vtkSQLiteQuery::Execute (  )  [virtual]

Execute the query. This must be performed before any field name or data access functions are used.

Implements vtkSQLQuery.

int vtkSQLiteQuery::GetNumberOfFields (  )  [virtual]

The number of fields in the query result.

Implements vtkRowQuery.

const char* vtkSQLiteQuery::GetFieldName ( int  i  )  [virtual]

Return the name of the specified query field.

Implements vtkRowQuery.

int vtkSQLiteQuery::GetFieldType ( int  i  )  [virtual]

Return the type of the field, using the constants defined in vtkType.h.

Implements vtkRowQuery.

bool vtkSQLiteQuery::NextRow (  )  [virtual]

Advance row, return false if past end.

Implements vtkRowQuery.

bool vtkSQLiteQuery::HasError (  )  [virtual]

Return true if there is an error on the current query.

Implements vtkRowQuery.

bool vtkSQLiteQuery::BeginTransaction (  )  [virtual]

Begin, abort (roll back), or commit a transaction.

Reimplemented from vtkSQLQuery.

bool vtkSQLiteQuery::RollbackTransaction (  )  [virtual]

Begin, abort (roll back), or commit a transaction.

Reimplemented from vtkSQLQuery.

bool vtkSQLiteQuery::CommitTransaction (  )  [virtual]

Begin, abort (roll back), or commit a transaction.

Reimplemented from vtkSQLQuery.

vtkVariant vtkSQLiteQuery::DataValue ( vtkIdType  c  )  [virtual]

Return data in current row, field c

Implements vtkRowQuery.

const char* vtkSQLiteQuery::GetLastErrorText (  )  [virtual]

Get the last error text from the query

Implements vtkRowQuery.

bool vtkSQLiteQuery::BindParameter ( int  index,
unsigned char  value 
) [virtual]

Bind a parameter to a placeholder in a query. A full discussion of this feature is beyond the scope of this header file, but in short, here's how it works: Instead of saying "SELECT foo FROM mytable WHERE myfield = 12345" you can say "SELECT foo FROM mytable WHERE myfield = ?". The ? character is a placeholder for a parameter that must then be bound. Call BindParameter(0, 12345) to bind the integer value 12345 to that field. Placeholders are indexed starting at 0. You are responsible for making sure that the types match when you call BindParameter. You don't have to get it precisely correct: in general, the SQL driver is smart enough to do things like cast a short to a long or a float to a double. Bound parameters were introduced in ANSI SQL 92. Please see that standard for more information. Most of these methods are excluded from wrapping because the Java wrapper treats all integer types from char up through 64-bit long as 'int'. This is incorrect behavior but what else am I going to do? Finally, the default implementation for BindParameter(int, vtkVariant) dispatches to one of the more type-specific versions. It should be OK to use in database drivers without modification.

Reimplemented from vtkSQLQuery.

bool vtkSQLiteQuery::BindParameter ( int  index,
signed char  value 
) [virtual]

Reimplemented from vtkSQLQuery.

bool vtkSQLiteQuery::BindParameter ( int  index,
unsigned short  value 
) [virtual]

Reimplemented from vtkSQLQuery.

bool vtkSQLiteQuery::BindParameter ( int  index,
short  value 
) [virtual]

Reimplemented from vtkSQLQuery.

bool vtkSQLiteQuery::BindParameter ( int  index,
unsigned int  value 
) [virtual]

Reimplemented from vtkSQLQuery.

bool vtkSQLiteQuery::BindParameter ( int  index,
int  value 
) [virtual]

Reimplemented from vtkSQLQuery.

bool vtkSQLiteQuery::BindParameter ( int  index,
unsigned long  value 
) [virtual]

Reimplemented from vtkSQLQuery.

bool vtkSQLiteQuery::BindParameter ( int  index,
long  value 
) [virtual]

Reimplemented from vtkSQLQuery.

bool vtkSQLiteQuery::BindParameter ( int  index,
vtkTypeUInt64  value 
) [virtual]

Reimplemented from vtkSQLQuery.

bool vtkSQLiteQuery::BindParameter ( int  index,
vtkTypeInt64  value 
) [virtual]

Reimplemented from vtkSQLQuery.

bool vtkSQLiteQuery::BindParameter ( int  index,
float  value 
) [virtual]

Reimplemented from vtkSQLQuery.

bool vtkSQLiteQuery::BindParameter ( int  index,
double  value 
) [virtual]

Reimplemented from vtkSQLQuery.

bool vtkSQLiteQuery::BindParameter ( int  index,
const char *  stringValue 
) [virtual]

Bind a string value -- string must be null-terminated

Reimplemented from vtkSQLQuery.

bool vtkSQLiteQuery::BindParameter ( int  index,
const char *  stringValue,
size_t  length 
) [virtual]

Bind a string value -- string must be null-terminated

Reimplemented from vtkSQLQuery.

bool vtkSQLiteQuery::BindParameter ( int  index,
const vtkStdString string 
) [virtual]

Reimplemented from vtkSQLQuery.

bool vtkSQLiteQuery::BindParameter ( int  index,
vtkVariant  value 
) [virtual]

Reimplemented from vtkSQLQuery.

bool vtkSQLiteQuery::BindParameter ( int  index,
const void *  data,
size_t  length 
) [virtual]

Bind a blob value. Not all databases support blobs as a data type. Check vtkSQLDatabase::IsSupported(VTK_SQL_FEATURE_BLOB) to make sure.

Reimplemented from vtkSQLQuery.

bool vtkSQLiteQuery::ClearParameterBindings (  )  [virtual]

Bind a blob value. Not all databases support blobs as a data type. Check vtkSQLDatabase::IsSupported(VTK_SQL_FEATURE_BLOB) to make sure.

Reimplemented from vtkSQLQuery.

virtual void vtkSQLiteQuery::SetLastErrorText ( const char *   )  [protected, virtual]


Friends And Related Function Documentation

friend class vtkSQLiteDatabase [friend]

Definition at line 56 of file vtkSQLiteQuery.h.


The documentation for this class was generated from the following file:

Generated on Mon Sep 27 18:52:05 2010 for VTK by  doxygen 1.5.6