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.