Table of Contents
- HOWTO for common tasks
- 
- Open a connection
- Define a data source (DSN)
- Build statements without using a parser
- 
- INSERT INTO customers (e, f, g) VALUES (##p1::string, 15, 'joe')
- SELECT people.firstname AS person, people.lastname, "date" AS birthdate, age FROM people
- SELECT c."date", name AS person FROM "select" AS c INNER JOIN orders USING (id)
- UPDATE products set ref='A0E''FESP' WHERE id = 14
- DELETE FROM items WHERE id = ##theid::int
- SELECT myfunc (a, 5, 'Joe') FROM mytable
- SELECT name FROM master WHERE id IN (SELECT id FROM subdata)
- INSERT INTO customers (e, f, g) SELECT id, name, location FROM subdate
- SELECT id, name FROM subdata1 UNION SELECT ident, lastname FROM subdata2
- SELECT CASE tag WHEN 'Alpha' THEN 1 WHEN 'Bravo' THEN 2 WHEN 'Charlie' THEN 3 ELSE 0 END FROM data
- SELECT product_id, name, sum (4 * 5 * price * 1.200000) FROM invoice_lines
- SELECT id, name, adress, cntry_id, countries.name FROM customers INNER JOIN countries ON (countries.id = cntry_id)
 
- 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
- 
- 
Library initialization — Library initialization and information
- 
Configuration — Access/Management of libgda configuration
- Configuring Libgda with environment variables
 
- Connections & commands
- 
- 
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
- GDA_CONNECTION_META_INDEXES
 
 
- Virtual connections
- 
- 
GdaVirtualProvider — Base class for all virtual provider objects
- 
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
- 
GdaLdapConnection — LDAP connection objects
 
- 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 — Data model interface
- 
GdaDataSelect — Base class for 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
- 
GdaDataPivot — A data model for data summarisation
- 
GdaDataAccessWrapper — Offers a random access on top of a cursor-only access data model
- 
GdaDataModelArray — An implementation of GdaDataModel based on a GArray
- 
GdaRow — Individual row of a GdaDataModelArray object
- 
GdaDataModelLdap — GdaDataModel to extract LDAP information
- 
GdaDataModelBdb — GdaDataModel to access Berkeley DB database contents
- 
GdaDataModelDir — GdaDataModel to list files in filesystem
- 
GdaDataProxy — Proxy to hold modifications for any GdaDataModel, providing the GdaDataModel interface itself
- 
GdaDataComparator — Simple data model's contents comparison
- Implementing your own data model
- 
- Virtual methods
- Signalling changes
 
 
- 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
- 
GdaTreeMgrLdap — A tree manager which creates a node for each child entry of an LDAP entry
 
- Data conversions
- 
- 
GdaDataHandler — Interface which provides data handling (conversions) capabilities
- 
GdaHanderString — Default handler for string values
- 
GdaHanderBoolean — Default handler for boolean values
- 
GdaHanderTime — Default handler for time values
- 
GdaHanderNumerical — Default handler for numeric values
- 
GdaHanderBin — Default handler for binary values
- 
GdaHanderType — Default handler for GType values
 
- Dictionary - metadata
- 
- Setup
- Adding custom data
- Database structure
- 
- Data types
- SQL identifiers
- Short and full names
- Declared foreign keys
- 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
- 
- 
Library initialization — Library initialization and information
- 
GdauiLogin — Connection opening widget
- 
GdauiProviderSelector — Select a database provider from a combo box
- 
GdauiDataSelector — Selecting data in a GdaDataModel
- 
GdauiDataProxy — Displaying and modifying data in a GdaDataProxy
- 
GdauiBasicForm — Form widget mapping the values contained in a GdaSet
- 
GdauiForm — Form widget to manipulate data in a GdaDataModel, with decorations
- 
GdauiRawForm — Form widget to manipulate data in a GdaDataModel
- 
GdauiGrid — Grid widget to manipulate data in a GdaDataModel, with decorations
- 
GdauiRawGrid — Grid widget to manipulate data in a GdaDataModel
- 
GdauiCombo — Combo box to choose from the contents of a GdaDataModel
- 
GdauiCloud — Cloud widget
- 
GdauiRtEditor — Rich text editor which uses a subset of the txt2tags markup.
- 
UI plugins — Plugin to customize dana entry widgets and call renderers in tree views
- 
GdauiDataEntry — Data entry widget
- 
GdauiDataStore — Bridge between a GdaDataModel and a GtkTreeModel
- 
GdauiDataFilter — Entrer rules to filter the rows in a GdauiDataProxy
- 
GdauiDataProxyInfo — Shows information & actions about a GdauiDataProxy widget
- 
GdauiServerOperation — Enter information to perform a DDL query
- 
GdauiTreeStore — Bridge between a GdaTree and a GtkTreeModel
- 
UI Utility functions — Set of UI related functions
 
- 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 — Utility functions
- 
Logging — Log functions
- 
Attributes manager — Manager for lists of attributes
 
 
      The following sections describe the API available for GDA applications.