browser_connection_new ()

BrowserConnection *
browser_connection_new (GdaConnection *cnc);

Creates a new BrowserConnection object wrapping cnc . The browser_core_take_connection() method must be called on the new object to mahe it managed by the browser.

To close the new connection, use browser_core_close_connection().

browser_connection_get_name ()

const gchar *
browser_connection_get_name (BrowserConnection *bcnc);

browser_connection_get_long_name ()

gchar *
browser_connection_get_long_name (BrowserConnection *bcnc);

Get the "long" name of bcnc

browser_connection_get_information ()

const GdaDsnInfo *
browser_connection_get_information (BrowserConnection *bcnc);

Get some information about the connection

browser_connection_is_virtual ()

gboolean
browser_connection_is_virtual (BrowserConnection *bcnc);

Tells if bcnc is a virtual connection or not

browser_connection_is_busy ()

gboolean
browser_connection_is_busy (BrowserConnection *bcnc,
                            gchar **out_reason);

Tells if bcnc is currently busy or not.

browser_connection_update_meta_data ()

void
browser_connection_update_meta_data (BrowserConnection *bcnc);

Make bcnc update its meta store in the background.

browser_connection_meta_data_changed ()

void
browser_connection_meta_data_changed (BrowserConnection *bcnc);

Call this function if the meta data has been changed directly (ie. for example after declaring or undeclaring a foreign key). This call creates a new GdaMetaStruct internally used.

browser_connection_get_meta_struct ()

GdaMetaStruct *
browser_connection_get_meta_struct (BrowserConnection *bcnc);

Get the GdaMetaStruct maintained up to date by bcnc .

browser_connection_get_meta_store ()

GdaMetaStore *
browser_connection_get_meta_store (BrowserConnection *bcnc);

browser_connection_get_dictionary_file ()

const gchar *
browser_connection_get_dictionary_file
                               (BrowserConnection *bcnc);

browser_connection_get_favorites ()

ToolsFavorites *
browser_connection_get_favorites (BrowserConnection *bcnc);

Get bcnc 's favorites handler

browser_connection_get_completions ()

gchar **
browser_connection_get_completions (BrowserConnection *bcnc,
                                    const gchar *sql,
                                    gint start,
                                    gint end);

See gda_completion_list_get()

browser_connection_create_parser ()

GdaSqlParser *
browser_connection_create_parser (BrowserConnection *bcnc);

Get a new GdaSqlParser object for bcnc

browser_connection_render_pretty_sql ()

gchar *
browser_connection_render_pretty_sql (BrowserConnection *bcnc,
                                      GdaStatement *stmt);

Renders stmt as SQL well indented

browser_connection_execute_statement ()

guint
browser_connection_execute_statement (BrowserConnection *bcnc,
                                      GdaStatement *stmt,
                                      GdaSet *params,
                                      GdaStatementModelUsage model_usage,
                                      gboolean need_last_insert_row,
                                      GError **error);

Executes stmt by bcnc . Unless specific requirements, it's easier to use browser_connection_execute_statement_cb().

browser_connection_execution_get_result ()

GObject *
browser_connection_execution_get_result
                               (BrowserConnection *bcnc,
                                guint exec_id,
                                GdaSet **last_insert_row,
                                GError **error);

Pick up the result of the exec_id 's execution.

BrowserConnectionExecuteCallback ()

void
(*BrowserConnectionExecuteCallback) (BrowserConnection *bcnc,
                                     guint exec_id,
                                     GObject *out_result,
                                     GdaSet *out_last_inserted_row,
                                     GError *error,
                                     gpointer data);

Callback function called by browser_connection_execute_statement_cb(). If you need to keep some of the arguments for a later usage, you need to ref/copy them.

None of the passed arguments must not be modified

browser_connection_execute_statement_cb ()

guint
browser_connection_execute_statement_cb
                               (BrowserConnection *bcnc,
                                GdaStatement *stmt,
                                GdaSet *params,
                                GdaStatementModelUsage model_usage,
                                gboolean need_last_insert_row,
                                BrowserConnectionExecuteCallback callback,
                                gpointer data,
                                GError **error);

Executes stmt by bcnc and calls callback when done. This occurs in the UI thread and avoids having to set up a waiting mechanism to call browser_connection_execution_get_result() repeatedly.

browser_connection_normalize_sql_statement ()

gboolean
browser_connection_normalize_sql_statement
                               (BrowserConnection *bcnc,
                                GdaSqlStatement *sqlst,
                                GError **error);

See gda_sql_statement_normalize().

browser_connection_check_sql_statement_validify ()

gboolean
browser_connection_check_sql_statement_validify
                               (BrowserConnection *bcnc,
                                GdaSqlStatement *sqlst,
                                GError **error);

browser_connection_rerun_select ()

guint
browser_connection_rerun_select (BrowserConnection *bcnc,
                                 GdaDataModel *model,
                                 GError **error);

Re-execute model

browser_connection_rerun_select_cb ()

guint
browser_connection_rerun_select_cb (BrowserConnection *bcnc,
                                    GdaDataModel *model,
                                    BrowserConnectionExecuteCallback callback,
                                    gpointer data,
                                    GError **error);

Re-execute model .

Warning: gda_data_model_freeze() and gda_data_model_thaw() should be used before and after this call since the model will signal its changes in a thread which is not the GUI thread.

browser_connection_begin ()

gboolean
browser_connection_begin (BrowserConnection *bcnc,
                          GError **error);

Begins a transaction

browser_connection_commit ()

gboolean
browser_connection_commit (BrowserConnection *bcnc,
                           GError **error);

Commits a transaction

browser_connection_rollback ()

gboolean
browser_connection_rollback (BrowserConnection *bcnc,
                             GError **error);

Rolls back a transaction

browser_connection_get_transaction_status ()

GdaTransactionStatus *
browser_connection_get_transaction_status
                               (BrowserConnection *bcnc);

Retuns: the GdaTransactionStatus of the connection, or NULL

browser_connection_set_table_column_attribute ()

gboolean
browser_connection_set_table_column_attribute
                               (BrowserConnection *bcnc,
                                GdaMetaTable *table,
                                GdaMetaTableColumn *column,
                                const gchar *attr_name,
                                const gchar *value,
                                GError **error);

browser_connection_get_table_column_attribute ()

gchar *
browser_connection_get_table_column_attribute
                               (BrowserConnection *bcnc,
                                GdaMetaTable *table,
                                GdaMetaTableColumn *column,
                                const gchar *attr_name,
                                GError **error);

browser_connection_define_ui_plugins_for_batch ()

void
browser_connection_define_ui_plugins_for_batch
                               (BrowserConnection *bcnc,
                                GdaBatch *batch,
                                GdaSet *params);

Calls browser_connection_define_ui_plugins_for_stmt() for each statement in batch

browser_connection_define_ui_plugins_for_stmt ()

void
browser_connection_define_ui_plugins_for_stmt
                               (BrowserConnection *bcnc,
                                GdaStatement *stmt,
                                GdaSet *params);

Analyses stmt and assign plugins to each GdaHolder in params according to the preferences stored for each table's field, defined at some point using browser_connection_set_table_column_attribute().

browser_connection_keep_variables ()

void
browser_connection_keep_variables (BrowserConnection *bcnc,
                                   GdaSet *set);

Makes a copy of the variables in set and keep them in bcnc . Retreive them using browser_connection_load_variables()

browser_connection_load_variables ()

void
browser_connection_load_variables (BrowserConnection *bcnc,
                                   GdaSet *set);

For each GdaHolder in set , set the value if one is available in bcnc .

BrowserConnectionPrivate

typedef struct {
	GdaThreadWrapper *wrapper;
	GIOChannel       *ioc;
	guint             ioc_watch_id;
	GSList           *wrapper_jobs;
	guint             wrapper_results_timer;
	gboolean          long_timer;
	gint              nb_no_job_waits; /* number of times check_for_wrapper_result() has been
					      called without any job */

	GHashTable       *executed_statements; /* key = guint exec ID, value = a StatementResult pointer */

	gulong            meta_store_signal;
	gulong            transaction_status_signal;

	gchar         *name;
	GdaConnection *cnc;
	gchar         *dict_file_name;
        GdaSqlParser  *parser;

	GdaDsnInfo     dsn_info;
	GMutex        mstruct_mutex;
	GSList        *p_mstruct_list; /* private GdaMetaStruct list: while they are being created */
	GdaMetaStruct *c_mstruct; /* last GdaMetaStruct up to date, ready to be passed as @mstruct */
	GdaMetaStruct *mstruct; /* public GdaMetaStruct: once it has been created and is no more modified */

	ToolsFavorites *bfav;

	gboolean  busy;
	gchar    *busy_reason;

	GdaConnection *store_cnc;

	GdaSet        *variables;

	GSList        *results_list; /* list of #ExecCallbackData pointers */
	gulong         results_timer_id;
} BrowserConnectionPrivate;

BrowserConnection

typedef struct _BrowserConnection BrowserConnection;

The “gda-connection” property

  “gda-connection”           GdaConnection *

Connection to use.

Flags: Write / Construct Only

The “busy” signal

void
user_function (BrowserConnection *browserconnection,
               gboolean           arg1,
               gchar             *arg2,
               gpointer           user_data)

Flags: Run First

The “favorites-changed” signal

void
user_function (BrowserConnection *browserconnection,
               gpointer           user_data)

Flags: Run First

The “meta-changed” signal

void
user_function (BrowserConnection *browserconnection,
               GdaMetaStruct     *arg1,
               gpointer           user_data)

Flags: Run First

The “table-column-pref-changed” signal

void
user_function (BrowserConnection *browserconnection,
               gpointer           arg1,
               gpointer           arg2,
               gchar             *arg3,
               gchar             *arg4,
               gpointer           user_data)

Flags: Run First

The “transaction-status-changed” signal

void
user_function (BrowserConnection *browserconnection,
               gpointer           user_data)

Flags: Run First