Table of Contents
- Foreword about abstraction
- SQL identifiers
- Binary large objects (BLOBs)
- 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
- 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
- GDA_CONNECTION_META_INDEXES
- 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
-
LibgdaUI Initialization
-
GdauiLogin — Connection opening dialog
-
GdauiProviderSelector — Select a database provider from a combo box
-
GdauiDataSelector — Selecting data in a GdaDataModel
-
GdauiDataProxy — Modifying data in a GdaDataModel
-
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
-
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
-
Logging — Log functions
-
Attributes manager — Manager for lists of attributes
The following sections describe the API available for GDA applications.