Part II. API reference

Table of Contents

Foreword about abstraction
SQL identifiers
Binary large objects (BLOBs)
HOWTO for common tasks
Open a connection
Define a data source (DSN)
Execute a SELECT command
Modify the result of a SELECT command
Execute an INSERT, UPDATE or DELETE command
Get the last inserted row
Execute a DDL command
Get information about a table's columns
Update the meta data about a table
Validate a DML statement
Control value's assignment to various objects
Add your own data to a GdaMetaStore
Object Hierarchy
Initialization and configuration
Libgda initialization — Library initialization
Configuration — Access/Management of libgda configuration
Configuring Libgda with environment variables
Connections & commands
Convenience functions — Do quickly some actions
GdaConnection — A connection to a database
GdaSqlParser — SQL parser
GdaSqlBuilder — Factory object for statements
GdaStatement — Single SQL statement
GdaRepetitiveStatement — Execute the same statement several times with different values
GdaBatch — Multiple SQL statements grouped together.
GdaHolder — Container for a single GValue
GdaSet — Container for several values
GdaConnectionEvent — Any event which has occurred on a GdaConnection
GdaTransactionStatus — Keeps track of the transaction status of a connection
GdaXaTransaction — Distributed transaction manager
Description of the data model returned by gda_connection_get_meta_store_data()
GDA_CONNECTION_META_NAMESPACES
GDA_CONNECTION_META_TYPES
GDA_CONNECTION_META_TABLES
GDA_CONNECTION_META_VIEWS
GDA_CONNECTION_META_FIELDS
Virtual connections
GdaVirtualProvider — Base class for all virtual providers
GdaVproviderDataModel — Virtual provider for connections based on a list of GdaDataModel
GdaVproviderHub — Virtual provider for connections based on other connection
GdaVirtualConnection — Base class for all virtual connection objects
GdaVconnectionDataModel — Virtual connection based on a list of GdaDataModel
GdaVconnectionHub — Virtual connection which bind together connections
Data handling
A single Value — Assorted functions for dealing with GValue values.
Custom data validation
GdaHolder controls
GdaSet controls
GdaDataProxy controls
Advanced GdaDataSelect usage
Automatic re-run of the SELECT statement
Invalid parameters
Blobs — Binary data and BLOBs handling
GdaDataModel — Basic data model class
GdaDataSelect — Data models returned by the execution of a SELECT statement
GdaDataModel columns — Management of GdaDataModel column attributes
GdaDataModelIter — Data model iterator
GdaDataModelImport — Importing data from a string or a file
GdaDataAccessWrapper — Offers a random access on top of a cursor-only access data model
GdaDataModelArray — An implementation of GdaDataModel based on a GArray.
GdaDataModelArray's rows — Row for a GdaDataModelArray object
GdaDataModelBdb — GdaDataModel to access Berkeley DB database contents
GdaDataModelDir — GdaDataModel to list files in filesystem
GdaDataProxy — Proxy to hold modifications for any GdaDataModel, and provides the GdaDataModel interface itself
GdaDataComparator — Simple data model's contents comparison
Trees
GdaTree — A tree-structure
GdaTreeManager — Base class for all the tree managers
GdaTreeNode — a node in a GdaTree
GdaTreeMgrLabel — a tree manager which creates a single node
GdaTreeMgrSelect — a tree manager which creates a node for each row resulting from the execution of a SELECT statement
GdaTreeMgrSchemas — a tree manager which creates a node for each schema in a database
GdaTreeMgrTables — a tree manager which creates a node for each table in a schema
GdaTreeMgrColumns — a tree manager which creates a node for each column of a table
Data conversions
GdaDataHandler — Interface which provides data handling (conversions) capabilities
GdaHandlerString — Default handler for strings
GdaHandlerBoolean — Default handler for booleans
GdaHandlerTime — Default handler for time, date and timestamp
GdaHandlerNumerical — Default handler for numeric values
GdaHandlerBin — Default handler for binary values
GdaHandlerType — Default handler for GType values
Dictionary - metadata
Setup
Adding custom data
Database structure
Data types
SQL identifiers
Short and full names
Individual table description
GdaMetaStore — Dictionary object
GdaMetaStruct — In memory representation of some database objects
Data definition (DDL) queries
GdaServerOperation — Handles any DDL query in an abstract way
GdaServerOperation: individual nodes — Getting information about parts (nodes) composing a path
GdaServerOperation: sequences — Manipulating sequences
User interface API reference
UI Utility functions — Set of UI related functions
GdauiLogin — Connection opening dialog
GdauiProviderSelector — Select a database provider from a combo box
GdauiBasicForm — Form widget mapping the values contained in a GdaSet
GdauiForm
GdauiGrid
GdauiRawForm
GdauiRawGrid
GdauiCombo — Combo box to choose from the contents of a GdaDataModel
GdauiDataEntry — Data entry widget
GdauiDataStore — Bridge between a GdaDataModel and a GtkTreeModel
GdauiDataWidgetFilter
GdauiDataWidget
GdauiDataWidgetInfo
GdauiServerOperation
GdauiSet
GdauiTreeStore
Multi threading
GdaMutex — Recursive mutex implementation
GdaLockable — Interface for locking objects in a multi threaded environment
GdaThreadWrapper — Execute functions in a sub thread
Miscellaneous
Utility functions
Logging — Log functions
Attributes manager — Manager for lists of attributes

The following sections describe the API available for GDA applications.